lingo init

Crie a configuração de localização com caminhos explícitos para a origem, os destinos e os catálogos.

lingo init grava as definições de localização em .lingo/config.json. Utilize este comando para definir o primeiro idioma de origem, a lista de destinos e os padrões de ficheiros de um projeto. Os ficheiros de origem, as credenciais e a associação ao motor de localização são elementos 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 ficheiro gerado e confirme que seleciona apenas o conteúdo de origem pretendido. Em seguida, crie esses ficheiros, se necessário, inicie sessão e execute link antes de efetuar traduções remotas.

Opções #

OpçãoPredefinição ou efeito
--source <locale>en ao aceitar as predefinições.
--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 i18n.messagesPath do catálogo React; predefinição: locales.
--types-path <path>Define i18n.typesPath da declaração; predefinição: lingo.d.ts.
--forceSubstitui as definições de localização existentes.
--no-agents-mdIgnora o bloco Lingo.dev em AGENTS.md e CLAUDE.md.
--yes, -yUtiliza os valores fornecidos ou as predefinições sem fazer perguntas.

Sem --yes, é-lhe pedido que indique as opções em falta. 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. São removidos os idiomas de destino duplicados e o que corresponda exatamente ao idioma de origem. Se a lista final de idiomas de destino ficar vazia, é rejeitada. Coloque os padrões entre aspas para que o interpretador de comandos não os expanda antes de a CLI os receber.

A inicialização também escreve um bloco do Lingo.dev no AGENTS.md do projeto, criando o ficheiro se não existir, e num 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 iniciarem o trabalho de localização. O texto fora dos marcadores do bloco é preservado e uma execução posterior substitui apenas o texto entre esses marcadores.

Reinicializar um projeto existente #

Sem forçar a inicialização, a configuração de localização existente é preservada e a inicialização falha em vez de a substituir. Ao forçá-la, o comando reconstrói files[] a partir dos padrões. Perdem-se as opções avançadas das entradas, como exclusões, formatos explícitos, modelos de saída e controlos de chaves. Guarde essas opções antes de forçar a inicialização ou, se a alteração for pequena, edite a configuração existente.

As restantes secções de raiz, incluindo a associação à organização e ao motor de localização, são mantidas. Os valores predefinidos dos caminhos dos catálogos são omitidos da configuração guardada; uma execução forçada que reponha as predefinições pode eliminar personalizações anteriores de i18n. Alterar os caminhos dos catálogos não altera automaticamente os padrões dos ficheiros de tradução.

O guia do primeiro ficheiro dá continuidade à configuração, passando pelo preenchimento inicial e pela obtenção dos ficheiros de destino. Consulte Configuração como referência para as opções avançadas das entradas de ficheiros.