Localización de contenido estático

El CLI de Lingo.dev traduce archivos estáticos de tu repositorio —Markdown, MDX, Markdoc, JSON, YAML, subtítulos y más— con un motor de localización configurado. Solo apúntalo a tu contenido, ejecútalo una vez y obtén los archivos traducidos junto a los originales.

Tipos de contenido compatibles#

Requisitos previos#

Cada ejecución del CLI envía el contenido a través de un motor de localización: la configuración que determina qué modelo LLM, glosario, voz de marca e instrucciones se aplican. Crea uno en el panel de Lingo.dev y genera una clave de API.

Sitios de documentación#

La mayoría de los frameworks de documentación organizan el contenido traducido en directorios por idioma. Los buckets markdown, mdx y markdoc del CLI traducen estos archivos sin alterar el frontmatter, los bloques de código ni la sintaxis de los componentes.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/getting-started.md"]
    },
    "mdx": {
      "include": ["docs/[locale]/setup.mdx"]
    }
  }
}

Ajusta el patrón include para que coincida con la convención de directorios de tu framework:

Datos estructurados#

Los archivos JSON y YAML se traducen con los buckets json y yaml. Usa locked keys para evitar que se modifiquen valores no traducibles, como ID, URL o flags de configuración.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "json": {
      "include": ["content/[locale].json"],
      "lockedKeys": ["id", "slug", "url"]
    },
    "yaml": {
      "include": ["data/[locale].yaml"]
    }
  }
}

Para archivos YAML que usan el código de idioma como clave raíz —algo común en Rails y Hugo— usa el bucket yaml-root-key: lee desde la clave del idioma de origen y escribe en las claves de los idiomas de destino dentro del mismo archivo.

Subtítulos#

Los archivos de subtítulos SRT y VTT se traducen con los buckets srt y vtt. El CLI conserva todos los tiempos, índices de cues y etiquetas de formato; solo se traduce el contenido de texto.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "srt": {
      "include": ["subs/[locale]/intro.srt"]
    }
  }
}

Cómo trabajar con grandes volúmenes de contenido#

Los repositorios de contenido estático pueden contener miles de archivos. El CLI lo maneja de forma eficiente con tres mecanismos:

Siguientes pasos#