Localização de Conteúdo Estático

A CLI do Lingo.dev traduz arquivos estáticos no seu repositório — Markdown, MDX, Markdoc, JSON, YAML, legendas e muito mais — com um engine de localização configurado. Basta apontar para o seu conteúdo, executar uma vez e obter os arquivos traduzidos ao lado dos arquivos de origem.

Tipos de conteúdo compatíveis#

Pré-requisitos#

Cada execução da CLI envia o conteúdo por um engine de localização — a configuração que define qual modelo de LLM, glossário, voz da marca e instruções serão aplicados. Crie um no dashboard do Lingo.dev e gere uma chave de API.

Sites de documentação#

A maioria dos frameworks de documentação organiza o conteúdo traduzido em diretórios por idioma. Os buckets markdown, mdx e markdoc da CLI traduzem esses arquivos preservando frontmatter, blocos de código e sintaxe de 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"]
    }
  }
}

Ajuste o padrão include para seguir a convenção de diretórios do seu framework:

Dados estruturados#

Arquivos JSON e YAML são traduzidos com os buckets json e yaml. Use chaves bloqueadas para evitar que valores não traduzíveis (IDs, URLs, flags de configuração) sejam alterados.

{
  "$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 arquivos YAML que usam o código do idioma como chave raiz — algo comum em Rails e Hugo — use o bucket yaml-root-key em vez disso. Ele lê a chave do idioma de origem e grava nas chaves dos idiomas de destino dentro do mesmo arquivo.

Legendas#

Arquivos de legenda SRT e VTT são traduzidos com os buckets srt e vtt. A CLI preserva todos os dados de tempo, índices de cue e tags de formatação — apenas o conteúdo textual é traduzido.

{
  "$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"]
    }
  }
}

Trabalhando com grandes volumes de conteúdo#

Repositórios de conteúdo estático podem conter milhares de arquivos. A CLI lida com isso com eficiência por meio de três mecanismos:

Próximos passos#