manual/kmod/README.po4a

   1 このディレクトリ以下には、2 種類の po ファイル群が入っています。
   2 マニュアルを改訂するときは、どちらでもお好きな方をご利用ください。
   3 どちらも、それなりのやり方で、利用できるはずです。
   4
   5 ご存知でしょうが、po4a では、複数の manpage を一つにまとめた po ファイルを
   6 作ることもできますし、1 manpage 1 po ファイルにすることもできます。
   7
   8 po4a ディレクトリ以下には、man5 と man8 の manpage をそれぞれ一つに
   9 まとめた po ファイルと、po4a コマンドの設定ファイルが入っています。
  10 po4a/man5/ja.po と同ディレクトリの kmod-man5.cfg、及び
  11 po4a/man8/ja.po と同ディレクトリの kmod-man8.cfg が、それです。
  12 翻訳にこうした ja.po ファイルを使う場合は、翻訳 manpage の作成に
  13 kmod ディレクトリ直下にある Makefile が使用できます (make を使用したく
  14 ない場合は、kmod ディレクトリから直接 "po4a po4a/man8/kmod-man8.cfg"
  15 などを実行しても構いません。この場合、draft/man8 以下に manpage が
  16 作成されます)。
  17
  18 po4a-each ディレクトリ以下に入っているのは、1 manpage 1 po ファイル形式の
  19 po フィルです。こちらは Makefile を利用できません。すべて po4a-translate
  20 コマンドを使って、手作業で一つ一つ po　ファイルを日本語 manpage に変換
  21 することになります。なお、kmod パッケージでは、どの manpage の場合でも
  22 コマンドに "-o groff_code=verbatim" オプションを付ける必要があります。
  23 たとえば、こんな具合です。
  24
  25   $ po4a-translate -f man -m original/man8/modprobe.8 \
  26   -p po4a-each/man8/modprobe.8.po -l draft/man8/modprobe.8 \
  27   -a po4a-each/add_ja/copyright/modprobe.8.txt -o groff_code=verbatim \
  28   -k 0 -v
  29
  30 どちらのやり方にも一長一短があります。たとえば、複数 manpage をまとめた
  31 po ファイルを使えば、make 一発で po から複数の manpage を作成することができ、
  32 上記のような長々しいコマンドを打ち込む必要も、憶える必要もありません。
  33 また、改訂時には、新しい原文を用意して make (あるいは、po4a コマンド)
  34 を実行するだけで、既訳部分を取り込んだ、翻訳の土台になる新しい po
  35 ファイルが作れます。
  36
  37 一方、1 manpage 1 po ファイル方式の最大の長所は、たくさんの manpage
  38 を一つにした長大な po ファイルを相手にしなくても済むことでしょう。
  39 やりたくないものや、よくわからないものに、手を出さないでも済みます。
  40 また、自分が今何を訳しているのか、はっきりしていますし、(上の例の
  41 ように、"-k 0" オプションを付けて po4a-translate を実行すれば)
  42 訳しながら、いつでも好きなときに整形後の結果を簡単に確かめることが
  43 できます (もう一方のやり方でも、できないわけではありません)。
  44
  45 翻訳の対象を選ぶときや、訳している間は、1 manpage 1 po ファイルの
  46 方が楽であり、原稿の提出時やマニュアルの改訂時には、複数ページを
  47 一つにまとめるやり方の方が楽だ、と言えるでしょう。言い換えれば、
  48 翻訳という作業そのものについては、1 manpage 1 po ファイルに利があり、
  49 翻訳製品の操作や管理では、すべての manpage を一つにする方法の方が
  50 優っているということでしょうか。
  51
  52 そんなわけで、両方の po ファイルを置いておきます。manpage の改訂をなさる
  53 ときは、お好きな方、使いやすい方を利用してください。要らない方は、消して
  54 しまっても構いません。自分が使わない方の po ファイルまで更新するのは面倒
  55 でしょうから。
  56
  57 なお、実を言うと、私はやりませんでしたが、すべての manpage を一つに
  58 まとめるのではなく、1 manpage 1 po ファイルになるように、po4a の設定
  59 ファイルを書くこともできます。この方法を使えば、変換時に po4a-translate
  60 を、改訂時に po4a-updatepo を使うのではなく、どちらの場合も、
  61 "po4a 設定ファイル" コマンドを実行するだけで済ますことが出来ます。
  62
  63 --
  64 長南洋一 (version 29 の改訂者)
  65