Vezi Configurație pentru schema YAML și ordinea de încărcare.
Intrări necesare
| Nume | Descriere |
|---|---|
sourceLocale | Localitatea sursă (de exemplu en) folosită pentru a găsi fișiere de resurse precum **/*.en.resx. De asemenea, redirecționat către Translator ca from=<locale>. |
subscriptionKey | Cheia de abonament Azure AI Translator. Treci prin secrets. |
endpoint | URL-ul de endpoint al traducătorului, de exemplu https://api.cognitive.microsofttranslator.com/. |
Intrări opționale comune
| Nume | Implicit | Descriere |
|---|---|---|
region | niciuna | Regiunea de resurse traducătoare (omiterea resurselor globale). |
toLocales | toate suportate | Locații în care să traduci. Acceptă un array JSON (["fr","de"]) sau valori separate de virgule. |
include | niciuna | Modele de glob separat de linii newline; Doar fișierele corespunzătoare sunt traduse. |
exclude | niciuna | Modele de glob separat de linii newline; Fișierele de potrivire sunt sărite (aplicate după include). |
configPath | .github/resource-translator.yml | Calea către fișierul de configurare YAML (relativ la rădăcina spațiului de lucru). |
dryRun | false | Când true, rulează traduceri și emite rezumate, dar nu scrie fișiere. |
failOnError | true | Când true, erorile neașteptate eșuează acțiunea; Când false, erorile sunt avertismente. |
Intrări de cerere de traducător
Acestea se mapează direct către parametrii interogării Azure AI Translator v3. Fiecare este opțional; implicitele Traducătorului se aplică când nu este setată.
| Nume | Implicit | Descriere |
|---|---|---|
categoryId | general | Azure Custom Translator category — butonul industry/domain/ton. Redirecționat ca ?category=.... |
textType | plain | plain sau html. Folosește html doar când valorile resurselor tale sunt fragmente HTML reale. |
profanityAction | NoAction | NoAction, Marked sau Deleted. Controlează modul în care termenii profani sunt emși în traduceri. |
profanityMarker | Asterisk | Asterisk sau Tag. Are sens doar când profanityAction este Marked. |
allowFallback | true (implicit traducător) | Când false, traducătorul returnează o eroare în loc să revină la sistemul general dacă categoryId ta nu are implementare pentru o locație țintă. |
apiVersion | 3.0 | Versiunea API REST a traducătorului. |
Reziliență și protecție provizorie
Aceste intrări controlează modul în care acțiunea se comportă atunci când Translator îți limitează cererea și cum protejează tokenurile provizorii precum {{name}} sau {0} de a fi distruse în timpul traducerii.
| Nume | Implicit | Descriere |
|---|---|---|
maxRetries | 5 | Numărul maxim de încercări de reîncercare pentru răspunsurile HTTP tranzitorii (408, 425, 429, 500, 502, 503, 504). Numărul total de apeluri HTTP pe cerere este 1 + maxRetries. |
retryBackoffMs | 30000 | Limitează (în milisecunde) orice somn de retragere. Acțiunea onorează antetul Retry-After răspuns al Azure, exact când este prezent; în caz contrar, folosește un backoff exponențial cu tremurat, limitat la această valoare. |
protectPlaceholders | true | Când true (implicit), elementele de înlocuire precum {{name}}, ${var}, {0}, {0:N2}, %s, %1$s și entități HTML sunt înlocuite cu tokenuri sentinel înainte de traducere și restaurate ulterior. Dezactivează doar atunci când sursa ta conține intenționat text literal în formă de înlocuitor care ar trebui tradus. |
customPlaceholderPatterns | niciuna | Regexuri separate de linii noi (fără delimitatori) adăugate la setul implicit de placeholder, de exemplu <<.+?>> pentru sintaxă personalizată a tokenului. |
noTranslatePatterns | niciuna | Modelele glob separate de linii noi se potriveau cu cheile la nivel de parser (căile punctate JSON, name RESX, msgid PO, id unității XLIFF, cheia INI/restext). Cheile corespunzătoare sunt eliminate din cererea Translator și trec cu valoarea sursă păstrată. |
Ieșiri
| Nume | Descriere |
|---|---|
summary-title | Rezumat scurt prietenos cu titlul de PR, de exemplu Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Rezumat de reducere potrivit pentru un corp de PR sau un rezumat de post. |
has-new-translations | 'true' când erau generate una sau mai multe traduceri noi. |