Kuckt Konfiguratioun fir d'YAML-Schema an d'Luedreiefolleg.
Erfuerderlech Inputen
| Numm | Beschreiwung |
|---|---|
sourceLocale | Quellplaz (z.B. en), déi benotzt gëtt fir Ressourcedateien wéi **/*.en.resx ze fannen. Och un den Iwwersetzer als from=<locale> weidergeleet. |
subscriptionKey | Azure AI Translator subscription key. Fuert iwwer secrets. |
endpoint | Translator-Endpunkt-URL, z.B. https://api.cognitive.microsofttranslator.com/. |
Allgemeng optional Inputen
| Numm | Default | Beschreiwung |
|---|---|---|
region | Keng | Translator-Ressourceregioun (fir global Ressourcen ewechgelooss). |
toLocales | All ënnerstëtzt | Plazen fir ze iwwersetzen. Akzeptéiert e JSON-Array (["fr","de"]) oder Komma-getrennte Wäerter. |
include | Keng | Klo-Muster, déi duerch Newline getrennt sinn; nëmmen passend Dateien ginn iwwersat. |
exclude | Keng | Klo-Muster, déi duerch Newline getrennt sinn; Matchende Dateien ginn iwwersprongen (no Include ugewandt). |
configPath | .github/resource-translator.yml | Wee op d'YAML Konfiguratiounsdatei (relativ zum Workspace-Root). |
dryRun | false | Wann true, féiert Iwwersetzungen aus a generéiert Zesummefaassungen, awer schreift keng Dateien. |
failOnError | true | Wann true onerwaart Feeler d'Aktioun feelen; wann false, sinn Feeler Warnungen. |
Translator-Ufro-Inputen
Dës ginn direkt op Azure AI Translator v3 Ufroparameter ofgemappt. All eenzel ass fakultativ; d'Iwwersetzer-Standarden gëllen wann se net gesat ginn.
| Numm | Default | Beschreiwung |
|---|---|---|
categoryId | general | Azure Custom Translator Kategorie — den Industrie-/Domain-/Toun-Knäppchen. Weidergeleet als ?category=.... |
textType | plain | plain oder html. Benotz html nëmmen, wann deng Ressourcewäerter richteg HTML-Fragmenter sinn. |
profanityAction | NoAction | NoAction, Marked oder Deleted. Kontrolléiert, wéi profan Begrëffer an Iwwersetzungen ausgedréckt ginn. |
profanityMarker | Asterisk | Asterisk oder Tag. Nëmmen bedeitend wann profanityAction Marked ass. |
allowFallback | true (Iwwersetzer Standard) | Wann false, gëtt Translator eng Feeler zréck amplaz op de generelle System zréckzefalen, wann Äre categoryId keng Deployéierung fir eng Zilplaz huet. |
apiVersion | 3.0 | Translator REST API Versioun. |
Resilienz a Platzhalter-Schutz
Dës Inputen kontrolléieren, wéi d'Aktioun sech verhält, wann den Translator deng Ufro drosselt, a wéi et Platzhalter-Token wéi {{name}} oder {0} schützt, während der Iwwersetzung zerstéiert ze ginn.
| Numm | Default | Beschreiwung |
|---|---|---|
maxRetries | 5 | Maximal Retry-Versich op transient HTTP-Äntwerten (408, 425, 429, 500, 502, 503, 504). D'Gesamtzuel vun HTTP-Uruff pro Ufro ass 1 + maxRetries. |
retryBackoffMs | 30000 | Cap (an Millisekonnen) op all eenzelen Backoff-Schlof. D'Aktioun respektéiert Azure seng Retry-After Äntwert-Header genee wann se präsent ass; soss benotzt en jittered exponentiellen Backoff, deen op dëse Wäert limitéiert ass. |
protectPlaceholders | true | Wann true (Standard), ginn Plazhalter wéi {{name}}, ${var}, {0}, {0:N2}, %s, %1$s an HTML-Entitéiten virun der Iwwersetzung duerch Sentinel-Token ersat a spéider erëm restauréiert. Deaktivéiert nëmmen, wann Är Quell bewosst wörtlech Platzhalter-fërmegen Text enthält, deen iwwersat soll ginn. |
customPlaceholderPatterns | Keng | Zeilen-getrennte Regexen (ouni Delimiter), déi zum Standard-Platzhalter-Set derbäigesat goufen, z.B. <<.+?>> fir personaliséiert Token-Syntax. |
noTranslatePatterns | Keng | Newline-getrennte Glob-Muster, déi mat Parser-Niveau Schlësselen verglach ginn (JSON punktéierte Wee, RESX name, PO msgid, XLIFF Eenheet id, INI/restext Schlëssel). Passend Schlësselen ginn aus der Translator-Ufro ewechgeholl a ginn duerch, mat hirem Quellwäert erhalen. |
Ausgänge
| Numm | Beschreiwung |
|---|---|
summary-title | Kuerz PR-Titelfrëndlech Zesummefaassung, z.B. Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Markdown-Zesummefaassung gëeegent fir e PR-Kierper oder eng Job-Zesummefaassung. |
has-new-translations | 'true' wann eng oder méi nei Iwwersetzungen generéiert goufen. |