Differences

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

--- mantisbt:translationshowto [2008/07/28 10:23] – add -lang mailing list info 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 MantisBT.
+Communication about MantisBT localisation can take page at the <mantisbt-lang@lists.sourceforge.net> mailing list.
+Localization for MantisBT and the Core Plugins is managed thanks to [[https://translatewiki.net/wiki/Translating:MantisBT|translatewiki.net]].
+===== Prerequisites =====
+Before you can start contributing, you need to create an account at translatewiki.net
+  * 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 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.