diff options
author | Josh Triplett <josh@freedesktop.org> | 2008-01-27 16:13:54 -0800 |
---|---|---|
committer | Josh Triplett <josh@freedesktop.org> | 2008-01-27 16:14:38 -0800 |
commit | 1b03a06c8c0dbf59469ff30d09a0c9c3051e0b00 (patch) | |
tree | 06f20b766475a98f7881aa962f0c8a494c87908b /doc/ikiwiki/wikilink.mdwn | |
parent | fafb2edaa7aeb1293e716fa96f087cb713f4a70a (diff) |
Add new preprocessor directive syntax¸ using a '!' prefix.
Add a prefix_directives option to the setup file to turn this syntax
on; currently defaults to false, for backward compatibility. Support
optional '!' prefix even with prefix_directives off, and use that in
the underlay to support either setting of prefix_directives. Add NEWS
entry with migration information.
Diffstat (limited to 'doc/ikiwiki/wikilink.mdwn')
-rw-r--r-- | doc/ikiwiki/wikilink.mdwn | 14 |
1 files changed, 11 insertions, 3 deletions
diff --git a/doc/ikiwiki/wikilink.mdwn b/doc/ikiwiki/wikilink.mdwn index 38df00f86..debbe7305 100644 --- a/doc/ikiwiki/wikilink.mdwn +++ b/doc/ikiwiki/wikilink.mdwn @@ -22,6 +22,14 @@ page, but the link will appear like this: [[foo_bar|SandBox]]. To link to an anchor inside a page, you can use something like `\[[WikiLink#foo]]` -**Note that you cannot use spaces in WikiLinks**. Replace spaces with -underscores. The presence of spaces is used to distinguish between a -[[PreprocessorDirective]] and a WikiLink. +## Preprocessor directives and wikilinks + +ikiwiki has two syntaxes for +[[preprocessor_directives|PreprocessorDirective]]. The older syntax +used spaces to distinguish between preprocessor directives and +wikilinks; as a result, with that syntax in use, you cannot use spaces +in WikiLinks, and must replace spaces with underscores. The newer +syntax, enabled with the `prefix_directives` option in an ikiwiki +setup file, prefixes directives with `!`, and thus does not prevent +links with spaces. Future versions of ikiwiki will turn this option +on by default.
\ No newline at end of file |