تێکردنەکان و دەرچووەکان · وەرگێڕی سەرچاوە

سەیری شێوەپێدان بکە بۆ هێڵکاری 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. ئارەزوومەندانە — سڕینەوە (لەگەڵ awsSecretAccessKey) بۆ بەکارهێنانی زنجیرەی بڕوانامەی بنەڕەتی AWS / OIDC. تێپەڕین لە ڕێگەی secrets.

awsSecretAccessKey

بنەڕەت: هیچ

کلیلی چوونەژوورەوەی نهێنی AWS. دەبێت لەگەڵ awsAccessKeyId دابین بکرێت. تێپەڕین لە ڕێگەی secrets.

awsSessionToken

بنەڕەت: هیچ

هێمای دانیشتنی ئارەزوومەندانەی AWS بۆ بڕواپێدانە کاتییەکان. تێپەڕین بە secrets.

awsRegion

بنەڕەت: هیچ

ناوچەی AWS بۆ خزمەتگوزاری وەرگێڕان (بۆ نمونە 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 (بەگوێرەی ڕەگی workspace).

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

ئەمانە راستەوخۆ نەخشە دەکێشن بۆ پارامیتەرەکانی پرسی Azure AI Translator v3 و جێبەجێ دەکرێن بۆ دابینکەری Azure. textType و profanityAction هەروەها نەخشەیان بۆ AWS/Google دانراوە کە هاوتایەکی هەیە (سەیری ڕێنمایی دابینکەرەکان بکە)؛ ئەوانی تر تەنها Azure بوون. هەموویان ئارەزوومەندانەیە. گریمانەکانی وەرگێڕ جێبەجێ دەبن لە کاتی دانان.

categoryId

بنەڕەت: general

هاوپۆلی Azure Custom Translator — دەسکی پیشەسازی/دۆمەین/تۆن. نێردرا وەک ?category=....

textType

بنەڕەت: plain

plain یان html. بەکارهێنانی html تەنها کاتێک بەهای سەرچاوەکانت پارچەکانی HTML ڕاستەقینەن.

profanityAction

بنەڕەت: NoAction

NoAction، Marked، یان Deleted. کۆنتڕۆڵی چۆنیەتی بڵاوبوونەوەی دەستەواژەی پیس لە وەرگێڕاندا دەکات.

profanityMarker

بنەڕەت: Asterisk

Asterisk یان Tag. تەنها کاتێک مانادار profanityAction Marked.

allowFallback

بنەڕەت: ڕاستە (وەرگێڕی بنەڕەتی)

کاتێک false، وەرگێڕ هەڵەیەک دەگەڕێنێتەوە لەجیاتی گەڕانەوە بۆ سیستەمی گشتی ئەگەر categoryId تۆ بڵاوکردنەوەی بۆ شوێنی مەبەست نەبێت.

apiVersion

بنەڕەت: 3.0

وەرگێڕی REST API.

بەرگری / پاراستنی جێگرەکان

ئەم تێکردنانە کۆنتڕۆڵی چۆنیەتی هەڵسوکەوتی کردارەکە دەکەن کاتێک وەرگێڕ داواکاریەکەت دەخنکێنێت و چۆن تۆکنەکانی جێگرە وەک {{name}} یان {0} دەپارێزێت لە تێکچوون لەکاتی وەرگێڕان.

maxRetries

بنەڕەت: 5

زۆرترین هەوڵی دووبارە هەوڵدان لەسەر وەڵامدانەوەی کاتی HTTP (408, 425, 429, 500, 502, 503, 504). کۆی گشتی ژمارەی پەیوەندیەکانی HTTP بۆ هەر داواکارییەک بریتیە لە 1 + maxRetries.

retryBackoffMs

بنەڕەت: 30000

Cap (بە میلی چرکە) لە هەر تاکە خەوێکی گەڕانەوە. کردارەکە ڕێز لە سەردێڕی وەڵامدانەوەی Retry-After Azure دەگرێت ڕێک کاتێک ئامادەیە. ئەگینا ئەو پاشەکشەی نمایی لەرزۆک بەکاردەهێنێت کە بەم بەهایە داپۆشراوە.

protectPlaceholders

بنەڕەت: true

کاتێک true (گریمانە)، پلەیسهۆڵدەرەکانی وەک {{name}}، ${var}، {0}، {0:N2}، %s، %1$s و HTML پێش وەرگێڕان دەگۆڕدرێن بە نیشانەی پاسەوان و دواتر دەگەڕێننەوە. ناچالاک تەنها کاتێک سەرچاوەکەت بە ئەنقەست دەقی شێوە جێگرەوەی وشەیی تێدایە کە پێویستە وەربگێڕدرێت.

customPlaceholderPatterns

بنەڕەت: هیچ

regexes بە هێڵی نوێی جیاکراو (بەبێ سنووردار) زیادکرا بۆ کۆمەڵەی پلەیس هۆڵدەری گریمانەیی، بۆ نمونە <<.+?>> بۆ ڕستەسازی توکنی سازێنراو.

noTranslatePatterns

بنەڕەت: هیچ

نمونەی گلۆب کە بە هێڵی نوێ جیاکرایەوە هاوتایە لەگەڵ کلیلەکانی ئاستی شیکەرەوە (JSON خاڵدار Path, RESX name, PO msgid, XLIFF unit id, INI/restext key). کلیلەکانی هاوشێوە لە داواکاری وەرگێڕ فڕێدەدرێن و بە بەهای سەرچاوەکەیان دەپارێزرێن.

دەرچوەکان

summary-title

پوختەیەکی کورت بۆ ناونیشانی پەیوەندییە گشتیەکان، بۆ نمونە Machine-translated 320 files, a total of 5,418 translations.

summary-details

پوختەی Markdown گونجاوە بۆ دەزگای پەیوەندییە گشتییەکان یان پوختەی کار.

has-new-translations

'true' کاتێک وەرگێڕانێکی نوێ یان زیاتر دروست کرا.