Hop, un nouveau plugin : Translator
http://phpwebgallery.net/ext/extension_view.php?eid=223

Ce plugin s'adresse surtout aux linguistes motivés pour aider à traduire PhpWebGallery, sa seule et unique fonction étant l'aide à la traduction des fichiers .lang.php.

Le système se veut simple, normallement on devrait être en mesure de pouvoir l'utiliser tel que, mais une petite documentation présentant ses fonctionnalités ne fera pas de mal ;)

(1) Avant de commencer...
* le plugin ne sait gérer que les fichiers encodés en iso-8859-1 ; les fichiers utilisant un autre type d'encodage (utf-8 par exemple) ne sont pas reconnus par le plugin (la gestion de l'utf-8 sera uniquement pour la version du plugin associé à pwg 1.8)
* le plugin est compatible 1.7.0 & 1.7.1
* lors de l'installation, le plugin tente de modifier une partie du code du fichier <i>include/functions_user.inc.php</i> (nécessaire pour la gestion du mode "traducteur") ; vous devez donc donner tous les droits d'accès en écriture sur ce fichier pour que l'installation puisse se faire
* le plugin refuse de s'installer si vous ne répondez pas aux trois conditions précédentes
* la version 1.0.0-béta est une version béta, il y a (certainnement) des bugs ; ne l'installez que sur un environnement de test
* le plugin n'a pour l'instant été testé qu'avec Firefox 2.0 ; l'usage du javascript et de l'ajax étant ici intensif, probable que les dysfonctionnements soient nombreux avec IE...

(2) Comment çà se présente ?
L'interface dispose de 4 onglets fig.1 (1) (un 5ème apparait lors de l'édition) :
* Status (onglet par défaut)
   > permet d'avoir une vue sur l'état des fichiers traduits
* Langues
   > permet la gestion des langues traduites
* Maintenance
   > permet la gestion des opérations de maintenance, à savoir l'export, les purges, et la synchronisation des élements de la base avec les fichiers
* Configuration
   > quelques options pour configurer le plugin selon ses goûts


En haut de l'écran, apparait une alerte si le plugin détermine que les fichiers de langues présents sur le serveur ont changés depuis leur intégration dans la base donnée fig.1 (2). Je reviendrais plus tard sur cette fonction.

Le reste de la page est constitué d'un tableau récapitulant la liste des fichiers de langues fig.1 (3a) et de l'état de leur traduction associée fig.1 (3b)


(fig.1)


En cliquant sur la ligne d'un fichier, celle-ci se déplie :
(fig.2)
Elle est découpée en 3 partie :
* Le détail de l'avancement de la traduction fig.2 (1), constitué de :
   - le nombre d'éléments restant à traduire
   - le nombre d'éléments dont la traduction reste à valider
   - le nombre d'élements traduits et validé
   - le nombre d'élements supprimés
   - le nombre total d'élements pour le fichier
* D'un lien fig.2 (2) vers un outil comparant pour le fichier, les différences sur les langues traduites (on peut voir sur l'exemple que la traduction anglaise dispose de 151 éléments et la version française dispose de 153 éléments)
* De liens fig.2 ](3) permettant :
   - d'éditer le fichier dans la langue correspondante
   - de traduire ce fichier dans une autre langue


Cliquer sur le lien comparaison nous redirige vers une page avec un nouvel onglet fig.3 (1) :
(fig.3)
Le tableau fig.3 (2) détaille la liste des éléments différents entre les fichiers.
Sélectionner les éléments souhaités et cliquer sur le bouton fig.3 (3) "Mettre à jour les éléments sélectionner" va les recréer automatiquement en base.

Il ne doit plus y avoir de différences entre les fichiers.
(fig.3b)


En retournant sur l'onglet status puis en cliquant sur la ligne du fichier en question, on constate que les deux éléments sont bien présents dans la version anglaise du fichier, avec le status "à traduire" :
(fig.4)

Cliquer sur le lien d'édition nous redirige vers une page avec un nouvel onglet fig.5 (1)) : il s'agit de la page de traduction
(fig.5)
Les caractérisques de la traduction en cours sont récapitulées fig.5 (2).

Les différentes clefs sont listées fig.5 (4) avec :
- leur nom
- leur traduction
- leur status (carré de couleur)

Il est possible de filtrer les éléments affichés en fonction de leur status fig.5 (3) ; on va filtrer les éléments avec le status "à traduire" en sélectionnant le status dans la liste déroulante. La liste des élements se rafraichit automatiquement.

Cliquer sur un élément pour le déplier :
(fig.6)
Apparaissent :
- une zone de saisie fig.6 (1) (dont on peut faire varier la taille avec le +/- à gauche) pré-renseignée de la traduction actuelle
- d'un modèle de traduction fig.6 (2)
- de la langue du modèle de traduction fig.6 (3) ; modifier la langue met à jour le modèle
- d'une aide à la traduction fig.6 (4) avec Google Translate (toutes les traductions d'une langue à une autre ne sont pas supportées, seules les couples de langues valident permettent la traduction)
- de l'historique des traductions pour la clef fig.6 (5)
- des boutons permettant les actions à mener fig.6 (6)

La traduction automatique de l'exemple nous donne :

Remove the base keys are not present in the file (the key pass status <i> deleted </ i>, the complete removal of elements of the base is not as effective purging is not conducted)

que l'on corrige par :

Remove from database keys who aren't present in the file (the key change to status <i>deleted</i>, the complete removal of elements from the database is not effective until purge is not conducted)

en faisant bien attention aux balises HTML (Google Translate les malmène un peu)

