Actions

Difference between revisions of "Developer Area/Language Packs"

From Mahara Wiki

< Developer Area
m (Removed duplicated information)
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Here you can find information about developing new language packs for Mahara. If you speak another language and know a small amount of PHP, then you should be able to translate Mahara, or help with a translation effort already in place.
+
Here you can find information about developing new language packs for Mahara. If you speak another language, then you should be able to translate Mahara, or help with a translation effort already in place.
  
Remember to check http://gitorious.org/mahara-lang and the [[Download Mahara|download page]] first - you may find that Mahara has already been translated into the language you want!
+
Remember to check the list of existing language packs at http://langpacks.mahara.org first - you may find that Mahara has already been translated into the language you want!
  
===Subpages===
+
==Launchpad translations==
  
* [[Developer Area/Language Packs/GUI Translation Interface|GUI Translation Interface]]
+
Most translations are now maintained in the [https://translations.launchpad.net/mahara-lang Mahara translation project on Launchpad].
* [[Developer Area/Language Packs/Structure|Structure]]
 
* [[Developer Area/Language Packs/Translating and Git|Translating and Git]]
 
* [[Developer Area/Language Packs/Translating Basics|Translating Basics]]
 
  
===See also===
+
If you would like to help with one of these translations, first have a look at the [https://translations.launchpad.net/+groups/mahara-translation-group list of translation teams].  If your language has a team appointed in this list, you will need to join the appropriate team for your language before you can help with the translation.
  
* [http://mahara.org/interaction/forum/topic.php?id=2197 Forum thread about translation tools] 
+
If you would like to start a new translation, or if your language doesn't have an appointed team, you can help with the translation as soon as you have created an account on Launchpad.
* [http://mahara.org/interaction/forum/topic.php?id=1973 Automatic validation of language packs]
+
 
 +
==How to start a new translation==
 +
 
 +
If your language doesn't appear in the [https://translations.launchpad.net/mahara-lang/trunk list of Mahara Translation status by language] (Click 'View all languages' to see all available languages), you can start a new Mahara translation for your language. Here is a quick instruction.
 +
 
 +
# [https://login.launchpad.net/+new_account Create an account on Launchpad] if you don't have one.
 +
# If there is a [https://translations.launchpad.net/+groups/mahara-translation-group Mahara translation team] responsible to your language, please join this team. Otherwise, please contact an administrator of the [https://launchpad.net/~mahara-lang/+members Mahara translators]. Alternatively, you can join the translation team for your language in general.
 +
# Once you are in a Mahara translation team, you can start to translate or review existing strings on [https://translations.launchpad.net/mahara-lang/trunk Launchpad].
 +
# Once you are ready to test your translation (it does not have to be complete), please [mailto:[email protected] contact] us to have your translation added to the official list at http://langpacks.mahara.org.
 +
# You can continue to update your translation on Launchpad. Your tar ball in Mahara format will be automatically generated and stored at http://langpacks.mahara.org when changes are detected (usually once per day depending on Launchpad).
 +
# There are some essential language configuration settings stored as lang strings in langconfig.php:
 +
## '''thislanguage''': (Required) The name of the language, in the language. This is the string shown to users in the language selection menu.
 +
## '''locales''' (Required): A list of computer locale names for the language, in order of preference. For example: "en_US.utf8,en_GB.utf8,en,english-us,english-uk,english"
 +
## '''parentlanguage''': (Optional) If this is supplied, then if a string is not yet translated in the langpack, Mahara will attempt to use a string from the specified parent language instead. (If the parent language doesn't have it either, it will fall back to English.)
 +
 
 +
For more information please read [https://help.launchpad.net/Translations/StartingToTranslate the Launchpad help page].
 +
 
 +
==Git-based translations==
 +
 
 +
{{Obsolete}}
 +
 
 +
A couple of translations (currently just Czech and English(US)) are not maintained on Launchpad yet.  For information about the older translation process, see the documentation on [[Developer Area/Language Packs/Translation Tools|Translation Tools]].  For moving existing translations from the old process to the new process, see the instructions on [[Developer Area/Language Packs/Launchpad Migration|migrating language packs from gitorious to launchpad]].
 +
 
 +
If you are in charge of an official translation administrator, you can follow the instructions for [[Developer Area/Language Packs/Launchpad New Language Packs|add new tar ball language pack to launchpad]]
 +
 
 +
==langpacks.mahara.org scripts==
 +
 
 +
See [[Developer Area/Language Pack Generation]] for information about the automated scripts that synchronize the langpacks on http://langpacks.mahara.org

Revision as of 17:25, 11 April 2016

Here you can find information about developing new language packs for Mahara. If you speak another language, then you should be able to translate Mahara, or help with a translation effort already in place.

Remember to check the list of existing language packs at http://langpacks.mahara.org first - you may find that Mahara has already been translated into the language you want!

Launchpad translations

Most translations are now maintained in the Mahara translation project on Launchpad.

If you would like to help with one of these translations, first have a look at the list of translation teams. If your language has a team appointed in this list, you will need to join the appropriate team for your language before you can help with the translation.

If you would like to start a new translation, or if your language doesn't have an appointed team, you can help with the translation as soon as you have created an account on Launchpad.

How to start a new translation

If your language doesn't appear in the list of Mahara Translation status by language (Click 'View all languages' to see all available languages), you can start a new Mahara translation for your language. Here is a quick instruction.

  1. Create an account on Launchpad if you don't have one.
  2. If there is a Mahara translation team responsible to your language, please join this team. Otherwise, please contact an administrator of the Mahara translators. Alternatively, you can join the translation team for your language in general.
  3. Once you are in a Mahara translation team, you can start to translate or review existing strings on Launchpad.
  4. Once you are ready to test your translation (it does not have to be complete), please contact us to have your translation added to the official list at http://langpacks.mahara.org.
  5. You can continue to update your translation on Launchpad. Your tar ball in Mahara format will be automatically generated and stored at http://langpacks.mahara.org when changes are detected (usually once per day depending on Launchpad).
  6. There are some essential language configuration settings stored as lang strings in langconfig.php:
    1. thislanguage: (Required) The name of the language, in the language. This is the string shown to users in the language selection menu.
    2. locales (Required): A list of computer locale names for the language, in order of preference. For example: "en_US.utf8,en_GB.utf8,en,english-us,english-uk,english"
    3. parentlanguage: (Optional) If this is supplied, then if a string is not yet translated in the langpack, Mahara will attempt to use a string from the specified parent language instead. (If the parent language doesn't have it either, it will fall back to English.)

For more information please read the Launchpad help page.

Git-based translations

Warning: The information on this page is obsolete and kept mainly for historical purposes.

A couple of translations (currently just Czech and English(US)) are not maintained on Launchpad yet. For information about the older translation process, see the documentation on Translation Tools. For moving existing translations from the old process to the new process, see the instructions on migrating language packs from gitorious to launchpad.

If you are in charge of an official translation administrator, you can follow the instructions for add new tar ball language pack to launchpad

langpacks.mahara.org scripts

See Developer Area/Language Pack Generation for information about the automated scripts that synchronize the langpacks on http://langpacks.mahara.org