Chuyển đến nội dung chính

Trình chuyển đổi chữ viết

Trình chuyển đổi chữ viết là các hook hậu dịch thuật mang tính tất định (deterministic), không sử dụng LLM, giúp chuyển đổi văn bản từ một hệ thống chữ viết này sang một hệ thống chữ viết khác. Chúng cho phép quy trình làm việc "dịch một lần, hiển thị bằng nhiều chữ viết" — bạn dịch sang một chữ viết làm việc (thường là chữ Latinh), sau đó tự động chuyển đổi sang chữ viết hiển thị.

Tại sao cần Trình chuyển đổi chữ viết?​

Một số ngôn ngữ sử dụng nhiều hệ thống chữ viết cho cùng một ngôn ngữ nói:

  • Plains Cree: SRO (Latinh) để chỉnh sửa → Syllabics (ᓀᐦᐃᔭᐍᐏᐣ) để hiển thị
  • Tiếng Serbia: Chữ Latinh cho mục đích quốc tế → Chữ Cyrillic cho mục đích nội địa
  • Tiếng Klingon: Chữ Latinh hóa (Romanization) để gõ → pIqaD ( ) để hiển thị

Việc dịch trực tiếp sang các chữ viết phi Latinh gây ra nhiều vấn đề: LLM sinh ra các ký tự ảo giác (hallucinate), các tệp JSON trở nên khó kiểm soát phiên bản (version-control) và các công cụ diff không thể so sánh các thay đổi. Trình chuyển đổi chữ viết giải quyết vấn đề này bằng cách giữ các bản dịch ở một chữ viết thân thiện với việc kiểm soát phiên bản và chuyển đổi một cách tất định tại thời điểm đồng bộ (sync).

Các trình chuyển đổi có sẵn​

Rosetta được tích hợp sẵn năm trình chuyển đổi chữ viết:

LocaleTừSangLoạiYêu cầu Font?
crkSRO (Standard Roman Orthography)Cree SyllabicsTất địnhKhông — Unicode gốc
srLatinhCyrillicTất địnhKhông — Unicode gốc
tlhLatinh hóapIqaDTất địnhCó — PUA U+F8D0–F8FF
x-elvish-sLatinhTengwar (Mode of Beleriand)Tất địnhCó — PUA U+E000–E07F
x-kryptonianLatinhKryptonianMật mã dựa trên fontCó — PUA U+E100–E119

Tất định vs. Dựa trên Font​

  • Trình chuyển đổi tất định (Cree, Serbia, Klingon, Tengwar) thực hiện ánh xạ ký tự-sang-ký tự thực sự bằng cách sử dụng các quy tắc ngôn ngữ học. Đầu ra chứa các ký tự Unicode thực tế.
  • Trình chuyển đổi dựa trên font (Kryptonian) là các mật mã thay thế 1:1, trong đó đầu ra là các ký tự Unicode PUA chỉ hiển thị chính xác khi một font chữ cụ thể được tải.

Cách thức hoạt động​

Trình chuyển đổi chữ viết chạy sau khi dịch như một bước xử lý hậu kỳ. Luồng xử lý (pipeline) như sau:

Source (English) → LLM Translation → Working Script → Script Converter → Display Script

Ví dụ, với Plains Cree:

"Welcome" → LLM → "tānisi" (SRO) → Converter → "ᑖᓂᓯ" (Syllabics)

Khớp tham lam từ trái sang phải (Greedy Left-to-Right Matching)​

Tất cả các trình chuyển đổi đều sử dụng cùng một thuật toán: tại mỗi vị trí ký tự, thử khớp chuỗi dài nhất có thể trước, sau đó là các chuỗi ngắn dần. Các ký tự không khớp với bất kỳ mẫu nào (khoảng trắng, dấu câu, số) sẽ được giữ nguyên.

Điều này xử lý chính xác các chữ ghép đôi (digraph) và chữ ghép ba (trigraph):

  • Klingon: tlh → một ký tự pIqaD duy nhất (không phải t + l + h)
  • Tiếng Serbia: nj → њ (không phải н + ј)
  • Cree: twê → một âm tiết (syllabic) duy nhất (không phải t + w + ê)

