JSON は、Web サイトやアプリがデータ・設定・多言語の文言(i18n の言語ファイル)を保存するのによく使う形式です。言語ファイルはたいてい "キー名": "文言" の組み合わせで、プログラムはキー名で文言を探します。そのため変換ではキー名を変えてはいけませんし、元のファイルと見比べやすいよう、構造や書式もそのまま残すのが理想です。
変換されるもの
- 文字列の値。配列や入れ子のオブジェクトの中の文字列も含みます。
\u5934\u53d1(头发)のように\uでエスケープした中国語。- キー名(設定で切り替えられ、既定はオフ)。
そのまま残るもの
- キー名、数値、
true・false・null、オブジェクトと配列の構造。 - インデントと書式。変わった文字列だけを書き直し、それ以外のバイトは元のまま残します。
下の変換例は「簡→繁」「台湾」で「地域の用語も変換」をオンにした結果で、「打印机」が「印表機」、「内存」が「記憶體」のように台湾の言い方になっています。
文字コードと互換性
JSON の仕様では、システムのあいだでやり取りするときは UTF-8 を使うことになっていて、多くのプログラムも UTF-8 として読みます。元のファイルが GBK や Big5 なら自動で判定し、出力はすべて UTF-8 です。BOM は既定で元のファイルに合わせるので、BOM のなかったファイルに BOM が付くことはありません。
変換例
| 原文 | 変換結果 |
|---|---|
| {"title": "软件设置"} | {"title": "軟體設定"} |
| {"menu.file": "文件", "menu.help": "帮助"} | {"menu.file": "檔案", "menu.help": "幫助"} |
| {"msg": "内存不足,请关闭后台程序"} | {"msg": "記憶體不足,請關閉後臺程式"} |
| {"count": 3, "enabled": true, "label": "打印机"} | {"count": 3, "enabled": true, "label": "印表機"} |
| {"tip": "\u70b9\u51fb\u4fdd\u5b58"} | {"tip": "點選儲存"} |
OpenCC(s2twp)で実際に変換した結果です。
使い方
- zh-CN.json のような言語ファイルをページにドロップするか、「ファイルを選択」を押します。複数の言語ファイルをまとめて選べます。
- 方向を「簡→繁」、地域を「台湾」か「香港」にします。「地域の用語も変換」は最初からオンで、UI の言葉がその地域の言い方になります。
- カードの「N か所を変換」とプレビューを確かめます。正しい JSON でないファイルには、別に警告が出ます。
- ダウンロードします。既定では言語コードが付き、messages.zh-CN.json は messages.zh-Hant-TW.json になります。
注意点
- 用語の置き換えは辞書どおりで、意味までは見ません。「文件」は書類の意味でも「檔案」になり、「点击保存」は「點選儲存」になります。UI の文言は、公開前にその地域の言葉に詳しい人に見てもらうと安心です。
- 文字列の値は全体を変換します。値に /分类/软件 のような中国語のパスや URL が入っていると、それも変わるので注意してください。
- ASCII で書いたプレースホルダー({name} や %s など)は変わりません。中国語で書いたプレースホルダーは変換されます。
よくある質問
キー名は変換されますか?
既定では変換しません。プログラムはキー名で文言を探すので、変わると見つからなくなります。中国語のキー名も変えたいときは、詳細設定の「JSON:キー名も変換」をオンにします。
\u でエスケープした中国語も変換できますか?
できます。エスケープを読み取ってから変換し、変わった文字列は UTF-8 の文字のまま書き戻します。変わらなかった文字列は元の書き方のままです。下の変換例の最後の行がその例です。
ファイルが整形し直されることはありますか?
ありません。インデント・スペース・改行・キーの順番はそのままで、変わらなかった部分は 1 バイトも変えないので、Git で比べると変わった文言だけが見えます。
コメント付きの JSON はどうなりますか?
コメントや末尾のカンマがあるファイルは正しい JSON ではないので、カードに「正しい JSON ではないため変換しませんでした」と表示されます。「プレーンテキストとして変換」を押すと変換できますが、キー名の中国語も変わります。
簡体字の言語ファイルから香港版を作るには?
「簡→繁」と「香港」を選び、「地域の用語も変換」はオンのままにします。OpenCC の香港の用語で置き換わる語は少なく、「鼠标」は「滑鼠」になりますが、「软件」は香港でふつうに使われる「軟件」のままです。