Migrate escaped directives (\[[) in doc/todo to have \[[! prefix
[ikiwiki.git] / 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]]