[3.0.x] Comment proposer une traduction au format MODx ?

Rédigé le: 01 Oct 2010 à 08:31
- Comment proposer une traduction au format MODx ?

Cette documentation est destinée à celles et ceux qui souhaitent proposer des traductions spontanées de MODs ou répondre aux recherches de traductions des membres. Elle n'a pas pour but d'être exhaustive, elle présente juste les grandes lignes ;).

- Que doit contenir votre archive de traduction ?
Trois fichiers sont incontournables :
  • le fichier d'installation au format .xml : install_fr.xml impérativement.
  • le fichier permettant l'affichage du fichier d'installation dans votre navigateur : modx.prosilver.en.xsl
  • le fichier de licence : license.txt
En fonction du MOD, l'archive peut intégrer un répertoire contenant les fichiers langues spécifiques au format .php et/ou .txt qui sont à transférer dans le répertoire language/fr/*.* du forum.

Les fichiers langues doivent être encodés au format UTF8 sans BOM, avec les retours de ligne au Format UNIX.
Pour cela, en utilisant Notepad++, mettez dans vos paramétrages » préférences... » nouveau document/dossier »
  • format de saut de ligne » UNIX, (menu : Édition / Convertir les sauts de ligne / Convertir en format UNIX (LF) )
  • encodage » UTF-8 sans BOM. (menu : Encodage / Convertir en UTF-8 (sans BOM) )

Pour corriger un fichier mal encodé, faire comme suit :
Ouvrir le fichier » Encodage » Convertir en UTF-8 (sans BOM), enregistrez ;
Ensuite, Édition » Convertir les sauts de ligne » Convertir en Format UNIX (LF), enregistrez.

- Où trouver ces fichiers ?
Rendez-vous sur la page MODX resource center (Centre de ressources MODx) sur phpBB.com.
Cliquez sur le lien Quickstart files pour télécharger la dernière version des fichiers : Quickstart files MODx 1.2.6.
Décompressez l'archive sur votre ordinateur.

Image

Pour récupérer le fichier sample.xml, regardez un peu plus bas sur la page Centre de ressources MODx juste au-dessus d'Archive, vous y trouvez le lien Sample MODX File (prosilver, 3.0). Faites un clic droit et enregistrer sous ;).

Ou plus simple, téléchargez l'archive toute prête : Quickstart files MODx 1.2.6 :P

Image


- Création "manuelle" du fichier .xml
Pour ce faire, on utilise le fichier sample-30-126.xml - contenu dans l'archive téléchargée précédemment - qui comme son nom l'indique est un fichier exemple ;). S'il n'y est pas, vous l'insérez tout simplement.
Lorsque vous l'ouvrez dans votre navigateur, vous obtenez la page d'installation d'un MOD (informations concernant le MOD, les auteurs, les instructions, etc.)



Ouvrez-le maintenant dans un éditeur de texte (notepad++, par exemple).


Il n'y a pas à avoir peur... C'est facilement apprivoisable ;).
Ce fichier contient la majeure partie des instructions qui seront nécessaires à son élaboration. S'il vous en manque, rendez-vous ici ;).
Maintenant, il ne vous reste plus qu'à remplacer les éléments d'exemples par ceux du MOD et de renommer le fichier sample-30-126.xml en install_fr.xml.

Par exemple, si vous deviez effectuer la traduction française pour cette partie
Code: Tout sélectionner
        <title lang="en">Hello World</title>
        <title lang="nl">Hallo Wereld</title>

        <description lang="en">Quick Start Tutorial sample</description>
        <description lang="nl">Snel start tutorial voorbeeld</description>

        <author-notes lang="en">This is a tutorial, do not install this MOD</author-notes>
        <author-notes lang="nl">Dit is een tutorial, installeer deze mod niet</author-notes> 

vous le feriez ainsi
Code: Tout sélectionner
        <title lang="en">Hello World</title>
        <title lang="fr">Salut tout le monde</title>

        <description lang="en">Quick Start Tutorial sample</description>
        <description lang="fr">Tutoriel de démarrage rapide</description>

        <author-notes lang="en">This is a tutorial, do not install this MOD</author-notes>
        <author-notes lang="fr">Ceci est un tutoriel, vous ne devez pas installer ce MOD</author-notes>

fr est le code iso pour la langue française.


- Utilisation du générateur de fichier .xml en ligne
Vous avez aussi la possibilité d'utiliser le générateur en ligne pour créer votre fichier .xml.
Pour ce faire rendez-vous sur la page de MODX Install File Creator and Text / MODX Convertor.


Le formulaire est assez intuitif et ne pose pas réellement de problèmes.
Il suffit de suivre les indications des infos-bulles pour remplir les champs, puis valider en cliquant sur Download.

Par rapport à l'exemple précédent, voici ce que vous obtiendriez




Vous pouvez obtenir du support pour cette documentation dans le sujet : [Support] Comment proposer une traduction au format MODx ?

-Edité par papicx- 22/05/2013 09h20
Motif: ajout des instructions de codage des fichiers langue, mise à jour pour la version 1.2.6