BLUEPRINT

第11章：多言語サポート

11.1 概要

プロトコルはグローバル開発者コミュニティを対象とし、9言語のプロトコル文書を提供することで、異なる言語背景の開発者がプロトコル仕様を正確に理解できるようにします。

11.2 サポート言語

言語コード言語ディレクトリパス役割
enEnglish（英語）docs/en/基準言語
zh-CN簡体中文docs/zh-CN/翻訳
zh-TW繁體中文docs/zh-TW/翻訳
ja日本語docs/ja/翻訳
ko한국어docs/ko/翻訳
deDeutschdocs/de/翻訳
frFrançaisdocs/fr/翻訳
esEspañoldocs/es/翻訳
ruРусскийdocs/ru/翻訳

11.3 ディレクトリ構造

各言語は独立したディレクトリ構造を維持します：

docs/{language_code}/
├── specification/
│   ├── draft/                # ドラフト仕様書
│   │   └── specification.md
│   └── 2025-11-25/          # バージョン化仕様書
│       └── specification.md
├── blueprint/               # ブループリントドキュメント
│   └── illustration/        # イラストリソース
├── community/               # コミュニティドキュメント
├── develop/                 # 開発ガイド
└── sdk/                     # SDKドキュメント

11.4 基準言語戦略

  • 英語（en）がプロトコル文書の基準言語として機能
  • すべての新規コンテンツはまず英語で作成
  • 他の言語バージョンは英語から翻訳
  • 基準言語ドキュメントが更新された場合、他の言語バージョンに同期状態を注記

11.5 翻訳原則

  1. 技術用語は英語のまま保持（例：Skill Descriptor、Well-Known URI）
  2. 概念的な説明はターゲット言語で表現
  3. コード例内のコメントはターゲット言語に翻訳
  4. ドキュメント構造は基準言語と一致を維持
  5. 各翻訳バージョンに対応する基準言語バージョン番号を注記

11.6 同期状態注記

基準言語ドキュメントが更新された後、他の言語バージョンはドキュメントヘッダーに同期状態を注記すべきです：

---
base_version: en/2025-11-25
sync_status: synced | outdated | in_progress
last_synced: 2025-11-25
---