lingo init

Crie a configuração de localização com idioma de origem, idiomas de destino e caminhos de catálogo explícitos.

lingo init grava as configurações de localização em .lingo/config.json. Use esse comando quando um projeto precisar definir seu primeiro idioma de origem, a lista de idiomas de destino e os padrões de arquivos. Os arquivos de origem, as credenciais e o vínculo com o engine de localização são recursos separados: a inicialização não cria nem traduz esses recursos.

sh
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yes

Abra o arquivo gerado e confira se ele seleciona apenas o conteúdo de origem desejado. Em seguida, crie esses arquivos, se necessário, faça login e execute link antes de iniciar a tradução remota.

Opções #

OpçãoValor padrão ou efeito
--source <locale>en ao aceitar os valores padrão.
--targets <list>Idiomas separados por vírgulas; de,fr,es com --yes.
--files <list>Padrões separados por vírgulas: locales/<source>.json com --yes, por exemplo, locales/en.json.
--messages-path <path>Define o catálogo React i18n.messagesPath; padrão: locales.
--types-path <path>Define a declaração i18n.typesPath; padrão: lingo.d.ts.
--forceSubstitui as configurações de localização existentes.
--no-agents-mdIgnora o bloco do Lingo.dev em AGENTS.md e CLAUDE.md.
--yes, -yUsa os valores fornecidos ou os valores padrão sem fazer perguntas.

Sem --yes, as opções que faltam são solicitadas. As listas são divididas por vírgulas e espaços. Por isso, para adicionar um padrão que contenha um espaço, edite .lingo/config.json. Os idiomas de destino duplicados e o idioma idêntico ao de origem são removidos. Se a lista resultante de idiomas de destino estiver vazia, ela será rejeitada. Coloque os padrões entre aspas para que o shell não os expanda antes que a CLI os receba.

O comando de inicialização também grava um bloco do Lingo.dev no AGENTS.md do projeto, criando o arquivo caso ele não exista, e em um CLAUDE.md existente, a menos que este importe um AGENTS.md que receba o bloco. O bloco instrui os agentes de programação a executar npx @lingo.dev/cli agent-guide antes de iniciar o trabalho de localização. O texto fora dos marcadores do bloco é preservado, e uma execução posterior substitui apenas o texto entre eles.

Reinicializar um projeto existente #

Sem forçar a operação, a configuração de localização existente é preservada e a inicialização falha em vez de sobrescrevê-la. Ao forçar, o comando recria files[] a partir dos padrões. As opções avançadas das entradas, como exclusões, formatos explícitos, modelos de saída e controles de chaves, são perdidas. Salve essas opções antes de forçar a operação ou edite a configuração existente para fazer uma alteração menor.

As outras seções de nível superior, incluindo o vínculo entre a organização e o engine de localização, são preservadas. Os valores padrão dos caminhos de catálogo são omitidos da configuração salva; uma execução forçada que retorne aos valores padrão pode remover personalizações anteriores de i18n. Alterar os caminhos de catálogo não altera automaticamente os padrões dos arquivos de tradução.

O guia do primeiro arquivo continua a partir da configuração e abrange o preenchimento inicial das traduções e a obtenção dos arquivos de destino. Consulte Configuração como referência para entradas avançadas de arquivos.