Translation: Difference between revisions

From MoodleDocs
(rewording (work in progress))
 
(27 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Language}}
{{Translation}}
 
==So you'd like to help with translating Moodle?==
==So you'd like to help with translating Moodle?==


Great! :-) Please check the [[dev: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 of Moodle LMS  and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.
 
Otherwise, check the [[:dev:Translation credits|Translation credits]] and contact the maintainer of your language pack to ask where you can help. The name at the top of the list for each language is the current language pack maintainer. (If you don't receive a response within a reasonable time, email Koen [mailto:translation@moodle.org translation@moodle.org].)
 
==Getting started==
 
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''.
 
To help with translating Moodle
 
# [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.
# 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]].
 
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.


== How do language packs work? ==
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]].


A standard Moodle comes with an English language pack only. It is installed in ''moodledata/lang/en.'' Extra language packs are normally installed directly from within Moodle from ''Administration>Language>Language packs'', but in some cases you might need to
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.
install them via FTP to your moodledata folder into the folder ''lang''.


The English language terms (or 'strings')  for the main (core) Moodle features such as administration, roles etc, are stored in ''lang/en.'' Language files relating to modules, blocks and add-ons are stored with the files of that particular module, block or add-on. So if you wanted to see the language strings for the badges block for example, you would look in ''blocks/badges/lang/en''. If you wanted to see the language files for the workshop module, you would look in'' mod/workshop/lang/en''
Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [[Translating Moodle Academy]]


==Wish to take on responsibility for a language pack?==


If you install another languge pack, you will then get  a folder  such as ''lang/fr'' which would have French translations of Moodle terms. Unlike with English, other language  packs such as  ''lang/fr'' will contain all translations along with the main core terms so you would find see for example the badges strings in ''lang/fr/block_badges.php'' and the workshop strings in ''lang/fr/workshop.php''
Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.


These files (which all end in .php) contain short phrases, often called "strings". Strings may contain a placeholder (between the square brackets below) This placeholder is replaced with the chosen words from the language pack when the string is displayed. The term between the square brackets is called the 'string identifier'  or the 'string name'. Examples:
==Is Moodle not yet translated into your language?==


  $string['addnewcourse'] = 'Add a new course';
Please see [[Starting a new language pack]].
$string['hidesection'] = 'Hide section {$a}';


If a string hasn't been translated, then Moodle will use the parent language or the original English version. Thus, you might see a Moodle site where some terms have been translated into a language but others still display in English.
==Any questions?==


==See also==
Please check the [[Translation  FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].


* [[Translation FAQ]]
* [[dev:Translation langconfig|Settings in langconfig]]


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

Latest revision as of 10:08, 5 August 2022


So you'd like to help with translating Moodle?

Great! :-) All translation of Moodle LMS and the plugins 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.

Did you end up here, wanting to translate the Moodle Academy courses, please start at Translating Moodle Academy

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.