Differences

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

--- mantisbt:translationshowto [2009/12/07 13:58] – updated (not finished siebrand
+++ mantisbt:translationshowto [2026/02/07 12:32] (current) – [Validating translations] updated for new test_langs.php functionality dregad
@@ Line 3: / Line 3: @@
 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.
-Remember to announce your work on <mantisbt-lang@lists.sourceforge.net> mailing list, so other translators will engage you if you are not the only contributor for the language
+Localization for MantisBT and the Core Plugins is managed thanks to [[https://translatewiki.net/wiki/Translating:MantisBT|translatewiki.net]].
-===== Existing translations =====
+===== Prerequisites =====
-  # register a user at http://translatewiki.net/wiki/Special:UserLogin?type=signup
+Before you can start contributing, you need to create an account at translatewiki.net
-  # create a user page at http://translatewiki.net/wiki/User:YourUserName with a little information about yourself. Example: http://translatewiki.net/wiki/User:Horus
-  # request translator access at http://translatewiki.net/wiki/Project:Translator . This will take a few hours to be processed by a site administrator. Make certain you have created a user page.
-  * open strings_english.txt for reference
-  * open the file with your editor of choice; editor must support UTF encoding
-  * edit the strings and save the results
-  * run <code>svn diff > strings_<language>.patch</code>
-  * open a new issue in http://www.mantisbt.org/bugs, attaching the patch file
+  * register a user at [[https://translatewiki.net/wiki/Special:UserLogin?type=signup|translatewiki.net]]
+  * 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 verify that the localized language files do not introduce errors and check for inconsistencies with the English reference language strings.
+The script will detect problem such as invalid language file names, missing strings, syntax errors, incorrect or inconsistent placeholders, etc.
+It is also useful for validating 3rd-party plugins' language files that are not managed by translatewiki.net.
-===== New translations =====
-Follow the same process as for updating an existing translation. Use http://translatewiki.net. Once your translated percentage goes over 40%, the language will be added to the MantisBT source code by the translatewiki.net staff