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.
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yesAbra 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ção | Valor 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. |
--force | Substitui as configurações de localização existentes. |
--no-agents-md | Ignora o bloco do Lingo.dev em AGENTS.md e CLAUDE.md. |
--yes, -y | Usa 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.