Traduza o seu primeiro ficheiro
Crie um catálogo de origem, obtenha os ficheiros de destino em alemão e francês e traduza uma alteração posterior ao conteúdo de origem.
Este guia mostra como configurar, traduzir e obter as traduções de um ficheiro JSON em inglês. No final, terá os ficheiros nos idiomas de destino guardados no disco e uma base para as próximas alterações. Para deixar a configuração a cargo de um agente de programação, consulte Configurar com um agente de programação.
Utilize um pequeno diretório de projeto, com Node.js e npm disponíveis. Precisa também de uma conta Lingo.dev e de permissão para traduzir com um motor de localização ativado, além de quota suficiente na conta para este trabalho.
Instalar e iniciar sessão #
npm install --global @lingo.dev/cli
lingo --version
lingo loginAo iniciar sessão, o navegador abre-se. Num executor não interativo, forneça antes LINGO_API_KEY através do respetivo armazenamento de segredos. Uma chave definida no ambiente tem prioridade sobre as credenciais de início de sessão guardadas, por isso remova qualquer chave que esteja a sobrepô-las inadvertidamente antes de iniciar sessão como outra pessoa.
Criar o conteúdo de origem #
Crie um diretório locales e guarde o seguinte 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 escreve .lingo/config.json e adiciona um bloco 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 ignorar este passo. link permite selecionar a organização e o motor de localização, ou criá-los se o seu nível de acesso o permitir. Um motor de localização fornece os modelos e as orientações linguísticas; o respetivo ID fica guardado na configuração do projeto, enquanto a sua credencial é guardada em separado.
Abra a configuração antes de continuar. Esta deve indicar en como origem, de e fr como destinos e locales/en.json como ficheiro de origem. Verifique também os IDs da organização e do motor de localização, sobretudo se estiver a trabalhar num projeto copiado ou numa bifurcação.
Traduzir e obter os resultados #
lingo push --backfill-missing --waitO preenchimento retroativo solicita os ficheiros de destino em falta. --wait aguarda e transfere os resultados concluídos. Um primeiro envio simples, sem um Lockfile, guarda o conteúdo de origem em vez de solicitar esta tradução inicial.
Não altere os ficheiros de destino enquanto o comando aguarda: esta forma de obter os resultados diretamente não volta a verificar se existem conflitos com alterações locais, ao contrário do comando pull executado em separado. Se a execução ficar a aguardar revisão ou indicar falhas, verifique esse estado antes de a considerar concluída.
Abra locales/de.json e locales/fr.json. Confirme que ambas as chaves de checkout continuam presentes e leia os valores traduzidos. Se não conseguir avaliar um idioma de destino, recorra a uma pessoa qualificada para fazer a revisão ou a uma medição adequada. Ao integrar os ficheiros numa aplicação, carregue-os também através do carregador de recursos habitual da aplicação.
Reveja .lingo/lock.json juntamente com as diferenças nos ficheiros de origem e de destino. Faça um commit conjunto dos ficheiros aceites, da configuração e da versão de referência. Sem --wait, execute lingo pull mais tarde, a partir do mesmo checkout e na mesma máquina, para obter a execução mais recente registada localmente.
Atualizar o conteúdo de origem #
Altere um valor ou adicione uma chave em locales/en.json e, em seguida, execute:
lingo push --waitA atualização normal compara as alterações no conteúdo de origem com a versão de referência guardada. O preenchimento retroativo destina-se a ficheiros em falta, não a novas chaves num ficheiro de destino já existente.
Para outros tipos de recursos ou estruturas, 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, siga o guia de início rápido do React; selecione o respetivo catálogo JSONC na configuração, em vez de assumir que este ficheiro JSON de exemplo o seleciona.