Zie Configuratie voor het YAML-schema en laadvolgorde.
Vereiste invoer
| Naam | Beschrijving |
|---|---|
sourceLocale | Bronlocatie (bijv. en) gebruikt om bronbestanden zoals **/*.en.resx te vinden. Ook doorgestuurd naar de vertaler als from=<locale>. |
subscriptionKey | Azure AI Translator subscription key. Ga via secrets. |
endpoint | Vertaler-endpoint URL, bijvoorbeeld https://api.cognitive.microsofttranslator.com/. |
Veelvoorkomende optionele invoer
| Naam | Standaard | Beschrijving |
|---|---|---|
region | Geen | Vertalerresourceregio (weggelaten voor globale bronnen). |
toLocales | alle ondersteunde | Locaties om naar te vertalen. Accepteert een JSON-array (["fr","de"]) of komma-gescheiden waarden. |
include | Geen | Newline-gescheiden globpatronen; alleen overeenkomende bestanden worden vertaald. |
exclude | Geen | Newline-gescheiden globpatronen; Matching files worden overgeslagen (toegepast na include). |
configPath | .github/resource-translator.yml | Pad naar het YAML-configuratiebestand (ten opzichte van de root van de werkruimte). |
dryRun | false | Wanneer true, voer vertalingen uit en genereer samenvattingen, maar schrijf geen bestanden. |
failOnError | true | Wanneer true, mislukken onverwachte fouten de actie; Wanneer false, zijn fouten waarschuwingen. |
Invoer van vertalerverzoeken
Deze worden direct gekoppeld aan Azure AI Translator v3 queryparameters. Elke optie is optioneel; de standaardinstellingen van de Vertaler gelden wanneer deze worden uitgeschakeld.
| Naam | Standaard | Beschrijving |
|---|---|---|
categoryId | general | Azure Custom Translator categorie — de industrie/domein/toonknop. Doorgestuurd als ?category=.... |
textType | plain | plain of html. Gebruik html alleen wanneer je resourcewaarden echte HTML-fragmenten zijn. |
profanityAction | NoAction | NoAction, Marked of Deleted. Bepaalt hoe grove termen worden uitgesproken in vertalingen. |
profanityMarker | Asterisk | Asterisk of Tag. Alleen betekenisvol als profanityAction Marked is. |
allowFallback | waar (Vertaler standaard) | Wanneer false, geeft Translator een foutmelding in plaats van terug te vallen op het algemene systeem als je categoryId geen deployment voor een doellocatie heeft. |
apiVersion | 3.0 | Translator REST API-versie. |
Veerkracht en tijdelijke bescherming
Deze inputs bepalen hoe de actie zich gedraagt wanneer Translator je verzoek afknijpt en hoe het placeholder-tokens zoals {{name}} of {0} beschermt tegen verminking tijdens vertaling.
| Naam | Standaard | Beschrijving |
|---|---|---|
maxRetries | 5 | Maximale herpogingen bij transiente HTTP-antwoorden (408, 425, 429, 500, 502, 503, 504). Het totale aantal HTTP-aanroepen per verzoek is 1 + maxRetries. |
retryBackoffMs | 30000 | Beperk (in milliseconden) op elke enkele backoff-slaapstand. De actie houdt zich precies aan Azure's Retry-After response-header wanneer aanwezig; anders gebruikt het jittered exponentiële backoff met een maximum op deze waarde. |
protectPlaceholders | true | Wanneer true (standaard), worden plaatshouders zoals {{name}}, ${var}, {0}, {0:N2}, %s, %1$s en HTML-entiteiten vervangen door sentinel-tokens vóór vertaling en daarna hersteld. Schakel alleen uit wanneer je bron opzettelijk letterlijke tijdelijke tekst bevat die vertaald moet worden. |
customPlaceholderPatterns | Geen | Nieuwlijn-gescheiden regexen (zonder scheidingstekens) toegevoegd aan de standaard plaatshouderset, bijvoorbeeld <<.+?>> voor aangepaste tokensyntaxis. |
noTranslatePatterns | Geen | Newline-gescheiden globpatronen worden gekoppeld aan parser-niveau sleutels (JSON gestippelde pad, RESX name, PO msgid, XLIFF unit id, INI/restext key). Overeenkomende sleutels worden uit het vertalerverzoek verwijderd en doorgegeven, waarbij hun bronwaarde behouden blijft. |
Uitgangen
| Naam | Beschrijving |
|---|---|
summary-title | Korte PR-titelvriendelijke samenvatting, bijvoorbeeld Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Markdown-samenvatting geschikt voor een PR-organisatie of functiebeschrijving. |
has-new-translations | 'true' wanneer één of meer nieuwe vertalingen werden gegenereerd. |