Re: [debian-www:Bug] wrong japanese at www.debian.org

[Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>]

遠藤です。

Keita Maehara <maehara@debian.or.jp> writes:

> # HOWTO_translate も重要ですが、新規日本語版翻訳者向けの簡易 HOWTO (コマ
> # ンドラインを示すだけなら数行で済むはず)があった方がよさそう。

ということで、ちょっとまとめてみました。

# 簡潔にと思ったのですが、なんだか数十行になってしまいました。


Debian ウェブページ 日本語翻訳プロジェクト
翻訳作業簡易マニュアル

I. 翻訳するには

a. 準備

 1. cvs パッケージをインストール

 2. 適当な作業ディレクトリを用意する。
   mkdir ~/debian-www/

 3. そのディレクトリにソースをダウンロードする
   cd ~/debian-www/
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml login
   (パスワードを聞かれるが、単にリターンキーを押す)
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout webwml/english
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout webwml/japanese

   ~/debian-www/webwml/english/ 以下にオリジナルの英語ソースが
   ~/debian-www/webwml/japanese/ 以下に現時点で翻訳済の日本語ソースが
   ダウンロードされます

   ここまでの作業は次回から不要です。作業ディレクトリで cvs update を実
   行するだけで、ソースが最新の状態になります。

b. 実際の翻訳作業

 1. http://master.debian.or.jp/~kamop/www-ja.html で翻訳作業の状況を確認。

 2. どのページを翻訳するか決めたら、debian-www ML で翻訳する旨を流す。

 3. ソースを最新の状態にする。
    cd ~/debian-www/
    cvs update

 4. 英語オリジナルを、日本語の同じディレクトリにコピー
    (例えば intro/cooperation.wml を翻訳するなら、)
    cd ~/debian-www/webwml/
    cp ./english/intro/cooperation.wml  ./japanese/intro/
    (~/debian-www/webwml/japanese/ 以下に対応するディレクトリがない場合は作
    る。)

 5. 翻訳する。
   ・一行目に #!wml -o ../../../debian.org/devel/%BASE.html.en があれば削除
   ・文字コードは iso-2022-jp で。
     (Emacs20 なら M-x set-buffer-file-coding-system で iso-2022-jp-unix
      を選択)
   ・リンクやタグは変更しないように注意。
     (何らかの変更を加えるときは本家への連絡が必要)
   ・訳語一覧は、以下を参照
     http://www.globe.to/~moka/debian/debian_trans_table/trans_table.html
     (岡 充<95i44@xxxxxxxxxxxxxxxx>さんがメンテナンスされています。)

 6. メーリングリストに投稿
    (でもできたら、下の説明を読んでプレビューしてから投稿しましょう。)


II. プレビューするには(wml ソースをコンパイルし html ソースを生成する)

a. 準備

 1. 以下のパッケージをインストール
    wml libgd-perl kcc

 2. html ファイルが生成される ~/debian/debian.org/ ディレクトリを作成
    mkdir ~/debian-www/debian.org/

 3. さらにサブディレクトリを作成
    cd ~/debian-www/webwml/english/
    find ./ -type d -not -name CVS -exec mkdir "../../debian.org/{}" \; -print

    ここまでの作業はオリジナルのディレクトリに変更がない限り次回から不要で
    す。

b. html ファイルを生成する。

 1. ~/debian-www/webwml/japanese ディレクトリで make する。 
    cd ~/debian-www/webwml/japanese
    make

    (新たに自分でディレクトリを作成したときは japanese/Makefile を修正する。)
    ~/debian-www/debian.org/ 以下に、html ファイルが生成されます。

 2. ブラウザで見る。


CVS をちゃんと理解していないために用語の問題などもあるかと思います。
また、その他の間違い、欠けている情報などのご指摘よろしくお願いします。

-- 
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>