Not logged in. · Lost password · Register
Forum: General Help and Support General Stuff RSS
Internationalization of Wiki's using Dokuwiki
OpenCPN needs to translate the User Manual to multiple languages
Avatar
rgleason #1
Member since Sep 2016 · 266 posts
Group memberships: Members
Show profile · Link to this post
Subject: Internationalization of Wiki's using Dokuwiki
We have a crowd sourced method to engage and manage internationalization for the program OpenCPN which is associated with github.

This is a link to a description of the process  (needs some updates)
https://opencpn.org/wiki/dokuwiki/doku.…?id=opencpn:deve…

We would like to use the same crowd sourced methods and github to manage translation of the User Manual for OpenCPN.

This will result in different data text files for each language.

Is Dokuwiki set up so that users can easily select which language files to be using?

I expect that the dokuwiki help files for the various plugins in a number of languages will be available, but some of the languages will be swedish etc. which will be needed too. Perhaps these can be done by our translators too?

I would like to know how "ready" Dokuwiki is for this type of use.

Are there any example websites I could look at?

Thanks.
This post was edited on 2018-10-17, 18:08 by rgleason.
Avatar
turnermm (Moderator) #2
Member since Oct 2009 · 4446 posts · Location: Canada
Group memberships: Global Moderators, Members, Super Mods
Show profile · Link to this post
This is the plugin that Dokuwiki uses for its translatons:
   https://www.dokuwiki.org/plugin:translation
Myron Turner
github: https://github.com/turnermm
plugins, templates: http://www.mturner.org/devel
Avatar
Samana Johann #3
Member since Jun 2018 · 124 posts · Location: Aural/Cambodia
Group memberships: Members
Show profile · Link to this post
It look's more as if Rgleason looks for either "cooperation-partner" for software localization or to implement the work done here for further own use, or to simply show possibilities, Mr. Myron Turner, but of cause it could be wrong. Rgleason will possible correct or explain.

For general info https://www.dokuwiki.org/localization might be of interest if the "assumed" case matches.

Mr. Andreas might be the one to address, if seeking for offer.
This post was edited on 2018-10-18, 14:49 by Samana Johann.
Avatar
Michaelsy #4
Member since Jun 2015 · 671 posts · Location: Düsseldorf, Germany
Group memberships: Members
Show profile · Link to this post
In reply to post #1
OpenCPN needs to translate the User Manual to multiple languages.
Are there any example websites I could look at?

The DokuWiki User Manual itself handles multiple languages: https://www.dokuwiki.org

HTH - Michael Sy.
By Patreon.com a few eurons can be fed into the code phasers of
the DokuWiki engine. Besides, Andi's posts are worth reading.
Avatar
rgleason #5
Member since Sep 2016 · 266 posts
Group memberships: Members
Show profile · Link to this post

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 thehttps://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/chang… 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…

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/…
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.
This post was edited 3 times, last on 2018-10-20, 20:44 by rgleason.
Close Smaller – Larger + Reply to this post:
Verification code: VeriCode Please enter the word from the image into the text field below. (Type the letters only, lower case is okay.)
Smileys: :-) ;-) :-D :-p :blush: :cool: :rolleyes: :huh: :-/ <_< :-( :'( :#: :scared: 8-( :nuts: :-O
Special characters:
Go to forum
Imprint
This board is powered by the Unclassified NewsBoard software, 20150713-dev, © 2003-2015 by Yves Goergen
Current time: 2019-01-17, 20:29:01 (UTC +01:00)