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

   1 As discussed on IRC, preprocessor directives should transition to a
   2 new syntax distinct from wikilinks.  Possible syntaxes:
   3
   4 * `[[!preprocessor directive]]`
   5 * `{{preprocessor directive}}`
   6
   7 The transition would involve adding the new syntax, adding an option
   8 to turn off the old syntax with the default allowing it, giving people
   9 time to convert their wikis and turn the option on, and releasing a
  10 new ikiwiki (version 3 for instance) that turns off the old syntax by
  11 default.
  12
  13 Making this transition would fix two major warts:
  14
  15 * The inability to use spaces in wikilinks or link text
  16 * The requirement to use a trailing space on a preprocessor directive
  17   with no arguments, such as `\[[!toc ]]`
  18
  19 --[[JoshTriplett]]
  20
  21 [[done]] in version 2.21, using the '!'-prefixed syntax. --[[JoshTriplett]]