Avant propos
Le terme plugin translater désigne ce plugin.
Le terme générique "module" utilisé dans le plugin translater peut désigner un plugin ou un thème installé.
Une langue peut être désignée soit par son nom (Français), soit par son code (fr).
Edition d'une langue
- Lignes grisées
- Si une ligne est grisée (Inaccessible), c'est que cette chaine est déjà traduite dans la distribution Dotclear
et que l'option "Traduire uniquement les chaines inconnues" est selectionnée dans les paramètres.
- Groupe
- C'est le nom du fichier de langue.
D'autres choix sont possibles mais Dotclear ne recherche que le groupe main de façon générique, et public pour la partie publique.
Pour de gros plugin ou tout simplement pour des raisons de commodité (!) vous pouvez vouloir séparer certaines traductions.
Il faut alors demander explicitement à Dotclear de les charger.
Par exemple si vous avez un fichier mon_plugin/locales/fr/error.po coté admin pour gérer les traductions de messages d'erreurs,
il faudra alors dans le fichier _admin.php du votre plugin charger ce fichier avec l10n::set('mon_plugin/locales/fr/error'); sans extension.
Attention dans cet exemple seul la langue fr est chargé, il faut adapter l'appel pour charger la bonne langue.
- Chaine
- C'est la chaine à traduire trouvée dans l'extension. elle est apellé avec __('ma_chaine') .
Si la ligne suivante commence par un "+", il s'agira alors de la forme pluriel de cette traduction.
Elle est appelé avec __('un singulier', '%s pluriels'), certaines langues ont jsuqu'à six formes pluriels.
- Traduction
- Traduction donnée à cette chaine pour la langue choisie.
- Existant
- Indique la traduction et l'extension qui utilise cette chaine le cas échéant.
Si javascript est activé l'icone présent avant permet de copier d'un click cette tradution
et l'icone d'après déplie la liste des traductions existantes.
- Fichier
- C'est la liste des fichiers sources ainsi que la ligne ou se trouve la chaine à traduire.
Support
Si vous souhaitez plus d'aide ou apporter votre contribution à ce plugin, voici quelques liens utiles.