(no commit message)
[ikiwiki] / doc / bugs / unwanted_discussion_links_on_discussion_pages.mdwn
1 Background: some po translations (amongst which `fr.po`) translate "discussion" to an upper-cased word (in French: "Discussion").
2 By the way, this is wished e.g. in German, where such a noun has to be written with an upper-cased "D", but I can not see
3 the logic behind the added "D" in French.
4
5 Anyway, this gettext-translated word is used to name the discussion pages, as `$discussionlink` in `Render.pm` is
6 built from `gettext("discussion")`. In the same piece of code, a case-sensitive regexp that tests wether the page
7 being rendered is a discussion page is case-sensitive.
8
9 On the other hand, new discussion pages are created with a name built from `gettext("Discussion")` (please note the upper-cased
10 "D"). Such a new page name seems to be automagically downcased.
11
12 This leads to newly created discussion pages not being recognized as discussion pages by the
13 `$page !~ /.*\/\Q$discussionlink\E$/` regexp, so that then end with an unwanted discussion link.
14
15 A simple fix that seems to work is to make this regexp case-insensitive:
16
17     git diff IkiWiki/Render.pm
18     diff --git a/IkiWiki/Render.pm b/IkiWiki/Render.pm
19     index adae9f0..093c25b 100644
20     --- a/IkiWiki/Render.pm
21     +++ b/IkiWiki/Render.pm
22     @@ -77,7 +77,7 @@ sub genpage ($$) {
23             }
24             if ($config{discussion}) {
25                     my $discussionlink=gettext("discussion");
26     -               if ($page !~ /.*\/\Q$discussionlink\E$/ &&
27     +               if ($page !~ /.*\/\Q$discussionlink\E$/i &&
28                        (length $config{cgiurl} ||
29                         exists $links{$page."/".$discussionlink})) {
30                             $template->param(discussionlink => htmllink($page, $page, gettext("Discussion"), noimageinline => 1, forcesubpage => 1));
31
32 But the best way would be to avoid assuming implicitely that translators will translate "discussion" and "Discussion" the same way.
33
34 > [[done]] --[[Joey]] 
35
36 [[!tag patch]]