X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/0e4fe066d865f748851ada1ac69afcd6521424f9..fdb4fad223cac4b5a87f7da2de9fc7dc1b9a8f8b:/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn 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 90b870b56..f6dbacad7 100644 --- a/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn +++ b/doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn @@ -1,7 +1,7 @@ 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 +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 +[[!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 \\[[...|...]] @@ -11,12 +11,12 @@ 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 +> If you look at [[ikiwiki/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 +> WikiLink and a [[ikiwiki/Directive]]. 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 @@ -34,3 +34,20 @@ reported in [[index/discussion#index11h1]]. > 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]] + +>> I agree that the grammar should be unambiguous. It seems to me that the +>> problem with spaces-in-wikilinks is caused by overloading the wikilink +>> and preprocessor syntax to use the same symbols. If they didn't (and is +>> there much advantage in them using the same symbols? I know in some +>> cases you have something which is a wikilink and a preprocessor directive, +>> but how often?) there'd be no problem with spaces. +>> +>> If there was ever a future, syntax-breaking major release of ikiwiki +>> (similar to python3000) I'd like to see this fixed as part of that. +>> --[[JonDowland]] + +>>> You can enable `prefix_directives` and get the disambiguated behavior +>>> and spaces in wikilinks today. It will become the default in 3.0. +>>> --[[Joey]] + +[[done]]