Starting a new language pack: Difference between revisions

From MoodleDocs
mNo edit summary
m (clean up, typos fixed: ie, → i.e.,, , → , (24), eg → e.g.)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Translation}}
If Moodle is not yet translated into your language and you would like to help, please  [http://lang.moodle.org/login/signup.php create an account on the Translation site] and contact our Moodle translation coordinator, Koen Roggemans, [mailto:translation@moodle.org translation@moodle.org].
If Moodle is not yet translated into your language and you would like to help, please  [http://lang.moodle.org/login/signup.php create an account on the Translation site] and contact our Moodle translation coordinator, Koen Roggemans, [mailto:translation@moodle.org translation@moodle.org].


Line 4: Line 5:


First:
First:
* '''Make sure langconfig[https://moodledev.io/general/development/process/translation/langpack/langconfig] is properly set up'''. It would be a very good idea to ask for other translators to double-check your translation of this extremely important file by posting a request in the [https://lang.moodle.org/mod/forum/view.php?id=5 Translating Moodle forum].
* '''Make sure [[Translation langconfig|langconfig]] is properly set up'''. It would be a very good idea to ask for other translators to double-check your translation of this extremely important file by posting a request in the [https://lang.moodle.org/mod/forum/view.php?id=5 Translating Moodle forum].
* Take a look at [[Translation priority]]. All files have a rating according to how urgent they need translating.
* Take a look at [[Translation priority]]. All files have a rating according to how urgent they need translating.


Line 10: Line 11:


==Starting a child language of an existing language pack==
==Starting a child language of an existing language pack==
If your country uses a variation of an existing language, that has a few (or many) differences from an [https://docs.moodle.org/dev/Translation_langconfig#parentlanguage.2Ccore_langconfig existing parent language] (ie, Canadian French is a variation of French, or US English has some spelling differences from UK English), a child language might be a good solution, as only the strings that need changes have to be uploaded to AMOS.
If your country uses a variation of an existing language, that has a few (or many) differences from an [https://docs.moodle.org/dev/Translation_langconfig#parentlanguage.2Ccore_langconfig existing parent language] (i.e., Canadian French is a variation of French, or US English has some spelling differences from UK English), a child language might be a good solution, as only the strings that need changes have to be uploaded to AMOS.
Some examples of existing child languages and the changes from the parent language for Moodle 4.0 are:
Some examples of existing child languages and the changes from the parent language for Moodle 4.0 are:


* Català (Valencià) , 4416 changes from ca
* Català (Valencià), 4416 changes from ca
*Dansk (kursus) , 22 changes from da
*Dansk (kursus), 22 changes from da
*Dansk Rum , 857 changes from da
*Dansk Rum, 857 changes from da
*Davvisámegiella , 7235 changes from no
*Davvisámegiella, 7235 changes from no
*Deutsch community , 246 changes from de_du
*Deutsch community, 246 changes from de_du
*Deutsch - Du , 1051 changes from de
*Deutsch - Du, 1051 changes from de
*Deutsch - Kids , 273 changes from de_du
*Deutsch - Kids, 273 changes from de_du
*English - Pirate , 1545 changes from en
*English - Pirate, 1545 changes from en
*English for kids , 75 changes from en
*English for kids, 75 changes from en
*English - United States , 705 changes from en
*English - United States, 705 changes from en
*Español de México para niños , 140 changes from es_mx
*Español de México para niños, 140 changes from es_mx
*Español Venezuela , 157 changes from es
*Español Venezuela, 157 changes from es
*Filipino , 945 changes from tl
*Filipino, 945 changes from tl
*Finlandssvenska , 3049 changes from sv
*Finlandssvenska, 3049 changes from sv
*Français - Canada , 973 changes from fr
*Français - Canada, 973 changes from fr
*Hebrew kids , 1284 changes from he
*Hebrew kids, 1284 changes from he
*Japanese kids , 117 changes from ja.
*Japanese kids, 117 changes from ja.
*Kalaallisut , 561 changes from da
*Kalaallisut, 561 changes from da
*Lithuanian (university) , 13414 changes from lt
*Lithuanian (university), 13414 changes from lt
*Lulesamisk , 8 changes from no
*Lulesamisk, 8 changes from no
*Norsk , 798 changes from no
*Norsk, 798 changes from no
*Norsk - nynorsk , 3608 changes from no
*Norsk - nynorsk, 3608 changes from no
*Sørsamisk , 8 changes from no
*Sørsamisk, 8 changes from no
*Suomi+ , 983 changes from fi
*Suomi+ , 983 changes from fi
*Wolof , 203 changes from fr
*Wolof, 203 changes from fr


If your local language only has a few differences from an existing language, it still qualifies as a different language for Moodle, and it can have its own language pack (if someone is willing to create and maintain it).
If your local language only has a few differences from an existing language, it still qualifies as a different language for Moodle, and it can have its own language pack (if someone is willing to create and maintain it).
Line 43: Line 44:
==Defining the language code==
==Defining the language code==
For historical reasons we use the [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639-1] code for the representation of the language. If that doesn't exist, we use the [https://en.wikipedia.org/wiki/List_of_ISO_639-3_codes ISO639-3 code] (e.g. Moroccan Tamazight).
For historical reasons we use the [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639-1] code for the representation of the language. If that doesn't exist, we use the [https://en.wikipedia.org/wiki/List_of_ISO_639-3_codes ISO639-3 code] (e.g. Moroccan Tamazight).
In some exceptional cases, like the Occitan languages, we combine the [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1] code with the [https://en.wikipedia.org/wiki/List_of_ISO_639-6_codes ISO 639-6] code, eg oc_gsc (keep in mind that the [https://en.wikipedia.org/wiki/List_of_ISO_639-6_codes ISO 639-6] standard is [http://www.iso.org/iso/catalogue_detail?csnumber=43380 withdrawn]).
In some exceptional cases, like the Occitan languages, we combine the [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1] code with the [https://en.wikipedia.org/wiki/List_of_ISO_639-6_codes ISO 639-6] code, e.g. oc_gsc (keep in mind that the [https://en.wikipedia.org/wiki/List_of_ISO_639-6_codes ISO 639-6] standard is [http://www.iso.org/iso/catalogue_detail?csnumber=43380 withdrawn]).
Other exceptions includes the _kids addition for language packs for very young children and some other exceptions. These exceptions should be kept to a minimum.
Other exceptions includes the _kids addition for language packs for very young children and some other exceptions. These exceptions should be kept to a minimum.

Latest revision as of 14:54, 3 November 2022

If Moodle is not yet translated into your language and you would like to help, please create an account on the Translation site and contact our Moodle translation coordinator, Koen Roggemans, translation@moodle.org.

Once your language pack has been set up, you can follow the instructions provided in Maintaining a language pack.

First:

  • Make sure langconfig is properly set up. It would be a very good idea to ask for other translators to double-check your translation of this extremely important file by posting a request in the Translating Moodle forum.
  • Take a look at Translation priority. All files have a rating according to how urgent they need translating.

If you have any questions about using AMOS, please post in the Using AMOS forum.

Starting a child language of an existing language pack

If your country uses a variation of an existing language, that has a few (or many) differences from an existing parent language (i.e., Canadian French is a variation of French, or US English has some spelling differences from UK English), a child language might be a good solution, as only the strings that need changes have to be uploaded to AMOS. Some examples of existing child languages and the changes from the parent language for Moodle 4.0 are:

  • Català (Valencià), 4416 changes from ca
  • Dansk (kursus), 22 changes from da
  • Dansk Rum, 857 changes from da
  • Davvisámegiella, 7235 changes from no
  • Deutsch community, 246 changes from de_du
  • Deutsch - Du, 1051 changes from de
  • Deutsch - Kids, 273 changes from de_du
  • English - Pirate, 1545 changes from en
  • English for kids, 75 changes from en
  • English - United States, 705 changes from en
  • Español de México para niños, 140 changes from es_mx
  • Español Venezuela, 157 changes from es
  • Filipino, 945 changes from tl
  • Finlandssvenska, 3049 changes from sv
  • Français - Canada, 973 changes from fr
  • Hebrew kids, 1284 changes from he
  • Japanese kids, 117 changes from ja.
  • Kalaallisut, 561 changes from da
  • Lithuanian (university), 13414 changes from lt
  • Lulesamisk, 8 changes from no
  • Norsk, 798 changes from no
  • Norsk - nynorsk, 3608 changes from no
  • Sørsamisk, 8 changes from no
  • Suomi+ , 983 changes from fi
  • Wolof, 203 changes from fr

If your local language only has a few differences from an existing language, it still qualifies as a different language for Moodle, and it can have its own language pack (if someone is willing to create and maintain it).

Defining the language code

For historical reasons we use the ISO-639-1 code for the representation of the language. If that doesn't exist, we use the ISO639-3 code (e.g. Moroccan Tamazight). In some exceptional cases, like the Occitan languages, we combine the ISO 639-1 code with the ISO 639-6 code, e.g. oc_gsc (keep in mind that the ISO 639-6 standard is withdrawn). Other exceptions includes the _kids addition for language packs for very young children and some other exceptions. These exceptions should be kept to a minimum.