注意: 原文はこの翻訳よりも新しくなっています。

L10n Debconf テンプレートと PO ファイル — 翻訳者への助言

[ 地域化 ] [ 言語一覧 ] [ ランキング ] [ POT ファイル ] [ エラー ] [ 翻訳者への助言 ]

翻訳者のための一般的な注意

  1. 翻訳を始める前に、(もし存在するなら) debian-l10n-<language>@lists.debian.org にいる他の翻訳者たちに、同じ作業を行っている人がいないかどうか確認してください。 またあなたが翻訳しようとしているパッケージの現在のバグ報告を読んで、 翻訳が既に報告されていないことを確認してください。
  2. 更新作業の場合は、作業の重複を避けるため、 前の翻訳者に連絡を取ってください。メールアドレスは PO ファイル に書いてあります。
  3. 翻訳作業の開始にあたっては、まず templates.pot ファイルを xx.po にコピーしてください。ここで xx はあなたの言語の ISO コード です。そして先頭の msgstr に翻訳文字列に使われる文字セットを 指定し、他にも有用な情報があれば書き加えてください。
  4. PO ファイルの編集には、一般的なテキストエディタならなんでも 使えます。また gtranslator や kbabel のように、PO ファイルに特化したツールもあります。 PO ファイルにあまり慣れていない場合にはこれらも役に立つでしょう。 Gettext ドキュメンテーション には PO ファイルの書式についての説明があります。少なくとも ヘッダエントリの埋め方 と PO ファイルの書式 の章は読んでおきましょう。
  5. 翻訳が終わったら、最低一回はファイルを読み直し、誤訳・綴り間違い・ 文法ミス・打ち間違いなどの失敗をすべて修正しましょう。 (PO エディタを使っている場合は、おそらくスペルチェッカや acheck のような 翻訳補助機能があるでしょう)。 次に 
                msgfmt -c -v -o /dev/null あなたの言語コード.po
    を実行し、ファイルが正しく、問題なく組込めるかを確認しましょう。 あなたの言語チームのポリシーによっては、 専用の l10n メーリングリストに翻訳を送り、 査読してもらうのも良いでしょう。
  6. もし翻訳が正しく完成できたら、 翻訳したパッケージに対して バグ報告 を、深刻度 wishlist で提出しましょう。バグ報告には l10n と patch マーク をタグ付けして、 後から検索する人のために [INTL:xx] (ここで xx はあなたの言語の ISO コード です) を件名にします。そして翻訳を含めてくれる ようメンテナに丁重に依頼し、このファイルの処理方法について 指示しましょう (例えば debian/po/cs.po に添付ファイルをコピーしてください)。 翻訳を添付するのを忘れないように。このステップは reportbug ユーティリティを使うと簡単に実行できます。

po-debconf 特有の注意

  1. フィールド名は msgid の前のコメントとして表示されます。 値 Default は debconf に対して特殊な意味を持ちます。なぜなら テンプレートのタイプが Select や Multiselect であったときに、それらは翻訳されては いけません が、 それらの値は (稀な環境では) 英語の Choices フィールドの 別の文字列に変更されることがあるからです。この理由から、 開発者は混乱を避けるために Default の代わりに DefaultChoice を使うべきです。 これは po-debconf 拡張です。 生成されたテンプレートファイルでは、Default は 当然表示されます。なぜなら debconf はこの DefaultChoice フィールドを定義していないからです。
  2. 翻訳者への指示が開発者により挿入されているかもしれないので、 使用しているツールはこれらのコメントを (誤りなく) 表示 できなければなりません。例えば geneweb パッケージの言語選択の扱い方の指示を見てください。
  3. ときどき msgstr が異なる値なのに msgid が同じなことが あります。 msgid を一意的にするために、ある特殊なテキストを文字列の終わりに 挿入できます。より正確には、文字列の終わりの
    • 左鉤括弧: [
    • 空白
    • 0 個以上の左鉤括弧以外の文字と、右鉤括弧と改行
    • 右鉤括弧: ]
    の連続は msgid 文字列から取り除かれます。 これは msgstr でも同様なので、 翻訳者は空の文字列を挿入できます。
  4. 行は debconf により折り返されますが、空白から始まるときは例外です。 そのような行はリストの整形に使われますが、それぞれの フロントエンドに独自の制限があります。全てのフロントエンドで 満足に表示されるためには、そのような行は 72 文字を超えては ならないようです。
  5. podebconf-display-po スクリプト (po-debconf >= 0.8.3 から) は、設定時に debconf に表示されるような形で、あなたの翻訳を表示できます。 翻訳がどのように見えるかについてざっと知りたい場合には 
                podebconf-display-po -fdialog debian/po/あなたの言語コード.po
    を実行してください。しかし、これは基本的な設定ファイルでしか 動作せず、複雑な操作 (たとえば大量のテキスト置換のような) が実行されると、表示は変化するかもしれません。利用可能な debconf のフロントエンド (これは -f フラグで選択できます) は debconf(7) に列挙されています。

このページは 2024 年 12 月 9 日に収集した情報に基づき作成されました。 これらのファイルについて作業するときは、最新のものであることを確認してください!