DokuWiki

It's better when it's simple

User Tools

Site Tools


localization

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
localization [2016-02-08 04:02] – old revision restored (2015-10-29 14:57) spam 125.255.136.190localization [2023-12-11 20:15] (current) – old revision restored (2023-09-24 01:09) oiv
Line 3: Line 3:
 [[DokuWiki]]'s user interface can be configured to use any language by setting the appropriate option in the [[config:lang|config]]. [[DokuWiki]]'s user interface can be configured to use any language by setting the appropriate option in the [[config:lang|config]].
  
-You can help translating DokuWiki to your language by visiting the [[http://translate.dokuwiki.org|DokuWiki Localization Hub]]. We recommend to join the [[mailinglist#I18N Mailing List]] to be informed when new strings are added and need to be translated.+You can help translating DokuWiki to your language by visiting the [[https://translate.dokuwiki.org/|DokuWiki Localization Hub]]. We recommend to join the [[mailinglist#I18N Mailing List]] to be informed when new strings are added and need to be translated.
  
 ===== Localizing DokuWiki and its plugins and templates ===== ===== Localizing DokuWiki and its plugins and templates =====
Line 12: Line 12:
 Important things to keep in mind when translating: Important things to keep in mind when translating:
   * Please try to **complete your countries main official language** before starting another dialect.   * Please try to **complete your countries main official language** before starting another dialect.
-  * If you do major translation work it is recommended to check your translations in the [[http://download.dokuwiki.org/|development snapshot]]. This gives you the opportunity to correct errors and verify the layout in your language. +  * If you do major translation work it is recommended to check your translations in the [[https://download.dokuwiki.org/|development snapshot]]. This gives you the opportunity to correct errors and verify the layout in your language.
   * In some languages words and sentences tend to get longer than the original English words. Keep in mind that **your translation needs to work on any screen size** and it often looks better if **words are in line with other items on the page**.   * In some languages words and sentences tend to get longer than the original English words. Keep in mind that **your translation needs to work on any screen size** and it often looks better if **words are in line with other items on the page**.
-  * When translating technical descriptions of external origin like the API's delivered by Github,Twitter , Google etc please **read the external manual first**. This is especially important for translating interfaces. Maybe a localized version of the manual or helppages is already at the external source and you can use all or part of these.  +  * When translating technical descriptions of external origin like the API's delivered by Github, Twitter, Google etc please **read the external manual first**. This is especially important for translating interfaces. Maybe a localized version of the manual or helppages is already at the external source and you can use all or part of these. 
-  * As DokuWiki wants to be **standards-compliant**, consider learning about these regarding your language first. You can learn about correct spelling and interpunction from dictionaries or webpages maintained by public institutions.  +  * As DokuWiki wants to be **standards-compliant**, consider learning about these regarding your language first. You can learn about correct spelling and interpunction from dictionaries or webpages maintained by public institutions.
   * Always **keep the format strings intact**, i.e. identical. Strings like these ''<nowiki>%1$d</nowiki>'' and ''%%<i>%s</i>%%'' and ''%%<strong>Update:</strong>%%''. The word ''Update:'' should be translated but the word ''%%<strong>%%'' **not**.   * Always **keep the format strings intact**, i.e. identical. Strings like these ''<nowiki>%1$d</nowiki>'' and ''%%<i>%s</i>%%'' and ''%%<strong>Update:</strong>%%''. The word ''Update:'' should be translated but the word ''%%<strong>%%'' **not**.
 +
 +==== Howto add a new language ====
 +To prevent spam, https://translate.dokuwiki.org/ only has languages which exist in the source code DokuWiki. To initiate a new language you can send a pull request with some translated lines or if you do not program you can open an issue in our Bug tracker. Please use ISO 639-1 (2-letter) and ISO 639-3 (3-letter) language code format, see... When accepted the language becomes available for easier translation via the translation tool.
  
 ==== Directions for consistent translations ==== ==== Directions for consistent translations ====
 +
 At the [[teams:i18n:consistenttranslations|consistent translations]] page you can find: At the [[teams:i18n:consistenttranslations|consistent translations]] page you can find:
   * some preferred translations for regularly used words    * some preferred translations for regularly used words 
Line 25: Line 29:
 ==== Plugins ==== ==== Plugins ====
  
-Plugin authors can register their plugin at the [[http://translate.dokuwiki.org|DokuWiki Localization Hub]] where you can easily help to translate the plugin.+Plugin authors can register their plugin at [[https://translate.dokuwiki.org/]] where you can easily help to translate the plugin.
  
-If a plugin is not translatable via the hub you can do it manually:+If a plugin is not translatable via the translation tool you can do it manually:
  
-  * Copy the content of ''lib/plugins/<pluginname>/lang/en/'' to\\ ''lib/plugins/<pluginname>/lang/<ISO-code>/''+  * Copy the content of ''lib/plugins/<pluginname>/lang/en/'' to\\ ''lib/plugins/<pluginname>/lang/<ISO-lang-code>/''
   * Edit the contained ''.php'' and ''.txt'' files in a [[utf-8|UTF-8 capable]] text editor   * Edit the contained ''.php'' and ''.txt'' files in a [[utf-8|UTF-8 capable]] text editor
   * Zip up the new language folder and send it to the author for inclusion in future releases   * Zip up the new language folder and send it to the author for inclusion in future releases
Line 37: Line 41:
 ===== Changing some localized texts and strings in your installation ===== ===== Changing some localized texts and strings in your installation =====
  
-There are many localized texts in DokuWiki like emails that are sent on registration, password forgotten, the text above the edit form, and more. Also the strings used in the buttons and links are translated. You can modify these by creating custom files with your version of the texts. This way your changes aren't overwritten on upgrades. +There are many localized texts in DokuWiki like emails that are sent on registration, password forgotten, the text above the edit form, and more. Also the strings used in the buttons and links are translated. You can modify these by creating custom files with your version of the texts. This way your changes aren't overwritten on upgrades.
  
 You can change these texts by copying the ''<name>.txt'' files or copying some strings from ''lang.php'': You can change these texts by copying the ''<name>.txt'' files or copying some strings from ''lang.php'':
-  * from ''inc/lang/<ISO-code>/'' +  * from ''inc/lang/<[[https://www.loc.gov/standards/iso639-2/php/English_list.php|ISO 639-1]]-lang-code>/'' 
-  * to ''**conf/lang/**<ISO-code>/'' +  * to ''**conf/lang/**<ISO-lang-code>/'' 
-and editing the copied content. +and editing the copied content.
  
 You can do the same thing for plugins and templates by copying ''<name>.txt'' or some strings from ''lang.php'': You can do the same thing for plugins and templates by copying ''<name>.txt'' or some strings from ''lang.php'':
-  * from ''lib/plugins/<plugin>/lang/<ISO-code>/'' +  * from ''lib/plugins/<plugin>/lang/<ISO-lang-code>/'' 
-  * to ''**conf/plugin_lang/**<plugin>/<ISO-code>/''+  * to ''**conf/plugin_lang/**<plugin>/<ISO-lang-code>/''
  
-  * from ''lib/tpl/<template>/lang/<ISO-code>/'' +  * from ''lib/tpl/<template>/lang/<ISO-lang-code>/'' 
-  * to ''**conf/template_lang/**<template>/<ISO-code>/''+  * to ''**conf/template_lang/**<template>/<ISO-lang-code>/''
  
-:!: Copy only strings from ''lang.php'' which you will modify. The remains strings are read from the original file.+Copy only strings from ''lang.php'' which you will modify. The remaining strings are read from the original file.
  
-Translating txt-files is possible since "Rincewind" 2011-04-22. Translating some strings from ''lang.php'' since Release 2014-09-29 "Hrun". 
  
-===Example===+=== Example === 
 Example of an English ''lang.php'' file. This is possible for every language. Example of an English ''lang.php'' file. This is possible for every language.
 <code php conf/lang/en/lang.php> <code php conf/lang/en/lang.php>
Line 65: Line 69:
  
 $lang['btn_admin'            = 'Admin Panel'; $lang['btn_admin'            = 'Admin Panel';
- 
 </code> </code>
- 
  
 ====== Translating DokuWiki.org (the documentation) ====== ====== Translating DokuWiki.org (the documentation) ======
  
-Translating the DokuWiki documentation here at dokuwiki.org is encouraged. Translated pages are to be named like their English counterparts and stored in a separate namespace based on their ISO code. To make this easier the [[plugin:translation| translation plugin]] adds links to existing and missing translations in the upper left corner of every page.+Translating the DokuWiki documentation here at dokuwiki.org is encouraged. Translated pages are to be named like their English counterparts and stored in a separate namespace based on their ISO code. To make this easier the [[plugin:translation|Translation Plugin]] adds links to existing and missing translations in the upper left corner of every page.
  
-Only languages manually configured by the administrator are shown in the selector. If you want to add translations for a language currently not shown, just manually create the pages in the appropriate language subnamespace and send a mail to the [[mailinglist#i18n_mailing_list|I18N mailing list]] asking for your language to be added. +Only languages manually configured by the administrator are shown in the selector. If you want to add translations for a language currently not shown, just manually create the pages in the appropriate language subnamespace and send a mail to the [[mailinglist#i18n_mailing_list|I18N mailing list]] asking for your language to be added.
  
 ===== Translation Guidelines ===== ===== Translation Guidelines =====
Line 85: Line 87:
   * A good starting point for translations is the [[manual]]   * A good starting point for translations is the [[manual]]
   * You may also want to translate the [[aside|sidebar]] to your language   * You may also want to translate the [[aside|sidebar]] to your language
 +
 ===== Disabling translation feature for certain pages ===== ===== Disabling translation feature for certain pages =====
  
-Where translation is not sensible the %%~~NOTRANS~~%% macro should be inserted into the page.+Where translation is not sensible the ''%%~~NOTRANS~~%%'' macro should be inserted into the page.
  
 ====== See also ====== ====== See also ======
  
-  * [[http://translate.dokuwiki.org|DokuWiki Localization Hub]]+  * [[https://translate.dokuwiki.org/|DokuWiki Localization Hub]]
   * [[Romanization]]   * [[Romanization]]
   * [[plugin:translation|Translation Plugin]]   * [[plugin:translation|Translation Plugin]]
   * [[devel:localization|Development info about localization]]   * [[devel:localization|Development info about localization]]
-  * Directions for [[[[teams:i18n:consistenttranslations|consistent translations]]+  * Directions for [[teams:i18n:consistenttranslations|consistent translations]]
   * The [[teams:I18N]] Team (translation team)   * The [[teams:I18N]] Team (translation team)
 +
localization.1454900563.txt.gz · Last modified: 2016-02-08 04:02 by 125.255.136.190

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki