Diferencia entre revisiones de «20/Traducción»

De MoodleDocs
m (tidy up)
(tidy up)
 
(No se muestran 11 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
{{Idioma}}
{{Frequently updated page translation
{{chafa}}
|devpagetitle = Translation
{{Moodle 2.x}}
}}{{Idioma}}
Vea [https://docs.moodle.org/24/en/Translation Translation]
{{Moodle 2.0}}


==Si Usted quiere ayudar con la traducción de Moodle==
==Así es que Usted quiere ayudar a traducir  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! :-) 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].


Otherwise, check [https://docs.moodle.org/24/en/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].)
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].)


==Empezar a traducir==
==Cómo empezar==


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''.  
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''.  
Línea 18: Línea 18:
# [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.
# [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].
# 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 [https://docs.moodle.org/24/en/AMOS AMOS documentation].
# Access the AMOS translation tool via the link in the navigation block and see the [https://docs.moodle.org/25/en/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.
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.
== ¿Cómo funcionan los paquetes de idioma? ==
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
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''
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''
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:
$string['addnewcourse'] = 'Add a new course';
$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.


== Información preliminar: Estructura de un paquete de idioma de Moodle ==
== Información preliminar: Estructura de un paquete de idioma de Moodle ==
Línea 26: Línea 47:
The standard Moodle distribution comes with an English language pack only. All other languages must be added to your installation. The English strings for Moodle core (that is the main subsystems like administration, gradebook, roles etc) can be found in ''lang/en/'' folder of your Moodle installation. For example, grading related strings are defined in ''lang/en/grades.php''. All other Moodle components (like activity modules, blocks, enrolment plugins etc) define their own strings in ''lang/en/'' folder within the plugin directory. For example, Workshop module defines its strings in ''mod/workshop/lang/en/workshop.php''.
The standard Moodle distribution comes with an English language pack only. All other languages must be added to your installation. The English strings for Moodle core (that is the main subsystems like administration, gradebook, roles etc) can be found in ''lang/en/'' folder of your Moodle installation. For example, grading related strings are defined in ''lang/en/grades.php''. All other Moodle components (like activity modules, blocks, enrolment plugins etc) define their own strings in ''lang/en/'' folder within the plugin directory. For example, Workshop module defines its strings in ''mod/workshop/lang/en/workshop.php''.


