lingo push
Envie alterações à origem, crie os ficheiros de destino em falta ou atualize intencionalmente as traduções selecionadas.
Após a configuração do primeiro ficheiro, utilize lingo push --wait para as alterações habituais à origem. A CLI compara os bytes da origem com a referência guardada, solicita o processamento das alterações e descarrega os destinos concluídos. As origens cujos bytes não sofreram alterações são ignoradas.
Os outros modos destinam-se a tarefas diferentes. Escolha-os em função do que pretende alterar, em vez de tratar cada push como uma tradução completa.
Escolher o trabalho a realizar #
| Invocação | Comportamento |
|---|---|
| Push simples sem uma referência válida | Guarda os bytes da origem; não solicita automaticamente uma tradução inicial. |
| Push simples com uma referência | Traduz as alterações à origem de forma incremental. |
lingo push 'locales/en.json' | Utiliza um planeamento de âmbito definido, sem a comparação habitual com a origem anterior; permite adotar os destinos existentes. |
lingo push --backfill-missing | Cria os ficheiros de destino em falta para as origens configuradas. |
Push de âmbito definido com --force | Regenera os destinos selecionados em ficheiros separados, sem manter o contexto dos destinos existentes. |
Push com --key | Seleciona unidades com chaves estáveis nos destinos existentes; a reutilização de valores inalterados depende do formato. |
O preenchimento de ficheiros em falta não adiciona chaves novas ou alteradas a um ficheiro de destino normal que já exista. Avisa se houver alterações à origem desde a referência guardada; conclua essas atualizações habituais com um push simples antes de preencher os ficheiros em falta, para manter os idiomas existentes atualizados. Um documento que abranja apenas parte dos idiomas configurados mantém a referência de origem existente, para que um push simples posterior possa processar as edições pendentes dos restantes idiomas. Os catálogos XCStrings partilhados utilizam planeamento por idioma. Os padrões posicionais restringem a seleção aos ficheiros configurados, em vez de permitirem ficheiros arbitrários.
Opções #
| Opção | Efeito |
|---|---|
| Padrões posicionais | Selecionam ficheiros configurados; coloque os carateres universais da shell entre aspas. |
--force, -f | Substituem traduções de ficheiros completos; utilize padrões de ficheiro explícitos ou o preenchimento de ficheiros em falta. |
--backfill-missing | Cria os ficheiros de destino em falta. |
--key <pattern> | Permite selecionar unidades estáveis e pode ser repetida. |
--yes, -y | Dispensam a confirmação de substituição forçada. |
--wait, -w | Aguardam e descarregam os resultados, em vez de terminarem após o envio. |
--estimate | Planeia o trabalho e calcula o respetivo custo sem traduzir nem criar uma tarefa. |
--with <stage> | Executar uma etapa apenas neste envio; a opção pode ser repetida. |
--without <stage> | Ignorar uma etapa apenas neste envio; a opção pode ser repetida. |
--review-*, --content-length | Ajustar as definições de uma etapa apenas neste envio. |
As opções booleanas têm o valor falso por predefinição. Os destinos são definidos na configuração; o push não tem uma opção de idioma. A substituição forçada de ficheiros completos pede confirmação, exceto quando a confirmação automática, a seleção por chave ou a estimativa dispensam esse pedido. Sem padrões posicionais, --force seleciona todos os ficheiros de origem e idiomas de destino configurados. Utilize padrões de ficheiro explícitos e verifique o âmbito com --estimate antes de uma substituição abrangente. A substituição forçada pode substituir edições manuais nos destinos, pois elimina o contexto do destino atual nos formatos com ficheiros separados. Os catálogos XCStrings e as tabelas CSV podem continuar a reutilizar traduções incorporadas no ficheiro de origem partilhado.
Atualizar as chaves selecionadas #
Utilize uma atualização por chave quando as orientações guardadas tiverem mudado, mas o texto de origem não, ou quando um subconjunto conhecido precisar de ser traduzido novamente:
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --waitAs chaves são caminhos com pontos ou parênteses retos. Selecionar um objeto inclui todas as cadeias de texto nele contidas: auth.login inclui auth.login.title, mas não auth.login_url. * representa um segmento inteiro. A notação com barras da versão anterior da CLI, como auth/login, também funciona. JSON, JSONC, TypeScript e PHP regeneram as cadeias de texto selecionadas, mesmo quando a respetiva origem não mudou. YAML e YAML com chaves de raiz aceitam a seleção por chave, mas podem reutilizar os valores atuais do destino quando a origem corresponde à referência guardada. Para corrigir a redação em YAML, edite diretamente o destino; para uma regeneração mais abrangente após alterações às orientações, guarde os destinos aceites e utilize --force para o ficheiro completo, sem --key.
Os idiomas de destino em falta e os formatos sem chaves estáveis são ignorados, com mensagens a indicá-lo; os restantes formatos interrompem o push com um erro. Crie os destinos em falta separadamente. Adicionar --force a --key não altera o planeamento por chave nem impede a reutilização em YAML.
Um push limitado a determinadas chaves mantém inalterada a referência da origem completa, quer os resultados sejam recolhidos por push --wait ou por um pull posterior. Assim, as alterações habituais à origem que estejam pendentes continuam a ser processadas no push simples seguinte. Âmbitos apresenta a matriz de formatos e a gramática das chaves.
Obter uma estimativa antes de uma substituição abrangente #
lingo push 'locales/en.json' --force --estimateA estimativa planeia exatamente as alterações necessárias, sem traduzir nem criar uma tarefa. Envia os ficheiros de que o servidor não dispõe para esse plano, pelo que faz uma chamada ao serviço, não uma simulação sem ligação. Não substitui o apontador de pull guardado nem a referência concluída. O primeiro push apenas guarda as origens, pelo que a respetiva estimativa indica que não há nada a estimar e remete para lingo push --estimate --backfill-missing.
O resultado apresenta o custo planeado, as traduções a produzir e a reutilizar, os tokens de saída e as linhas por idioma. Os custos eventuais de correções posteriores e as despesas faturadas pelo seu próprio fornecedor de IA aparecem em linhas separadas e não entram no total planeado; os avisos indicam depois o que fica excluído da estimativa. Os montantes assinalados com ~ são aproximados. Descrevem o plano, não o consumo medido nem um orçamento. Um push demasiado grande para permitir uma estimativa falha e apresenta o motivo indicado pelo servidor; forneça padrões de ficheiro para estimar apenas uma parte.
Alterar etapas num único envio #
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-editAs opções de etapa alteram o fluxo de processamento do motor apenas neste envio, permitindo experimentar uma configuração sem editar nem recriar o motor. Todas as definições não especificadas por uma opção são herdadas do motor, incluindo os 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.
| Definição | Valores |
|---|---|
--review-level | everything envia todas as unidades para os revisores; strict, medium ou lax envia apenas as unidades que a avaliação por IA assinala com esse nível de gravidade. |
--review-pool <name> | As revisões utilizam este grupo em vez dos grupos do motor. |
--review-languages <locales> | Idiomas que o grupo --review-pool revê, separados por vírgulas; por predefinição, todos os idiomas. |
--review-timeout <hours> | O número de horas de que os revisores dispõem. |
--content-length <rule> | source, match:<percent> ou max:<columns>. |
Uma definição ajusta uma etapa sem a ativar, pelo que o envio falha se essa etapa não for executada: adicione --with human-review ou --with content-length. Num motor sem grupos de revisão, --with human-review requer --review-pool. Se solicitar uma etapa que o seu plano não inclui, o envio falha em vez de essa etapa ser ignorada. O envio guarda os resultados como qualquer outro envio; adicione --force ou --key para voltar a traduzir as unidades sem alterações e --estimate para calcular primeiro o custo da configuração. Ao tentar novamente, tem de usar as mesmas opções de etapa.
Para adicionar um novo idioma, conclua primeiro as atualizações habituais da origem para os destinos existentes. Depois, adicione-o a targetLocales, verifique lingo push --backfill-missing --estimate e solicite o preenchimento dos ficheiros em falta sem alterar a revisão da origem. Adicionar um idioma explica essa sequência até às verificações na aplicação. Remover um idioma impede a sua seleção futura, sem eliminar ficheiros. Não utilize a purga de idiomas em catálogos XCStrings partilhados.
Recolher e recuperar #
Sem a opção de espera, mantenha o checkout e o apontador local da máquina até que pull obtenha os resultados. Outro push pode substituir esse apontador. Com a opção de espera, verifique os resultados com falha total ou parcial e os ficheiros efetivamente descarregados. A espera termina assim que todos os destinos por concluir estiverem a aguardar revisão humana; execute pull quando as pessoas responsáveis pela revisão terminarem. Não edite os destinos durante a recolha direta em modo de espera, pois esta não efetua uma nova comparação com as edições locais, ao contrário de pull.
Para voltar a tentar o trabalho que falhou, corrija a causa e siga o procedimento de recuperação de execuções com falha: repita o push adequado mantendo o estado, confirme o ID da tarefa apresentado e verifique os resultados obtidos. Se os resultados do push anterior nunca tiverem sido recolhidos e o pedido não tiver mudado, o push reutiliza esse pedido em vez de o duplicar: volta a associar-se a uma tarefa em execução, recolhe os resultados de uma tarefa concluída e substitui uma tarefa com falha por uma nova.