Attention : vous consultez actuellement la documentation dédiée aux versions 1.x de Moodle. La documentation pour les versions 2.x de Moodle est consultable ici : Traduction 2.0, celle pour les versions 3.x de Moodle est consultable ici : Traduction 2.0 et celle pour Moodle 4.x est consultable là : Traduction 2.0.

« Traduction 2.0 » : différence entre les versions

De MoodleDocs
Aller à :navigation, rechercher
Aucun résumé des modifications
 
(19 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{En cours de traduction}}
{{Travail en cours}}
{{Moodle 2.0}}
{{Moodle 2.0}}


Ligne 33 : Ligne 31 :
Les chaînes de caractères utilisées pour l'installation de Moodle sont un cas particulier. Elles se trouvent dans le dossier ''install/lang'' de la distribution de Moodle et ne contiennent que les chaînes nécessaires au processus d'installation. Les fichiers nécessaires sont générés automatiquement à partir de la traduction normale. Ils '''ne doivent pas être modifiés manuellement'''. Les modifications aux chaînes utilisées lors de l'installation ne sont donc reportées qu'avec un léger délai, jusqu'à ce que le script ne soit lancé et que les modifications soient incorporées aux sources de Moodle.
Les chaînes de caractères utilisées pour l'installation de Moodle sont un cas particulier. Elles se trouvent dans le dossier ''install/lang'' de la distribution de Moodle et ne contiennent que les chaînes nécessaires au processus d'installation. Les fichiers nécessaires sont générés automatiquement à partir de la traduction normale. Ils '''ne doivent pas être modifiés manuellement'''. Les modifications aux chaînes utilisées lors de l'installation ne sont donc reportées qu'avec un léger délai, jusqu'à ce que le script ne soit lancé et que les modifications soient incorporées aux sources de Moodle.


== Utiliser l'outil de traduction AMOS ==
== AMOS - l'outil de traduction de Moodle ==
 
Depuis Moodle 2.0, toutes les chaînes de caractères de Moodle sont traduites via un nouvel outil appelé AMOS. Voir la page [[AMOS]] pour plus d'informations.
<p class="note">'''L'outil de traduction AMOS n'est pas encore localisable, et l'interface se présente donc complètement en anglais. La terminologie des concepts ci-dessous est par conséquent conservée pour l'instant dans la langue anglaise originale.'''</p>
 
Les responsables officiels de la maintenance des paquetages de langue peuvent créer un compte sur AMOS, à l'adresse http://lang.moodle.org/, et envoyer un courriel à [mailto:translation@moodle.org translation@moodle.org] pour que leur compte soit activé de façon à leur permettre de travailler sur leur traduction.
 
