localization
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
localization [2014-05-17 11:40] – keep the format strings intact rene | localization [2023-12-11 20:15] (current) – old revision restored (2023-09-24 01:09) oiv | ||
---|---|---|---|
Line 3: | Line 3: | ||
[[DokuWiki]]' | [[DokuWiki]]' | ||
- | You can help translating DokuWiki to your language by visiting the [[http:// | + | You can help translating DokuWiki to your language by visiting the [[https:// |
- | ===== Localizing DokuWiki and it' | + | ===== Localizing DokuWiki and its plugins and templates ===== |
Most of DokuWiki and its plugins and templates only provide localization for English and some other languages. | Most of DokuWiki and its plugins and templates only provide localization for English and some other languages. | ||
- | We encourage you to translate | + | We encourage you to translate |
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. | ||
- | * Please keep the **bi-annual release date of DokuWiki** in mind. If you do mayor translation work it is recommended to check your translations in the [[http:// | + | * If you do major translation work it is recommended to check your translations in the [[https:// |
- | * In some languages words and sentences tend to get longer than the original English words. This is especially important when header markup is used, they also grow. Keep in mind that **your translation | + | * In some languages words and sentences tend to get longer than the original English words. Keep in mind that **your translation |
- | * When translating technical | + | * When translating technical |
- | * As DokuWiki wants to be **standardscompliant** , consider learning about these regarding your language first. | + | * 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**, | + | * Always **keep the format strings intact**, |
+ | |||
+ | ==== Howto add a new language ==== | ||
+ | To prevent spam, https:// | ||
==== Directions for consistent translations ==== | ==== Directions for consistent translations ==== | ||
+ | |||
At the [[teams: | At the [[teams: | ||
* some preferred translations for regularly used words | * some preferred translations for regularly used words | ||
Line 24: | Line 29: | ||
==== Plugins ==== | ==== Plugins ==== | ||
- | Plugin authors can register their plugin at the [[http:// | + | Plugin authors can register their plugin at [[https:// |
- | 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 '' | + | * Copy the content of '' |
* Edit the contained '' | * Edit the contained '' | ||
* 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 34: | Line 39: | ||
For any further questions or general help you could send a mail to the [[mailinglist# | For any further questions or general help you could send a mail to the [[mailinglist# | ||
- | ===== Changing localized texts in your installation ===== | + | ===== Changing |
- | Available since " | + | There are many localized texts in DokuWiki like emails that are sent on registration, |
- | There are many localized | + | You can change these texts by copying |
+ | * from '' | ||
+ | * to '' | ||
+ | and editing the copied content. | ||
- | You can change these texts by copying | + | You can do the same thing for plugins and templates |
- | * from '' | + | * from '' |
+ | * to '' | ||
- | This way your changes aren't overwritten on upgrades. You can do the same thing for plugins and templates(e.g. the help text for permissions in the ACL editor) by copying the files: | + | |
- | | + | * to '' |
- | * from '' | + | |
- | and changing them there. | + | |
- | :!: This method cannot be used for '' | + | Copy only strings from '' |
+ | |||
+ | |||
+ | === Example === | ||
+ | |||
+ | Example | ||
+ | <code php conf/ | ||
+ | <?php | ||
+ | /** | ||
+ | * Customization of the english language file | ||
+ | * Copy only the strings that needs to be modified | ||
+ | */ | ||
+ | |||
+ | $lang[' | ||
+ | </ | ||
====== 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: | + | 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: |
- | 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# | + | 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# |
===== Translation Guidelines ===== | ===== Translation Guidelines ===== | ||
Line 66: | 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 '' |
====== See also ====== | ====== See also ====== | ||
- | * [[http:// | + | * [[https:// |
* [[Romanization]] | * [[Romanization]] | ||
* [[plugin: | * [[plugin: | ||
* [[devel: | * [[devel: | ||
- | * Directions for [[[[teams: | + | * Directions for [[teams: |
* The [[teams: | * The [[teams: | ||
+ |
localization.1400319642.txt.gz · Last modified: 2014-05-17 11:40 by rene