Kev hloov pauv · Tus Neeg Txhais Lus Resource

Saib CHANGELOG.md rau tag nrho cov ntaub ntawv.

Tso tawm

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

Ntau tus neeg muag khoom: txhais nrog Azure AI Translator, AWS Translate lossis Google Cloud Translation qab ib qho API nto. Xaiv ib tus neeg zov me nyuam ib qho kev khiav nrog cov tswv yim provider tshiab; qhov kev txiav txim delegates rau lub matching SDK tom qab ib lub Hoobkas thiab behaves tib yam tsis hais tus neeg muag khoom. Tag nrho rov qab tshaj — provider neej ntawd rau azure, yog li Azure workflows uas twb muaj lawm ua haujlwm tsis hloov.
Tus neeg muab kev pabcuam AWS Txhais Lus Tshiab (@aws-sdk/client-translate). Txheeb xyuas qhov tseeb nrog AWS default daim ntawv pov thawj saw (pom zoo: OIDC los ntawm aws-actions/configure-aws-credentials) lossis qhia meej awsAccessKeyId / awsSecretAccessKey; cheeb tsam los ntawm awsRegion lossis AWS_REGION.
Tshiab Google Cloud Translation provider (@google-cloud/translate, v2). Txheeb xyuas qhov tseeb nrog kev pabcuam-account JSON daim ntawv pov thawj (googleCredentials) lossis API tus yuam sij (googleApiKey); yeem googleProjectId.
Cov tswv yim tshiab: provider, awsAccessKeyId, awsSecretAccessKey, awsRegion, googleApiKey, googleCredentials, googleProjectId.
Lub hom phiaj-specifier mapping: textType maps rau Google lub format thiab profanityAction maps rau AWS profanity masking qhov twg ib tug sib npaug muaj. Azure-tsuas yog specifiers (categoryId, apiVersion, profanityMarker, allowFallback) tsis quav ntsej los ntawm lwm tus neeg muab kev pab.
Azure thov cov tswv yim (subscriptionKey, endpoint, region) tsis muaj cim ntxiv lawm yuav tsum tau ua nyob rau hauv action.yml li ntawd lwm tus neeg muab kev pab yuav raug xaiv — tseem validated ntawm runtime thaum provider yog azure.
Cov neeg muab kev pab txhais lus tshiab nplooj ntawv, tus neeg zov me nyuam tabs ntawm Kev Pib, xaiv tus neeg muab kev pab ntawm nplooj ntawv Inputs, thiab ib nplooj ntawv tshiab hauv tsev coj nrog Azure, AWS thiab Google.

3.0.2 — 2026-07-10

Tsau: Tus neeg txhais lus thov tam sim no pin api-version=3.0 rau ntawm cov xov hlau rau ob qho tib si /translate thiab /languages. Azure SDK tsuas yog hwm tus neeg siv khoom qib api-version kev xaiv thaum daim ntawv pov thawj dhau los; qhov kev txiav txim siab authenticates ib qho kev thov los ntawm cov headers, yog li qhov kev xaiv ntawd tau poob ntsiag to thiab thov defaulted rau kev saib ua ntej API-version uas nws daim ntawv cog lus /translate tsis lees txais lub cev nrog HTTP 400 (yuam kev code 400074). Ua kom tiav qhov kho pib hauv 3.0.1.

3.0.1 — 2026-07-10

Tsau: Lub /translate thov lub cev tam sim no yog ib tug liab qab JSON array ntawm { text } khoom es tsis txhob qhwv { inputs } khoom, phim v3.0 REST daim ntawv cog lus. Ntawm nws tus kheej qhov no tsis tau rov qab txhais lus — saib 3.0.2.

3.0.0 — 2026-07-08

Bumped mus rau node24 runtime (TAWG).
Cov tswv yim tshiab: include, exclude, configPath, categoryId, apiVersion, dryRun, failOnError, ntxiv rau cov lus txhais lus siab textType, profanityAction, profanityMarker thiab allowFallback.
Source locale yog tam sim no kuj xa mus rau Tus Neeg Txhais Lus raws li from=<locale> li ntawd luv hlua yog tsis autodetected.
Kev ua siab ntev: tsis siv neeg rov sim ntawm transient HTTP teb (408, 425, 429, 500, 502, 503, 504) hwm Azure lub Retry-After header — ntog rov qab mus rau jittered exponential backoff thaum tsis muaj. Tunable los ntawm maxRetries thiab retryBackoffMs. Kaw # 46.
Qhov chaw tiv thaiv: tokens zoo li {{name}}, ${var}, {0}, {0:N2}, %s, %1$s thiab HTML cov chaw tau qhwv hauv sentinels ua ntej txhais lus thiab rov qab kho tom qab, yog li Tus Neeg Txhais Lus nres mangling i18next / Mustache / Handlebars / .NET / printf qhov chaw. Toggle ntawm protectPlaceholders; txuas nrog customPlaceholderPatterns. Zawm # 16.
Ib qho tseem ceeb xaiv tawm: cov tswv yim tshiab noTranslatePatterns poob cov yuam sij sib txuam los ntawm Tus Neeg Txhais Lus thov tag nrho (khaws cov txiaj ntsig ntawm cov npe lag luam, cov lej yuam kev, thiab lwm yam). Phim glob qauv tiv thaiv parser-theem yuam sij (JSON dotted path, RESX name, PO msgid, XLIFF chav tsev id, INI/restext yuam sij). Kaw # 35.
Repo-qib config ntawm .github/resource-translator.yml.
Kev txhawb nqa glossary, cov kauj ruam ntsiab lus ntawm core.summary.
esbuild bundler, ESLint 9 tiaj tiaj config, Prettier, EditorConfig.
npm audit huv (0 qhov tsis muaj zog).
Astro + Tailwind v4 docs site nrog saib kev hloov pauv thiab Expressive Code.
Docs kev nkag mus: WCAG 2.1 AA pass. Logo glyphs hloov mus rau txoj kev kom lawv tsis ua tiav cov xim-sib piv tiv thaiv gradient nres, lub ntab Back to top khawm siv inert thaum muab zais (es tsis txhob muaj aria-hidden toggle uas ua rau nws tabbable), formats.astro ntu tsis sib tsoo nrog lawv cov pib-tsim cov npe IDs, peb daim npav locale tam sim no nthuav tawm BCP-47-siv tau lang yam ntxwv (nya→ny, lug→lg, run→rn), theej tawm Documentation cov cim cim yog disambiguated ntawm sidebar thiab footer, thiab txhua lub rooj ntaub ntawv ntawm inputs / configuration nkoj nrog lub vijtsam-nyeem ntawv caption.
Inline code styling: docs prose <code> tam sim no hnav lub sov / amber ntsiab lus accent — txawv los ntawm lub hom→accent palette siv rau kev sib txuas thiab cov ntsiab lus.
Dependabot pib-merge, CodeQL luam theej duab, CI matrix.

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).