lingo push

Envie alterações na origem, preencha arquivos de destino ausentes ou atualize intencionalmente as traduções selecionadas.

Após a configuração do primeiro arquivo, use lingo push --wait para as edições de rotina na origem. A CLI compara os bytes da origem com a referência salva, solicita o processamento das alterações e baixa os destinos concluídos. Origens com bytes idênticos são ignoradas.

Os outros modos atendem a tarefas diferentes. Escolha conforme o que precisa mudar, em vez de tratar cada push como uma tradução completa.

Escolha o que processar #

ComandoComportamento
Push simples sem referência válidaArmazena os bytes da origem; não solicita uma tradução inicial automaticamente.
Push simples com referênciaTraduz as alterações na origem de forma incremental.
lingo push 'locales/en.json'Usa planejamento com escopo definido, sem a comparação habitual com a origem anterior; destinos existentes podem ser adotados.
lingo push --backfill-missingCria os arquivos de destino ausentes para as origens configuradas.
Push com escopo definido e --forceRegenera os destinos selecionados em arquivos separados, sem manter o contexto dos destinos existentes.
Push com --keySeleciona unidades com chaves estáveis nos destinos existentes; a reutilização de valores inalterados depende do formato.

O preenchimento de arquivos ausentes não adiciona chaves novas ou alteradas a um arquivo de destino comum que já existe. Ele avisa sobre alterações na origem desde a referência salva; conclua essas atualizações de rotina com um push simples antes do preenchimento para manter os idiomas existentes atualizados. Um documento que abrange apenas parte dos idiomas configurados mantém a referência de origem existente, permitindo que um push simples posterior processe as edições pendentes dos demais. Catálogos XCStrings compartilhados usam planejamento por idioma. Os padrões posicionais selecionam apenas arquivos que também constam na configuração, sem aceitar arquivos arbitrários.

Opções #

OpçãoEfeito
Padrões posicionaisSelecionam arquivos configurados; coloque os curingas do shell entre aspas.
--force, -fSubstituem traduções de arquivos inteiros; use padrões explícitos de arquivo ou o preenchimento de arquivos ausentes.
--backfill-missingInicializa os arquivos de destino ausentes.
--key <pattern>Permite selecionar unidades estáveis e pode ser repetida.
--yes, -yDispensam a confirmação de substituição forçada.
--wait, -wAguardam e baixam os resultados, em vez de retornar logo após o envio.
--estimatePlaneja o trabalho e calcula o custo sem traduzir nem criar uma tarefa.
--with <stage>Executar uma etapa apenas neste envio; pode ser especificado mais de uma vez.
--without <stage>Ignorar uma etapa apenas neste envio; pode ser especificado mais de uma vez.
--review-*, --content-lengthAjustar as configurações de uma etapa apenas neste envio.

As opções booleanas têm false como valor padrão. Os destinos vêm da configuração; push não tem uma opção de idioma. A substituição forçada de arquivos inteiros pede confirmação, a menos que yes, a seleção por chave ou a estimativa dispense essa etapa. Sem padrões posicionais, --force seleciona todos os arquivos de origem e idiomas de destino configurados. Use padrões explícitos de arquivo e confira o escopo com --estimate antes de uma substituição ampla. A substituição forçada pode sobrescrever edições manuais no destino, pois descarta o contexto do destino atual nos formatos com arquivos separados. Catálogos XCStrings e tabelas CSV ainda podem reutilizar traduções incorporadas ao arquivo de origem compartilhado.

Atualize chaves selecionadas #

Use a atualização por chave quando as orientações salvas tiverem mudado, mas o texto de origem não, ou quando um subconjunto conhecido precisar ser traduzido novamente:

sh
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --wait

As chaves são caminhos com pontos ou colchetes. Ao selecionar um objeto, você inclui todas as strings contidas nele: auth.login inclui auth.login.title, mas não auth.login_url. * representa um segmento inteiro. A sintaxe com barras da versão anterior da CLI, como auth/login, também funciona. JSON, JSONC, TypeScript e PHP regeneram as strings selecionadas mesmo quando a origem não mudou. YAML e YAML com chaves na raiz aceitam a seleção por chave, mas podem reutilizar os valores atuais do destino quando a origem corresponde à referência salva. Para corrigir a redação em YAML, edite o destino diretamente; para uma regeneração mais ampla após mudanças nas orientações, salve os destinos aceitos e use --force para o arquivo inteiro, sem --key.

Idiomas de destino ausentes e formatos sem chaves estáveis são ignorados, com mensagens informando isso; outros formatos interrompem o push com um erro. Inicialize os destinos ausentes separadamente. Adicionar --force a --key não altera o planejamento com escopo por chave nem impede a reutilização em YAML.

