diff options
| -rw-r--r-- | doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn | 37 | ||||
| -rw-r--r-- | doc/index/discussion.mdwn | 11 |
2 files changed, 36 insertions, 12 deletions
diff --git a/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn b/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn index e628278ab..90b870b56 100644 --- a/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn +++ b/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn @@ -1,3 +1,36 @@ -Versions 2.0 and 2.1 of ikiwiki, and I think earlier versions as well, allowed wiki links to have spaces in the link text. For example, [[ikiwiki logo page|logo]] should create an anchor tag referencing the logo page, and [[ikiwiki logo|logo/ikiwiki.png]] should create an image tag referencing the logo. +Versions 2.0 and 2.1 of ikiwiki, and I think earlier versions as well, +allowed wiki links to have spaces in the link text. For example, [[ikiwiki +logo page|logo]] should create an anchor tag referencing the logo page, and +[[ikiwiki logo|logo/ikiwiki.png]] should create an image tag referencing +the logo. -As of version 2.2, this no longer works. I think the pattern \\[[...|...]] should allow spaces before the pipe. I suspect this is the same problem as reported in [[index/discussion#index11h1]].
\ No newline at end of file +As of version 2.2, this no longer works. I think the pattern \\[[...|...]] +should allow spaces before the pipe. I suspect this is the same problem as +reported in [[index/discussion#index11h1]]. + +> The above examples are ambiguous, only worked due to a bug, and were +> never documented to work. So I'm not inclined to re-add support for them. +> +> If you look at [[WikiLink]], it is clear that spaces cannot be used in +> WikiLinks. It also shows how to use underscores in the link text if you +> want multiple words. +> +> This was a decision I made a long time ago due to the ambiguity between a +> WikiLink and a [[PreProcessorDirective]]. Is "\[[foo bar|baz]]" a wikilink to +> baz with a link text of "foo bar", or an instance of preprocessor +> directive "foo" with a parameter of "bar|baz"? If it's interpreted as a +> wikilink today, that could change tomorrow if a new preprocessor directive +> is added. +> +> Before version 2.2, ikiwiki actually first treated it as a preprocessor +> directive. If that failed, it output the preprocessor directive back onto +> the page, and next the wikilink code tried treating it as a wikilink. +> In 2.2, I fixed several problems with the way an unhandled preprocessor +> directive was re-output onto the page, by prefixing it with a '\' ... +> which makes it not be treated as a WikiLink. +> +> If WikiLinks had ever been documented to work with spaces in them, then +> I'd feel I needed to support the pre 2.2 behavior, but I don't feel that +> I have to support old behavior that was never documented and happened due +> to a bug, so I current have no plans to bring the old behavior back. +> --[[Joey]] diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn index 27a9127e5..9f9b1820b 100644 --- a/doc/index/discussion.mdwn +++ b/doc/index/discussion.mdwn @@ -178,16 +178,7 @@ My best regards, --[[Paweł|ptecza]] -> This is not new behavior in 2.2 as far as I know. Ikiwiki was always -> interpreted "[ [foo bar] ]" as a preprocessor directive, with the -> whitespace after the first word being the significant bit that -> distinguishes it from a wikilink. If you want whitespace in a wikilink, -> you use underscores; there's been a note at the end of [[WikiLink]] about -> that for some time. --[[Joey]] - ->> Hm. Probably you're right, but my WikiLinks with spaces work for me ->> with ikiwiki <= 2.0 and don't work with ikiwiki 2.2. What's the explanation? ->> --[[Paweł|ptecza]] +> See [[bugs/Spaces_in_link_text_for_ikiwiki_links]] ---- |