guide/translation_update.rst

   1 ============
   2 翻訳更新方法
   3 ============
   4
   5 JM リポジトリの構成は :doc:`git_repository` に書かれている通りです。
   6
   7 JM の翻訳の管理方法は
   8
   9 * roff を直接翻訳
  10 * po4a を使って翻訳
  11
  12 の2つの方法が混在しています。
  13
  14 po4a を使用している場合には、各パッケージのディレクトリに po4a というフォルダが存在します。
  15 存在しない場合は、roff を直接編集して翻訳しています。
  16
  17 roff を直接翻訳
  18 ===============
  19
  20 release 版を編集する場合は、必ず draft を編集してから、 release に反映して下さい。
  21 draft 側には、原文がコメントとして入っていますが、release には翻訳済みの文章のみが含まれます。
  22
  23 .. note::
  24
  25    以下の説明は、各パッケージのディレクトリ (manual/fetchmail など) で作業することを前提に説明します。
  26
  27 #. draft を更新します
  28 #. draft の更新が終わったら、release に反映します。
  29    対象ファイルを draft 以下から release 以下にコピーするだけですが、 JM-release.sh コマンドを利用するのが楽です。
  30
  31    .. code-block:: none
  32
  33       $ ../../admin/JM-release.sh -f -g draft/man1/fetchmail.1 release
  34       draft/man1/fetchmail.1 -> release/man1/fetchmail.1
  35
  36 #. Git でコミットして、sourceforge.jp に push します。
  37
  38 draft 以下の全ファイルを release に反映する場合は、JM-release-all.sh コマンドを実行します。
  39 draft の全ファイルがリリース済みの場合に release への反映もれがないかを確認する際などに使います。
  40
  41 .. code-block:: none
  42
  43    $ cd manual/fetchmail
  44    $ ../../admin/JM-release-all.sh
  45    (git status や git diff で変更内容を確認)
  46    (git commit -> git push)
  47
  48 po4a を使って翻訳
  49 =================
  50
  51 **LDP\_man-pages と GNU\_coreutils は管理方法が少し複雑です。詳細は下の方にありますので参照して下さい。**
  52
  53 翻訳は po4a ディレクトリ以下の ja.po ファイルで管理しています。
  54 ja.po ファイルは po4a/ja.po の場合と、po4a/<dir>/ja.po にある場合があります。
  55
  56 #. man ページに対応する ja.po がどれかは ``po4a/**/*.cfg`` を見て判断します。
  57    更新したいファイルが分かっている場合は以下のように grep して下さい。
  58
  59    .. code-block:: none
  60
  61       $ grep iptables-save.8 po4a/**/*.cfg
  62
  63 #. ja.po を編集します。編集にあたっては Emacs の po-mode, poedit などが利用できます。
  64 #. make または make translate で ja.po の内容を draft 以下に反映します。
  65 #. (参考 make stat で ja.po の翻訳状況を表示できます)
  66 #. release に反映する必要がある場合は、「roff を直接翻訳」の場合と同様に JM-release.sh を使用して、release フォルダ以下に反映して下さい。
  67 #. git commit で更新を登録して、git push で sf.jp に送信して下さい
  68
  69 po4a 移行後の課題
  70 -----------------
  71
  72 * レビューをどのようにして行うか?
  73 * ja.po を投稿してもレビューできない。 できあがった draft でレビューする必要がある。
  74 * translation-list の更新が手動になっている
  75 * 複数のファイルが一つの ja.po の変更で更新されることがあり、管理が面倒
  76
  77 LDP man-pages
  78 =============
  79
  80 :doc:`LDP_man-pages` を参照。
  81
  82 GNU_coreutils
  83 =============
  84
  85 :doc:`GNU_coreutils` を参照。
  86
  87 ``help2man`` の出力と、追加ファイル ``*.x`` の翻訳を合わせて、
  88 日本語マニュアルを生成しています。
  89 そのため、管理が他のものと異なっています。