Traductions
Traductions
Tous les textes de l'interface de Dokos sont traduisibles. Si un texte n'est pas traduit, ouvrez un ticket sur GitLab (il faut un compte GitLab) ou signalez-le sur le forum.
Fichiers de traduction
Dokos utilise le format gettext. Chaque application a un dossier locale/ :
| Fichier | Contenu |
|---|---|
<app>/locale/main.pot | Modèle : tous les textes traduisibles de l'application. |
<app>/locale/fr.po | Traductions d'une langue (ici le français). |
Exemples : frappe/locale/fr.po dans le dépôt Dodock, erpnext/locale/fr.po dans le dépôt Dokos.
bench build compile les fichiers .po en fichiers .mo dans sites/assets/locale/. Dokos lit les fichiers .mo.
Textes traduisibles dans le code
En Python, entourez le texte de _() :
from frappe import _
frappe.msgprint(_("Invoice {0} submitted").format(doc.name))
En JavaScript, utilisez __(), avec la liste des valeurs à remplacer en deuxième argument :
frappe.msgprint(__("Invoice {0} submitted", [doc.name]));
Écrivez le texte source en anglais. La traduction française est dans le fichier fr.po.
Contexte
Un même mot peut avoir plusieurs traductions. Un contexte les distingue :
_("Apply", context="Job Opening")
__("Apply", null, "Job Opening");
Dans le fichier .po, le contexte est la ligne msgctxt :
msgctxt "Job Opening"
msgid "Apply"
msgstr "Postuler"
Les libellés des champs d'un formulaire sont traduits avec le nom du type de document comme contexte. Sans traduction pour ce contexte, Dokos utilise la traduction sans contexte.
Corriger une traduction sur un site
Pour corriger un texte sur votre site seulement, sans modifier le code :
- Ouvrez la liste Traduction et cliquez sur Ajouter.
- Choisissez la Langue.
- Saisissez le Texte Source (le texte anglais) et le Texte Traduit.
- Si besoin, saisissez le Contexte (par exemple le nom du type de document).
- Enregistrez.
La traduction du site remplace celle des fichiers .po.
Corriger une traduction dans le code
- Ouvrez le fichier
fr.pode l'application dans GitLab (voir les exemples ci-dessus). - Cherchez le
msgiddu texte et corrigez lemsgstr. - Proposez une merge request vers la branche
developdu dépôt.
Vous pouvez aussi ouvrir un ticket avec le texte, la traduction proposée et une capture d'écran.
Traduire les nouveaux textes d'une application
Depuis le dossier du bench :
- Mettez à jour le modèle :
bench generate-pot-file --app erpnext - Ajoutez les nouveaux textes au fichier de la langue :
bench update-po-files --app erpnext --locale fr - Traduisez les entrées dont le
msgstrest vide, avec un éditeur de fichiers.po(Poedit, par exemple) ou un éditeur de texte. - Compilez et vérifiez sur votre site :
bench compile-po-to-mo --app erpnext --locale fr bench --site <mon-site> clear-cache - Proposez une merge request avec le fichier
fr.po.
Le nom technique de Dokos est erpnext et celui de Dodock est frappe.
Ajouter une langue
bench create-po-file de --app erpnext
La commande crée erpnext/locale/de.po à partir du modèle main.pot. La langue doit aussi exister dans le fichier frappe/geo/languages.csv.