Après application de la traduction, la page est remise à jour :
- la clef passe au status "à valider"
- un bouton associé à ce status apparait et permet de valider définitivement la traduction (les sytème "à valider/validé" est mis en place pour permettre à plusieurs personnes de travailler sur la même traduction)
(fig.6b)


On veut maintenant traduire le plugin en Italien : il faut d'abord créer les caractérisitques de la langue.
Cliquer sur l'onglet langue redirige vers la page suivante :
(fig.7)
Composée :
- d'une liste des langues disponibles fig.7 (1)
- d'un lien donnant la possibilité de les éditer/supprimer fig.7 (2)
- d'un lien pour l'ajout fig.7 (3)

Le lien pour l'ajout redirige vers la page suivante :
(fig.8)
Choisir l'italien dans la liste des langues, compléter/corriger les autres champs (ils sont alimentés automatiquement lors de la sélection dans la liste, mais c'est pas forcément correct... désolé ^^;) et valider l'ajout.


En retournant sur l'onglet status on constate la présence de la nouvelle langue fig.9 (1), et l'absence de traductions pour celle-ci fig.9 (2).
(fig.9)
En dépliant le fichier que l'on veut traduire, et en cliquant sur le lien "traduire vers", une liste déroulante fig.9 (3) apparait avec la nouvelle langue (it_IT.iso-8859-1 en l'occurence). Sélectionner la langue redirige directement vers la page de traduction (tous les éléments sont créés avec le status "à traduire").


(3) Après avoir traduit, je fais quoi ?
L'onglet maintenance dispose de trois onglets :
- exporter
- purger
- analyser

L'export consiste à créer à partir des traductions présentes dans la base, les fichiers de langues. Ils sont automatiquement crées au bon endroit, que çà soit pour pwg ou pour les plugins. Celà nécessite par contre que les droits d'accès nécessaires pour l'écriture des fichiers soient alloués.

Pour procéder à l'export :
(fig.10)
- déterminer fig.10 (1) si l'on souhaite tout exporter ou exporter uniquement les fichiers sélectionnés dans la liste fig.10 (2)
- déterminer fig.10 (3) quels sont les élements à exporter ; uniquement les versions validés ou même les éléments à valider (les éléments à traduire ou supprimé ne sont jamais exportés)
- indiquer fig.10 (4) si l'on souhaite faire un export en mode traducteur, qui est l'option sélectionnée par défaut (une erreur de manip et pouf, on écrase les fichiers de langues)
- cliquer sur exporter

Un compte rendu s'édite pendant l'export (çà peut être long si on exporte beaucoup de fichiers) :
(fig.10b)


La purge consiste à supprimer définitivement de la base, les élements :
- avec le status "supprimé"
- disposant de plusieurs versions de traductions (on ne conserve alors que la dernière)
(fig.11)


L'analyse permet de visualiser les différences entre les traductions en base et les fichiers de langues, la liste présente les fichiers, et le résultat de l'analyse. Déplier les éléments permet de consulter le détail de l'analyse et de décider des actions à mener.
(fig.12)
Plusieurs cas peuvent se produirent :
- le fichier de langue sur le serveur à été modifié fig.12 (1a) et fig.12 (1b), il est alors possible :
      * de supprimer les élements en trop dans la base
      * d'importer les éléments manquants dans la base
- une langue est présente dans la base, mais il n'existe aucun fichier sur le serveur fig.12 (2), il est alors possible de supprimer la langue de la base
- un fichier existe sur le serveur, mais il n'existe pas dans la base (pas d'exemple sur la capture), il est alors possible d'importer le fichier dans la base ; si les caractéristiques de la langue n'existent pas, il est nécessaire d'aller d'abord les créer avant de pouvoir procéder à l'import

La page status affiche l'état général de l'analyse fig.1 (2) si l'option "Vérification automatique des différences de version entre la base de données et les fichiers de langues présents sur le serveur" est sélectionnée (par défaut oui) dans les options.


(4) Le mode traducteur, c'est quoi ?
L'export en mode traducteur génère un fichier .lang.phps au lieu du fichier .lang.php classique.
On bascule du mode traducteur au mode normal via le lien situé au dessus des onglets fig.13 (1).

Après bascule, tous les élements de la page pour lesquels un export en mode traducteur sont précédés d'une étoile entre crochets [*] dont la couleur correspond au status de l'élement au moment de l'export. Ce mode s'applique aussi bien à la partie administrateur qu'à la partie publique.
(fig.13)
(fig.13b)

Il permet de vérifier les élements traduits ou à traduire.
Survoler le [*] avec la souris affiche l'infobulle suivant fig.14 (1) indiquant entre autre :
(fig.14)
- le nom de la clef
- son status (en texte + couleur)
- la date de la traduction
Ces informations sont celles en cours dans la base (et non pas celles au moment de l'export)

Cliquer sur le [*] redirige vers la page de traduction avec l'élément déplié prêt à l'emploi.

A noter que, dans ce mode, les boutons des formulaires ne fonctionnent pas !
les hyperliens par contre, fonctionnent (sauf si on clique sur [*])


(5) L'installation
J'aurais peut-être du commencer par là.
Pas grand chose à dire, si ce n'est que lors du processus d'installation, un import automatique de tous les fichiers de langues trouvé est effectué. Les caractéristiques de langues sont constituées à partir des informations contenues dans les fichiers common.lang.php

Pour pouvoir être installé, le plugin nécessite que la dernière version (la 1.1.1) du plugin "Grum Plugin Classes" soit installée.
http://phpwebgallery.net/ext/extension_view.php?eid=199

Dernière modification par grum (2008-05-12 02:49:11)