Cấu hình · Trình dịch tài nguyên

Ghi đè đường dẫn bằng đầu vào configPath nếu bạn cần một vị trí không mặc định.

Lược đồ

# .github/resource-translator.yml
sourceLocale: en

# Provider config can be nested. Keep secrets in workflow inputs; use repo
# config for non-secret defaults like region, model, formality, or category.
provider:
  azure:
    categoryId: my-custom-translator-category
    apiVersion: "3.0"
    allowFallback: true

toLocales:
  - fr
  - de
  - es
include:
  - "src/**/*.en.json"
  - "apps/**/*.en.resx"
exclude:
  - "**/__tests__/**"
glossary:
  Acme: Contoso
  Octocat: Octocat   # keep brand names verbatim

# Translator request shape — most users can ignore these.
textType: plain                  # plain | html
profanityAction: NoAction        # NoAction | Marked | Deleted
profanityMarker: Asterisk        # Asterisk | Tag (only when profanityAction == Marked)

# Resilience — Translator returns 429 under load. Defaults are usually
# fine; tune only if your runs are large enough to hit them.
maxRetries: 5
retryBackoffMs: 30000             # cap on any single backoff sleep (ms)

# Placeholder protection. ON by default — wraps tokens like {{name}},
# {0}, %s, ${var} into sentinels before translation and restores them
# on the way back. Set false only when source intentionally contains
# placeholder-shaped literals.
protectPlaceholders: true
customPlaceholderPatterns:
  - "<<.+?>>"                     # any extra token syntax you use

# Per-key opt-out. Keys matching any glob are dropped from the request
# and pass through with the source value preserved.
noTranslatePatterns:
  - "errors.code.*"
  - "brands.*"

Tham chiếu trường

provider

Kiểu: "azure" | "aws" | "google" | provider block

Either a provider string or a nested provider block (provider.azure, provider.aws, or provider.google). Prefer nested blocks for provider-specific settings; keep secrets in workflow inputs rather than committed config.

sourceLocale

Kiểu: string

Quay trở lại đầu vào sourceLocale nếu không được đặt. Cũng được chuyển tiếp đến Translator dưới dạng from=<locale> vì vậy các chuỗi ngắn không được tự động phát hiện.

toLocales

Kiểu: string[]

Một mảng hoặc một chuỗi được phân tách bằng dấu phẩy.

include / exclude

Kiểu: string[]

Các mẫu Glob được đánh giá dựa trên đường dẫn tuyệt đối và tương đối không gian làm việc.

glossary

Kiểu: map<string,string>

Ghi đè thuật ngữ sau dịch. Nhận biết ranh giới từ (xử lý C++, .NET).

categoryId

Kiểu: string

Danh mục Azure Custom Translator — nút ngành/miền của bạn (giọng điệu pháp lý, y tế, tiếp thị, v.v.). Gửi dưới dạng ?category=....

textType

Kiểu: "plain" | "html"

Mặc định là plain. Chỉ sử dụng html nếu giá trị tài nguyên của bạn chứa các đoạn HTML thực.

profanityAction

Kiểu: "NoAction" | "Marked" | "Deleted"

Cách xử lý các thuật ngữ tục tĩu trong đầu ra đã dịch.

profanityMarker

Kiểu: "Asterisk" | "Tag"

Chỉ có ý nghĩa khi profanityAction "Marked".

allowFallback

Kiểu: boolean

Đặt thành false để dịch không thành công khi categoryId của bạn không triển khai cho ngôn ngữ đích thay vì quay trở lại mô hình chung.

apiVersion

Kiểu: string

Phiên bản API REST của dịch giả. Mặc định là 3.0.

awsFormality

Kiểu: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

Kiểu: boolean

Set to true to enable AWS Translate brevity mode for supported language pairs.

awsTerminologyNames / awsParallelDataNames

Kiểu: string[]

AWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.

googleModel

Kiểu: string

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

googleApiEndpoint

Kiểu: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Kiểu: boolean

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

maxRetries

Kiểu: integer

Số lần thử lại tối đa đối với phản hồi HTTP tạm thời (408, 425, 429, 500, 502, 503, 504). Mặc định là 5. Tổng số lệnh gọi HTTP trên mỗi yêu cầu là 1 + maxRetries.

retryBackoffMs

Kiểu: integer

Giới hạn (ms) trên bất kỳ giấc ngủ dự phòng nào. Mặc định là 30000. Tiêu đề Retry-After của Azure được vinh danh chính xác khi có mặt; nếu không, lùi theo cấp số nhân chập chờn được sử dụng, giới hạn ở giá trị này.

protectPlaceholders

Kiểu: boolean

Mặc định là true. Khi bật, các token như {{name}}, ${var}, {0}, {0:N2}, %s, %1$s và HTML được thay thế bằng sentinel token trước khi dịch và được khôi phục sau đó. Chỉ tắt khi nguồn cố tình chứa các chữ hình giữ chỗ.

customPlaceholderPatterns

Kiểu: string[]

Các mẫu biểu thức chính quy bổ sung (không có dấu phân cách) được thêm vào bộ giữ chỗ mặc định, ví dụ: <<.+?>> cho cú pháp mã thông báo tùy chỉnh. Các biểu thức chính quy không hợp lệ sẽ bị bỏ qua.

noTranslatePatterns

Kiểu: string[]

Các mẫu Glob khớp với các khóa cấp trình phân tích cú pháp (đường dẫn chấm JSON, name RESX, PO msgid, id đơn vị XLIFF, khóa INI/restext). Các khóa phù hợp được loại bỏ khỏi yêu cầu và chuyển qua với giá trị nguồn của chúng được giữ nguyên.

changeDetection

Kiểu: "smart" | "disabled"

Defaults to smart. Uses the committed state manifest to translate only changed or missing parser keys. Set to disabled or false to preserve the legacy always-translate behavior.

statePath

Kiểu: string

Path to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.

Đang tải thứ tự

Hành động này đọc đầu vào rõ ràng từ quy trình làm việc.
Nó tải cấu hình YAML từ configPath.
Đối với mỗi trường được chia sẻ, đầu vào sẽ thắng; nếu không, giá trị YAML sẽ được sử dụng.
Các giá trị hợp nhất được xác thực. Enum không hợp lệ (ví dụ: profanityAction: Mask) khiến hành động nhanh chóng không thành công với thông báo rõ ràng.

Giọng điệu và công nghiệp, nói một cách đơn giản

API Azure AI Translator v3 không có một núm âm duy nhất. Hai cài đặt kết hợp để cung cấp cho bạn hầu hết các quyền kiểm soát giống nhau:

Ngành / lĩnh vực: sử dụng categoryId để trỏ vào danh mục Azure Custom Translator được đào tạo trên kho dữ liệu của riêng bạn — pháp lý, kỹ thuật, y tế, tiếp thị hoặc bất kỳ thứ gì khác. Đây là đòn bẩy mạnh nhất cho giọng điệu, tiếng nói thương hiệu và từ vựng.
Văn bản bề mặt: Sử dụng Thuật ngữ để khóa nguyên văn tên thương hiệu và cụm từ sản phẩm, đồng thời sử dụng profanityAction để loại bỏ các cụm từ tục tĩu khi nhắm mục tiêu bản địa hóa cho đối tượng trẻ tuổi.

Chọn ngôn ngữ của bạn

Cấu hình kho lưu trữ

Lược đồ

Tham chiếu trường

Đang tải thứ tự

Giọng điệu và công nghiệp, nói một cách đơn giản