Veja Configuração para o esquema YAML e a ordem de carregamento.
Entradas necessárias
| Nome | Descrição |
|---|---|
sourceLocale | Local de origem (por exemplo, en) usado para encontrar ficheiros de recursos como **/*.en.resx. Também encaminhado para o Tradutor como from=<locale>. |
subscriptionKey | Chave de subscrição Azure AI Translator. Passa pela secrets. |
endpoint | URL do endpoint do tradutor, por exemplo, https://api.cognitive.microsofttranslator.com/. |
Entradas opcionais comuns
| Nome | Padrão | Descrição |
|---|---|---|
region | nenhum | Região de recursos tradutores (omitir recursos globais). |
toLocales | todos suportados | Locais para traduzir. Aceita um array JSON (["fr","de"]) ou valores separados por vírgulas. |
include | nenhum | Padrões de globos separados por linhas novas; apenas os ficheiros correspondentes são traduzidos. |
exclude | nenhum | Padrões de globos separados por linhas novas; Os ficheiros correspondentes são ignorados (aplicados após incluir). |
configPath | .github/resource-translator.yml | Caminho para o ficheiro de configuração YAML (relativo à raiz do workspace). |
dryRun | false | Quando true, execute traduções e emita resumos, mas não escreva ficheiros. |
failOnError | true | Quando true, erros inesperados falham a ação; Quando false, os erros são avisos. |
Entradas de pedido do tradutor
Estes mapeiam diretamente para os parâmetros de consulta do Azure AI Translator v3. Todos são opcionais; os valores predefinidos do tradutor aplicam-se quando não estão definidos.
| Nome | Padrão | Descrição |
|---|---|---|
categoryId | general | Azure Custom Translator category — o botão industry/domain/tone knob. Encaminhado como ?category=.... |
textType | plain | plain ou html. Usa-html apenas quando os teus valores de recursos forem fragmentos HTML reais. |
profanityAction | NoAction | NoAction, Marked ou Deleted. Controla como os termos profanos são emitidos nas traduções. |
profanityMarker | Asterisk | Asterisk ou Tag. Só significa quando profanityAction é Marked. |
allowFallback | true (Tradutor por defeito) | Quando false, o Tradutor devolve um erro em vez de recorrer ao sistema geral se o seu categoryId não tiver deployment para um local alvo. |
apiVersion | 3.0 | Tradutor versão da API REST. |
Resiliência e proteção provisória
Estas entradas controlam como a ação se comporta quando o Tradutor limita o seu pedido e como protege tokens provisórios como {{name}} ou {0} de serem manipulados durante a tradução.
| Nome | Padrão | Descrição |
|---|---|---|
maxRetries | 5 | Tentativas máximas em respostas HTTP transitórias (408, 425, 429, 500, 502, 503, 504). O número total de chamadas HTTP por pedido é 1 + maxRetries. |
retryBackoffMs | 30000 | Limite (em milissegundos) para qualquer sono de recuo. A ação honra o cabeçalho de resposta Retry-After do Azure exatamente quando presente; caso contrário, utiliza um backoff exponencial com tremor limitado a este valor. |
protectPlaceholders | true | Quando true (por defeito), os marcadores de posição como {{name}}, ${var}, {0}, {0:N2}, %s, %1$s e HTML são substituídos por tokens sentinela antes da tradução e restaurados posteriormente. Desative apenas quando a sua fonte contiver intencionalmente texto literal em forma de marcador que deva ser traduzido. |
customPlaceholderPatterns | nenhum | Regexes separados por novas linhas (sem delimitadores) adicionados ao conjunto de marcadores de posição padrão, por exemplo, <<.+?>> para sintaxe personalizada de tokens. |
noTranslatePatterns | nenhum | Padrões de globos separados por nova linha correspondiam às chaves ao nível do parser (JSON doted path, RESX name, PO msgid, unidade XLIFF id, chave INI/restext). As chaves correspondentes são eliminadas do pedido do Tradutor e passam com o seu valor de origem preservado. |
Saídas
| Nome | Descrição |
|---|---|
summary-title | Resumo curto e adequado para títulos de relações públicas, por exemplo, Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Resumo de desconto adequado para um órgão de relações públicas ou resumo de cargos. |
has-new-translations | 'true' quando uma ou mais novas traduções eram geradas. |