Comprendre la structure des fichiers.po
A .Fichier.po (Portable Object) est le format standard utilisé par les workflows de localisation basés sur gettext. Il associe des chaînes source originales ( msgid) avec chaînes traduites ( msgstr) et comporte des métadonnées en texte simple. Au-delà des paires visibles, deux éléments jouent un rôle décisif pour les traducteurs et les développeurs: commentaires et contexte. Les commentaires communiquent l'intention, les contraintes ou les détails de mise en oeuvre, pendant que le contexte (le msgctxt field) disambiguise les chaînes identiques utilisées à différents endroits.
Connaître l'anatomie du fichier vous aide à élaborer des commentaires utiles et un contexte. Une entrée typique contient des commentaires optionnels du développeur et du traducteur, des lignes de référence optionnelles pointant vers l'emplacement du code source, des drapeaux qui indiquent des formes ou des formats pluriels, et la msgctxt si nécessaire. Traiter commenter les champs et contexte en tant que citoyens de première classe— ils sont légers, lisibles par l'homme et peuvent prévenir des erreurs de traduction coûteuses.
Différents types de commentaires dans les fichiers. o
. Les fichiers.po présentent en charge plusieurs formules de commentaires, chacun ayant un mais spécifique. L'utilisation du bon type de commentaires rend l'analyse prévisible pour les outils et plus claire pour les humains. Voici une explication concise des types courant et du moment où les utilisateurs.
Le tableau qui suit résume les types de commentaires, leur signification et des exemples d'utilisation pratique.
| Préfixe | Signification | Utilisation |
|---|---|---|
| #. | Commentaire extrait automatique (note du traducteur) | Utilisation pour les conseils sanitaires produits par les outils d'extraction, comme la signification du paramètre |
| #: | Référence à l'emplacement de la source (file:line) | Inclure les lieux du pointage des traducteurs où la chaîne apparaît en code |
| #, | Drapeaux (par exemple, flou, sans format c) | Populé par des outils pour identifier l'état ou la manipulation spécialisée |
| # | Commentaire du traducteur (formulaire libre) | Notes humaines de traducteurs ou brèves suggestions de développeurs |
| #| | Chaîne précédente non traduite (obsolète) | Lors de la conservation de l'histoire après les changements; rarement nécessaire pour modifier |
Utilisation lignes de référence ( #: chemin/fichier:ligne) lorsque le lieu compte pour le sens. Utilisation #. pour des conseils courts, extraits programmatiques et simples # pour les instructions ciblées que les traducteurs doivent lire. Évitez de faire double emploi avec plusieurs types de commentaires; préférez un commentaire faisant autorité par entrée.
Contexte de levier (msgctxt) pour des traductions précises
Les msgctxt champ existe pour disambiguer les chaînes source identiques utilisées dans différents contextes sémantiques. Par exemple, le mot anglais « fermer » peut signifier « presque » ou « fermer ». Sans contexte, les traducteurs doivent deviner, ce qui peut conduire à des erreurs dans les langues où ces significations utilisent des mots différents.
Meilleures utilisations msgctxt:
- Lorsque la même chaîne source apparaît dans les éléments d'interface utilisateur avec différentes fonctions (p. ex., étiquette de bouton vs texte descriptif).
- Quand la pluralité ou le genre grammatical dispensé de la façon dont la chaîne est utilisée.
- Lorsque les jetons de format externe ou de balisage changeant de sens et doivent être conservés exactement.
Exemple pratique (décrit): préférer ajouter msgctxt comme "bouton:close" et "label:distance-close" au lieu de se fier uniquement aux commentaires. Cela garantit que les outils de traduction et les traducteurs voient une distinction lisible par machine. Évitez les valeurs contextuelles trop verbeuses; gardez-les courts, cohérents et stables entre les versions.
Meilleurs pratiques pour rédiger et maintenir les commentaires
Les bons commentaires sont concis, pertinents et écuries. Ils doivent expliquer pourquoi une chaîne existe, décrire les placesholders et notre toute contrainte grammaticale. Ne réchez pas ce qui est déjà à partir de la chaîne source; au lieu de cela, ajoutez des informations qui embauchent les erreurs.
Lignes directrices pratiques que vous pouvez appliquer immédiatement:
- Expliquez les emplacements et le formatage — Si une chaîne continue des places comme "%s" ou « {nom} », décrire leur ordre et s'ils peuvent être amis ou réponses.
- Donnez un exemple de cour d'utilisation — des exemples d'une ligne précise l'intention. Par exemple: #. Oui. Oui. Oui. Oui. Apparaît dans les paramètres du compte comme une étiette bouton
- Marquer les parties non négociables — Si une marque ou un terme technique doit rester inchangé, indiquez-le clairement dans le commentaire.
- Gardez les commentaires écuries et en version — Lorsque vous changez de comportement d'interface utilisateur, mettez à jour le commentaire avec le nouveau contexte et incluez une date ou une référence de ticket si utile.
- Invitez le jargon du développement seul — Gardez la langue accessible aux traducteurs professionnels; utilisez des phrases simples et invitez les acronymes internes, sauf indication contraire.
Lorsque vous maintenez les commentaires sur les versions, lancez un laissez rapide pour supprimer les notes obsolètes et corriger les références. Si une chaîne est supprimée ou modifiée de facon significatif, mise à jour ou supprimer les commentaires relatifs à l'invitation de confiner les traducteurs.
Conseils de collaboration entre développeurs et traducteurs
Les meilleurs résultats de localisation durable d'une collaboration légère et continue. Commentaires et contexte sont le canal de communication intégré directement dans le flux de travail de traduction. Les rencontres en s'intendant sur des conventions partagées et des rapports d'outillage.
Pratiques de collaboration réalisables:
- Établir un guide de style de commentaires — Décider des préfixes, de la longueur minimale du contexte et de l'inclusionventuel des numéros de ticket. Documenter le guide où les deux équipes peuvent y accéder.
- Utilisation des conventions — Par exemple, préfixer les contextes avec "bouton:", "menu:", ou "error:" afin que les traducteurs puissent scanner et faire l'utilisation rapidement.
- Exécuter un examen d'équivalence pour les traducteurs — Partagez une courte visite de votre base de code.
- Encourager les commentaires bilatéraux — Permettre aux traducteurs d'ajouter des commentaires (#) avec des questions ou des notes. Examiner ces commentaires mensuels et répondre ou mettre à jour les sources pour tenir compte des clarifications.
- Contrôles automatiques — Intégrer le double qui met en garde contre les descriptions manuscrites du déposant de place, le msgctxt vide lorsque l'ambiguïté existe, ou les références contradictoires.
Enfin, appréciez les commentaires des traducteurs. Un commentaire concis du traducteur signalant une véritable ambiguïté est l'information que vous devez intégrer à la source pour inviter des problèmes récurrents. L'objectif est une boule d'amélioration continue où les commentaires et le contexte évoluent avec le produit plutôt que de devenir des annotations cesse.
