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