Saib Kev teeb tsa rau YAML schema thiab kev txiav txim thau khoom.
Yuav tsum tau tawm tswv yim
| Lub Npe | Kev piav qhia |
|---|---|
sourceLocale | Qhov chaw hauv zos (piv txwv li en) siv los nrhiav cov ntaub ntawv peev txheej xws li **/*.en.resx. Kuj xa mus rau Tus Neeg Txhais Lus raws li from=<locale>. |
subscriptionKey | Azure AI Translator subscription yuam sij. Dhau los ntawm secrets. |
endpoint | Tus neeg txhais lus endpoint URL, piv txwv li https://api.cognitive.microsofttranslator.com/. |
Cov tswv yim xaiv feem ntau
| Lub Npe | Lub neej ntawd | Kev piav qhia |
|---|---|---|
region | tsis muaj | Txhais lus resource cheeb tsam (omit rau cov peev txheej thoob ntiaj teb). |
toLocales | tag nrho cov kev txhawb nqa | Locales los txhais rau. Txais JSON array (["fr","de"]) los yog comma-cais qhov tseem ceeb. |
include | tsis muaj | Newline-cais glob qauv; Tsuas yog cov ntaub ntawv sib txuam yog txhais. |
exclude | tsis muaj | Newline-cais glob qauv; Cov ntaub ntawv sib txuam yog hla (thov tom qab suav nrog). |
configPath | .github/resource-translator.yml | Txoj kev mus rau YAML config cov ntaub ntawv (txheeb ze rau lub hauv paus chaw ua haujlwm). |
dryRun | false | Thaum true, khiav translations thiab emit summaries tab sis tsis txhob sau cov ntaub ntawv. |
failOnError | true | Thaum true, qhov yuam kev tsis tau npaj siab ua tsis tiav qhov kev ua; Thaum false, yuam kev yog ceeb toom. |
Tus neeg txhais lus thov tswv yim
Cov ntawv qhia no ncaj qha mus rau Azure AI Translator v3 query parameter. Txhua tus yog xaiv tau; lub Txhais lus defaults siv thaum unset.
| Lub Npe | Lub neej ntawd | Kev piav qhia |
|---|---|---|
categoryId | general | Azure Custom Translator qeb — kev lag luam / domain / tone pob khawm Forwarded raws li ?category=.... |
textType | plain | plain los yog html. Siv html tsuas yog thaum koj cov peev txheej muaj nuj nqis yog HTML tawg tiag tiag. |
profanityAction | NoAction | NoAction, Marked, lossis Deleted. Tswj yuav ua li cas cov lus tsis zoo yog tso tawm hauv kev txhais lus. |
profanityMarker | Asterisk | Asterisk los yog Tag. Tsuas yog muaj txiaj ntsig thaum profanityAction yog Marked. |
allowFallback | muaj tseeb (Tus neeg txhais lus lub neej ntawd) | Thaum false, Tus Neeg Txhais Lus rov qab ib qho yuam kev es tsis txhob poob rov qab mus rau qhov system dav dav yog tias koj lub categoryId tsis muaj kev xa tawm rau lub hom phiaj hauv zos. |
apiVersion | 3.0 | Tus neeg txhais lus REST API version. |
Resilience & placeholder tiv thaiv
Cov tswv yim no tswj hwm yuav ua li cas qhov kev txiav txim thaum Lub Tshuab Txhais Lus throttles koj qhov kev thov thiab yuav ua li cas nws shields placeholder tokens xws li {{name}} los yog {0} los ntawm raug mangled thaum lub sij hawm txhais lus.
| Lub Npe | Lub neej ntawd | Kev piav qhia |
|---|---|---|
maxRetries | 5 | Qhov siab tshaj plaws rov sim ntawm cov lus teb HTTP ib ntus (408, 425, 429, 500, 502, 503, 504). Tag nrho cov naj npawb ntawm HTTP hu rau ib qho kev thov yog 1 + maxRetries. |
retryBackoffMs | 30000 | Cap (hauv milliseconds) ntawm ib qho kev pw tsaug zog rov qab. Qhov kev nqis tes ua hwm Azure lub Retry-After teb header raws nraim thaum muaj; txwv tsis pub nws siv jittered exponential backoff capped ntawm tus nqi no. |
protectPlaceholders | true | Thaum true (lub neej ntawd), qhov chaw xws li {{name}}, ${var}, {0}, {0:N2}, %s, %1$s thiab HTML cov chaw raug hloov nrog sentinel tokens ua ntej txhais lus thiab rov qab kho tom qab. Lov tes taw tsuas yog thaum koj qhov chaw txhob txwm muaj cov ntawv nyeem literal placeholder uas yuav tsum tau txhais. |
customPlaceholderPatterns | tsis muaj | Newline-cais regexes (tsis muaj delimiters) ntxiv rau lub neej ntawd placeholder teeb, piv txwv li <<.+?>> rau kev cai token syntax. |
noTranslatePatterns | tsis muaj | Newline-cais glob qauv sib phim tiv thaiv parser-theem yuam sij (JSON dotted path, RESX name, PO msgid, XLIFF chav tsev id, INI/restext yuam sij). Cov yuam sij sib txuam yog poob los ntawm tus neeg txhais lus thov thiab dhau los ntawm lawv qhov chaw tus nqi khaws cia. |
Cov zis
| Lub Npe | Kev piav qhia |
|---|---|
summary-title | Luv luv PR-title-phooj ywg ntsiab lus, piv txwv li Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Markdown ntsiab lus haum rau PR lub cev lossis cov ntsiab lus ntawm txoj haujlwm. |
has-new-translations | 'true' thaum ib lossis ntau dua cov lus txhais tshiab tau tsim. |