Localización de contenido estático

La 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. Apúntala a tu contenido, ejecútala una vez y obtén los archivos traducidos junto a los originales.

Tipos de contenido compatibles#

Requisitos previos#

Cada ejecución de la 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 de la CLI traducen estos archivos conservando el frontmatter, los bloques de código y 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 adaptarlo a la convención de directorios de tu framework:

Datos estructurados#

Los archivos JSON y YAML se traducen con los buckets json y yaml. Usa claves bloqueadas para evitar que se modifiquen valores no traducibles, como ID, URL o indicadores 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"]
    }
  }
}

En los archivos YAML que usan el código de idioma como clave raíz —algo habitual en Rails y Hugo— usa en su lugar 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. La CLI conserva todos los datos de temporización, los índices de las pistas y las 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"]
    }
  }
}

Trabajo con grandes volúmenes de contenido#

Los repositorios de contenido estático pueden contener miles de archivos. La CLI lo gestiona de forma eficiente mediante tres mecanismos:

Siguientes pasos#