po plugin: documentation work

[git.ikiwiki.info.git] / 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 d6e4e5a9b5f91e9cf77bf5a4cc074b52569be6c5..f6dbacad7fe6e442622fa4133469240a15a94e67 100644 (file)
--- 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 [[ikiwiki/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
@@ -35,4 +35,19 @@ reported in [[index/discussion#index11h1]].
 > 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]]