Difference between revisions of "JA/QA/HowToFix L10NIssue"

Latest revision as of 01:27, 25 May 2010

目的

ここでは OpenOffice.org 日本語版のメッセージとヘルプの問題 （課題がすでに登録されている物) を修正する方法について説明します。問題を発見し課題を報告する際の方法についてはhttp://wiki.services.openoffice.org/wiki/JA/QA/HowToFileIssues をご覧ください。

使用するツール

1. OpenOffice.org IssueTracker
2. Pootle for OpenOffice.org
   
3. ファイルから特定の文字列を検索する OS 依存ツール
   

          このドキュメントでは Unix 系 OS (Linux/MacOS X/Solaris) での文字列検索作業について説明しています。

          注意: Windows 上での文字列検索作業は具体的に説明していません

準備

• IssueTracker を使用するために OpenOffice.org のアカウントを取得する
  

    http://ja.openoffice.org の左上の Register リンクから行います。

• Pootle  を使用するために Pootle  のアカウントを取得する
  

    http://www.sunvirtuallab.com:32300 の登録 リンクから行います。

    アカウントを取得後、翻訳プロジェクトコーディネーター に問い合わせ、修正権限付与の依頼する必要があります。

• Pootle から現在の日本語メッセージとヘルプのデータを以下の手順で取得する
  

       1. Pootle にアクセスし、ログインリンクをクリック

       2. ユーザ名、パスワード (言語は [日本語]) を入力しログインボタンをクリック

       3. 左にある OO.o PO Help リンクをクリック

       4. [日本語][OO.o PO Help] の下の "フォルダの ZIP" リンクをクリック

    これでヘルプデータ (helpcontent2-ja.zip) がダウンロードできます。 

    メッセージデータ (openoffice_org-ja.zip) のダウンロードは、上記手順 3 で OO.o PO UI をクリックすれば同様に行うことが出来ます。  

• 日本語メッセージとヘルプに関する課題の担当者になる
  

    品質保証プロジェクトのメーリングリスト qa@ja.openoffice.org にメールを書いて、以下のことを行ってください。

       1. 品質保証プロジェクトコーディネーターとの間で、課題の修正担当となることの合意を取る

       2. 上の合意が取れたら、品質保証プロジェクトメンバーに、今後登録する日本語翻訳関連の課題の担当者には自分を指定するようお願いする

バグの修正作業

ここでは課題 109078 [JAinconsistent translation about "word count" を例にとって説明します。

これは "word count" が "文字カウント" と ワードカウント" の二通りに訳されているという問題です。

課題で報告されている内容をしっかり理解してください。課題によってはバグの内容がはっきりしない場合もあります。その際は、課題に書き込んで報告者に質問したり、翻訳プロジェクトのメーリングリスト translate@ja.openoffice.org で議論してください。

以下に修正作業の手順を示します。

調査

• これらの訳がメッセージデータとヘルプデータのどこに出てくるかを調べる

        文字列の探し方は unix 系のマシンで仕事をしていると仮定した場合の一例です。

        ここでは /home/ooo/res_ja/UI に openoffice_org-ja.zip を /export/ooo/res_ja/OLH に helpcontent2-ja.zip をそれぞれ展開していることにします。

• メッセージのデータから "文字カウント" という訳がどこにあるかを調べる
  

$ cd /home/ooo/res_ja/UI
$ find . -name "*.po" -exec grep "文字カウント" {} \; -print
msgstr "文字カウント(~W)"
./officecfg/registry/data/org/openoffice/Office/UI.po

• "ワードカウント" という訳の場所を調べる
  

$ find . -name "*.po" -exec grep "ワードカウント" {} \; -print
msgstr "ワードカウント"
./sw/sdi.po
msgstr "ワードカウント"
./sw/source/ui/dialog.po

"ワードカウント" という訳は二カ所にあることが分かります。

• ヘルプデータでも同じように調べる
  

$ cd /home/ooo/res_ja/OLH
$ find . -name "*.po" -exec grep "文字カウント" {} \; -print
msgstr "<variable id=\"wordcount\">メニュー <emph>ツール → 文字カウント
</emph></variable>"
./swriter/00.po
msgstr "文字カウント"
msgstr "<link href=\"text/swriter/01/06040000.xhp\">文字カウント</link>"
./swriter/01.po
msgstr "<emph>ツール → 文字カウント</emph> を選択します。"
./swriter/guide.po
$ find . -name "*.po" -exec grep "ワードカウント" {} \; -print

これでヘルプ上では "文字カウント" と訳されている箇所が四カ所、"ワードカウント" と訳されている箇所は無いということが分かります。

ここでどちらに統一するか決めなければなりませんが、この場合のように明らかな間違いではなく判断が難しい場合は、翻訳プロジェクトのメーリングリストtranslate@ja.openoffice.org に問い合わせてください。ここでは "文字カウント" に統一することにします。

Pootle で文字列を編集

調査の結果 sw/sdi.po と sw/source/ui/dialog.po にある "ワードカウント" と言う文字列を "文字カウント" にすれば良いと言うことが分かりました。ここから実際に Pootle を使って文字列を直していきます。

• Pootle にログインし、ホーム -> 日本語の順にクリックする
  
• sw/sdi.po の編集
  

        - [OO.o PO  UI] -> [sw] -> [sdi.po] の順にクリック

            これはメッセージの文字列なので [OO.o PO UI] に行きます。ヘルプを直す場合は [OO.o PO Help] に行くことになります。

        - 検索ボックスに ワードカウント と入れ検索

            "ワードカウント" という文字列の入ったエントリが編集できる形で出てくるので、これを "文字カウント" に直して [送信] ボタンを押します。

編集文字列を検索する際は、その文字列で探す以外に ID で検索する方法もあります。
(こうすると必ず希望するエントリが最初に表示されます)

ID は PO ファイルの該当エントリのコメント (# で始まる行) に書いてある文字列です。
sdi.po の "ワードカウント" の場合 "swslots.src#FN_WORDCOUNT_DIALOG.sfxslotinfo.text" になります。
ID で検索するには検索ボックスの▼をクリックして[位置]にチェックを付けてから、検索を行ってください。

• sw/source/ui/dialog.po の編集

       - [OO.o PO UI] -> [sw] -> [source] -> [ui] -> [dialog.po] の順にクリック

        あとは sdi.po と同様の作業をします。

これでバグは修正されました。修正は次に Pootle から翻訳リソースを持ってきてビルドされる OpenOffice.org に反映されます。

が、作業はこれで終わりではありません。

IssueTracker のステータスを更新

実際にバグを修正したら課題のステータスを IssueTracker で更新しなければなりません。

手順は次のようになります。

• OpenOffice.org の IssueTracker に行く
• 課題番号に 109078 を入力して [検索] ボタンをクリックし [JA] inconsistent translation about "word count" に行く
• 追加コメントを記入する

    例えば

Fixed in Pootle.
"ワードカウント" -> "文字カウント" in sw/sdi.po and sw/source/ui/dialog.po

• 課題の解決、変更:解決方法 変更先 : [修正済み] というラジオボタンをクリック
• [実行] ボタンをクリック

これで課題は修正済みになりました。

以上でバグフィックスの作業は終了です。

その後の開発版 OpenOffice.org で問題が修正されていることが確認できたら、この課題に戻って "課題を検証済みにマークする" というラジオボタンをクリックして[実行]ボタンをクリックしてください。さらに正式リリースバイナリで確認したら "課題を処理済みにマークする" をチェックして[実行] ボタンをクリックしてください。これでこの課題が完全に処理されたことになります。