تۆماری گۆڕان · وەرگێڕی سەرچاوە

سەیری CHANGELOG.md بکە بۆ تۆماری تەواو.

بڵاوکراوەکان

3.2.0 — 2026-07-12

Smart change detection now defaults to smart: a compact provider-neutral state manifest (.github/resource-translator-state.json) tracks parser keys, source hashes, target hashes, and translation-affecting settings so only changed or missing keys are sent to the selected provider. Use changeDetection=disabled or false for legacy always-translate behavior, statePath to relocate the manifest, and snapshotOnly to bootstrap the manifest from existing target files without calling a provider. The same release adds nested {provider} blocks, AWS/Google-native behavior knobs, narrow-friendly reference cards, and official provider-doc links. Key-level audit rule codes are logged for every decision.

3.1.0 — 2026-07-10

فرە فرۆشیار: وەرگێڕان بە Azure AI Translator، AWS Translate، یان Google Cloud Translation لە پشت یەک ڕووکەشی یەکگرتووی API. دابینکەرێک هەڵبژێرە بۆ هەر ڕاکردنێک لەگەڵ تێکردنی provider نوێ؛ کردارەکە نوێنەری SDK ی هاوشێوە لە پشت کارگەیەک دەکات و بەبێ گوێدانە فرۆشیار هەمان ڕەفتار دەکات. بەتەواوی گونجاوە بۆ دواوە — provider گریمانە بۆ azure، بۆیە بەڕێوەچونی کاری بەردەستی Azure بەردەوام کاردەکات بەبێ گۆڕان.
دابینکەری نوێی وەرگێڕانی AWS (@aws-sdk/client-translate). سەلماندن بە زنجیرەی بڕواپێدانی بنەڕەتی AWS (پێشنیازکراو: OIDC via aws-actions/configure-aws-credentials) یان awsAccessKeyId / awsSecretAccessKey ئاشکرا؛ هەرێم لە ڕێگەی awsRegion یان AWS_REGION.
دابینکەری نوێی وەرگێڕانی Google Cloud (@google-cloud/translate, v2). سەلماندن بە بڕواپێدانی JSON ئەژمێری خزمەتگوزاری (googleCredentials) یان کلیلی API (googleApiKey)؛ ئارەزوومەندانە googleProjectId.
تێکردنە نوێکان: provider، awsAccessKeyId، awsSecretAccessKey، awsRegion، googleApiKey، googleCredentials، googleProjectId.
نەخشەسازی دیاریکەری مەبەست: textType نەخشە بۆ گووگڵ format و نەخشەی profanityAction بۆ دەمامکی جنێو AWS کە هاوتایەکی هەبێت. دیاریکەرەکانی Azure تەنها (categoryId، apiVersion، profanityMarker، allowFallback) لەلایەن دابینکەرەکانی ترەوە پشتگوێ دەخرێن.
تێکردنەکانی داواکاری Azure (subscriptionKey، endpoint، region) چیتر دیاری نەکراون لە action.yml بۆیە دابینکەرەکانی تر دەتوانرێت دیاری بکرێن — هێشتا سەلمێنراوە لە کاتی کارکردن کاتێک provider azure.
پەڕەی دابینکەرانی وەرگێڕانی نوێ، خشتەبەندی دابینکەر لەسەر دەستپێکردن، هەڵبژاردنی دابینکەر لە پەڕەی تێکردنەکان، و پەڕەیەکی نوێی ماڵەوە لەگەڵ Azure، AWS، و Google.

3.0.2 — 2026-07-10

چاککراوە: وەرگێڕ داواکاری ئێستا api-version=3.0 لەسەر وایەرەکە جێگیر دەکات بۆ هەردوو /translate و /languages. Azure SDK تەنها ڕێز لە بژاردەی وەشانی api-level لەسەر ئاستی کلایەنت دەگرێت کاتێک بڕواپێدانێک تێدەپەڕێت. کردارەکە بۆ هەر داواکارییەک لە رێگەی سەرپەڕەکانەوە ڕەسەنایەتی دەکات، بۆیە ئەو بەربژارە بە بێدەنگی فڕێدرا و داواکاریەکان بە گریمانە بۆ وەشانی پێشدیمەنی API کە گرێبەستی /translate جەستەی HTTP 400 ڕەتکردەوە (کۆدی هەڵە 400074). چارەسەرکردنەکە تەواو دەکات کە لە 3.0.1 دەستی پێکرد.

3.0.1 — 2026-07-10

چاککراوە: جەستەی داواکاری /translate ئێستا ڕیزێکی JSON ڕووتە لە بڕگەکانی { text } لەجیاتی تەنێکی پێچراو { inputs }، هاوتایە لەگەڵ گرێبەستی v3.0 REST. ئەمە خۆی لە خۆیدا وەرگێڕانەکانی نەگەڕاندەوە — بڕوانە 3.0.2.

3.0.0 — 2026-07-08

