Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Translation: Difference between revisions

From MoodleDocs
m (Protected "Translation": Developer Docs Migration ([Edit=Allow only administrators] (indefinite)))
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:Migrated|newDocId=/general/development/process/translation}}
{{Translation}}
{{Translation}}
{{Work in progress}}
==So you'd like to help with translating Moodle?==
==So you'd like to help with translating Moodle?==


Great! :-) Please check the [[Language packs without maintainer|list of language packs without maintainer]]. If your language is listed, and you'd like to volunteer to become language pack maintainer, email our translation coordinator, Koen, [mailto:translation@moodle.org translation@moodle.org].
Great! :-) All translation happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.


Otherwise, check the [http://lang.moodle.org/local/amos/credits.php Translation credits] and contact the maintainer of your language pack to ask where you can help. (If you don't receive a response within a reasonable time, email Koen [mailto:translation@moodle.org translation@moodle.org].)
Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].  


==Getting started==
Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.


The Moodle languages portal http://lang.moodle.org/ enables translators to work collaboratively on language packs and submit translations using a special Moodle translation tool called ''AMOS''.
==Wish to take on responsibility for a language pack?==


To help with translating Moodle
Please see [[Maintaining a language pack]] and the [[AMOS manual]]  for further information about the AMOS translation toolkit.


# [http://lang.moodle.org/login/signup.php Create an account] on the portal, making sure you provide your full name (in order for you to receive credit for your translation work) and contact email.
==Is Moodle not yet translated into your language?==
# See the info [http://lang.moodle.org/mod/page/view.php?id=9 Help for newcomers].
# Access the AMOS translation tool via the link in the navigation block and see the [[AMOS|AMOS documentation]].
# Check the [https://docs.moodle.org/dev/Translation_langconfig langconfig] file first, before translating other files.


If you have any questions, please enrol in the [http://lang.moodle.org/course/view.php?id=2 Translating Moodle course] and join the discussions there.
Please see  [[Starting a new language pack]].


==Moodle placeholders must not be translated==
==Any questions?==
The following words, when enclosed within {curly brackets}, are placeholders for Moodle names of variables. They should not be translated, but must remain as they are within the curly brackets:


'''firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe , institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername , deleted, suspended, course1, course2, course3, course4'''
Please check the [[Translation  FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].
 
They must also be written exactly like this in all translations of the documentation pages (such as this page.)However, the documentation writer/translator might like to include a translation enclosed in brackets. For example, in the Spanish documentation pages you might find: password (''contraseña'').
 
The fact is: '''no placeholders can be translated in AMOS'''. There is no official list of "reserved" $a properties. Whatever xyz is put in {$a->xyz}, it must be kept as it is in AMOS.
 
Example:
 
[[File:26 AMOS fullnamedisplay_core original.png]]
 
'''Must''' be (in this case, when translated into Mexican Spanish):
 
[[File:26 AMOS fullnamedisplay_core.png]]
 
unless your language uses lastname before the firstname, as Japanese does, which translates to:
 
[[File:26 AMOS fullnamedisplay_core Japanese.png]]
 
==Non-translatable strings==
While AMOS does a great job for translating the Moodle core and most Moodle plugin language strings, some English language strings are (as of July 2013) not yet available for translation with AMOS.
 
The plugins classified as '[https://moodle.org/plugins/browse.php?list=category&id=38 Other] ' are not translatable by AMOS (see [http://lang.moodle.org/mod/forum/discuss.php?d=3113 this forum thread]). You can use the [[:en:Language customization|language customization]] tool within your Moodle (production or local) server to produce the .php file cointaining the translated language strings for your language and email this file to the particular 'other' plugin maintainer, so that it can be included in the lang folder within the downloadable Zip file for the plugin.
 
==Looking for translated plugins in the Moodle plugins database==
* According to [http://lang.moodle.org/mod/forum/discuss.php?d=2485 http://lang.moodle.org/mod/forum/discuss.php?d=2485], almost all contributed plugins published in Moodle Plugins directory have been imported into [http://lang.moodle.org/ AMOS] and are ready to be translated.
* When a user is looking at the [https://moodle.org/plugins/ Moodle plugins database], in ' Description tab > Useful links section' there is a link to 'Contribute translation for (your preferred language)' that points to [http://lang.moodle.org/ AMOS].
* Have a look at an example for the very popular [https://moodle.org/plugins/view.php?plugin=mod_hotpot HotPot] plugin:
 
[[File:Link to Plugin translations in Moodle plugins database.png|300px]]
 
* You can click on the 'Contribute translation for (your preferred language)' link.
* '''CURRENTLY:''' If you do not have an account in AMOS, you would have to 'Create a new account' by using the appropiate link.
* If you have a translator account at AMOS, you can use AMOS to contribute a translation.
* If the user then selects all the language packs (except English fixes) and writes 'pluginname' in the box for 'String identifier', AMOS will display the name of the plugin in all available translations.
* Make sure that you have selected the Moodle branch(es) that you are interested in (eg, 2.5 in the image below).
 
[[File:Plugins translations in AMOS.png|400px]]
 
* In the above example, there are a total of 123 different language packs registered in AMOS; 63 of these are missing a translation for HotPot, which means thet there are 60 different language translations already available for the HotPot plugin, a fair number for this popular plugin :)
* When no translation is available for any/many language(s), the box named 'Translation' will be empty for those languages.
* If a plugin name has been translated, there is a fair chance (but no certainty) that this plugin has been (completely) translated into that language. You can change the settings in AMOS and check for yourself.
* Please help Moodle users in other languages by translating your favorite plugins :)
* You can find the plugins with the largest number of downloads in the last year (or in the last two months) at [https://moodle.org/plugins/stats.php https://moodle.org/plugins/stats.php]. These are the plugins most likely to be most useful when translated to your language. It would probably be a good idea to translate them first.


==See also==
==See also==


* [[Translation priority]] - a useful list (albeit incomplete) categorising the priority in which strings should be translated.
* [https://download.moodle.org/langpack/3.8/ Language packs for Moodle 3.8] for the percentage of language strings translated in each language pack for the current Moodle branch
* [[Translation langconfig|Settings in langconfig]]


[[fr:Traduction]]
[[fr:Traduction]]
[[de:Übersetzung]]
[[de:Übersetzung]]
[[es:Traducción]]
[[es:Traducción]]

Revision as of 07:41, 25 May 2022

Important:

This content of this page has been updated and migrated to the new Moodle Developer Resources. The information contained on the page should no longer be seen up-to-date.

Why not view this page on the new site and help us to migrate more content to the new site!

So you'd like to help with translating Moodle?

Great! :-) All translation happens on our Moodle translation site, so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to Contributing a translation.

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the Translation credits and ask where you can help.

Wish to take on responsibility for a language pack?

Please see Maintaining a language pack and the AMOS manual for further information about the AMOS translation toolkit.

Is Moodle not yet translated into your language?

Please see Starting a new language pack.

Any questions?

Please check the Translation FAQ and join us in the Using AMOS forum.

See also