El CLI traduce seis formatos de archivo. El formato se infiere por la extensión del archivo; define format en una entrada files[] para sobrescribirlo.
| Formato | Extensiones | Valor de format | Notas |
|---|---|---|---|
| JSON | .json | json | Clave-valor. Admite controles de clave. |
| JSONC | .jsonc | jsonc | JSON con comentarios. Los comentarios se conservan y también funcionan como notas para traductores. |
| Markdown | .md | md | Se traduce la prosa; el frontmatter es opcional. |
| MDX | .mdx | mdx | Markdown + JSX. Las props de los componentes son opcionales. |
| Markdoc | .mdoc | markdoc | Markdown + etiquetas. Frontmatter + atributos de etiquetas. |
| OpenAPI YAML | .yaml | yaml-openapi | Especificaciones de OpenAPI. Define siempre format de forma explícita. |
Míralo de principio a fin
El proyecto demo incluye un archivo por formato con la configuración exacta que necesita cada uno. Clónalo con npx degit lingodotdev/lingo.dev/demo/new-cli my-lingo-demo y ejecuta un push.
npx degit lingodotdev/lingo.dev/demo/new-cli my-lingo-demo
cd my-lingo-demoJSON y JSONC#
Traducción simple de clave-valor. Se traduce cada valor de texto, a menos que un control de clave indique lo contrario.
{ "pattern": "content/en/app.json", "lockedKeys": ["meta.version"] }JSONC también conserva los comentarios, que el motor usa como contexto. Consulta notas para traductores.
{ "pattern": "content/en/settings.jsonc", "preservedKeys": ["featureFlags"] }Markdown, MDX y Markdoc#
La prosa del cuerpo se traduce de forma predeterminada. El frontmatter y los componentes integrados no se traducen a menos que actives esa opción.
Frontmatter#
Indica con translateFrontmatterFields qué campos del frontmatter se deben traducir:
{
"pattern": "content/en/guide.md",
"translateFrontmatterFields": ["title", "description"]
}Props de componentes MDX#
En MDX, traduce props específicas de componentes específicos con translateComponentProps:
{
"pattern": "content/en/landing.mdx",
"translateFrontmatterFields": ["title"],
"translateComponentProps": [{ "component": ["Hero", "Callout"], "props": ["title", "body"] }]
}Esto traduce las props title y body de <Hero> y <Callout>, y deja intactas todas las demás.
Markdoc#
Markdoc funciona como Markdown, con el frontmatter y los atributos de las etiquetas intactos:
{
"pattern": "content/en/changelog.mdoc",
"translateFrontmatterFields": ["title"]
}OpenAPI YAML#
El YAML genérico es ambiguo, así que las especificaciones de OpenAPI requieren un format explícito:
{ "pattern": "content/en/api.yaml", "format": "yaml-openapi" }El motor traduce los campos visibles para las personas (resúmenes, descripciones) y deja intactas las claves de esquema, las rutas y los IDs de operación.
Rutas de salida#
Los destinos se escriben sustituyendo el segmento de idioma del patrón de origen —content/en/app.json → content/de/app.json—. Mantén el idioma de origen en la ruta para que el CLI sepa dónde van los destinos. Consulta Configuración.
¿Vienes del CLI anterior?#
El CLI anterior admitía ~25 formatos (CSV, PO, XLIFF, strings de Android/Xcode, Flutter ARB, HTML y más). El soporte para esos formatos se está incorporando al CLI actual según el uso; mientras llega el tuyo, la documentación del CLI anterior lo cubre.
