| 91 | {{{#!div style="background-color:#efe;padding-left:4em" |
| 92 | **mrelbe**: |
| 93 | |
| 94 | ''"Trac itself will not supply any localised documentation pages - only default pages."'' -- Why? Since the core of Trac 0.12 is localised, I would expect help pages to be presented in the same language as I've selected in the preferences panel, without having to add separate plugins. |
| 95 | |
| 96 | Shouldn't help pages be handled in a fashion inspired by the way text strings are now? Today, a message.po file defines text strings for each locale. |
| 97 | |
| 98 | Some thoughts (for what it's worth): Define a help-page-directory for each locale containing files of translated help pages. The physical name of each file shall be same as for the implementation language (cf. gettext strings). |
| 99 | |
| 100 | {{{ |
| 101 | trac/locale/en_US/help/index.po |
| 102 | trac/locale/en_US/help/Permissions |
| 103 | trac/locale/en_US/help/Tickets |
| 104 | |
| 105 | trac/locale/sv/help/index.po |
| 106 | trac/locale/sv/help/Hjälp # unique help file for Swedes |
| 107 | trac/locale/sv/help/Tickets |
| 108 | }}} |
| 109 | |
| 110 | index.po contains translations of localised help page names to the physical file name. |
| 111 | |
| 112 | Example for Swedish: |
| 113 | |
| 114 | * "Permissions" --> "" (not translated) |
| 115 | * "Tickets" --> "Ärenden" |
| 116 | |
| 117 | When Swedish language is selected: |
| 118 | |
| 119 | * `[[help:Ärenden]]` shows "sv/help/Tickets". |
| 120 | |
| 121 | * `[[help:Tickets]]` shows "sv/help/Tickets". |
| 122 | |
| 123 | * `[[help:Permissions]]` falls back to show "en_US/help/Permissions" since that page has not been translated. |
| 124 | |
| 125 | * `[[help:Hjälp]]` shows "sv/help/Hjälp" since this is a unique Swedish help page, not present in index.po but a file exists with the referred name for selected locale. ''(If Unicode characters in filenames is a problem, then it should be possible to define an ASCII-based filename and extend index.po, or similar.)'' |
| 126 | }}} |
| 127 | |