AMOS offre la possibilité de travailler collaborativement à la traduction de Moodle. Des volontaires peuvent ainsi proposer des traductions. Si vous désirez participer, créez simplement un compte sur AMOS, à l'adresse http://lang.moodle.org/. Il n'est dans cas pas nécessaire d'annoncer manuellement votre compte à translation@moodle.org. En revanche, assurez-vous de '''contacter le responsable officiel''' de la traduction de Moodle dans votre langue, afin de coordonner votre travail.
 
Pour la langue française, veuillez vous annoncer sur le [http://moodle.org/mod/forum/view.php?id=1683 forum de traduction] de [http://moodle.org/course/view.php?id=20 Moodle en français].
 
=== Concepts de base ===
 
AMOS est constitué de plusieurs outils, accessibles au travers du bloc de navigation principal, ainsi que d'un dépôt où sont stockés les chaînes de caractères.
 
Les outils sont : ''Translator'', ''Stage'', ''Stashes'' et ''Log''. Le dépôt est le ''Repository''.
 
* ''Translator'' : l'outil permettant d'afficher et de filtrer les chaînes sur lesquelles l'on veut travailler et de le traduire
* ''Stage'' : une zone de dépôt temporaire contenant les chaînes traduites durant la session en cours
* ''Stash'' : la sauvegarde d'un ''stage''. Analogue à un fichier de votre ordinateur dans lequel vous enregistreriez votre travail. Il est possible de partager votre ''stash'' avec le responsable officiel de la traduction de votre langue par ce que l'on appelle une ''pull request''. Au pluriel, on écrit ''stashes''.
* ''Repository'' : une base de données de toutes les chaînes de caractères de l'interface de Moodle, ainsi que leur historique : anciennes versions de la traduction, etc. Le ''repository'' est hébergé sur le serveur lang.moodle.org
* ''Log'' : affichage de l'historique de toutes les modifications des chaînes de caractères de Moodle.
 
[[image:AMOS-workflow.png]]
 
=== Utilisation de ''Translator'' ===
 
Les filtres de ''Translator'' permettent d'afficher les chaînes que vous voulez traduire. De nombreuses options de filtrage sont disponibles. Il est possible de travailler sur un seul composant ou sur toutes les chaînes manquantes. On peut rechercher les chaînes contenant une expression donnée (en anglais ou dans la chaîne traduite), etc. Il est également possible de consulter les chaînes des anciennes versions de Moodle, mais celles-ci sont en lecture seule et ne peuvent pas être modifiées dans AMOS. Elles sont importées vers AMOS à partir du CVS.
 
En cliquant sur le champ destiné à recevoir la traduction, celui-ci devient modifiable et l'on peut y entrer la traduction. Pour valider la traduction et l'envoyer vers le ''Stage'', il suffit de cliquer en dehors du champ.
 
=== Utilisation de ''Stage'' ===
 
The translated strings are put into a temporary area called ''stage'' immediately after the cursor leaves the editor field. The stage holds your work before it is either committed into the repository (if you are language pack maintainer) or is stashed and offered to the maintainers for inclusion.
 
The stage is destroyed when you logout. You have to explicitly commit or stash the stage so it is saved permanently. If you forget to do it, or there is a problem with the connectivity, your browser crashes or whatever, you can find your most recent snapshot of the stage in AUTOSAVE stash.
 
If you are language pack maintainer, you can commit the stage into the repository so your work is registered and the translated strings become part of the official language package. Language packages in ZIP format are generated every hour (at 45 mins) and are published at http://download.moodle.org/langpack/2.0/. At the same time, they become available for Moodle sites for automatic update.
 
=== Utilisation de ''Stashes'' ===
 
At any moment, you can save a snapshot of the current stage. We call such snapshot a ''stash''. Stashed strings are kept forever until you drop them manually (please do not abuse this and keep your stashes reasonable big). The stash can be ''applied'' so that the stashed strings are copied back to the stage.
 
Your stash can be also offered to the official language pack maintainers for inclusion into the repository. Once you have a bulk of translation finished in your stage, just stash it and create ''pull request''. This will mark the stash as available for the maintainers and they will be able to apply it into their stage, review your work and eventually commit it. Please note that the maintainers are not sent any notification on new pull requests (this is intentional to prevent spamming). Just use either Moodle messaging subsystem or direct email to inform the maintainer about the pull request. We believe that all contributors should be in contact with the official maintainer anyway and AMOS should not try to replace this kind of communication.
 
Your pull request is available to the maintainers of all languages that your stash modifies. Once you receive a confirmation from the maintainers that your work has been accepted, you should drop the offered stash.
 
There is one special stash record for every user called AUTOSAVE. This stash keeps the most recent state of the stage. You may find it useful if you loose the current stage for any reason - your browser crashes, your internet connectivity dies or you accidentally unstage all strings. If that happens, just apply the AUTOSAVE stash to get your work back. The AUTOSAVE stash is updated every time you stage a string. So if your stage is empty and your AUTOSAVE is full of strings and you go into the Translator first without applying the stash, the AUTOSAVE will be replaced with the new translated string. We recommend to experiment a bit with this feature first.
 
=== Utilisation de ''Log'' ===
 
Cet outil affiche les modifications effectuées dans les chaînes de caractères de Moodle. Il n'est pas encore complètement implémenté. Des filtres sont prévus, qui permettront de rechercher des modifications spécifiques de chaînes, de façon analogue à l'outil ''Translator''.


[[Catégorie:Langue]]
[[Catégorie:Langue]]


[[en:Translation 2.0]]
[[en:Translation 2.0]]

Dernière version du 17 janvier 2011 à 11:07

Moodle2.0


Moodle 1.x

Le texte ci-dessous décrit le processus de traduction de Moodle pour les versions 2.0 et ultérieures. Pour Moodle 1.x, veuillez consulter la page Traduction.

Résumé des modifications depuis Moodle 1.x

  • Les traductions ne sont plus gérées dans le CVS. Elles sont stockées dans une base de données sur http://lang.moodle.org
  • Une application web est utilisée pour le processus de traduction
  • Tous les plugins définissent maintenant leurs chaînes de caractères dans leur propre dossier, y compris les plugins officiels, comme c'était déjà le cas pour les plugins contribués par des tiers
  • Le nom des dossiers des paquetages de langue ne comportent plus le suffixe _utf8
  • Les fichiers d'aide HTML ont été remplacés par des chaînes de caractères d'aide dont l'identifiant comporte le suffixe _help
  • Les paramètres pour variables doivent être entourés d'accolades, par exemple {$a} ou {$a->blabla}
  • Il n'y a plus besoin de placer une barre oblique inversée avant les guillemets droits dans les chaînes de caractères

Structure d'un paquetage de langue pour Moodle 2.x

La distribution standard de Moodle ne comporte que le paquetage de langue anglais. Tous les autres paquetages doivent être ajoutés manuellement à votre installation. Les chaînes en anglais pour le cœur de Moodle, c'est-à-dire ses sous-systèmes principaux (administration, carnet de notes, rôles, etc.) se trouvent dans le dossier lang/en de la distribution de Moodle. Par exemple, les chaînes concernant l'évaluation des activités sont définies dans le fichier lang/en/grades.php. Les chaînes de caractères de tous les autres composants de Moodle (modules d'activité, blocs, plugins d'inscription, etc.) se trouvent dans un dossier lang/en situé dans le dossier du composant concerné. Par exemple, les chaînes du module Atelier se trouvent dans le fichier mod/workshop/lang/en/workshop.php.

Les traductions sont situées dans le dossier de données moodledata de Moodle, dans le sous-dossier lang. Par exemple, la traduction en italien se trouve dans le dossier lang/it/. Les traductions de tous les composants préinstallés (coeur et plugins) y sont stockées. La traduction française du module Atelier est par exemple stockée dans moodledata/lang/fr/workshop.php et celle des chaînes concernant l'évaluation des activités dans moodledata/lang/fr/grades.php (notez la différence par rapport aux chaînes de caractères du paquetage anglais).

Les fichiers de langue ont tous l'extension .php (comme moodle.php ou admin.php). Ces fichiers contiennent de brèves expressions ou phrases, appelées chaînes de caractères ou simplement chaînes. Les chaînes contiennent parfois des paramètres pour la substitution de variables. Ces paramètres sont remplacés par certaines valeurs lorsque la chaîne est affichée. Les chaînes sont stockées dans un tableau PHP dénommé $string. La clef du tableau est appelée identifiant de la chaîne ou nom de la chaîne. Exemples :

$string['addnewcourse'] = 'Ajouter un cours';
$string['hidesection'] = 'Cacher la section {$a}';
$string['uploadedfileto'] = '{$a->file} déposé dans {$a->directory}';

La définition de ces chaînes est utilisée par la fonction get_string() pour être affichée (voir lib/moodlelib.php). Si une chaîne n'est pas traduite dans une langue, Moodle essaie de la trouver dans une langue dite parente. S'il n'y a pas de langue parente définie pour cette langue ou que la langue parente ne définit pas non plus la chaîne, c'est le texte anglais qui est alors utilisé automatiquement.

Les chaînes de caractères utilisées pour l'installation de Moodle sont un cas particulier. Elles se trouvent dans le dossier install/lang de la distribution de Moodle et ne contiennent que les chaînes nécessaires au processus d'installation. Les fichiers nécessaires sont générés automatiquement à partir de la traduction normale. Ils ne doivent pas être modifiés manuellement. Les modifications aux chaînes utilisées lors de l'installation ne sont donc reportées qu'avec un léger délai, jusqu'à ce que le script ne soit lancé et que les modifications soient incorporées aux sources de Moodle.

AMOS - l'outil de traduction de Moodle

Depuis Moodle 2.0, toutes les chaînes de caractères de Moodle sont traduites via un nouvel outil appelé AMOS. Voir la page AMOS pour plus d'informations.