कन्फिगरेसन · स्रोत अनुवादक

यदि तपाईँलाई पूर्वनिर्धारित नभएको स्थान आवश्यक भएमा configPath आगतसँग मार्ग अधिलेखन गर्नुहोस् ।

स्किमा

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

फिल्ड सन्दर्भ

provider

प्रकार: "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

प्रकार: string

यदि सेट नभएमा sourceLocale आगतमा फर्कन्छ । अनुवादकलाई पनि पठाइएको छ किनकि from=<locale> छोटो तारहरू स्वत: पत्ता लगाउँदैनन्।

toLocales

प्रकार: string[]

या एउटा एरे वा अल्पविराम-बिभाजित स्ट्रिङ ।

include / exclude

प्रकार: string[]

ग्लोब ढाँचाहरू निरपेक्ष र कार्यक्षेत्र-सापेक्ष मार्गहरूको बिरूद्ध मूल्यांकन गरियो।

glossary

प्रकार: map<string,string>

अनुवादपछिको शब्द ओभरराइड हुन्छ। शब्द-सीमा सचेत (ह्यान्डल C++, .NET)।

categoryId

प्रकार: string

Azure Custom Translator श्रेणी - तपाईंको उद्योग / डोमेन घुंडी (कानूनी, चिकित्सा, मार्केटिंग टोन, आदि)। ?category=... रूपमा पठाइएको छ ।

textType

प्रकार: "plain" | "html"

पूर्वनिर्धारित plain । यदि तपाईँको संसाधन मानले वास्तविक HTML टुक्राहरू समावेश गर्दछ भने मात्र html प्रयोग गर्नुहोस् ।

profanityAction

प्रकार: "NoAction" | "Marked" | "Deleted"

अनुवाद गरिएको आउटपुटमा अपवित्र सर्तहरूको उपचार कसरी गर्ने।

profanityMarker

प्रकार: "Asterisk" | "Tag"

केवल तब मात्र अर्थपूर्ण छ जब profanityAction "Marked"।

allowFallback

प्रकार: boolean

अनुवाद असफल गर्न false सेट गर्नुहोस् जब तपाईंको categoryId सामान्य मोडेलमा फर्कनुको सट्टा लक्षित लोकेलको लागि कुनै परिनियोजन छैन।

apiVersion

प्रकार: string

अनुवादक REST API संस्करण। पूर्वनिर्धारित 3.0 ।

awsFormality

प्रकार: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

प्रकार: boolean

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

awsTerminologyNames / awsParallelDataNames

प्रकार: string[]

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

googleModel

प्रकार: string

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

googleApiEndpoint

प्रकार: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

प्रकार: boolean

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

maxRetries

प्रकार: integer

क्षणिक एचटीटीपी प्रतिक्रियाहरूमा अधिकतम पुन: प्रयास प्रयास (408, 425, 429, 500, 502, 503, 504) । पूर्वनिर्धारित 5 । प्रति अनुरोध कुल HTTP कलहरू 1 + maxRetries।

retryBackoffMs

प्रकार: integer

कुनै पनि एकल ब्याकअफ निद्रामा क्याप (एमएस)। पूर्वनिर्धारित 30000 । Azure को Retry-After हेडर उपस्थित हुँदा ठ्याक्कै सम्मानित हुन्छ; अन्यथा जिटर गरिएको एक्सपोनेन्शियल ब्याकअफ प्रयोग गरिन्छ, यो मानमा क्याप गरिएको छ।

protectPlaceholders

प्रकार: boolean

पूर्वनिर्धारित true । जब सुरु हुन्छ, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s र HTML संस्थाहरू जस्ता टोकनहरू अनुवाद गर्नु अघि सेन्टिनल टोकनहरूसँग प्रतिस्थापन गरिन्छ र पछि पुनर्स्थापित गरिन्छ। स्रोतले जानाजानी प्लेसहोल्डर आकारको लिटरलहरू समावेश गरेमा मात्र अक्षम पार्नुहोस् ।

customPlaceholderPatterns

प्रकार: string[]

अतिरिक्त रेगेक्स ढाँचाहरू (सीमांकहरू बिना) पूर्वनिर्धारित प्लेसहोल्डर सेटमा थपियो, उदाहरणका लागि <<.+?>> अनुकूलन टोकन वाक्यविन्यासको लागि। अवैध रेजेक्सलाई उपेक्षा गरिन्छ ।

noTranslatePatterns

प्रकार: string[]

ग्लोब ढाँचाहरू पार्सर-स्तर कुञ्जीहरू (JSON थोप्ला मार्ग, RESX name, PO msgid, XLIFF एकाइ id, INI / restext कुञ्जी) सँग मेल खान्छन्। मिल्दो कुञ्जीहरू अनुरोधबाट हटाइन्छ र तिनीहरूको स्रोत मान संरक्षित गरेर पास गरिन्छ।

changeDetection

प्रकार: "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

प्रकार: string

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

क्रम लोड गर्दै

कार्यले कार्यप्रवाहबाट स्पष्ट इनपुटहरू पढ्छ।
यसले YAML कन्फिगरेसनलाई configPath बाट लोड गर्दछ।
प्रत्येक साझा क्षेत्रको लागि, इनपुटले जित्छ; अन्यथा YAML मान प्रयोग गरिन्छ।
गाभिएको मान प्रमाणित गरिएको छ । अवैध enums (जस्तै: profanityAction: Mask) ले स्पष्ट सन्देशसँग कार्य छिटो असफल हुन सक्छ।

टोन र उद्योग, सरल शब्दहरूमा

Azure AI अनुवादक v3 API सँग एकल टोन घुंडी छैन। दुई सेटिङहरूले तपाईंलाई धेरै जसो समान नियन्त्रण दिन संयोजन गर्दछ:

उद्योग / डोमेन: तपाईंको आफ्नै कर्पसमा प्रशिक्षित Azure Custom Translator श्रेणीमा औंल्याउन categoryId प्रयोग गर्नुहोस् - कानूनी, प्राविधिक, चिकित्सा, मार्केटिंग, वा अरू केही। यो टोन, ब्रान्ड आवाज, र शब्दावलीको लागि सबैभन्दा बलियो लिभर हो।
सतह पाठ: ब्रान्ड नामहरू र उत्पादन सर्तहरू शब्दशः लक गर्न शब्दावली प्रयोग गर्नुहोस्, र युवा दर्शकहरूको लागि स्थानीयकरणलाई लक्षित गर्दा अपवित्र सर्तहरू स्क्रब गर्न profanityAction प्रयोग गर्नुहोस्।

तपाईँको भाषा रोज्नुहोस्

भण्डार कन्फिगरेसन

स्किमा

फिल्ड सन्दर्भ

क्रम लोड गर्दै

टोन र उद्योग, सरल शब्दहरूमा