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#

A CLI detecta o formato de cada arquivo pela extensão — não há nenhum tipo de bucket para configurar. O idioma fica no caminho (content/en/x.md vira content/de/x.md), então não é preciso usar o placeholder [locale].

Consulte a Referência de formatos para ver a lista completa de tipos de arquivo compatíveis.

Pré-requisitos#

Cada execução 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 regras serão aplicados. Crie um no dashboard do Lingo.dev e, em seguida, configure o CLI (Node 22+):

npm install -g @lingo.dev/cli
lingo login
lingo init
lingo link

lingo init e lingo link criam .lingo/config.json, conectando a CLI à sua organização e à sua engine. Faça commit desse arquivo para que todos os ambientes compartilhem a mesma configuração.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "docs/en/getting-started.md" }]
}

Em CI, ignore lingo login e forneça LINGO_API_KEY como variável de ambiente. Gere uma em chaves de API.

Sites de documentação#

A maioria dos frameworks de documentação organiza o conteúdo traduzido em diretórios por idioma. Adicione um padrão por arquivo de origem (ou um glob) a files. A CLI preserva frontmatter, blocos de código e a sintaxe dos componentes ao traduzir Markdown, MDX e Markdoc.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [
    { "pattern": "docs/en/getting-started.md" },
    { "pattern": "docs/en/setup.mdx" }
  ]
}

Execute a primeira tradução para preencher todos os idiomas de destino:

lingo push --backfill-missing

Nas execuções seguintes, lingo push traduz apenas o que mudou. Use lingo pull para buscar traduções produzidas em outro lugar.

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

Dados estruturados#

Arquivos JSON e YAML são traduzidos automaticamente com base na extensão. Use controles de chave para evitar que valores não traduzíveis (IDs, URLs, flags de configuração) sejam alterados.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [
    { "pattern": "content/en.json" },
    { "pattern": "data/en.yaml" }
  ]
}

YAML genérico não precisa de um campo format. Apenas yaml-openapi, yaml-root-key e android exigem um "format" explícito na entrada do arquivo.

Legendas#

Arquivos de legenda SRT são traduzidos com base na extensão. A CLI preserva todos os dados de tempo, índices de cue e tags de formatação — apenas o conteúdo de texto é traduzido.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "subs/en/intro.srt" }]
}

Trabalhando com grandes volumes de conteúdo#

Repositórios de conteúdo estático podem ter milhares de arquivos. A CLI lida com isso com eficiência:

Para verificar se as traduções estão atualizadas sem gravar arquivos — útil como gate de CI — execute lingo check.

Próximos passos#