ローカリゼーション用の未加工テキスト ファイルを準備するときは、以下のガイドラインに従ってください。 これらのガイドラインは、ローカリゼーションの技術的な側面 (ローカリゼーション システム内でのコンテンツの解析および配信) においても、包括的でわかりやすいコメントを通じてできる限り最適な翻訳を実現できるようにするためにも、非常に重要です。
このチュートリアルでは、次の内容を学びます。
- 適切に書式設定された言語ファイルを作成する方法。
- 各翻訳にコンテキストを提供するためのベスト プラクティス。
要件
本チュートリアルを開始する前に、次の少なくともいずれかを完了することをお勧めします。これらのチュートリアルでは翻訳を利用しているため、本チュートリアルの例として役立つからです。
テキスト文字列
ゲーム内で表示させるために作成したテキストは en_US.lang ファイルにあります。 各テキスト文字列は 1 行に表示され、特定のデータが含まれるように特別な方法で書式設定されています。
- 文字列名 (必須)
- 文字列値 (必須)
- 文字列コメント (強く推奨)
一般的には、次のようになります。
StringName=StringValue ###StringComment
文字列名
各テキスト文字列には文字列名を指定する必要があります (ID やキーとも呼ばれます)。 この名前を使用して翻訳システム内でテキスト文字列を識別します。
文字列名 (キー/ID) は行の先頭に配置し、後ろに等号 (=) を付けます。 また、ファイル内の他の名前と比べたときに一意である必要もあります。
文字列名の例
Welcome.Message.1=
必ずわかりやすい文字列名を指定してください。 適切な文字列名は、そのテキストがゲーム内のどこでどのように使用されるかを翻訳者が理解する際のヒントになります。
文字列値
各テキスト文字列には文字列値を指定する必要があります。 この値はゲーム内でプレイヤーに表示されるテキストです。 行では、各値が先頭の等号 (=) で始まり、タブ文字で終わって、後にハッシュタグ文字が続きます。
文字列値の例
Welcome.Message.1=Welcome to our world! #
ここで、文字列名は Welcome.Message.1 で、文字列値は Welcome to our world! です。
注意
<tab># は、パーサーが文字列を認識するために必要な終端記号です。 ハッシュタグはコメントの開始部分を示すものであるため、余分に追加しても問題はありません (下記参照)。 タブをスペースに変換するプログラムや処理には注意してください。変換すると機能しなくなります。 タブは文字コード U+0009 にする必要があります。 等号 (=) の前後にはスペースを使用しないでください。
コメント
コメントは翻訳者に対してテキスト文字列に関する重要なコンテキスト情報を提供します。 多くの場合、コメントは高品質の翻訳を実現するうえで不可欠であるため、強く推奨されます。
行末にもう 2 つのハッシュタグ文字を追加してからコメントを入力することで、テキスト文字列にコメントを関連付けます。 最後のハッシュタグ文字の後であれば、コメントでスペースを使用することができます。
Author.Name.2=Created by <name> ###<name> is the proper name of the map creator, and he is a male person.
翻訳者が Created by <name> というテキストを翻訳する際に、<name> is the proper name of the map creator, and he is a male person というコメントが翻訳者に表示されます。 このコメントからは、人物の名前が 1 人の男性の固有名詞であることがわかります。 特定の言語では、コンテキストが単独の人 (ジェンダーを含む) なのか、人のグループなのか、会社名なのかによって訳語が異なるため、コメントを付けることは良い習慣です。
すべての文字列にコメントを付けることで翻訳者ができるだけ良い仕事ができるよう支援することを強くお勧めします。 翻訳者に役立ちそうなことであればなんでも詳しく説明するようにしてください。たとえば、以下のような情報です。
- コンテキストおよび発話の一部
- 固有名詞 (と説明)
- 主語/目的語のジェンダー、数、およびそれが場所/位置であるのかどうか
- キャラクターやアイテムの意味
- 色分けにどのような意図が込められているか
- 翻訳してはいけない箇所
- 分割または結合されている行の全文 (下記参照)
重要
コメントは文字列ごとに付けます。 1 つのコメントを複数の文字列に適用する場合は、そのコメントをコピーして各行に貼り付けます。 翻訳者は文字列に関連付けられたコメントしか確認できません。 翻訳者が en_US.lang ファイル全体を手にすることはありません。 このため、複数のテキスト文字列にわたって行や会話を分割しないことがベスト プラクティスになります。 分割する必要がある場合は、翻訳者の助けになるように、文字列ごとに文や会話の全文をコメントに入力します。 翻訳者にはこれらの各行がバラバラに表示され、しかも必ずしも順番どおりには表示されないことを覚えておいてください。
コメントの例
次に示すように、各行のコメントには看板の全文を含めます。 これによって、翻訳者ははるかに容易に正しく訳すことができます。
Welcome.Sign.1=Welcome to ### Welcome to our world! We hope you have fun!
Welcome.Sign.2=our world! ### Welcome to our world! We hope you have fun!
Welcome.Sign.3=We hope you ### Welcome to our world! We hope you have fun!
Welcome.Sign.4=have fun! ### Welcome to our world! We hope you have fun!
ファイル
en_US.lang ファイルは UTF-8 エンコードで保存する必要があります。 このファイルを ANSI、UTF-8 BOM、UCS-2、またはその他でエンコードすると、処理に失敗します。
たとえば、Windows 10 のメモ帳を使用している場合にファイルを保存するときは、[エンコード] ドロップダウン メニューで必ず [UTF-8] を選択します。 また、間違って .txt ファイルを作成することのないように、[ファイルの種類] は [すべてのファイル] に設定します。
![[エンコード] が [UTF-8] に設定された Windows 10 のメモ帳](media/preparingrawtextforlocalization/utf8.png)
翻訳のコンテキストを示すドキュメント (PNG 画像や PDF ドキュメントなど) を別途送付することは可能ですが、これは通常の翻訳パイプラインから外れた手動プロセスであるため、適切に記述されたコメントや文字列名の代わりにはなりません。