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.
