Help:Extension:Translate/Group configuration/fr

Il existe plusieurs manières d'ajouter des groupes de messages à l'extension Translate. Les groupes de messages sont des ensembles de messages. Habituellement ils font correspondre un module logiciel à un fichier (et généralement un par langue pour les traductions). Il est également possible de créer des groupes qui contiennent les messages issus d'autres groupes de messages. On peut concevoir par exemple un groupe qui contienne tous les messages d'un logiciel particulier. Les groupes peuvent également contenir simplement des sous ensembles de messages, tels les messages les plus importants de MediaWiki qui doivent être traduits en priorité. Ce groupes de niveau supérieur ne correspondent pas directement aux fichiers quelque soit le format, mais comme tous les groupes, ils peuvent être exportés dans le format Gettext pour être utilisés dans d'autres outils de traduction.

Les groupes de messages sont les blocs de haut niveau avec lesquels les traducteurs interagissent ; pour choisir un message sur lequel travailler ils doivent d'abord choisir un groupe, à moins qu'ils utilisent la recherche de traductions. Chaque groupe possède ses statistiques ainsi qu'un identifiant unique. Naturellement les messages sont le plus petit bloc de texte que les traducteurs traduisent à la fois. Chaque message possède également un identifiant que l'on appelle habituellement clé. La clé n'a pas besoin d'être unique sur l'ensemble des groupes de messages.



Format classique de configuration des groupes
Il est facile d'ajouter des groupes de messages en utilisant le format YAML. Tout ce que vous avez à faire est de définir un espace de noms et d'ajouter un fichier de configuration à ; voir la page de configuration pour plus de détails. Exemple :

Le fichier lui-même utilise la syntaxe YAML. La syntaxe en elle même n'est pas décrite ici mais elle est facile à apprendre et vous pouvez utiliser tous les groupes prédéfinis comme exemples. N'oubliez pas d'utiliser des espaces à la place des caractères de tabulation pour l'indentation. Chaque fichier peut définir plusieurs groupes de messages. Chaque définition de groupe est séparée par une ligne de trois tirets, qui est le séparateur classique des documents en YAML.

Les définitions se classent en quelques éléments de niveau supérieur : BASICFILESMANGLERVALIDATORSINSERTABLESTAGSAUTOLOADLANGUAGES et le TEMPLATE spécial. Certains groupes personnalisés peuvent ajouter d'autres éléments au niveau supérieur. Tous les groupes n'ont pas besoin de définir l'ensemble des éléments.

BASIC
Cette section contient les informations de base à propos du groupe, comme son ID unique et son nom. Liste des clés possibles (les clés obligatoires sont marquées avec *) :

Exemple :

FILES
Cette section décrit l'aspect du système de fichiers et le format des fichiers de messages pour les groupes du type FileBasedMessageGroup. Liste des clés possibles (les clés obligatoires sont marquées avec *) :

Les variables des chemins sont :

Exemple :

MANGLER
Mangler is a way to mungle message keys to avoid conflicting message keys in multiple groups:

Exemple :

VALIDEURS
Cette section permet de définir des valideurs prédéfinis ou personnalisés.

INSERTABLES
This section allows to define a class which suggests insertables or use pre-defined insertables. The classes can be autoloaded as described in the AUTOLOAD section.

TAGS
It is possible to assign tags to messages. Each tag takes list of message keys (after mangling). "*" can be used as wildcard. The following tags are supported:

Exemple :

AUTOLOAD
This item takes list of class names with filenames as values. This way custom classes can be bundled easily with your custom message groups. The path should be relative to the location of the group configuration file itself.

Exemple :

TEMPLATE
There is a handy shortcut if you are defining multiple similar message groups. To avoid repetition, have the first definition start with this key. You can use any other top-level keys as subkeys for this item. All other groups will use these definitions as default values. Each group can of course override the default value from the template.

Exemple : 

GROUPS (pour la classe AggregateMessageGroup)
This key only takes list of group ids this message group consists of.

Exemple :

Wildcards are supported. In this case the aggregate group will not recursively include itself even if it matches a pattern. Example:

Wildcards can be problematic if you have nested aggregate groups, because some groups can be included multiple times: both directly and via the included aggregate groups.

LANGUAGES
This key makes it possible to allow and disallow translation into specific languages for the group. Translation into disallowed languages will be blocked.

Allowed ("include") entries override any values in the disallowed ("exclude") list. If an allowed entry is  that means all languages are allowed. The allowed list is also optional.



Groupes de messages pour les messages d'interface spécifiques à votre wiki
Example of message group for custom user interface of the wiki, for example for localized sidebar. Add the following code into your  and replace wikiname with something meaningful.



Raccourcis des extensions MediaWiki
Voir le groupe d'unités pour MediaWiki.