Notas para traductores
Obsoleto
Algunos formatos de archivo admiten comentarios en línea que el CLI de Lingo.dev incluye en las solicitudes de traducción. Estos comentarios le dan contexto al modelo de IA: aclaran términos ambiguos, definen el tono o indican dónde aparece el contenido en la interfaz.
Por qué importan las notas para traductores#
La palabra "Records" puede referirse a expedientes médicos, discos de música o registros de base de datos. Sin contexto, el modelo de IA tiene que adivinar. Una nota para traductores elimina esa ambigüedad:
{
// Medical context: refers to patient medical records
"records": "Records"
}El comentario se envía junto con la cadena en la solicitud de traducción, guiando al modelo hacia la interpretación correcta.
Formatos compatibles#
Actualmente, las notas para traductores son compatibles con:
| Formato | Tipo de bucket | Sintaxis de comentarios |
|---|---|---|
| JSONC | jsonc | // comment sobre la clave |
| Catálogos de strings de Xcode | xcode-xcstrings | Campo de comentario en el archivo .xcstrings |
Ejemplo de 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"
}Para usar JSONC, configura el tipo de bucket jsonc en tu i18n.json:
{
"buckets": {
"jsonc": {
"include": ["locales/[locale].jsonc"]
}
}
}Cómo escribir notas efectivas#
Las notas para traductores efectivas describen contexto que no se desprende de la cadena por sí sola:
| Efectiva | Por qué |
|---|---|
// Button label in checkout flow | Le indica al modelo dónde aparece en la interfaz y qué tan breve debe ser |
// "Set" means a collection, not the verb | Aclara una palabra con varios significados |
// Formal tone - displayed in legal footer | Define el registro esperado |
Las notas que solo repiten la cadena (// This says Welcome) no aportan valor.