Translations are located in your ''moodledata'' directory, in folder ''lang/xx/''. Translations of all the components - both core and plugins - are stored there. For example, the Czech translation of the Workshop module is stored in ''moodledata/lang/cs/workshop.php'' and grade-related strings in ''moodledata/lang/cs/grades.php'' (note the difference against the English strings). The [[Translation priority]] page gives you a quick overview about the lang files, the content and makes a suggestion about priorities for translation.  
Translations are located in your ''moodledata'' directory, in folder ''lang/xx/''. Translations of all the components - both core and plugins - are stored there. For example, the Czech translation of the Workshop module is stored in ''moodledata/lang/cs/workshop.php'' and grade-related strings in ''moodledata/lang/cs/grades.php'' (note the difference against the English strings). The [https://docs.moodle.org/25/en/Translation_priority Translation priority] page gives you a quick overview about the lang files, the content and makes a suggestion about priorities for translation.  


The language files all have a .php extension (eg ''moodle.php'' or ''workshop.php''). These files contains short phrases, often called "strings". Strings may contain a placeholder for variable substitution. The placeholder is replaced with a certain value when the string is displayed. Strings are stored in PHP array called $string. The item key in this array is called ''string identifier'' or ''string name''. Examples:
The language files all have a .php extension (eg ''moodle.php'' or ''workshop.php''). These files contains short phrases, often called "strings". Strings may contain a placeholder for variable substitution. The placeholder is replaced with a certain value when the string is displayed. Strings are stored in PHP array called $string. The item key in this array is called ''string identifier'' or ''string name''. Examples:
Línea 44: Línea 65:
* All plugins now define their English strings in the plugin folder, as contrib plugins used to
* All plugins now define their English strings in the plugin folder, as contrib plugins used to
* Language codes no longer have a _utf8 suffix
* Language codes no longer have a _utf8 suffix
* HTML help files have been replaced with [[Development:Help strings|strings with a _help suffix]]
* HTML help files have been replaced with [https://docs.moodle.org/24/en/Development:Help_strings strings with a _help suffix]
* Placeholders must be wrapped in curly braces
* Placeholders must be wrapped in curly braces
* Double quotes should not be escaped any more in the string definition
* Double quotes should not be escaped any more in the string definition
Línea 51: Línea 72:


==Vea también==
==Vea también==
 
* [https://docs.moodle.org/25/en/Translation_priority Translation priority] - a useful list (albeit incomplete) categorising the priority in which strings should be translated.
* [https://docs.moodle.org/24/en/Translation_FAQ Translation FAQ]
* [[Traducción FAQ]]
* [https://docs.moodle.org/dev/Translation_langconfig Settings in langconfig]
* [https://docs.moodle.org/dev/Translation_langconfig Settings in langconfig]



Revisión actual - 19:27 16 ago 2014

Nota: Esta es una traducción de una página de la documentación para desarrolladores (Developer docs), que se considera particularmente importante, y que en su versión original se actualiza frecuentemente. Por ello, se le recomienda que revise la página original en idioma inglés: Translation.

Moodle 2.0


Así es que Usted quiere ayudar a traducir Moodle?

Great! :-) Please check the 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, translation@moodle.org.

Otherwise, check the 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 translation@moodle.org.)

Cómo empezar

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

  1. 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.
  2. See the info Help for newcomers.
  3. Access the AMOS translation tool via the link in the navigation block and see the AMOS documentation.
  4. Check the langconfig file first, before translating other files.

If you have any questions, please enrol in the Translating Moodle course and join the discussions there.

¿Cómo funcionan los paquetes de idioma?

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 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


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

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:

$string['addnewcourse'] = 'Add a new course';
$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.


Información preliminar: Estructura de un paquete de idioma de Moodle

The standard Moodle distribution comes with an English language pack only. All other languages must be added to your installation. The English strings for Moodle core (that is the main subsystems like administration, gradebook, roles etc) can be found in lang/en/ folder of your Moodle installation. For example, grading related strings are defined in lang/en/grades.php. All other Moodle components (like activity modules, blocks, enrolment plugins etc) define their own strings in lang/en/ folder within the plugin directory. For example, Workshop module defines its strings in mod/workshop/lang/en/workshop.php.

Translations are located in your moodledata directory, in folder lang/xx/. Translations of all the components - both core and plugins - are stored there. For example, the Czech translation of the Workshop module is stored in moodledata/lang/cs/workshop.php and grade-related strings in moodledata/lang/cs/grades.php (note the difference against the English strings). The Translation priority page gives you a quick overview about the lang files, the content and makes a suggestion about priorities for translation.

The language files all have a .php extension (eg moodle.php or workshop.php). These files contains short phrases, often called "strings". Strings may contain a placeholder for variable substitution. The placeholder is replaced with a certain value when the string is displayed. Strings are stored in PHP array called $string. The item key in this array is called string identifier or string name. Examples:

$string['addnewcourse'] = 'Add a new course';
$string['hidesection'] = 'Hide section {$a}';
$string['uploadedfileto'] = 'Uploaded {$a->file} to {$a->directory}';

These strings definition can be then used by get_string() function (see lib/moodlelib.php). If a string doesn't exist in a particular language, Moodle tries to find it in the so called parent language. If there is no parent language defined or it does not define the requested string, then the equivalent in English will automatically be used instead.

Installation language packs may be found in the install/lang folder. These language packs contain only the strings needed for the installation process. The files are generated automatically and must not be changed manually. For translators this is a unusual experience, since changes you add to the strings used in the installation script will not be visible until our script is run and commits them into Moodle sources.

Resumen de cambios desde Moodle 1.9

  • Translations are not kept in CVS any more but in a database at http://lang.moodle.org
  • A web interface is used to translate strings
  • All plugins now define their English strings in the plugin folder, as contrib plugins used to
  • Language codes no longer have a _utf8 suffix
  • HTML help files have been replaced with strings with a _help suffix
  • Placeholders must be wrapped in curly braces
  • Double quotes should not be escaped any more in the string definition

For details of the translation process in versions of Moodle prior to 2.0, see Translation pre-2.

Vea también