Comandos CLI

tyndale init

Inicializa um novo projeto Tyndale. Cria tyndale.config.json com predefinições sensatas.

npx tyndale init

tyndale auth

Configure as credenciais do seu fornecedor de IA.

npx tyndale auth

tyndale translate

Extrai strings traduzíveis e gera traduções para todos os locales configurados.

npx tyndale translate [options]

Flag	Descrição
--locale <code>	Traduz apenas um locale específico
--force	Retraduz todas as strings, não apenas as alterações
--dry-run	Mostra o que seria traduzido sem escrever ficheiros
--token-budget <n>	Orçamento de tokens por lote de IA (predefinição: 50000)
--concurrency <n>	Máximo de sessões de tradução paralelas (detetado automaticamente)

tyndale validate

Verifica se todos os locales têm traduções completas e bem formadas. Não são feitas chamadas de IA.

npx tyndale validate

Termina com código 1 se forem encontrados problemas. Ideal para pipelines de CI.

tyndale extract

Extrai strings traduzíveis sem as traduzir. Útil para rever o que será enviado para o fornecedor de IA.

npx tyndale extract

tyndale translate-docs

Traduz ficheiros de documentação (MDX/MD) para qualquer framework suportado. Deteta automaticamente o framework de documentação ou usa a configuração de tyndale.config.json.

npx tyndale translate-docs [options]

Flag	Descrição
--content-dir <path>	Substitui a pasta de conteúdo da documentação
--force	Retraduz toda a documentação, não apenas os ficheiros em falta
--concurrency <n>	Máximo de sessões de tradução paralelas (detetado automaticamente)

Frameworks suportados: Starlight, Docusaurus, VitePress, MkDocs, Nextra.

translate-docs escreve .tyndale-docs-state.json na raiz do seu projeto para acompanhar os hashes dos documentos de origem. Faça commit deste ficheiro para que novos clones possam ignorar documentação inalterada sem retradução.

tyndale translate-docs setup

Deteta o framework de documentação e guarda a configuração em tyndale.config.json.

npx tyndale translate-docs setup

Analisa o seu projeto em busca de sinais do framework (dependências de pacote e ficheiros de configuração), confirma o framework detetado e escreve a secção docs na sua configuração.

tyndale model

Altera o modelo de IA usado nas traduções.

npx tyndale model