Konfigurācija · Resursu tulkotājs

Ignorējiet ceļu ar configPath ievadi, ja jums ir nepieciešama atrašanās vieta, kas nav noklusējuma.

Shēma

# .github/resource-translator.yml
sourceLocale: en

# Provider config can be nested. Keep secrets in workflow inputs; use repo
# config for non-secret defaults like region, model, formality, or category.
provider:
  azure:
    categoryId: my-custom-translator-category
    apiVersion: "3.0"
    allowFallback: true

toLocales:
  - fr
  - de
  - es
include:
  - "src/**/*.en.json"
  - "apps/**/*.en.resx"
exclude:
  - "**/__tests__/**"
glossary:
  Acme: Contoso
  Octocat: Octocat   # keep brand names verbatim

# Translator request shape — most users can ignore these.
textType: plain                  # plain | html
profanityAction: NoAction        # NoAction | Marked | Deleted
profanityMarker: Asterisk        # Asterisk | Tag (only when profanityAction == Marked)

# Resilience — Translator returns 429 under load. Defaults are usually
# fine; tune only if your runs are large enough to hit them.
maxRetries: 5
retryBackoffMs: 30000             # cap on any single backoff sleep (ms)

# Placeholder protection. ON by default — wraps tokens like {{name}},
# {0}, %s, ${var} into sentinels before translation and restores them
# on the way back. Set false only when source intentionally contains
# placeholder-shaped literals.
protectPlaceholders: true
customPlaceholderPatterns:
  - "<<.+?>>"                     # any extra token syntax you use

# Per-key opt-out. Keys matching any glob are dropped from the request
# and pass through with the source value preserved.
noTranslatePatterns:
  - "errors.code.*"
  - "brands.*"

Lauka atsauce

provider

Veids: "azure" | "aws" | "google" | provider block

Either a provider string or a nested provider block (provider.azure, provider.aws, or provider.google). Prefer nested blocks for provider-specific settings; keep secrets in workflow inputs rather than committed config.

sourceLocale

Veids: string

Atgriežas pie sourceLocale ievades, ja tas nav iestatīts. Pārsūtīts arī uz tulkotāju, jo from=<locale> tāpēc īsās virknes netiek automātiski noteiktas.

toLocales

Veids: string[]

Masīvs vai ar komatiem atdalīta virkne.

include / exclude

Veids: string[]

Glob modeļi, kas novērtēti pret absolūtiem un darbvietas relatīviem ceļiem.

glossary

Veids: map<string,string>

Pēctulkošanas terminu ignorēšana. Vārdu robežas apzinās (rokturi C++, .NET).

categoryId

Veids: string

Azure Custom Translator kategorija — jūsu nozares/domēna poga (juridiskā, medicīniskā, mārketinga tonis utt.). Nosūtīts kā ?category=....

textType

Veids: "plain" | "html"

Noklusējuma vērtība ir plain. Izmantojiet html tikai tad, ja resursu vērtības satur reālus HTML fragmentus.

profanityAction

Veids: "NoAction" | "Marked" | "Deleted"

Kā izturēties pret profāniem terminiem tulkotajā izvadē.

profanityMarker

Veids: "Asterisk" | "Tag"

Tikai tad, ja profanityAction ir "Marked".

allowFallback

Veids: boolean

Iestatiet false, lai neizdodas tulkot, ja jūsu categoryId nav izvietojuma mērķa lokalizācijai, nevis atgriezties pie vispārējā modeļa.

apiVersion

Veids: string

Tulkotāja REST API versija. Noklusējuma vērtība ir 3.0.

awsFormality

Veids: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

Veids: boolean

Set to true to enable AWS Translate brevity mode for supported language pairs.

awsTerminologyNames / awsParallelDataNames

Veids: string[]

AWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.

googleModel

Veids: string

Google Cloud Translation model, e.g. nmt or base.

googleApiEndpoint

Veids: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Veids: boolean

Optional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.

maxRetries

Veids: integer

Maksimālais atkārtoto mēģinājumu skaits ar īslaicīgām HTTP atbildēm (408, 425, 429, 500, 502, 503, 504). Noklusējuma vērtība ir 5. Kopējais HTTP zvanu skaits vienā pieprasījumā ir 1 + maxRetries.

retryBackoffMs

Veids: integer

Ierobežojums (ms) uz jebkuru atsevišķu backoff miega režīmu. Noklusējuma vērtība ir 30000. Azure Retry-After galvene tiek godināta tieši tad, kad tā ir klāt; pretējā gadījumā tiek izmantots trīcīgs eksponenciāls backoff, kas ierobežots ar šo vērtību.

protectPlaceholders

Veids: boolean

Noklusējuma vērtība ir true. Kad tie ir ieslēgti, tādi marķieri kā {{name}}, ${var}, {0}, {0:N2}, %s, %1$s un HTML entītijas pirms tulkošanas tiek aizstāti ar kontrolmarķieriem un pēc tam atjaunoti. Atspējot tikai tad, ja avots apzināti satur viettura formas literāļus.

customPlaceholderPatterns

Veids: string[]

Papildu regulārās izteiksmes modeļi (bez norobežotājiem), kas pievienoti noklusējuma vietturu kopai, piemēram, <<.+?>> pielāgotai marķieru sintaksei. Nederīgi regeksi tiek ignorēti.

noTranslatePatterns

Veids: string[]

Glob modeļi, kas saskaņoti ar parsētāja līmeņa atslēgām (JSON punktētais ceļš, RESX name, PO msgid, XLIFF vienība id, INI/restext taustiņš). Atbilstošās atslēgas tiek izmestas no pieprasījuma un tiek izvadītas, saglabājot to avota vērtību.

changeDetection

Veids: "smart" | "disabled"

Defaults to smart. Uses the committed state manifest to translate only changed or missing parser keys. Set to disabled or false to preserve the legacy always-translate behavior.

statePath

Veids: string

Path to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.

Iekraušanas pasūtījums

Darbība nolasa nepārprotamu ievadi no darbplūsmas.
Tas ielādē YAML konfigurāciju no configPath.
Katrā koplietojamajā laukā uzvar ievade; pretējā gadījumā tiek izmantota YAML vērtība.
Sapludinātās vērtības tiek validētas. Nederīgi uzskaitījumi (piemēram, profanityAction: Mask) izraisa ātru darbības neveiksmi ar skaidru ziņojumu.

Tonis un rūpniecība, vienkārši izsakoties.

Azure AI Translator v3 API nav vienas toņa pogas. Divi iestatījumi apvienojas, lai nodrošinātu lielāko daļu no vienas un tās pašas vadības:

Nozare / joma: izmantojiet categoryId, lai norādītu uz Azure Custom Translator kategoriju, kas ir apmācīta jūsu korpusā — juridiskajā, tehniskajā, medicīniskajā, mārketinga vai jebkā citā. Šī ir spēcīgākā tonis, zīmola balss un vārdu krājuma svira.
Virsmas teksts: Izmantojiet glosārijs, lai burtiski bloķētu zīmolu nosaukumus un produktu terminus, un izmantojiet profanityAction, lai iztīrītu rupjus terminus, atlasot lokalizāciju jaunākām mērķauditorijām.

Izvēlieties valodu

Repozitorija konfigurācija

Shēma

Lauka atsauce

Iekraušanas pasūtījums

Tonis un rūpniecība, vienkārši izsakoties.