web commit by tschwinge: Should perhaps explain the syntax. Done that extra-extensiv...

[git.ikiwiki.info.git] / doc / wikilink.mdwn

diff --git a/doc/wikilink.mdwn b/doc/wikilink.mdwn
index 7e4ff0c2050699480f4b36e54853a11033723baa..38df00f86ea42b3c57da07c414e02f8387e330b9 100644 (file)
--- a/doc/wikilink.mdwn
+++ b/doc/wikilink.mdwn
@@ -17,13 +17,11 @@ links at the start of a sentence, and so on.
 
 It's also possible to write a WikiLink that uses something other than the page
 name as the link text. For example `\[[foo_bar|SandBox]]` links to the SandBox
 
 It's also possible to write a WikiLink that uses something other than the page
 name as the link text. For example `\[[foo_bar|SandBox]]` links to the SandBox

-page, but the link will appear like this: [[foo_bar|SandBox]]. The reason you
-**have to use underscores in place of spaces in WikiLinks** is so that
-`ikiwiki` can distinguish your WikiLink from a PreProcessorDirective.
-
-(Note: previously, you could actually use spaces if you specify the target
-link following the pipe symbol (`|`), as in the above, but this has been
-disabled shortly after version 2.8).
+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]]`
 
 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.