マニュアル日本語化ガイドライン
はじめに
これは私(t-chen)が50以上のマニュアルを翻訳して感じたことの覚書です。ほとんど自分用に書いていますが、将来的に誰かのためになるかもしれないと思って残しておきます。
テンプレートについて
- マニュアルに関するルールは変更される可能性があるので、常にDiscordの#repo-discussionに目を通すようにしましょう。
- 元テンプレートから変更する点
<html>から<html lang="ja">に変更<link rel="stylesheet" type="text/css" href="css/font-japanese.css">をfont.cssの下に追加- h2タグの開始は
モジュール詳細：:(半角)ではなく：(全角)
- ファイル名は
Module Name translated (日本語 — モジュール名) (Creator).htmlModule Nameに元のモジュール名モジュール名に日本語のモジュール名Creatorに自分の名前-でもーでもなく—なので注意- 元マニュアル以外の翻訳の場合は
Module Name translated (日本語 — モジュール名) 用途 (Creator).html- 例:
The Button translated (日本語 — ボタン) 最適化 (Creator).html
- 例:
アップロード
- アップロード前にすること
- 方法1 - Githubを使う方法(Gitの使い方がわかる方向け)
- レポジトリのソースコードをフォークしてクローンする
- ファイルを追加してコミット、プッシュする。
- プルリクエストを送る
- 方法2 - #repo-requestに提出する方法
- Discordに参加し、#repo-requestにテンプレートのzipファイルの構造の通りにアップロードする
- 時間はかかるけど、メンテナーがそのうち反映してくれる(私にDMくれれば早めに対処します)
SVGについて
- マニュアル右上のSVGについては、無理に翻訳する必要はない。
- マニュアルに書かれていない文字([ディスプレイ]など)の場合は翻訳したほうが良い
- モジュールに書かれている文字がそのままSVGにかかれている場合は翻訳しない
- カッコはすべて[]に統一(元SVGがそうでなくても)
- それ以外のSVGのうち、文字が含まれているものは基本的に翻訳する。
- 別ファイルのSVG(マニュアル右上のSVGを含む)の文字はすべてパスに変換する
- Inkscapeで文字を選択→Ctrl+Shift+C
フォントについて
- 日本語のFontは”Noto Serif JP”を基本とする。
- 英字や数字が連続していて、等幅フォントでないと見にくい場合は”Special Elite”を使う。
- フォントは通常ひらがな・カタカタ・英字・数字・常用漢字・一部の記号以外対応していないので注意
- 対応している文字はfont-japanese.cssのコメントを見ること。
- フォントに文字を追加する方法。
- サブセットフォントメーカーにNoto Serif JPの元ファイルとfont-japanese.cssのコメント+追加したい文字を利用してサブセットを作成する。
- WOFFコンバータを利用してWOFFに変換する
- font-japanese.cssのコメントをアップデートする。
- Githubを使う場合は、アップデートしたものでプルリクエストを送れば良い
- #repo-requestを使う場合、フォントを変更した旨を追記してzipファイルを送る
ルールシードについて
- ルールシードMODを使うと、シードによってマニュアルが書き換えることができる。
- 判別方法:
<script src="js/ruleseed.js"></script>が入っていたら基本的にはルールシード対応モジュール(たまにミスって含まれているときもあるから注意) - Javascriptの知識が必要になるので、無理にルールシードに対応しなくてもよい。マニュアルを非対応にするには
<script src="js/ruleseed.js"></script>の行を削除すれば良い。 - ルールシードの対応については、モジュールによるので、よくコードを読んで対応すること。
用語について
間違っている、こうした方がよい、という提案がありましたら教えて下さい。場合によってはすべてのマニュアルを一括で変更できます
公式マニュアルにかかれているもの
これらは必ず遵守する
- Regular Module - モジュール, Needy Module - 特殊モジュール
- Moduleは「モジュールと特殊モジュール」で訳す
- Serial number - シリアルナンバー
- シリアル番号ではないので注意
- Lit indicator - 点灯したインジケーター
- Countdown timer - カウントダウンタイマー
- Strike - ミス(名詞)、ミスが記録される(動詞)
- Betteries - バッテリー
- 電池ではないので注意
- AA batteries - 単3バッテリー
- D battery - 単1バッテリー
- Port - ポート
- Parallel - パラレル
- Serial - シリアル
- Stereo RCA - ステレオRCA
- それ以外は英字のまま
- More than X, Less than X - Xより多い、Xより少ない
- わかりにくい、との批判もあるが、そのわかりにくさがゲームの鍵でもあるため
- X or More, X or lessはX以下、X以上でよい。
公式マニュアルにかかれていないもの
迷ったら参考にする程度でよい
- Unlit indicator - 点灯していないインジケーター
- Row, Collumn - 段、列
- Alphabet - 英字
- Reading order - 読み順
- できるだけフットノートで意味を追記したほうがよい
- Digital root - 数字根
- Magenta, Cyan - マゼンタ、シアン
- ピンク、水色などにしない理由は、1. 色の合成で意味を成す場合があるから 2. Magentaと別でPinkがある場合があるから
- Base 2, Base 10 - 二進法、十進法
- 進数は漢数字で
- 他のモジュール名は、翻訳名と原名のどちらも書く
- どちらをベースにプレイしている人でもプレイできるように
- Alphabetic position - アルファベット上での位置
- 元マニュアルに書いていない場合でも、(A=1, B=2…)と追記する方が良い(A=0, B=1…とする流派もあるため)
- A modulo/mod B - AをBで割ったときの余り
その他間違えやすい用語など
- Letters - ◯英字 ☓文字
- 文字はcharacters
- Encrypt ↔ Decrypt - 暗号化 ↔ 復号
- 復号化では無いので注意
- 複合とか複号でもないので注意
- Encrypted message ↔ Decrypted message - 暗号 ↔ 復号文
- Apply - 適用
- 適応するではないので注意(環境に適応する ↔ ルールを適用する)
迷ったら…
- マニュアルの第一の目標は正しく情報を伝えることです。一部のモジュール(特に古いモジュール)は、そもそも解除するのに情報が不足している場合があります。そのような場合はガンガン追記して大丈夫です。
- 例えば、Third Baseはモジュールが逆さまになっていることが書かれていませんが、これは表を読む上で重要な情報なので、追記しました。
- マニュアルでわかりにくいところがあり、それが意図的にわかりにくく書かれているのであればその選択は尊重すべきです。書き方が悪いだけである可能性が高い場合は、言い換えてもよいです。
- 例えば、Letter Keysは意図的に数字をアラビア数字で書いていませんので、それを尊重してすべて漢字で翻訳しました。
- Rock-Paper-Scissors-Lizard-Spockのじゃんけんの判定は、ドラマからの引用ですので、これもあえてわかりにくく書いています。
- Decolored Squaresの「次の正方形」の定義はかなりわかりにくいですが、これが意図的にわかりにくく書かれているとは思えなかったので変更しました。
- 直訳である必要もないので、適宜日本語としてふさわしい文章に書き換えてください。