Traduzir Documento

O comando doc translate traduz automaticamente arquivos de documentação de uma localidade base para localidades alvo usando serviços de tradução por IA.

Pontos-chave:

• Divide arquivos markdown grandes em partes para permanecer dentro dos limites da janela de contexto do modelo de IA.
• Tenta novamente a tradução se o formato de saída estiver incorreto.
• Incorpora contexto específico da aplicação e do arquivo para melhorar a precisão da tradução.
• Preserva traduções existentes ao não sobrescrevê-las.
• Processa arquivos, partes e locales em paralelo usando um sistema de fila para aumentar a velocidade.

npx intlayer doc translate

Argumentos:

Opções de lista de arquivos:

• --doc-pattern [docPattern...]: Padrões glob para corresponder aos arquivos de documentação a serem traduzidos.

  Exemplo: npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"

• --excluded-glob-pattern [excludedGlobPattern...]: Padrões glob para excluir da tradução.

  Exemplo: npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"

• --skip-if-modified-before [skipIfModifiedBefore]: Pular o arquivo se ele foi modificado antes do tempo especificado.

  • Pode ser um tempo absoluto como "2025-12-05" (string ou Date)
  • Pode ser um tempo relativo em ms 1 * 60 * 60 * 1000 (1 hora)
  • Esta opção verifica o tempo de atualização do arquivo usando o método fs.stat. Portanto, pode ser impactada pelo Git ou outras ferramentas que modificam o arquivo.

  Exemplo: npx intlayer doc translate --skip-if-modified-before "2025-12-05"

• --skip-if-modified-after [skipIfModifiedAfter]: Pular o arquivo se ele foi modificado dentro do tempo especificado.

  • Pode ser um tempo absoluto como "2025-12-05" (string ou Date)
  • Pode ser um tempo relativo em ms 1 * 60 * 60 * 1000 (1 hora)
  • Esta opção verifica o tempo de atualização do arquivo usando o método fs.stat. Portanto, pode ser impactada pelo Git ou outras ferramentas que modificam o arquivo.

  Exemplo: npx intlayer doc translate --skip-if-modified-after "2025-12-05"

• --skip-if-exists: Pular o arquivo se ele já existir.

  Exemplo: npx intlayer doc translate --skip-if-exists

Opções de saída da entrada:

• --locales [locales...]: Locais de destino para traduzir a documentação.

  Exemplo: npx intlayer doc translate --locales fr es de

• --base-locale [baseLocale]: Local de origem para traduzir.

  Exemplo: npx intlayer doc translate --base-locale en

Opções de processamento de arquivos:

• --nb-simultaneous-file-processed [nbSimultaneousFileProcessed]: Número de arquivos para processar simultaneamente para tradução.

  Exemplo: npx intlayer doc translate --nb-simultaneous-file-processed 5

Opções de IA:

• --model [model]: O modelo de IA a ser usado para tradução (exemplo: gpt-3.5-turbo).
• --provider [provider]: O provedor de IA a ser usado para tradução.
• --temperature [temperature]: Configuração de temperatura para o modelo de IA.
• --api-key [apiKey]: Forneça sua própria chave de API para o serviço de IA.
• --application-context [applicationContext]: Forneça contexto adicional para a tradução de IA.
• --data-serialization [dataSerialization]: O formato de serialização de dados a ser usado nas funcionalidades de IA do Intlayer. Opções: json (padrão, confiável), toon (menos tokens, menos consistente).

• --custom-prompt [prompt]: Personalize o prompt base usado para tradução. (Nota: Para a maioria dos casos de uso, a opção --custom-instructions é recomendada, pois oferece melhor controle sobre o comportamento da tradução.)

  Exemplo: npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Minha aplicação é uma loja de gatos"

Opções de variáveis de ambiente:

• --env: Especifica o ambiente (exemplo: development, production).
• --env-file [envFile]: Fornece um arquivo de ambiente personalizado para carregar variáveis.
• --base-dir: Especifica o diretório base do projeto.

• --no-cache: Desativa o cache.

  Exemplo: npx intlayer doc translate --base-dir ./docs --env-file .env.production.local

Opções de log:

• --verbose: Ativa o log detalhado para depuração. (padrão para true usando CLI)

  Exemplo: npx intlayer doc translate --verbose

Opções de instruções personalizadas:

• --custom-instructions [customInstructions]: Instruções personalizadas adicionadas ao prompt. Útil para aplicar regras específicas relacionadas à formatação, tradução de URLs, etc.

  • Pode ser um tempo absoluto como "2025-12-05" (string ou Date)
  • Pode ser um tempo relativo em ms 1 * 60 * 60 * 1000 (1 hora)
  • Esta opção verifica o tempo de atualização do arquivo usando o método fs.stat. Portanto, pode ser impactada pelo Git ou outras ferramentas que modificam o arquivo.

  Exemplo: npx intlayer doc translate --custom-instructions "Evite traduzir URLs e mantenha o formato markdown"

  Exemplo: npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"

Opções do Git:

• --git-diff: Executa apenas em dicionários que incluem alterações da base (padrão origin/main) para o branch atual (padrão: HEAD).
• --git-diff-base: Especifica a referência base para o git diff (padrão origin/main).
• --git-diff-current: Especifica a referência atual para o git diff (padrão: HEAD).
• --uncommitted: Inclui alterações não comitadas.
• --unpushed: Inclui alterações não enviadas (unpushed).

• --untracked: Inclui arquivos não rastreados.

  Exemplo: npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD

  Exemplo: npx intlayer doc translate --uncommitted --unpushed --untracked

Note que o caminho do arquivo de saída será determinado substituindo os seguintes padrões

• /{{baseLocale}}/ por /{{locale}}/ (Unix)
• {{baseLocale}}` por {{locale}}` (Windows)
• _{{baseLocale}}. por _{{locale}}.
• {{baseLocale}}_ por {{locale}}_
• .{{baseLocaleName}}. por .{{localeName}}.

Se o padrão não for encontrado, o arquivo de saída adicionará .{{locale}} na extensão do arquivo. ./my/file.md será traduzido para ./my/file.fr.md para o idioma francês.