خۆی کێشا بە node24 کاتی ڕاکردن (شکاندن).
تێکردنە نوێکان: include، exclude، configPath، categoryId، apiVersion، dryRun، failOnError، لەگەڵ دەسکی وەرگێڕی پێشکەوتوو textType، profanityAction، profanityMarker و allowFallback.
شوێنی سەرچاوە ئێستا بۆ وەرگێڕ دەنێردرێت چونکە from=<locale> زنجیرە کورتەکان بە شێوەیەکی ئۆتۆماتیکی نادۆزرێتەوە.
خۆڕاگری: دووبارە هەوڵدانەوەی ئۆتۆماتیکی لەسەر وەڵامەکانی کاتی HTTP (408, 425, 429, 500, 502, 503, 504) ڕێزگرتن لە سەرپەڕەی Retry-After Azure — دەگەڕێتەوە بۆ گەڕانەوەی توانی لەرزۆک کاتێک ئامادە نییە. لە ڕێگەی maxRetries و retryBackoffMs. دادەخرێت #46.
پاراستنی پلەیسهۆڵدەر: تۆکنەکانی وەک {{name}}، ${var}، {0}، {0:N2}، %s، %1$s و HTML پێش وەرگێڕان لە پاسەوانەکان دەپێچرێنەوە و دواتر دەگەڕێننەوە، بۆیە وەرگێڕ دەستکاری i18next/Mouache/Handlebars/.NET/printf دەوەستێنێت. گۆڕین لە ڕێگەی protectPlaceholders; درێژکردنەوە لەگەڵ customPlaceholderPatterns. توند دەکات #16.
هەڵوەشاندنەوەی هەر کلیلێک: تێکردنی noTranslatePatterns نوێ کلیلەکانی هاوشێوە لە داواکاری وەرگێڕ بە تەواوی دێتە خوارەوە (بەهای سەرچاوە بۆ ناوی براندەکان، کۆدەکانی هەڵە و هتد دەپارێزێت). شێوازەکانی گلۆب دەگونجێنێت بەرامبەر کلیلەکانی ئاستی شیکەرەوە (ڕێڕەوی خاڵی JSON، RESX name، PO msgid، یەکەی XLIFF id، کلیلی INI/restext). دادەخرێت #35.
ڕێکخستنی ئاستی ڕیپۆ لە رێگەی .github/resource-translator.yml.
پاڵپشتی فەرهەنگ، پوختەی هەنگاوەکان لە ڕێگەی core.summary.
esbuild bundler, ESLint 9 flat config, Prettier, EditorConfig.
NPM Audit Clean (0 لاوازی).
Astro + Tailwind v4 سایتی دۆکیۆمێنتەکان لەگەڵ گواستنەوەی دیمەنەکان و کۆدی دەربڕین.
دەستگەیشتنی بەڵگەنامەکان: WCAG 2.1 AA پاس. گلیفەکانی لۆگۆ گۆڕدراون بۆ ڕێڕەو بۆ ئەوەی چیتر شکست نەهێنن لە جیاوازی ڕەنگ بەرامبەر وەستانەکانی نمرەی لار، دوگمەی Back to top سەرئاوکەوتوو inert بەکاردەهێنێت لە کاتێکدا شاراوە (لەجیاتی گۆڕینەوەی aria-hidden کە جێی هێشتووە)، formats.astro بەشەکان چیتر بەریەک ناکەون لەگەڵ ناسنامەی سەردێڕی دروستکراوی خۆکاریان، سێ کارتی ناوچەیی ئێستا تایبەتمەندیەکانی BCP-47-valid lang دەردەخەن (nya→ny، lug→lg، run→rn)، دووبارەکردنەوە Documentation ناونیشانەکان لە نێوان شریتی تەنیشت و ژێرپەڕدا ڕوون کراونەتەوە، و هەموو خشتەیەکی داتا لەسەر inputs/configuration لەگەڵ ژێرنووسی خوێنەری شاشە دەنێردرێت.
ستایڵی کۆدی ناوهێڵ: پەخشانی دۆکیۆمێنتەکان <code> ئێستا شێوەزاری بابەتی گەرم/عەمبەر بەکاردەهێنێت — جیاوازە لە تەختەی شێوەزاری براند→شێوە کە بۆ بەستەر و سەردێڕەکان بەکاردەهێنرێت.
تێکەڵکردنی خۆکاری Dependabot، سکانکردنی CodeQL، ماتریکسی CI.

2.2.1 — 2024-01-05

Security: bumped axios (1.4.0 → 1.6.0), @babel/traverse, semver, and tough-cookie/@azure/ms-rest-js to clear Dependabot alerts.

2.2.0 — 2023-07-05

Maintenance release (dependency and dist refresh).

2.1.9 — 2023-04-11

Dependency upgrades (including xml2js 0.4.23 → 0.5.0) and a refreshed dist build.

2.1.8 — 2023-01-02

Security: bumped follow-redirects, node-fetch, decode-uri-component, minimist, ansi-regex, jsdom, json5, minimatch, and @actions/core (1.2.6 → 1.9.1).

2.1.7 — 2021-12-09

Use a different delimiter when building the translation map so keys containing the previous separator are handled correctly (#36).
Fixes #32.

2.1.6 — 2021-08-04

Assorted bug fixes and improved logging.

2.1.5 — 2021-07-28

Fix an issue with file names containing four segments.

2.1.4 — 2021-05-20

Added a JSON parser and .json file support.
Fix batching bug (#18).

2.1.3 — 2021-02-22

Maintenance release.

2.1.2 — 2021-02-18

Fixes #15.

2.1.1 — 2020-12-02

Fix the generated step summary.

2.1.0 — 2020-12-01

Support for additional resource file formats beyond .resx: .ini, .po, .restext, and .xliff.

2.0.4 — 2020-11-17

Maintenance release.

2.0.3 — 2020-11-15

Fixes a batching bug and other related issues.

2.0.2 — 2020-11-12

File filtering to limit excessive translations.
Batching of the translate API call to avoid rate limiting.

2.0.1 — 2020-11-12

New action outputs: has-new-translations, summary-title, and summary-details.
Fix a bug where an error was logged but the action failure was not set.

2.0.0 — 2020-11-06

First official, fully functional and verified release.

1.0.1 — 2020-11-05

Build release.

1.0.0 — 2020-11-05

Initial release of the Azure AI Translator resource action (.resx support).

0.0.x — 2020-10-31

Initial prototype pre-releases (tags 0.01–0.09).