Traduza seu primeiro arquivo
Crie um catálogo de origem, baixe os arquivos de destino em alemão e francês e traduza uma alteração posterior no conteúdo de origem.
Este passo a passo acompanha um arquivo JSON em inglês, da configuração à tradução e à obtenção dos arquivos traduzidos. Ao final, você terá os arquivos nos idiomas de destino em disco e uma base para as próximas edições. Para deixar a configuração por conta de um agente de programação, consulte Configurar com um agente de programação.
Use um diretório de projeto pequeno, com Node.js e npm disponíveis. Você também precisa de uma conta Lingo.dev e de permissão para traduzir com um engine de localização habilitado, além de uma cota disponível na conta que seja suficiente para o trabalho.
Instale e entre na conta #
npm install --global @lingo.dev/cli
lingo --version
lingo loginAo entrar na conta, o navegador será aberto. Para um executor não interativo, forneça LINGO_API_KEY pelo armazenamento de segredos. Uma chave definida no ambiente tem prioridade sobre o login salvo. Por isso, remova qualquer chave definida por engano antes de entrar com a conta de outra pessoa.
Crie o arquivo de origem #
Crie um diretório locales e salve o conteúdo a seguir como locales/en.json:
{
"checkout": {
"title": "Review your order",
"submit": "Place order"
}
}Na raiz do projeto, execute:
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo linkinit grava .lingo/config.json e adiciona um bloco do Lingo.dev a AGENTS.md para que os agentes de programação saibam que devem ler os guias para agentes da CLI; use --no-agents-md para pular essa etapa. link permite selecionar a organização e o engine de localização ou criá-los, se o seu acesso permitir. Um engine de localização fornece os modelos e as orientações linguísticas; o ID dele é salvo na configuração do projeto, enquanto sua credencial é mantida separadamente.
Abra a configuração antes de continuar. Ela deve indicar en como idioma de origem, de e fr como idiomas de destino e locales/en.json como arquivo de origem. Confira também os IDs da organização e do engine de localização, especialmente em um projeto copiado ou em um fork.
Traduza e baixe os arquivos #
lingo push --backfill-missing --waitO preenchimento retroativo solicita os arquivos de destino ausentes. --wait aguarda a conclusão e baixa os resultados. Um primeiro envio simples, sem um Lockfile, apenas armazena o conteúdo de origem, em vez de solicitar essa tradução inicial.
Não altere os arquivos de destino enquanto o comando estiver aguardando: esse download direto não refaz a comparação para detectar conflitos com edições locais, como faz o comando de download separado. Se a execução ficar aguardando revisão ou indicar falhas, verifique esse estado antes de considerá-la concluída.
Abra locales/de.json e locales/fr.json. Confirme que as duas chaves de checkout continuam presentes e leia os valores traduzidos. Se você não puder avaliar um idioma de destino, recorra a um revisor qualificado ou a uma medição aplicável. Ao integrar os arquivos a um aplicativo, carregue-os também pelo carregador de recursos que ele normalmente usa.
Revise .lingo/lock.json junto com as diferenças nos arquivos de origem e de destino. Faça o commit dos arquivos aceitos, da configuração e da versão de referência em conjunto. Sem --wait, execute lingo pull mais tarde, no mesmo checkout e na mesma máquina, para baixar os resultados da execução mais recente registrada localmente.
Atualize o arquivo de origem #
Altere um valor ou adicione uma chave em locales/en.json e execute:
lingo push --waitA atualização normal compara as alterações no conteúdo de origem com a versão de referência salva. O preenchimento retroativo serve para arquivos ausentes, não para novas chaves em um arquivo de destino que já existe.
Para outros tipos ou estruturas de recursos, consulte Configuração e Formatos. YAML e Android XML exigem a seleção explícita do formato. Para extrair chamadas do código-fonte React, continue com o guia de início rápido do React; selecione o catálogo JSONC dele na configuração, em vez de presumir que este arquivo JSON de exemplo já faz essa seleção.