Differences

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

--- mantisbt:translationshowto [2008/07/28 10:17] – created giallu
+++ mantisbt:translationshowto [2022/05/28 09:19] (current) – https TWN links dregad
@@ Line 1: / Line 1: @@
 ====== How to create or update a translation ======
-So, you noticed your language of choice is missing a string or you just spotted a less-than-ideal translation and want to contribute the updated string, here is some hints for fixing the issue and properly submitting your modifications for inclusion in mantis.
+So, you noticed your language of choice is missing a string or you just spotted a less-than-ideal translation and want to contribute the updated string, here is some hints for fixing the issue and properly submitting your modifications for inclusion in MantisBT.
-For a start, prepare your workspace by downloading the [[http://www.mantisbt.org/wiki/doku.php/mantisbt:howto_submit_patches#base_your_work_on_the_most_current_source_code|latest source code]]
+Communication about MantisBT localisation can take page at the <mantisbt-lang@lists.sourceforge.net> mailing list.
-===== Existing translations =====
+Localization for MantisBT and the Core Plugins is managed thanks to [[https://translatewiki.net/wiki/Translating:MantisBT|translatewiki.net]].
-  * find the language file you need to modify in the /lang directory; language files are named strings_<language>.txt
+===== Prerequisites =====
-  * open strings_english.txt for reference
-  * open the file with your editor of choice; editor must support UTF encoding
+Before you can start contributing, you need to create an account at translatewiki.net
-  * edit the strings and save the results
-  * run <code>svn diff > strings_<language>.patch</code>
+  * register a user at [[https://translatewiki.net/wiki/Special:UserLogin?type=signup|translatewiki.net]]
-  * open a new issue in http://www.mantisbt.org/bugs, attaching the patch file
+  * create a user page at https://translatewiki.net/wiki/User:YourUserName with a little information about yourself ([[https://translatewiki.net/wiki/User:Horus|example]]).
+  * set your user language in your [[https://translatewiki.net/wiki/Special:Preferences|preferences]] while logged in
+  * [[https://translatewiki.net/wiki/Project:Translator|request translator access]]. This will take a few hours to be processed by a site administrator. Make certain you have created a user page.
+===== Translations =====
+After you have been granted translator rights, you can translate MantisBT Core and the bundled Plugins at the following URLs:
+  * [[https://translatewiki.net/wiki/Special:Translate/out-mantis-core|MantisBT core]]
+  * [[https://translatewiki.net/wiki/Special:Translate/out-mantis-plugin-mantiscoreformatting|MantisBT Formatting plugin]]
+  * [[https://translatewiki.net/wiki/Special:Translate/out-mantis-plugin-mantisgraph|MantisBT Graphs plugin]]
+  * [[https://translatewiki.net/wiki/Special:Translate/out-mantis-plugin-xmlimportexport|MantisBT XML Import/Export plugin]]
+The translatewiki.net staff will add your work to the MantisBT source code periodically (changes are committed on a bi-weekly basis, Mondays and Thursdays), so the only thing you need to do is translate! Some localisation statistics can be found on the [[https://translatewiki.net/wiki/Translating:MantisBT|MantisBT translatewiki project page]].
+The same process is valid not only for updating translations for existing languages, but also if you wish to translate a new language.
+Once the language's translated percentage goes over 40%, it will be added to the MantisBT source code by the translatewiki.net staff.
+===== Validating translations =====
+Run http://localhost/mantisbt/admin/test_langs.php to make sure that the new file doesn't introduce syntax errors.
+Note: as the translation files are generated by TranslateWiki, this should not be necessary and is only kept here for historical purposes.
+This script is nevertheless useful for validating 3rd-party plugins' language files.
-===== New translations =====
-If your language is not included at all in mantis:
-  * create a new file by copying the strings_english.txt file like <code>cp strings_english.txt strings_<newlanguage>.txt</code>
-  * translate the strings
-  * attach the resulting file to a new issue in http://www.mantisbt.org/bugs