From 94226faf35518629a7d69201c800a35991f9b794 Mon Sep 17 00:00:00 2001 From: chrysn Date: Sat, 24 Mar 2012 22:46:11 -0400 Subject: [PATCH] workaround and some analysis of the bug --- doc/bugs/Underscores_in_links_don__39__t_appear.mdwn | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/bugs/Underscores_in_links_don__39__t_appear.mdwn b/doc/bugs/Underscores_in_links_don__39__t_appear.mdwn index d63f9cd18..b25dfb7fe 100644 --- a/doc/bugs/Underscores_in_links_don__39__t_appear.mdwn +++ b/doc/bugs/Underscores_in_links_don__39__t_appear.mdwn @@ -6,3 +6,13 @@ Expected behavior: I would like to be able to create links with underscores. I realize this is a feature, and I searched for ways to escape the underscore so it would appear, but I didn't find any. +> as a workaround, you can use \[[cmd\_\_95\_\_test|cmd_test]] (which will link to a page named "cmd test" at the url location "cmd\_test") or \[[cmd\_\_95\_\_test]] (which will link to a page named "cmd\_test" at the url location "cmd\_\_95\_\_test"). i would, from my limited understanding of ikiwiki internals, consider the bug valid, and suggest that +> +> * explicit link text be not subject to de-escaping (why should it; this would be the short term solution) +> * escaped page names never be used in user visible parts of ikiwiki (in my opinion, a user should not need to know about those internals, especially as they are configuration dependant (wiki_file_regexp)) +> +> note that in [[ikiwiki/wikilink]], that very behavior is documented; it says that "\[[foo\_bar|Sandbox]]" will show as "foo bar". (although you can't tell that apart from "foo\_bar" easily because it's a hyperlink). +> +> i assume that this behavior stems from times when wikilinks and [[ikiwiki/directive]]s were not distinguished by \[[ vs \[[! but by the use of whitespace in directives, so whitespace had to be avoided in wikilinks. +> +> --[[chrysn]] -- 2.26.2