Localização de Conteúdo Estático

A CLI do Lingo.dev traduz ficheiros estáticos no seu repositório — Markdown, MDX, Markdoc, JSON, YAML, legendas e muito mais — através de um motor de localização configurado. Aponte-a para o seu conteúdo, execute uma vez e obtenha os ficheiros traduzidos ao lado dos originais.

Tipos de Conteúdo Suportados#

Pré-requisitos#

Cada execução da CLI envia o conteúdo através de um motor de localização — a configuração que determina que modelo LLM, glossário, voz da marca e instruções se aplicam. 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 estes ficheiros, 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 corresponder à convenção de diretórios do seu framework:

Dados Estruturados#

Os ficheiros JSON e YAML são traduzidos com os buckets json e yaml. Use chaves bloqueadas para impedir 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 ficheiros YAML que usam o código do idioma como chave de raiz (comum em Rails e Hugo), use antes o bucket yaml-root-key — este lê a partir da chave do idioma de origem e escreve nas chaves do idioma de destino dentro do mesmo ficheiro.

Legendas#

Os ficheiros de legendas SRT e VTT são traduzidos com os buckets srt e vtt. A CLI preserva todos os dados temporais, índices de cues e etiquetas de formatação — apenas o conteúdo de texto é 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"]
    }
  }
}

Trabalhar com Grandes Volumes de Conteúdo#

Os repositórios de conteúdo estático podem conter milhares de ficheiros. A CLI trata isso de forma eficiente através de três mecanismos:

Próximos Passos#