Is Dokuwiki set up so that users of OpenCPN who want to read the Opencpn User Manual (dokuwiki) can easily select which language files to be using?
It appears that the
https://www.dokuwiki.org/plugin:translation Translation Plugin will allow the user to select a language, but the way it is described, that appears to be a per page selection. IE go to the page and then select the language. We would need something more comprehensive for the entire User Manual. We need to find out more about this.
Is Dokuwiki itself and the Plugins (that we use for OpenCPN) translated to multiple languages?
1. Yes, it appears that Dokuwiki and a number of it's plugins have been translated and the selection of the language is made in the Config file. See Localization of Dokuwiki
https://www.dokuwiki.org/localization
2. Directions for consistent translations:
https://www.dokuwiki.org/teams:i18n:consistenttranslations
3. See the list of languages available at this point where you can download the various versions
https://download.dokuwiki.org/ These versions will need to be hosted on the opencpn.org website, along with the versions of the plugins.
4. See the list of plugin translations available here
https://translate.dokuwiki.org/
Upgrade Plugin, Wrap, Gallery, Captcha, Indexmenu, Move, Translation, Dw2PDF, Ckgedit, Multiorphan, etc.
Looks pretty good, but some translations will be needed.
We next need to determine which languages and implement that on the opencpn.org website.
There may be some translation needed for Dokuwiki and plugins to get this completed.
Then the next task would be to build the crowdsource files and test out the OpenCPN translation process.
Are there some public dokuwiki websites with multiple languages that can be looked at for examples?
In looking for this I found an old plugin called Mutilingual
https://www.dokuwiki.org/plugin:multilingual
and instructions are here
https://www.inmotionhosting.com/support/edu/dokuwiki/change-language-doku-wiki/configure-multilingual-plugin however I believe Adreas Gohr's plugin Translation is far advanced
https://www.dokuwiki.org/start?id=plugin:translation
Here is a spanish help version of the Translation plugin
https://www.dokuwiki.org/es:plugin:translation#translation_plugin
Here is French (no translation yet)
https://www.dokuwiki.org/start?id=fr:plugin:translation
Here is Japanese
https://www.dokuwiki.org/start?id=ja:plugin:translation
And Russian
https://www.dokuwiki.org/start?id=ru:plugin:translation
Note the Namespace standard: Language [two characters?]:plugin:[plugin name]
I expect that there is a similar standard for various language files for dokuwiki itself.
Yes, this is the page for French Translation
https://www.dokuwiki.org/start?id=fr:dokuwiki
from the left dropdown, German
https://www.dokuwiki.org/start?id=de:dokuwiki
Italian
https://www.dokuwiki.org/start?id=it:dokuwiki
https://www.dokuwiki.org/start?id=nl:dokuwiki
So the namespace structure for multiple language versions of Dokuwiki is
[Language two characters]:dokuwiki
Another question related to translation of the OpenCPN User Manual is will the IndexMenu Sidebar feature work, such that the Titles of each page in the translated version be used to create the sidebar navigation?
I believe the answer is yes, I believe it will work this way, but we will have to try it.
See this github issue however...
https://github.com/splitbrain/dokuwiki-plugin-translation/issues/25
He is using Sidebar in a different way than we are however. We are using IndexMenu and the Page/Namespace titles to create the Sidebar navigation.