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).
La configuration du plugin translater est importante, elle permet d'affiner les automatismes du plugin
et ainsi de gagner beaucoup de temps dans la gestion des traductions.
Traduction
- Ecrire les fichiers
.lang.php
- C'est le format rapide des fichiers de langues.
Le fichier de langue .po étant la norme, le plugin translater le génère automatiquement lors de la création ou édition d'une langue,
cependant vous pouvez souhaiter générer le fichier .lang.php, il sera alors utilisé par défaut.
- Traduire également les chaines des fichiers de template
- Cette option permet de traduire les balises de langage des fichiers .html. Ex :
{{tpl:lang Lorem}}.
- Traduire uniquement les chaines inconnues
- Cette option est recommandée. Les chaines déjà traduites dans Dotclear sont alors grisées et non modifiable.
- Ecrire les commentaires dans les fichiers
- Pratique durant la phase de développement d'une extension, les noms et lignes relatives à la chaine sont alors spécifiés dans le fichier de langue.
Il est conseillé de désactiver cette option lors de la réalisation de version finale afin d'avoir des fichiers plus légers.
- Ecrire les informations à propos de l'auteur
- Ajoute aux fichiers de langue (si les commentaires sont actifs) des informations (pour peu qu'elles existent) à propos de l'auteur de la traduction.
Les masques suivants sont acceptés :
- displayname : pseudo de l'auteur
- firstname : prénom de l'auteur
- name : nom de l'auteur
- email : email de l'auteur
- url : site de l'auteur
Import/Export
- Ecraser les langages existants
- Si cette option est activée, lors de l'importation d'un paquetage de langues, les langues contenues dans ce paquetage remplacent celles existantes dans le module.
- Nom du paquetage exporté
- C'est le nom par défaut du fichier zip lorsque vous exportez des sauvegardes.
- Il accepte les masques suivants :
- type : plugin ou thème
- module : nom du module
- version : la version du module
- timestamp : le temps unix
- %Y%m%D.... : les masques de date Dotclear
Exemple : type-module-l10n-timestamp
Sauvegardes
Faire une sauvegarde quand des changements sont effectués
Permet de faire automatiquement des sauvegardes des fichiers de langue d'un module à chaque changement enregistré.
Limiter les sauvegardes à x fichiers par module
Permet de limiter le nombre de sauvegarde par module afin de ne pas prendre trop de place sur la plateforme.
Les sauvegardes ne sont pas effacées automatiquement. Il faut alors le faire dans le plugin translater depuis la liste des sauvegardes d'un module.
Enregistrer les sauvegardes dans :
Plusieurs choix de lieu de sauvegarde s'offrent :
- Repertoires locales de chaque module
- Repertoire racine des plugins
- Repertoire public (du blog en cours)
- Repertoire cache de Dotclear
- Repertoire unique du plugin translater
Le répertoire choisi doit être accessible en écriture au plugin translater.
Comportements
- Menu de départ par défaut
- Permet de choisir quelle page apparaît lors de l'accès au plugin translater.
- Activer le menu de la page des plugins
- Ajoute le bouton Traduire à chaque plugin sur la page de gestion des plugins.
- Activer le menu de la page des thèmes
- Ajoute le bouton Traduire dans les détails de chauqe thème de la gestion d'apparence du blog.
- Tableau de bord
- Il est possible d'ajouter le plugin translater au tableau de bord. La gestion de ces icones se fait depuis les préférences utilisateur de Dotclear.
Support
Si vous souhaitez plus d'aide ou apporter votre contribution à ce plugin, voici quelques liens utiles.