Notes de traduction
Déconseillé
Certains formats de fichier prennent en charge les commentaires en ligne que le CLI Lingo.dev inclut dans les requêtes de traduction. Ces commentaires donnent du contexte au modèle d’IA : ils lèvent les ambiguïtés, précisent le ton ou indiquent où le contenu apparaît dans l’interface.
Pourquoi les notes de traduction sont essentielles#
Le mot "Records" peut désigner des dossiers médicaux, des disques ou des enregistrements de base de données. Sans contexte, le modèle d’IA doit deviner. Une note de traduction lève cette ambiguïté :
{
// Medical context: refers to patient medical records
"records": "Records"
}Le commentaire est envoyé avec la chaîne dans la requête de traduction, ce qui guide le modèle vers la bonne interprétation.
Formats pris en charge#
Les notes de traduction sont actuellement prises en charge dans :
| Format | Type de bucket | Syntaxe des commentaires |
|---|---|---|
| JSONC | jsonc | // comment au-dessus de la clé |
| Catalogues de chaînes Xcode | xcode-xcstrings | Champ de commentaire dans le fichier .xcstrings |
Exemple JSONC#
{
// Navigation menu item - appears in the top header bar
"nav.home": "Home",
// Button label - triggers form submission, keep it short
"form.submit": "Submit",
// "Light" refers to the visual theme, not weight or illumination
"settings.theme.light": "Light"
}Pour utiliser JSONC, configurez le type de bucket jsonc dans votre i18n.json :
{
"buckets": {
"jsonc": {
"include": ["locales/[locale].jsonc"]
}
}
}Rédiger des notes efficaces#
Les notes de traduction efficaces décrivent un contexte qui ne ressort pas clairement de la chaîne seule :
| Efficace | Pourquoi |
|---|---|
// Button label in checkout flow | Indique au modèle où le texte apparaît dans l’interface et le niveau de concision attendu |
// "Set" means a collection, not the verb | Lève l’ambiguïté d’un mot polysémique |
// Formal tone - displayed in legal footer | Définit le niveau de langue attendu |
Les notes qui se contentent de reformuler la chaîne elle-même (// This says Welcome) n’apportent aucune valeur.