Konfiguracija · Prevajalnik virov

Preglasite pot z vhodom configPath, če potrebujete neprivzeto lokacijo.

Shema

# .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.*"

Terenska referenca

provider

Vrsta: "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

Vrsta: string

Če ni nastavljen, se vrne na vhod sourceLocale. Prav tako sem from=<locale> posredovan prevajalcu, da kratki nizi niso samodejno zaznani.

toLocales

Vrsta: string[]

Bodisi polje ali niz, ločen z vejico.

include / exclude

Vrsta: string[]

Glob vzorce ocenjujejo glede na absolutne in delovno prostorsko relativne poti.

glossary

Vrsta: map<string,string>

Izrazi po prevodu. Zaveda se meje besed (ročaji C++, .NET).

categoryId

Vrsta: string

Azure Custom Translator kategorija — vaša panoga/domenska funkcija (pravni, medicinski, marketinški ton itd.). Poslano kot ?category=....

textType

Vrsta: "plain" | "html"

Privzeto se nastavi na plain. Uporabljajte html le, če vaše vrednosti virov vsebujejo prave HTML fragmente.

profanityAction

Vrsta: "NoAction" | "Marked" | "Deleted"

Kako obravnavati vulgarne izraze v prevedenem izhodu.

profanityMarker

Vrsta: "Asterisk" | "Tag"

Pomembno je le, ko je profanityAction "Marked".

allowFallback

Vrsta: boolean

Nastavi false, da prevod ne uspe, ko tvoj categoryId nima nameščanja za ciljno lokacijo, namesto da bi se vrnil k splošnemu modelu.

apiVersion

Vrsta: string

Translator REST API različica. Privzeto se nastavi na 3.0.

awsFormality

Vrsta: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

Vrsta: boolean

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

awsTerminologyNames / awsParallelDataNames

Vrsta: string[]

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

googleModel

Vrsta: string

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

googleApiEndpoint

Vrsta: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Vrsta: boolean

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

maxRetries

Vrsta: integer

Največ poskusov ponovnega poskusa pri prehodnih HTTP odgovorih (408, 425, 429, 500, 502, 503, 504). Privzeto nastavi 5. Skupno število HTTP klicev na zahtevo je 1 + maxRetries.

retryBackoffMs

Vrsta: integer

Omejitev (ms) pri vsakem enkratnem backoff spanju. Privzeto se nastavi na 30000. Azurejeva Retry-After glava je spoštovana natanko, kadar je prisotna; v nasprotnem primeru se uporablja nihanje eksponentnega umika, omejeno na to vrednost.

protectPlaceholders

Vrsta: boolean

Privzeto se nastavi na true. Ko so vklopljeni, se žetoni, kot so {{name}}, ${var}, {0}, {0:N2}, %s, %1$s in HTML entitete, pred prevodom zamenjajo s sentinel žetoni in kasneje obnovijo. Onemogoči le, kadar izvorna koda namerno vsebuje literale v obliki začasnega pomena.

customPlaceholderPatterns

Vrsta: string[]

Dodatni regex vzorci (brez ločil) dodani privzetemu naboru nadomestkov, npr. <<.+?>> za prilagojeno sintakso žetonov. Neveljavni regexi se ignorirajo.

noTranslatePatterns

Vrsta: string[]

Glob vzorci so se ujemali s ključi na ravni parserja (JSON pikčasta pot, RESX name, PO msgid, XLIFF enota id, INI/restext ključ). Ujemajoči se ključi iz zahteve odstranijo in preidejo skozi z ohranjeno izvorno vrednostjo.

changeDetection

Vrsta: "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

Vrsta: string

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

Vrstni red nalaganja

Akcija bere eksplicitne vhode iz delovnega toka.
Naloži YAML konfiguracijo iz configPath.
Za vsako skupno polje zmaga vhod; v nasprotnem primeru se uporablja vrednost YAML.
Združene vrednosti so potrjene. Neveljavni enumi (npr. profanityAction: Mask) povzročijo, da dejanje hitro spodleti, če je jasno sporočilo.

Ton in industrija, preprosto povedano

API Azure AI Translator v3 nima niti enega gumba za ton. Dve nastavitvi skupaj omogočata večino enakega nadzora:

Industrija / področje: Uporabite categoryId, da pokažete na kategorijo Azure Custom Translator, usposobljeno na vašem lastnem korpusu — pravni, tehnični, medicinski, marketinški ali karkoli drugega. To je najmočnejši vzvod za ton, glas blagovne znamke in besedišče.
Površinsko besedilo: Uporabite Slovar za dobesedno zaklepanje imen blagovnih znamk in izdelkov ter uporabite profanityAction za odstranjevanje kletvic, ko ciljate na lokalizacijo za mlajše občinstva.

Izberite svoj jezik

Konfiguracija repozitorija

Shema

Terenska referenca

Vrstni red nalaganja

Ton in industrija, preprosto povedano