メインコンテンツへスキップ

Script Converters

Script Converters（スクリプトコンバーター）は、ある書記体系から別の書記体系へテキストを変換する、決定的（deterministic）でLLMを使用しない翻訳後のフックです。これにより、「一度翻訳すれば、複数のスクリプトでレンダリングできる」ワークフローが可能になります。つまり、作業用のスクリプト（通常はラテン文字）に翻訳し、その後自動的に表示用のスクリプトに変換します。

なぜスクリプトコンバーターが必要なのか？​

一部の言語では、同じ話し言葉に対して複数のスクリプト（文字）を使用します。

  • Plains Cree（平原クリー語）: 編集用のSRO（ラテン文字） → 表示用のSyllabics（音節文字、ᓀᐦᐃᔭᐍᐏᐣ）
  • Serbian（セルビア語）: 国際用途のラテン文字 → 国内用途のキリル文字
  • Klingon（クリンゴン語）: 入力用のローマ字表記 → 表示用のpIqaD（ ）

ラテン文字以外のスクリプトに直接翻訳すると、問題が発生します。LLMが文字のハルシネーションを起こしたり、JSONファイルのバージョン管理が困難になったり、diffツールで変更箇所を比較できなくなったりするためです。スクリプトコンバーターは、翻訳をバージョン管理に適したスクリプトで保持し、同期時に決定論的に変換することで、この問題を解決します。

利用可能なコンバーター​

Rosettaには、5つの組み込みスクリプトコンバーターが標準搭載されています。

ロケール変換元変換先タイプフォント要否
crkSRO (Standard Roman Orthography)Cree Syllabics決定的不要 — ネイティブUnicode
srラテン文字キリル文字決定的不要 — ネイティブUnicode
tlhローマ字表記pIqaD決定的必要 — PUA U+F8D0–F8FF
x-elvish-sラテン文字Tengwar (Mode of Beleriand)決定的必要 — PUA U+E000–E07F
x-kryptonianラテン文字Kryptonianフォントベースの暗号必要 — PUA U+E100–E119

決定的（Deterministic）とフォントベースの比較​

  • 決定的なコンバーター（Cree、Serbian、Klingon、Tengwar）は、言語学的ルールを使用して実際の文字対文字のマッピングを実行します。出力には実際のUnicode文字が含まれます。
  • フォントベースのコンバーター（Kryptonian）は1対1の換字式暗号であり、出力は特定のフォントを読み込んだ場合にのみ正しくレンダリングされるUnicode PUA文字になります。

仕組み​

スクリプトコンバーターは、翻訳の後に後処理ステップとして実行されます。パイプラインは以下の通りです。

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

例えば、Plains Cree（平原クリー語）の場合は次のようになります。

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

貪欲な左から右へのマッチング​

すべてのコンバーターは同じアルゴリズムを使用します。各文字位置で、最初に可能な限り最長のマッチを試し、その後徐々に短いマッチを試します。どのパターンにもマッチしない文字（スペース、句読点、数字など）は、変更されずにそのまま出力されます。

これにより、二重字（digraph）や三重字（trigraph）が正しく処理されます。

  • Klingon: tlh → 単一のpIqaD文字（t + l + h ではない）
  • Serbian: nj → њ（н + ј ではない）
  • Cree: twê → 単一の音節文字（t + w + ê ではない）

スクリプトコンバーターの使用​

スクリプトコンバーターは、ロケールコードが登録されたコンバーターと一致した場合に自動的に有効になります。設定は不要です。ターゲットロケールを設定するだけで機能します。

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

rosettaが en:crk ペアを同期する際、翻訳は最初にSROで生成され、その後 crk.json に書き込まれる前に自動的にSyllabics（音節文字）に変換されます。

コンバーターステータスの確認​

npx i18n-rosetta status

ステータス出力には、どのペアでスクリプトコンバーターが有効になっているか、およびどのような変換が実行されるかが表示されます。

Webフォントの要件​

3つのコンバーターは、カスタムWebフォントを必要とするUnicode私用領域（PUA）の文字を出力します。

Klingon (pIqaD)​

CSUR互換のpIqaDフォント（例: 「pIqaD qolqoS」や「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)​

CSUR互換のTengwarフォント（例: 「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​

PUAコードポイント U+E100–E119 にマッピングされたKryptonianフォントをインストールします。

@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 Kryptonianの代替アプローチ Kryptonianは純粋なA-Zの暗号であるため、スクリプトコンバーターを完全にスキップし、CSSを使用してラテン文字のテキストにフォントを適用することができます。これはWebデプロイメントにおいて、よりシンプルな方法となることがよくあります。Kryptonianフォントを配信し、関連する要素に font-family を設定するだけです。 :::

カスタムコンバーターの追加​

新しい言語のコンバーターを追加するには、lib/scripts.js を編集します。

  1. 変換マップの作成 — [from, to] ペアの順序付き配列（最長のシーケンスを先頭にする）
  2. コンバーター関数の作成 — 貪欲な左から右へのスキャナー（テンプレートとして sroToSyllabics を使用）
  3. SCRIPT_CONVERTERS オブジェクトへの登録 — ロケールコードをキーとして使用
  4. script フィールドの追加 — 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,
};

関連項目​