Sử dụng Trình chuyển đổi chữ viết​

Trình chuyển đổi chữ viết tự động kích hoạt khi mã locale khớp với một trình chuyển đổi đã đăng ký. Không cần cấu hình — bạn chỉ cần thiết lập locale đích:

i18n-rosetta.config.json
{
  "pairs": {
    "en:crk": {
      "method": "llm-coached",
      "model": "google/gemini-2.5-pro"
    }
  }
}

Khi rosetta đồng bộ cặp en:crk, các bản dịch trước tiên được tạo ra bằng SRO, sau đó tự động được chuyển đổi sang Syllabics trước khi ghi vào crk.json.

Kiểm tra trạng thái trình chuyển đổi​

npx i18n-rosetta status

Đầu ra trạng thái hiển thị các cặp nào có trình chuyển đổi chữ viết đang hoạt động và quá trình chuyển đổi mà chúng thực hiện.

Yêu cầu về Web Font​

Ba trình chuyển đổi xuất ra các ký tự Unicode Private Use Area (PUA) yêu cầu các web font tùy chỉnh:

Klingon (pIqaD)​

Cài đặt một font pIqaD tương thích với CSUR (ví dụ: "pIqaD qolqoS" hoặc "Klingon pIqaD HaSta"):

@font-face {
  font-family: 'pIqaD';
  src: url('/fonts/pIqaD.woff2') format('woff2');
  unicode-range: U+F8D0-F8FF;
}

:lang(tlh) {
  font-family: 'pIqaD', sans-serif;
}

Tengwar (Sindarin)​

Cài đặt một font Tengwar tương thích với CSUR (ví dụ: "Tengwar Formal CSUR", "Tengwar Annatar"):

@font-face {
  font-family: 'Tengwar';
  src: url('/fonts/tengwar-formal-csur.woff2') format('woff2');
  unicode-range: U+E000-E07F;
}

:lang(x-elvish-s) {
  font-family: 'Tengwar', serif;
}

Kryptonian​

Cài đặt một font Kryptonian được ánh xạ tới các điểm mã (codepoint) PUA U+E100–E119:

@font-face {
  font-family: 'Kryptonian';
  src: url('/fonts/kryptonian.woff2') format('woff2');
  unicode-range: U+E100-E119;
}

:lang(x-kryptonian) {
  font-family: 'Kryptonian', sans-serif;
}

:::tip Cách tiếp cận thay thế cho Kryptonian Vì Kryptonian là một mật mã A-Z thuần túy, bạn có thể bỏ qua hoàn toàn trình chuyển đổi chữ viết và áp dụng font chữ cho văn bản Latinh thông qua CSS. Cách này thường đơn giản hơn cho các triển khai web — chỉ cần cung cấp font Kryptonian và thiết lập font-family trên các phần tử liên quan. :::

Thêm một Trình chuyển đổi tùy chỉnh​

Để thêm một trình chuyển đổi cho một ngôn ngữ mới, hãy chỉnh sửa lib/scripts.js:

  1. Tạo bản đồ chuyển đổi (conversion map) — một mảng có thứ tự gồm các cặp [from, to], các chuỗi dài nhất xếp trước
  2. Tạo hàm chuyển đổi — một trình quét tham lam từ trái sang phải (sử dụng sroToSyllabics làm mẫu)
  3. Đăng ký nó trong đối tượng SCRIPT_CONVERTERS với mã locale làm khóa (key)
  4. Thêm trường script vào mục đăng ký của ngôn ngữ trong registers.js
// Example: adding a converter for Cherokee (chr)
const LATIN_TO_CHEROKEE_MAP = [
  ['ga', 'Ꭶ'], ['ka', 'Ꭷ'], ['ge', 'Ꭸ'], // ...
];

function latinToCherokee(text) {
  // Same greedy left-to-right pattern as other converters
}

SCRIPT_CONVERTERS['chr'] = {
  from: 'Latin',
  to: 'Cherokee Syllabary',
  type: 'deterministic',
  converter: latinToCherokee,
};

Xem thêm​