Input & output · Penterjemah Sumber

Lihat Konfigurasi untuk skema YAML dan pesanan memuatkan.

Input yang diperlukan

sourceLocale

Lokasi sumber (cth. en) digunakan untuk mencari fail sumber seperti **/*.en.resx. Juga dimajukan kepada pembekal sebagai from=<locale>.

Pemilihan pembekal & kelayakan

Pilih satu pembekal setiap larian dengan provider. Berikan hanya kelayakan pembekal yang dipilih — lihat panduan Input & output untuk persediaan penuh.

provider

Lalai: azure

Pembekal terjemahan: azure (lalai), aws atau google. Hanya satu pembekal digunakan setiap panggilan tindakan.

subscriptionKey

Lalai: tiada

Kunci langganan Azure AI Translator. Diperlukan untuk azure. Lulus melalui secrets.

endpoint

Lalai: tiada

URL endpoint Azure Translator, cth. https://api.cognitive.microsofttranslator.com/. Diperlukan untuk azure.

awsAccessKeyId

Lalai: tiada

ID kunci akses AWS. Pilihan — tinggalkan (dengan awsSecretAccessKey) untuk menggunakan rantaian kelayakan lalai AWS/OIDC. Lulus melalui secrets.

awsSecretAccessKey

Lalai: tiada

Kunci akses rahsia AWS. Mesti dibekalkan bersama-sama dengan awsAccessKeyId. Lulus melalui secrets.

awsSessionToken

Lalai: tiada

Token sesi AWS pilihan untuk kelayakan sementara. Lulus melalui secrets.

awsRegion

Lalai: tiada

Rantau AWS untuk perkhidmatan Terjemahan (cth. us-east-1). Diperlukan untuk aws melainkan AWS_REGION ditetapkan dalam persekitaran.

awsFormality

Lalai: tiada

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Lalai: tiada

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

awsTerminologyNames

Lalai: tiada

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

awsParallelDataNames

Lalai: tiada

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

googleApiKey

Lalai: tiada

Kekunci API Google Cloud. Sediakan googleCredentials ATAU ini untuk google. Lulus melalui secrets.

googleCredentials

Lalai: tiada

Kunci akaun perkhidmatan Google Cloud sebagai rentetan JSON. Sediakan googleApiKey ATAU ini untuk google. Lulus melalui secrets.

googleProjectId

Lalai: tiada

ID projek Google Cloud pilihan. Biasanya disimpulkan daripada kelayakan akaun perkhidmatan.

googleModel

Lalai: tiada

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

googleApiEndpoint

Lalai: tiada

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Lalai: tiada

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

Input pilihan biasa

region

Lalai: tiada

Rantau sumber penterjemah (tinggalkan untuk sumber global).

toLocales

Lalai: semua disokong

Tempatan untuk diterjemahkan kepada. Menerima tatasusunan JSON (["fr","de"]) atau nilai yang dipisahkan koma.

include

Lalai: tiada

corak glob yang dipisahkan garis baru; Hanya fail yang sepadan diterjemahkan.

exclude

Lalai: tiada

corak glob yang dipisahkan garis baru; Fail yang sepadan dilangkau (digunakan selepas disertakan).

configPath

Lalai: .github/resource-translator.yml

Laluan ke fail konfigurasi YAML (relatif kepada akar ruang kerja).

changeDetection

Lalai: 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

Lalai: .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

Lalai: 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

Lalai: false

Apabila true, jalankan terjemahan dan keluarkan ringkasan tetapi jangan tulis fail.

failOnError

Lalai: true

Apabila true, ralat yang tidak dijangka gagal dalam tindakan; apabila false, ralat adalah amaran.

Input permintaan Azure Translator

Ini dipetakan terus ke parameter pertanyaan Azure AI Translator v3 dan digunakan pada pembekal Azure. textType dan clamanityAction juga dipetakan ke AWS/Google di mana yang setara wujud (lihat panduan pembekal); selebihnya adalah Azure sahaja. Setiap satu adalah pilihan; lalai Penterjemah digunakan apabila dinyahtetapkan.

categoryId

Lalai: general

Kategori Custom Translator Azure — tombol industri/domain/nada. Dimajukan sebagai ?category=....

textType

Lalai: plain

plain atau html. Gunakan html hanya apabila nilai sumber anda ialah serpihan HTML sebenar.

profanityAction

Lalai: NoAction

NoAction, Marked atau Deleted. Mengawal cara istilah tidak senonoh dipancarkan dalam terjemahan.

profanityMarker

Lalai: Asterisk

Asterisk atau Tag. Hanya bermakna apabila profanityAction Marked.

allowFallback

Lalai: benar (Penterjemah lalai)

Apabila false, Penterjemah mengembalikan ralat dan bukannya kembali kepada sistem umum jika categoryId anda tidak mempunyai penggunaan untuk setempat sasaran.

apiVersion

Lalai: 3.0

Versi REST API penterjemah.

Ketahanan & perlindungan pemegang tempat

Input ini mengawal cara tindakan berkelakuan apabila Penterjemah mendikit permintaan anda dan cara ia melindungi token pemegang letak seperti {{name}} atau {0} daripada rosak semasa terjemahan.

maxRetries

Lalai: 5

Percubaan percubaan semula maksimum pada respons HTTP sementara (408, 425, 429, 500, 502, 503, 504). Jumlah panggilan HTTP setiap permintaan ialah 1 + maxRetries.

retryBackoffMs

Lalai: 30000

Topi (dalam milisaat) pada mana-mana tidur mundur tunggal. Tindakan ini menghormati pengepala respons Retry-After Azure tepat apabila hadir; jika tidak, ia menggunakan backoff eksponen gelisah yang dihadkan pada nilai ini.

protectPlaceholders

Lalai: true

Apabila true (lalai), ruang letak seperti entiti {{name}}, ${var}, {0}, {0:N2}, %s, %1$s dan HTML digantikan dengan token sentinel sebelum terjemahan dan dipulihkan selepas itu. Lumpuhkan hanya apabila sumber anda sengaja mengandungi teks berbentuk ruang letak literal yang harus diterjemahkan.

customPlaceholderPatterns

Lalai: tiada

Regex yang dipisahkan baris baru (tanpa pembatasan) ditambah pada set pemegang letak lalai, cth <<.+?>> untuk sintaks token tersuai.

noTranslatePatterns

Lalai: tiada

Corak glob yang dipisahkan garis baru dipadankan dengan kekunci peringkat penghurai (laluan putus-putus JSON, name RESX, PO msgid, id unit XLIFF, kekunci INI/restext). Kekunci yang sepadan digugurkan daripada permintaan Penterjemah dan dihantar dengan nilai sumbernya dikekalkan.

Keluaran

summary-title

Ringkasan ringkas mesra tajuk PR, contohnya Machine-translated 320 files, a total of 5,418 translations.

summary-details

Ringkasan penurunan harga sesuai untuk badan PR atau ringkasan pekerjaan.

has-new-translations

'true' apabila satu atau lebih terjemahan baru dijana.