داخلونه او وتنې · سرچینې ژباړونکی

د YAML سکیمې او بارولو ترتیب جوړښت وګورئ.

اړین داخلونه

sourceLocale

د سرچینې ځای (لکه en) چې د سرچینې فایلونو موندلو لپاره کارول کیږی لکه **/*.en.resx. همداراز چمتو کوونکی ته د from=<locale> په توګه واستول شو.

د عرضه کوونکی انتخاب او اسناد

د هر ځل لپاره یو چمتو کوونکی انتخاب provider. یوازې د ټاکل شوی عرضه کوونکی اسناد وړاندې کړئ — د بشپړ تنظیم لپاره داخلونه او وتنې لارښود وګورئ.

provider

ډیفالټ: azure

د ژباړې چمتو کوونکی: azure (ډیفالټ)، aws، یا google. یوازې یو عرضه کوونکی د هر عمل زنګ لپاره کارول کېږی.

subscriptionKey

ډیفالټ: هیڅ نشته

Azure AI Translator subscription key. د azure لپاره اړین دی. تېر secrets.

endpoint

ډیفالټ: هیڅ نشته

Azure Translator endpoint URL, مثلاً https://api.cognitive.microsofttranslator.com/. د azure لپاره اړین دی.

awsAccessKeyId

ډیفالټ: هیڅ نشته

د AWS د لاسرسی کیلی پېژندنه. اختیاری — د AWS ډیفالټ اسنادو زنځیر / OIDC کارول (د awsSecretAccessKey سره) پریښودل. تېر secrets.

awsSecretAccessKey

ډیفالټ: هیڅ نشته

د AWS پټ لاسرسی کیلی. باید له awsAccessKeyId سره برابر شی. تېر secrets.

awsSessionToken

ډیفالټ: هیڅ نشته

اختیاری AWS سیشن ټوکن د لنډمهاله اسنادو لپاره. د تېرېدو له لارې secrets.

awsRegion

ډیفالټ: هیڅ نشته

د AWS سیمه د Translate خدمت لپاره (لکه us-east-1). د aws لپاره اړین دی، پرته له دې چې AWS_REGION په چاپیریال کې تنظیم شوی وی.

awsFormality

ډیفالټ: هیڅ نشته

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

ډیفالټ: هیڅ نشته

When true, enables AWS Translate brevity mode for supported language pairs.

awsTerminologyNames

ډیفالټ: هیڅ نشته

AWS Translate custom terminology resource names. Accepts a JSON array or comma-separated values.

awsParallelDataNames

ډیفالټ: هیڅ نشته

AWS Translate parallel data resource names. Accepts a JSON array or comma-separated values.

googleApiKey

ډیفالټ: هیڅ نشته

د Google Cloud API کیلی. دا عملیات googleCredentials google. تېر secrets.

googleCredentials

ډیفالټ: هیڅ نشته

د Google Cloud خدمت-حساب کلید د JSON تار په توګه. دا عملیات googleApiKey google. تېر secrets.

googleProjectId

ډیفالټ: هیڅ نشته

اختیاری د Google Cloud پروژې پېژندنه. عموماً د خدمت حساب له اسنادو څخه اخیستل کېږی.

googleModel

ډیفالټ: هیڅ نشته

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

googleApiEndpoint

ډیفالټ: هیڅ نشته

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

ډیفالټ: هیڅ نشته

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

عام اختیاری داخلونه

region

ډیفالټ: هیڅ نشته

د ژباړونکی سرچینې سیمه (د نړیوالو سرچینو لپاره یې حذف کړه).

toLocales

ډیفالټ: ټول ملاتړ شوی

د ژباړې ځایونه. د JSON آرایه (["fr","de"]) یا کاما-جلا شوی ارزښتونو قبولوی.

include

ډیفالټ: هیڅ نشته

د نوی کرښې جلا شوی ګلوب نمونې؛ یوازې ورته فایلونه ژباړل کېږی.

exclude

ډیفالټ: هیڅ نشته

د نوی کرښې جلا شوی ګلوب نمونې؛ د مطابقت فایلونه پریښودل کیږی (د شمول وروسته تطبیق کیږی).

configPath

ډیفالټ: .github/resource-translator.yml

د YAML کنفیګ فایل ته لاره (د ورک اسپیس ریښې په نسبت).

changeDetection

ډیفالټ: smart

Smart change detection mode. smart translates only keys whose source value, target presence, state entry, or translation-affecting settings require it. Use disabled or false to send every eligible key on every run.

statePath

ډیفالټ: .github/resource-translator-state.json

Path to the compact deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json; commit it so future runs can audit and reuse unchanged translations.

snapshotOnly

ډیفالټ: false

When true, create/update the smart change-detection manifest from existing source and target files without calling a translation provider or writing target resource files. Useful when bootstrapping statePath while a provider is unavailable.

dryRun

ډیفالټ: false

کله چې true، ژباړې وچلوه او لنډیزونه خپروی، خو فایلونه مه لیکه.

failOnError

ډیفالټ: true

کله چې true، ناڅاپی تېروتنې عمل ناکاموی؛ کله چې false، تېروتنې خبرداری دی.

Azure Translator request inputs

دا برخې مستقیم د Azure AI Translator v3 پوښتنې پارامیټرونو ته نقشه کیږی او د Azure چمتو کوونکی ته تطبیقیږی. textType او profanityAction هم AWS/Google ته نقشه شوی چیرې چې ورته موجود وی (د عرضه کوونکی لارښود وګورئ); نور یوازې Azure دی. هر یو اختیاری دی؛ د ټرانسلیټر ډیفالټونه هغه وخت تطبیقېږی چې غیر تنظیم شی.

categoryId

ډیفالټ: general

Azure Custom Translator کټګوری — صنعت/ډومېن/تون knob. د ?category=... په توګه لیږل شوی.

textType

ډیفالټ: plain

plain یا html. html یوازې هغه وخت وکاروئ کله چې ستاسو سرچینې ارزښتونه ریښتینی HTML ټوټې وی.

profanityAction

ډیفالټ: NoAction

NoAction، Marked، یا Deleted. دا کنټرولوی چې په ژباړو کې ناپاک اصطلاحات څنګه خپاره شی.

profanityMarker

ډیفالټ: Asterisk

Asterisk یا Tag. یوازې هغه وخت معنا لری چې profanityAction Marked.

allowFallback

ډیفالټ: true (د ژباړونکی ډیفالټ)

کله چې false، ټرانسلیټر تېروتنه بېرته راولی، پر ځای د دې چې عمومی سیسټم ته لاړ شی که ستاسو categoryId د هدف ځای لپاره ځای پر ځای نه وی.

apiVersion

ډیفالټ: 3.0

د REST API ژباړونکی نسخه.

مقاومت او د ځای پر ځای ساتنه

دا داخلونه کنټرولوی چې کله Translator ستاسو غوښتنه محدوده کوی، عمل څنګه چلند کوی او څنګه د لنډمهاله توکنونو لکه {{name}} یا {0} د ژباړې پر مهال له خرابېدو څخه ساتی.

maxRetries

ډیفالټ: 5

په لنډمهاله HTTP ځوابونو کې اعظمی بیا هڅه (408, 425, 429, 500, 502, 503, 504). د هر غوښتنې لپاره د HTTP زنګونو ټول شمېر 1 + maxRetries.

retryBackoffMs

ډیفالټ: 30000

په هره یوه شېبه کې (په میلی ثانیو کې) کپ (په میلی ثانیو کې) په هر ډول شاتګ خوب کې. دا عمل د Azure د Retry-After ځواب سرلیک ته درناوی کوی کله چې موجود وی؛ که نه، دا د دې ارزښت سره د خوځنده exponential backoff کاروی.

protectPlaceholders

ډیفالټ: true

کله چې true (ډیفالټ)، لکه {{name}}، ${var}، {0}، {0:N2}، %s، %1$s او HTML موجودیتونه د ژباړې مخکې د Sentinel ټوکنونو سره بدلیږی او وروسته بیرته راګرځول کیږی. یوازې هغه وخت غیر فعال کړئ چې ستاسو سرچینه قصداً د موقتی شکل لرونکی متن ولری چې باید وژباړل شی.

customPlaceholderPatterns

ډیفالټ: هیڅ نشته

د نوی کرښې جلا شوی regexes (بې له محدودوونکو څخه) د ډیفالټ placeholder سیټ ته اضافه شوی، لکه د دودیز توکن نحو لپاره <<.+?>>.

noTranslatePatterns

ډیفالټ: هیڅ نشته

د نوی کرښه جلا شوی ګلوب نمونې د پارسر کچې کیلی (JSON نقطه لرونکی لاره، RESX name، PO msgid، XLIFF واحد id، INI/restext کیلی) سره برابرې شوې. د تطبیق کیلی ګانې د ټرانسلیټر غوښتنې څخه غورځول کېږی او د خپل سرچینې ارزښت ساتل کېږی.

تولیدونه

summary-title

لنډ د عامه اړیکو لپاره مناسب لنډیز، لکه Machine-translated 320 files, a total of 5,418 translations.

summary-details

د مارک ډاون لنډیز چې د PR ادارې یا دندې لنډیز لپاره مناسب دی.

has-new-translations

'true' کله چې یو یا څو نوې ژباړې تولید شوې.