Pular para o conteúdo
Pular para o conteúdo

Referência / CLI

Página traduzida automaticamente

Esta página foi traduzida automaticamente, então pode ter erros ou soar um pouco estranha. A versão em inglês é a fonte da verdade. Ler o original em inglês.

verbatra export

Exporta as strings sem tradução em uma entrega: pasta de trabalho do Excel, um CSV ou TSV por locale, ou um XLIFF por locale para uma ferramenta CAT.

Grava as strings que precisam de tradução em uma entrega que uma pessoa preenche e devolve ao verbatra import. Por padrão, ela leva só as strings ausentes e alteradas, as mesmas chaves que uma execução automática enviaria a um provedor. Uma chave cujo valor de origem está vazio ou só tem espaços não recebe linha até você escrever o texto de origem dela. O export nunca chama um provedor e não precisa de chave de API.

Sinopse

verbatra export [flags]

Exemplos

# write the workbook with missing and changed strings
verbatra export

# only the German and French sheets, to a specific path
verbatra export --locales de,fr --out handoff/round-2.xlsx

# one de.csv and fr.csv under handoff/
verbatra export --format csv --out handoff

# one de.xlf and fr.xlf in XLIFF 2.0 for a CAT tool
verbatra export --format xliff2 --out handoff

Flags

FlagArgumentoPadrãoEfeito
--out<path>verbatra-translations.xlsx, ou verbatra-translations para os outros formatosonde gravar a entrega: um arquivo para xlsx, um diretório para csv, tsv, xliff2 e xliff12
--format<format>xlsxxlsx (pasta de trabalho do Excel), csv ou tsv (um arquivo por locale), xliff2 ou xliff12 (um arquivo XLIFF por locale)
--locales<list>todos os locales de destino configuradosexporta só este subconjunto separado por vírgulas; um locale não configurado falha com UNKNOWN_LOCALE e uma lista vazia com INVALID_LOCALES, ambos com saída 2
--include-unchangednenhumdesativadoexporta também as strings que já estão atualizadas

Aceita também as flags globais --cwd, --config e --json.

Comportamento

CSV e TSV

--format csv e --format tsv gravam um <locale>.csv ou <locale>.tsv por locale exportado, com as mesmas colunas, na mesma ordem, que uma planilha da pasta de trabalho. --out nomeia o diretório, que é criado se não existir.

Um arquivo delimitado pode ser comparado com diff e abre em qualquer lugar, mas não tem proteção de células: todas as colunas são editáveis e a coluna Source hash fica visível. Um hash editado nunca é aceito: a importação o compara com a origem atual e retém a linha.

Cada exportação delimitada também grava um manifesto oculto, .verbatra-export-csv.json ou .verbatra-export-tsv.json, que nomeia os locales gravados. Uma exportação posterior com --locales mais restrito aposenta os locales que saíram: os arquivos deles permanecem em disco, e o verbatra import os recusa como sobras. A exportação nunca exclui nada do diretório de saída.

XLIFF

--format xliff2 grava XLIFF 2.0 e --format xliff12 grava XLIFF 1.2: um <locale>.xlf por locale exportado no diretório de --out, mais um manifesto .verbatra-export-xliff.json que funciona como o do CSV. Cada chave vira uma unidade com o nome da chave, placeholders e marcação viram códigos inline protegidos, a descrição e o significado da chave viram notas, e o estado do segmento segue o estado no arquivo de lock e o estado de revisão (initial para uma chave ausente ou obsoleta, translated quando está atualizada, reviewed quando foi aprovada). Veja Entregar a uma agência (XLIFF).

Cada destino também diz de onde veio. No XLIFF 1.2, um destino que um provedor, a memória de tradução ou um agente de IA escreveu e que nenhuma pessoa aprovou traz state-qualifier="mt-suggestion"; no XLIFF 2.0, o grupo de metadados verbatra da unidade traz origin e review-state. A importação ignora os dois. Quando verbatra.provenance.json não pode ser lido, nenhum marcador é gravado e o resultado de --json traz provenanceMarkers: "unavailable". Veja Registrar evidências de tradução automática.

Onde a entrega é gravada

A entrega só é gravada dentro da raiz do projeto. Antes de ler qualquer coisa, o export recusa com EXPORT_OUTPUT_CONFLICT um --out que saia da raiz do projeto ou que (por si mesmo ou por um arquivo que ele gravaria) nomeie um arquivo de que o projeto depende: um arquivo de locale configurado, o arquivo de lock, o arquivo de procedência, o cache da memória de tradução, um arquivo de configuração que o verbatra procura, a configuração que a execução carregou ou o arquivo de glossary configurado. Para xlsx, também são recusados um caminho que não nomeia nenhum arquivo (como out/) e a própria raiz do projeto. Os nomes são comparados sem diferenciar maiúsculas de minúsculas, e as verificações são repetidas depois que os links simbólicos são resolvidos.

Um caminho que passa ainda pode falhar na gravação (sem permissão de escrita, caminho já ocupado, disco cheio): a execução para com EXPORT_UNWRITABLE, nomeando o arquivo e o código do sistema de arquivos.

Um locale de destino que não consegue nomear sua planilha ou seu arquivo interrompe a exportação com WORKBOOK_INVALID. O nome de uma planilha xlsx deve ter de 1 a 31 caracteres, não pode conter nenhum de : \ / ? * [ ] e não pode coincidir com Instructions nem com o nome da planilha de outro locale de destino, sem diferenciar maiúsculas de minúsculas. O nome de um arquivo csv, tsv ou xlf não pode ser vazio, . ou .., e não pode conter separador de caminho, caractere de controle nem nenhum de : * ? " < > |. O mesmo código cobre uma pasta de trabalho que não pôde ser serializada.

Retorno no terminal

O export mostra uma linha enquanto grava e, quando havia algo a entregar, nomeia a importação que traz o arquivo preenchido de volta:

Saída
verbatra: exporting to xlsx... done (0.3s)
next: verbatra import verbatra-translations.xlsx (once your translators have filled it in)

Quando nada está pendente e --include-unchanged não foi passado, o arquivo não tem linhas, e a linha next: sugere a mesma exportação com --include-unchanged, mantendo --format, --out, --locales, --cwd e --config.

Essas linhas vão para o stderr, e --quiet as omite. Veja Saída no terminal.

Um verbatra.limits.json que não pode ser usado é ignorado com um alerta no stderr (LIMITS_FILE_IGNORED no --json).

Saída JSON

Schema: export-envelope.json valida o envelope inteiro (o objeto JSON da resposta); Schemas lista os outros.

Com --json, o envelope traz para onde a entrega foi e a contagem de linhas por locale:

{
  path: string;                // absolute path: the workbook for xlsx, the output directory otherwise
  locales: { locale: string; rows: number }[];
  provenanceMarkers?: "written" | "unavailable"; // XLIFF formats only
  limitsNotice?: { code: "LIMITS_FILE_IGNORED"; message: string };
}

Códigos de saída

CódigoSignificado
0a entrega foi gravada
2não foi possível executar: um erro que afeta a execução inteira, um caminho de saída recusado (EXPORT_OUTPUT_CONFLICT), uma entrega que não pôde ser gravada (EXPORT_UNWRITABLE, WORKBOOK_INVALID) ou um erro de uso

O export não tem modo de falha por locale, então nunca termina com 1. Veja Códigos de saída para o contrato que todo comando segue.

Veja também

Editar no GitHub

Nesta página