urosm
/
ikiwiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

analysis

master
joey 2007-07-20 17:53:58 +00:00
parent 2f583a6e05
commit 0e4fe066d8
2 changed files with 36 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn
View File

@ -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]].
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]]

11
doc/index/discussion.mdwn
View File

@ -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]]
----