1. Traduction simple
Quand PyQt utilise la fonction tr pour marquer les chaînes de caractères, Qt Quick
utilise qsTr. Ainsi, le code ci-après permet de traduire le texte du bouton :
Button {
text: qsTr("Valider")
}
Le développeur peut ensuite insérer, directement dans son code, des commentaires
précisant le contexte de chaque chaîne de caractères. Ces notes spéciales indiquent au
traducteur dans quelle partie de l'application l'élément textuel se trouve et aident à
lever d'éventuelles ambiguïtés. PyQt reconnaît deux types de tels commentaires :
ceux qui commencent par //: sont détectés comme le contexte pour la traduction
suivante (il ne peut y en avoir qu'un seul par chaîne à traduire) ;
ceux qui commencent par //~ servent à donner des notes supplémentaires. Le
premier mot après //~ est automatiquement considéré comme un identifiant, tandis
que le reste de la ligne constitue le commentaire proprement dit.
Par exemple, "Valider" peut être compris de différentes manières : ce bouton pourrait
soumettre un formulaire ("Envoyer") ou bien approuver une décision affichée à l'écran
("Confirmer").
Button {
//: La modification sur l'utilisateur courant a été revérifiée
par l'utilisateur.
//~ Contexte Aucun rapport avec une soumission de formulaire.
text: qsTr("Valider")
}
Note > Pour les chaînes de caractères affichées gérées par Qt Quick (comme les
boutons OK, Annuler, etc. des boîtes de dialogue de confirmation), la traduction se
fait automatiquement : PyQt est livré avec une série de fichiers de traduction pour
toutes ces chaînes de base, avec une adaptation à la plateforme courante (les noms
de ces boutons correspondront à ceux habituellement utilisés pour la plateforme de
l'utilisateur et sa langue).
Note > En écrivant le code source en français, on risque de se retrouver très vite
face à des problèmes d'encodage (certains caractères peuvent provoquer des
395
Quand PyQt utilise la fonction tr pour marquer les chaînes de caractères, Qt Quick
utilise qsTr. Ainsi, le code ci-après permet de traduire le texte du bouton :
Button {
text: qsTr("Valider")
}
Le développeur peut ensuite insérer, directement dans son code, des commentaires
précisant le contexte de chaque chaîne de caractères. Ces notes spéciales indiquent au
traducteur dans quelle partie de l'application l'élément textuel se trouve et aident à
lever d'éventuelles ambiguïtés. PyQt reconnaît deux types de tels commentaires :
ceux qui commencent par //: sont détectés comme le contexte pour la traduction
suivante (il ne peut y en avoir qu'un seul par chaîne à traduire) ;
ceux qui commencent par //~ servent à donner des notes supplémentaires. Le
premier mot après //~ est automatiquement considéré comme un identifiant, tandis
que le reste de la ligne constitue le commentaire proprement dit.
Par exemple, "Valider" peut être compris de différentes manières : ce bouton pourrait
soumettre un formulaire ("Envoyer") ou bien approuver une décision affichée à l'écran
("Confirmer").
Button {
//: La modification sur l'utilisateur courant a été revérifiée
par l'utilisateur.
//~ Contexte Aucun rapport avec une soumission de formulaire.
text: qsTr("Valider")
}
Note > Pour les chaînes de caractères affichées gérées par Qt Quick (comme les
boutons OK, Annuler, etc. des boîtes de dialogue de confirmation), la traduction se
fait automatiquement : PyQt est livré avec une série de fichiers de traduction pour
toutes ces chaînes de base, avec une adaptation à la plateforme courante (les noms
de ces boutons correspondront à ceux habituellement utilisés pour la plateforme de
l'utilisateur et sa langue).
Note > En écrivant le code source en français, on risque de se retrouver très vite
face à des problèmes d'encodage (certains caractères peuvent provoquer des
395