Um push com escopo por chave mantém inalterada a referência da origem inteira, seja a coleta feita por push --wait ou por um pull posterior. Assim, as edições de rotina pendentes na origem ainda são processadas no próximo push simples. Escopos apresenta a matriz de formatos e a sintaxe das chaves.

Faça uma estimativa antes de uma substituição ampla #

sh
lingo push 'locales/en.json' --force --estimate

A estimativa planeja exatamente as alterações necessárias, sem traduzir nem criar uma tarefa. Ela envia os arquivos que faltam no servidor para esse plano, portanto faz uma chamada ao serviço: não é uma simulação offline. Ela não substitui o ponteiro salvo de pull nem a referência do processamento concluído. Como o primeiro push apenas armazena as origens, sua estimativa informa que não há nada a estimar e indica lingo push --estimate --backfill-missing.

A saída informa o custo planejado, as traduções a produzir e reutilizar, os tokens de saída e as linhas por idioma. O custo condicional de correções posteriores e os gastos cobrados pelo seu próprio provedor de IA aparecem em linhas separadas e ficam fora do total planejado; em seguida, os avisos indicam o que a estimativa não contempla. Os valores marcados com ~ são aproximados. Eles descrevem o plano, não o consumo medido nem uma cotação. Um push grande demais para ser estimado falha e exibe o motivo informado pelo servidor; forneça padrões de arquivo para estimar apenas parte dele.

Alterar etapas para um único envio #

bash
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-edit

Os sinalizadores de etapa alteram o fluxo de processamento do engine apenas neste envio, para que você possa testar uma configuração sem editar ou recriar o engine. Todas as configurações não especificadas por um sinalizador vêm do engine, incluindo seus grupos de revisão humana.

--with e --without aceitam pre-edit, rephrase, human-review, post-edit, content-length ou back-translation. A tradução sempre é executada. --without também ignora as etapas que dependem da etapa ignorada: --without human-review ignora a avaliação por IA e a pós-edição.

ConfiguraçãoValores
--review-leveleverything envia todas as unidades aos revisores; strict, medium ou lax envia apenas as unidades que a avaliação por IA sinaliza com o nível de gravidade correspondente.
--review-pool <name>As revisões usam este grupo em vez dos grupos do engine.
--review-languages <locales>Idiomas que o grupo --review-pool revisa, separados por vírgulas; por padrão, todos os idiomas.
--review-timeout <hours>O número de horas disponíveis para os revisores.
--content-length <rule>source, match:<percent> ou max:<columns>.

Uma configuração ajusta uma etapa sem ativá-la. Por isso, o envio falha se a etapa não for executada: adicione --with human-review ou --with content-length. Usar --with human-review em um engine sem grupos de revisão exige --review-pool. Solicitar uma etapa que seu plano não oferece faz o envio falhar, em vez de simplesmente ignorar a etapa. O envio grava os resultados como qualquer outro envio; adicione --force ou --key para traduzir novamente as unidades sem alterações e --estimate para calcular o custo da configuração antes de executá-la. Ao tentar novamente, repita os mesmos sinalizadores de etapa.

Para adicionar um idioma, primeiro conclua as atualizações de rotina da origem para os destinos existentes. Depois, adicione o idioma a targetLocales, confira lingo push --backfill-missing --estimate e solicite o preenchimento dos arquivos ausentes sem alterar a revisão da origem. Adicionar um idioma detalha essa sequência até as verificações na aplicação. Remover um idioma impede sua seleção futura, sem excluir arquivos. Não use a remoção definitiva de idioma em catálogos XCStrings compartilhados.

Colete resultados e recupere falhas #

Sem a opção de espera, mantenha o checkout e o ponteiro local da máquina até que pull recupere os resultados. Outro push pode substituir esse ponteiro. Com a opção de espera, confira os resultados com falha total ou parcial e os arquivos efetivamente baixados. A espera termina assim que todos os destinos ainda não concluídos estiverem aguardando revisão humana; execute pull depois que os revisores terminarem. Não edite os destinos durante a coleta direta com espera, pois ela não faz a nova comparação de edições locais realizada por pull.

Para tentar novamente um trabalho que falhou, corrija a causa e siga o procedimento de recuperação de execuções com falha: repita o push adequado com o estado preservado, confirme o ID da tarefa exibido e confira os resultados. Se os resultados do push anterior ainda não tiverem sido coletados e a solicitação não tiver mudado, push reutiliza essa solicitação em vez de duplicá-la: a conexão com uma tarefa em execução é retomada, os resultados de uma tarefa concluída são coletados e uma tarefa que falhou é substituída por uma nova.