git.oblomov.eu Git - ikiwiki/blob - doc/todo/Short_wikilinks.mdwn

   1 Markdown supports nice short links to external sites within body text by references defined elsewhere in the source:
   2
   3         foo [bar][ref]
   4
   5         [ref]: http://example.invalid/
   6
   7 It would be nice to be able to do this or something like this for wikilinks as well, so that you can have long page names without the links cluttering the body text. I think the best way to do this would be to move wikilink resolving after HTML generation: parse the HTML with a proper HTML parser, and replace relative links with links to the proper files (plus something extra for missing pages).
   8
   9 A related possibility would be to move a lot of "preprocessing" after HTML generation as well (thus avoiding some conflicts with the htmlifier), by using special tags for the preprocessor stuff. (The old preprocessor could simply replace links and directives with appropriate tags, that the htmlifier is supposed to let through as-is. Possibly the htmlifier plugin could configure the format.)
  10
  11 Other alternatives would be
  12
  13   * to understand the source format, but this seems too much work with all the supported formats; or
  14
  15   * something like the shortcut plugin for external links, with additional support for specifying the link text, but the syntax would be much more cumbersome then.
  16