summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-07-20 17:53:58 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-07-20 17:53:58 +0000
commit0e4fe066d865f748851ada1ac69afcd6521424f9 (patch)
treee8e1191dfd56e3388c7e55aa9c1934a32df25484 /doc
parent2f583a6e05c9f1d3c64dccc991d7578b4dd6345a (diff)
analysis
Diffstat (limited to 'doc')
-rw-r--r--doc/bugs/Spaces_in_link_text_for_ikiwiki_links.mdwn37
-rw-r--r--doc/index/discussion.mdwn11
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]]
----