Notes pour la traduction dans la CLI v0
Précisez le sens de chaque occurrence à côté des messages JSONC ou Xcode de l’ancien système, puis actualisez explicitement la traduction concernée.
Un libellé court ne fournit pas toujours les informations nécessaires à la traduction. Une note peut préciser le sujet, l’action ou le registre sans ajouter de texte visible dans l’interface. Dans l’ancien workflow, utilisez des commentaires JSONC ou les champs de commentaire natifs des catalogues Xcode, lorsqu’ils sont pris en charge.
Précisez le sens manquant #
{
// Patient medical records, not music recordings
"records": "Records",
// Button that submits the form; use a short action label
"submit": "Submit",
// Visual theme, not weight
"theme.light": "Light"
}Sélectionnez le parseur qui prend en charge les commentaires dans i18n.json :
{
"buckets": {
"jsonc": { "include": ["locales/[locale].jsonc"] }
}
}« Ensemble de dossiers médicaux enregistrés » précise le sujet ; « Texte affiché à un utilisateur » n’apporte pas cette précision. Une note sur l’emplacement et le registre peut expliquer pourquoi un avis formel se distingue d’un libellé d’action. Utilisez un contrôle de clé pour préserver une valeur exacte qui ne doit pas changer, plutôt que de vous appuyer sur une note linguistique pour la protéger.
Examinez le résultat concerné #
Modifier uniquement une note ne change pas nécessairement la somme de contrôle de la valeur source. Demandez une retraduction ciblée si la version installée ignorerait autrement les textes inchangés. Lisez le libellé traduit à l’endroit où il apparaît réellement dans l’interface.
Pour XCStrings, utilisez le champ de commentaire natif et conservez la structure par langue du catalogue partagé. Consultez les anciens formats avant de supposer qu’un autre compartiment lit les notes de la même façon. Ces anciens commentaires ne relèvent pas du contrat de hachage et de contexte du catalogue React actuel.
Gardez toute note propre à une occurrence distincte du glossaire, des règles et du ton définis pour l’ensemble du moteur de localisation. Ces deux types d’informations peuvent être envoyés au serveur : aucun ne doit donc contenir de secrets ni de contenu que vous n’êtes pas autorisé à divulguer.