Mozilla 地域化プロジェクト FAQ |
|
Mozilla 地域化プロジェクトスタッフ |
MLP [地域化プロジェクトホーム] | [地域化資料] | [よくある質問（FAQ）]
はじめに |
この文書では他の MLP（Mozilla 地域化プロジェクト）ページにふ含まれていないすべての情報を、質問と回答の形で説明しています。
理想的にはこれらは地域化作業者がもっともよく遭遇する問題で、地域化ニュースグループでも新人からの質問が幾度となくポストされてきました。 ここに並んだ回答で説明しておくことで、作業者たちの苦痛と時間を軽減するでしょう。
この文書の内容について意見・批判などありましたら、他の MLP 関連ページと同様に mozilla.org 地域化ニュースグループなどを通じて私たちにお知らせください。
目次 |
地域化
| L.01 | dtd / properties ファイルの一部のコメントに、コマンド キーとインターフェースのいくつかの項目は翻訳すべきではないと書かれていますが、それらを変更するとどのような不具合が起きるのですか？ |
| L.02 | 地域化文字列のどの部分が、プログラムを正しく動かすために手を付けずに残しておく必要がありますか？ |
トラブルシューティング
ツール
| O.01 | Mozilla Translator 5.x: Chrome View ウィンドウを開いた時、ファイルのリストが左側に見えますが、読み込まれた / 翻訳された文字列がどこにも見あたりません。表示させるためにはどうすればいいですか？ |
| O.02 | JAR や XPI パッケージへの出力でエラーが返ります。どうやってこの状況から抜け出せばよいのでしょうか？ |
一般的な問題
| G.01 | ユーザ・インタフェースで使われる .XUL, .JS, .CSS, .DTD, .properties, .RDF, .CSS, .XBL 等のファイルはどこにありますか？ |
| G.02 | .JAR ファイルとはどういうもので、またそれを編集するにはどうすればいいですか？ |
地域化 |
L.01: dtd / properties ファイルの一部のコメントに、コマンド キーとインターフェースのいくつかの項目は翻訳すべきではないと書かれていますが、それらを変更するとどのような不具合が起きるのですか？
自分の文化（とユーザ！）にとって意味をなすものは何であれ変更するのは自由です。内部での使い方のために気づくためにプログラムが見つける必要があるものを認識することができる限り。
すべての単語を翻訳することは、平均的なユーザによってよいサービスにならないこともありますが、
英語のすべてのコンピュータ関連用語をそのままにすることも初心者の助けにならないでしょう。
バランス感覚が重要です。
So the question become..
L.02: 地域化文字列のどの部分が、プログラムを正しく動かすために手を付けずに残しておく必要がありますか？
開発者が dtd ファイルと properties ファイルに残したコメントを残さず読むことを学んでください。
この FAQ では触れられないことについての記述もあるかも知れません。
FAQ に載せようと試みてもおおざっぱな分類になるでしょう。
どの言語でも異なった文脈配列をしているため、実行時の情報によって補完されなくてはならない文字列は代替記号を含んでいます。
地域化作業者は、実行時にプログラムがそれを見つけて適切な情報に置き換えできる限り、文字列の中のどの場所にでも代替記号を置くことができます。
明確に求められることとして、地域化文字列の中で、代替記号は、元の文字列の中で現れるのと正確に同じ記述となる必要があります。
これら代替記号の表現に共通して用いられるものとしては:
&エンティティ名;（「エンティティ名」の名称を持つ XML エンティティで、ときどき他のエンティティの中で呼ばれるものです）、%S, $1%S, %lu ..（C スタイルの代替記号です）。
いつでも地域化コメントに目を配って、地域化作業者にとって陥りやすい失敗にパラメータによって陥らないでください。
これらの特別な文字列は見た目と機能性を変更するためのユーザ・インタフェースの値を含んでいます。
プログラムがいくつかの機能性を失うことを望まなければ、テキストを翻訳するかわりに、もちろん適切な値を入れることが必要でしょう（数値、true、false）。
トラブルシューティング |
T.01: なぜ地域化されたダイアログの中（例：Preferences）にウィンドウの中でテキストがぴったりあうようにリサイズされないものがあるのですか？
多くのダイアログウィンドウは地域化可能文字列から高さと幅を持っています。
ダイアログが地域化されたテキストを格納できる範囲に、それらの文字列の字数を変更する必要があります。
注意：小さなモニタを使っている人や、視覚面が弱い人が使う場合も考えて、サイズはいつでも低解像度ディスプレイ（せめて640x480 ピクセル）に収まるべきです。
しばしばこれらの文字数は em、px といった単位に従います。
前者は一文字の幅を意味し、後者はディスプレイのピクセル単位です。
T.02: 私の .XPI 言語パックをインストールした後、インストールウィンドウは謎の数字が表示されます。何が起こったのですか？
XPI インストールエラーコードは、
ヘッダファイル nsInstall.h で定義されています。
T.03: 作成した .XPI 言語パックのインストール中の動作を把握する方法がありますか？
Mozilla は install.log ログファイルの中にそれぞれの XPI インストールについてログを取っています。
Mozilla バイナリフォルダかユーザ・プロファイルフォルダのいずれかで見つけることができるでしょう
（あなたの使っている Mozilla のバージョンで、それぞれの OS でのデフォルトのフォルダ位置を知るためにはリリースノートを参照してください）。
このファイルには、具体的には新しくインストールされたコンポーネントのリストやインストール中の動作、インストール・スクリプト中の logComment() 呼び出しによって追記された様々な情報が含まれています。
T.04: ある特定のウィンドウを開くと、黄色地に赤文字で XML パーサのエラーについてメッセージが表示されます。どうすれば直せますか？
この問題のありがちな可能性として、「XML パーサが探している実体定義を提供していない」、「不正な文字のためXML パーサが解析に失敗した」などが考えられます。
悪者の DTD ファイルの解析をし始めると、XML パーサはたいていエラーが起こった XML（もしくは XUL） ファイルとそのファイルの中（行と列）の位置のシグナルを出します。
その XUL ファイル（chrome/ フォルダの中の圧縮された .jar の中を探してください）を開くと、どの DTD ファイルが読み込まれたのか見ることができます。
ときどき、XML パーサはエンティティ名も示します。そうすることで、地域化ファイルすべてからそれを探すことによって問題のある文字列をすばやく追跡することができます。
関連する名称からエンティティを探すことができなければ、問題はたぶん地域化ファイルにそのような文字列を入れていないことにあるでしょう。
新しいリリースで導入された新しい文字列をすべて取り込む必要があります。
また、XML 文字列としてすべての文字が許されるわけではないことも覚えておいてください。
T.05: dtd / properties ファイルを編集しましたが、インストールしてみると、Latin 文字 （A-Z, a-z) が壊れてしまうようです。何が問題なのでしょうか？
多分、それらを通常のテキストエディタで修正するなどして、DTD や properties ファイルに正しいエンコーディングを使っていなかったのでしょう。
.DTD ファイルは UTF-8 で、 .properties ファイルは Escaped Unicode（エスケープされた Unicode）で提供しなくてはなりません。
ツール |
O.01: Mozilla Translator 5.x:
Chrome View ウィンドウを開いた時、ファイルのリストが左側に見えますが、読み込まれた / 翻訳された文字列がどこにも見あたりません。表示させるためにはどうすればいいですか？
Mozilla Translator では通常の操作をするのに、アプリケーションが開始されたフォルダの中にある cache/ フォルダが存在しなくてはなりません。
そのため、次のチェックをすべきでしょう。そのフォルダが存在すればOK、存在しなければ"cache"という名前のフォルダを作ってください。その後、Mozilla Translator を再起動してください。cache/ を含んだフォルダから Mozilla Translator を起動すると、同じフォルダから Glossary.zip ファイルが読み込まれたか／保存されたかをチェックするのが簡単です。実行ユーザ —と、それに従って Mozilla Translator アプリケーション— に、この cache/ フォルダに対する読みとりと書き込みの十分な権限を与えてください（例：その中のファイルの削除を試してください）。
O.02: Mozilla Translator 5.x:
JAR や XPI パッケージへの出力でエラーが返ります。どうやってこの状況から抜け出せばよいのでしょうか？
Mozilla Translator が実行されている場所の cache/ フォルダの中のすべてのファイルを削除してみて下さい。
稼働しているシステムのデフォルトの一時ファイルの場所（例：Microsoft Windows では %WINDIR%\Temp フォルダ）の *.tmp を削除してみてください。それから、Mozilla Translator を再度起動して試してください。
一般的な問題 |
G.01: ユーザ・インタフェースで使われる .XUL, .JS, .CSS, .DTD, .properties, .RDF, .CSS, .XBL 等のファイルはどこにありますか？
G.02: .JAR ファイルとはどういうもので、またそれを編集するにはどうすればいいですか？
JAR ファイルは登録されたユーザ・インタフェースのリソースファイルが含まれている圧縮集約ファイルです。
それらはアプリケーション実行ファイルが含まれるフォルダの中の chrome/ という名前のフォルダに集められています。
マルチユーザ環境では JAR はユーザプロファイルディレクトリの中の chrome/ フォルダの中にインストールされます（それぞれの OS におけるデフォルトのフォルダの位置はリリースノートの該当する Mozilla のバージョンのページを参照してください）。
一般的な PKzip 互換ツールで、その中身を見たり解凍したりできます。