ドキュメントの多言語対応

まず主要20言語とDicks語で、ドキュメントの全章を読めるようにします。長期的には世界中の言語で読めることを目指します。言語ごとの対応状況は別々に管理し、未完成の翻訳を完成済みとは表示しません。

最初の対象言語

日本語、英語、簡体字中国語、韓国語、スペイン語、フランス語、ドイツ語、ブラジルポルトガル語、ロシア語、アラビア語、ヒンディー語、イタリア語、インドネシア語、トルコ語、ベトナム語、タイ語、ウクライナ語、ポーランド語、オランダ語、ベンガル語の20言語に対応します。これに創作言語のDicks語を加えます。

対象と言語コード、文字の方向、公開状態の正本は localization/locales.json です。アラビア語は右から左に表示します。言語名は各言語で表記し、国旗を言語の代わりには使いません。

全文対応に含めるもの

• 作者の序文、Hello World、導入、言語仕様、公式ライブラリ、開発ツール、運用の全章。
• 各リリースの変更履歴、互換性、移行手順、既知の制約。
• 公開済みの各バージョンと開発中のドキュメント。
• ナビゲーション、検索、サイドバー、バージョン切り替え、ボタン、エラー表示。

見出しだけの翻訳や、一部の章を原文のまま表示する状態を全文対応とは扱いません。日本語は開発中・固定バージョンの全章とUIを揃えています。ほかの19自然言語とDicks語は翻訳中です。

バージョンごとの原文と翻訳

固定マニュアルの原文は versioned_docs/ に保持します。翻訳は i18n/<locale>/docusaurus-plugin-content-docs/ に置き、current と version-<version> を分けて管理します。翻訳を追加するために旧バージョンの原文を上書きしません。

翻訳には対応する原文のSHA-256と翻訳本文のSHA-256を記録します。原文の変更後は翻訳を再確認します。同じ原文が複数バージョンにある場合も、対象バージョンごとの対応を追跡します。

実行するコード、コマンド、期待出力、識別子、URL、コミットSHA、バージョン番号は技術的な意味を保ちます。翻訳のためにサンプルの動作や安全上の条件を変えません。コードの変更が必要なときは、翻訳と混ぜずに原文の修正として検証します。

公開する条件

翻訳中の言語は作業用のファイルとして管理します。全文とUIの訳が揃い、原文との対応、リンク、サンプル、検索、スマートフォン表示、文字方向を確認してから公開します。原文への自動切り替えで未翻訳の章を埋めた状態では公開しません。

翻訳の更新でもPRに変更内容を記載し、マージ後のリリースに記録します。言語の仕様変更、誤訳の修正、表記の調整を区別し、必要な移行手順を残します。

Dicks語

Dicks語も見出しから本文まで意味のある文章として翻訳します。表示する文字は 8 = D ~ とASCIIの空白に限定します。他言語の文章を文字コードへ置き換えたものをDicks語の翻訳とは扱いません。

現在の字母・文法・辞書は0.1.0-draftです。複文、数、固有名詞、引用、技術用語を表現するための整備が残っています。これらを定義し、文章として内容を伝えられる状態にしてから全文対応を公開します。Dicks語の案内も参照してください。