Input & output · Penerjemah Sumber Daya

Lihat Konfigurasi untuk skema YAML dan urutan pemuatan.

Masukan yang diperlukan

sourceLocale

Lokal sumber (misalnya en) yang digunakan untuk menemukan file sumber daya seperti **/*.en.resx. Juga diteruskan ke penyedia sebagai from=<locale>.

Pemilihan penyedia & kredensial

Pilih satu penyedia per eksekusi dengan provider. Berikan hanya kredensial penyedia yang dipilih — lihat panduan Input & output untuk pengaturan lengkap.

provider

Bawaan: azure

Penyedia terjemahan: azure (default), aws, atau google. Hanya satu penyedia yang digunakan per panggilan tindakan.

subscriptionKey

Bawaan: tidak ada

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

endpoint

Bawaan: tidak ada

URL titik akhir Azure Translator, misalnya https://api.cognitive.microsofttranslator.com/. Diperlukan untuk azure.

awsAccessKeyId

Bawaan: tidak ada

ID kunci akses AWS. Opsional — hilangkan (dengan awsSecretAccessKey) untuk menggunakan rantai kredensial default AWS/OIDC. Lulus melalui secrets.

awsSecretAccessKey

Bawaan: tidak ada

Kunci akses rahasia AWS. Harus dipasok bersama dengan awsAccessKeyId. Lulus melalui secrets.

awsSessionToken

Bawaan: tidak ada

Token sesi AWS opsional untuk kredensial sementara. Lewati melalui secrets.

awsRegion

Bawaan: tidak ada

AWS untuk layanan Terjemahan (misalnya us-east-1). Diperlukan untuk aws kecuali AWS_REGION diatur di lingkungan.

awsFormality

Bawaan: tidak ada

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Bawaan: tidak ada

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

awsTerminologyNames

Bawaan: tidak ada

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

awsParallelDataNames

Bawaan: tidak ada

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

googleApiKey

Bawaan: tidak ada

Kunci API Google Cloud. Berikan googleCredentials ATAU ini untuk google. Lewati melalui secrets.

googleCredentials

Bawaan: tidak ada

Kunci akun layanan Google Cloud sebagai string JSON. Berikan googleApiKey ATAU ini untuk google. Lewati melalui secrets.

googleProjectId

Bawaan: tidak ada

ID project Google Cloud opsional. Biasanya disimpulkan dari kredensial akun layanan.

googleModel

Bawaan: tidak ada

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

googleApiEndpoint

Bawaan: tidak ada

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Bawaan: tidak ada

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

Input opsional umum

region

Bawaan: tidak ada

Wilayah sumber daya penerjemah (dihilangkan untuk sumber daya global).

toLocales

Bawaan: Semua didukung

Lokal untuk diterjemahkan. Menerima array JSON (["fr","de"]) atau nilai yang dipisahkan koma.

include

Bawaan: tidak ada

pola glob yang dipisahkan garis baru; hanya file yang cocok yang diterjemahkan.

exclude

Bawaan: tidak ada

pola glob yang dipisahkan garis baru; File yang cocok dilewati (diterapkan setelah disertakan).

configPath

Bawaan: .github/resource-translator.yml

Jalur ke file konfigurasi YAML (relatif terhadap akar ruang kerja).

changeDetection

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

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

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

Bawaan: false

Saat true, jalankan terjemahan dan keluarkan ringkasan tetapi jangan menulis file.

failOnError

Bawaan: true

Ketika true, kesalahan tak terduga gagal dalam tindakan; ketika false, kesalahan adalah peringatan.

Input permintaan Azure Translator

Ini dipetakan langsung ke parameter kueri Azure AI Translator v3 dan berlaku untuk penyedia Azure. textType dan profanityAction juga dipetakan ke AWS/Google jika ada yang setara (lihat panduan penyedia); sisanya hanya Azure. Masing-masing adalah opsional; default Penerjemah berlaku saat tidak disetel.

categoryId

Bawaan: general

Kategori Custom Translator Azure — kenop industri/domain/nada. Diteruskan sebagai ?category=....

textType

Bawaan: plain

plain atau html. Gunakan html hanya jika nilai resource Anda adalah fragmen HTML nyata.

profanityAction

Bawaan: NoAction

NoAction, Marked, atau Deleted. Mengontrol bagaimana istilah profan dipancarkan dalam terjemahan.

profanityMarker

Bawaan: Asterisk

Asterisk atau Tag. Hanya berarti ketika profanityAction Marked.

allowFallback

Bawaan: true (Penerjemah default)

Saat false, Penerjemah mengembalikan kesalahan alih-alih kembali ke sistem umum jika categoryId Anda tidak memiliki penyebaran untuk lokal target.

apiVersion

Bawaan: 3.0

Versi REST API penerjemah.

Ketahanan & perlindungan placeholder

Input ini mengontrol bagaimana tindakan berperilaku saat Penerjemah membatasi permintaan Anda dan bagaimana hal itu melindungi token placeholder seperti {{name}} atau {0} agar tidak rusak selama terjemahan.

maxRetries

Bawaan: 5

Upaya coba ulang maksimum pada respons HTTP sementara (408, 425, 429, 500, 502, 503, 504). Jumlah total panggilan HTTP per permintaan adalah 1 + maxRetries.

retryBackoffMs

Bawaan: 30000

Tutup (dalam milidetik) pada satu tidur mundur. Tindakan ini menghormati header respons Retry-After Azure persis saat ada; jika tidak, ia menggunakan backoff eksponensial jittered yang dibatasi pada nilai ini.

protectPlaceholders

Bawaan: true

Saat true (default), placeholder seperti entitas {{name}}, ${var}, {0}, {0:N2}, %s, %1$s, dan HTML diganti dengan token sentinel sebelum diterjemahkan dan dipulihkan setelahnya. Nonaktifkan hanya jika sumber Anda sengaja berisi teks berbentuk placeholder literal yang harus diterjemahkan.

customPlaceholderPatterns

Bawaan: tidak ada

Regex yang dipisahkan baris baru (tanpa pembatas) ditambahkan ke set placeholder default, misalnya <<.+?>> untuk sintaks token kustom.

noTranslatePatterns

Bawaan: tidak ada

Pola glob yang dipisahkan garis baru yang cocok dengan kunci tingkat parser (jalur putus-putus JSON, name RESX, PO msgid, id unit XLIFF, kunci INI/restext). Kunci yang cocok dihapus dari permintaan Penerjemah dan diteruskan dengan nilai sumbernya dipertahankan.

Keluaran

summary-title

Ringkasan singkat yang ramah judul PR, misalnya Machine-translated 320 files, a total of 5,418 translations.

summary-details

Ringkasan penurunan harga cocok untuk badan PR atau ringkasan pekerjaan.

has-new-translations

'true' ketika satu atau beberapa terjemahan baru dibuat.