WWWコンテンツの管理

• moguにある/cvs/jprootのgitへの変換について：従来CVSで管理していたWWWコンテンツはgitで管理するよう移行する。
• github:NetBSDjp/htdocs
• 日本独自コンテンツとwww.NetBSD.orgの日本語訳は CVS(CVSの使い方)で管理する。
• モジュールは htdocs。
• 以下の環境変数を設定することにより、ローカルマシン上で作業をすることができる。

        % setenv CVS_RSH ssh
        % setenv CVSROOT :ext:your_login_name@mogu.jp.netbsd.org:/cvsroot
      

• 更新時には www-changes-ja@jp.netbsd.org に更新情報が流れる。

WWWコンテンツの配置

• http://www.NetBSD.org/の ミラーはhttp://www.jp.NetBSD.org/ 以下で参照できる。但しhttp://www.jp.NetBSD.org/ は、 http://www.jp.NetBSD.org/ja/JP/index.html にリダイレクトされる。
• 日本語訳は、オリジナルと同じ構成で htdocs/ja/ 以下に作成する。
  http://www.jp.NetBSD.org/ja/ 以下で参照できる
• 日本語の独自コンテンツは htdocs/JP/ 以下に作成する。
  http://www.jp.NetBSD.org/ja/JP/ 以下で参照できる

www.NetBSD.org 日本語訳

• 翻訳する前に htdocs/JP/staff/translation-assign.txt の 翻訳するファイルの担当者欄に名前を記入すること。 このとき、査読者の欄は空欄とする。 またwww-changes-jaでの翻訳担当宣言もこのファイルに反映させる。 誰が行っても良い。 web page と完全に同期をとっているわけではないので、翻訳するファイルが このファイルに記述されていないこともある。この場合、適当に追加、ソート する。

• 翻訳が終了したら、もしくはwww-changes-jaに訳文がmailされたら、 translation-assign.txt の査読者 の欄を、空欄から 「NOT-YET」 に変更する。

  訳文はCVS手続きに従いcommitする。

査読

• 査読が終了したら、もしくはwww-changes-jaに査読結果がmailされたら、 査読結果を commit する。その際 translation-assign.txt の査読者の欄に、カンマで区切って名前を 記入すること。

オリジナル更新時

• 新規翻訳時と同様に行います。
• 更新分の査読が必要ないと判断した場合は、 translation-assign.txtは変更する必要はありません。
• > pigu(web サーバー) の /htdocs/www.jp.netbsd.org/ja ディレクトリにはあるが /htdocs/www.netbsd.org/htdocs ディレクトリにないような場合、 翻訳状況 の最後の「移動/削除/list2htmlで生成されている原文」 に入ります。

www.NetBSD.org 日本語訳 CVS手続き

• sakamoto@jp.netbsd.org

新規およびオリジナル更新時には以下の手続きで、 オリジナルのimportと訳文のcommitを行う。

1. 念のため、mogu 上でリポジトリを一時的にバックアップする
   tar zcf ~/ja-bak.tar.gz -C /cvsroot htdocs/ja
2. 翻訳したいオリジナルファイルだけをカレントディレクトリに置く
3. CVSROOT,CVS_RSHなどを設定後、
   cvs import -I \! -ko DIR VENDOR RELEASE
   で登録

   DIR	オリジナルのディレクトリパスの頭に ja/を付ける (http://www.netbsd.org/hoge/piyo.htmlの場合は htdocs/ja/hoge になります)。
   VENDOR	TNF を指定(The NetBSD Foundation)。
   RELEASE	date-1999-01-10 というようにimportする日を指定します (1999/07/01にimportする場合は date-1999-07-01)。

   
   例: cvs import -I \! -ko htdocs/ja/hoge TNF date-1999-01-10

4. checkout後、オリジナルファイルの上に和訳を上書きしcommit。
5. ファイルの追加があった場合には、layout.xmlにも追加する。
6. make 変更したファイル.html等
   を実行し、生成されたhtmlファイルをaddする。

listファイルをcommitした後は、working dirでmakeしてhtmlファイルを生成し、 commitすること。htmlファイルのimportは必要ない。 またMakefileがない場合はオリジナルからimportすること。

未解決の問題

• 翻訳の際にJNUG(Japan NetBSD Users' Group)の copyright notice を足すべきか?
• 査読完了の判断。および、完了時の作業。
• URL の修正
  www-changes-ja に流れた Message-Id: < 20000225192910O.kawamoto@es.osaka-u.ac.jp> の urlcheck.pl を使い翻訳した HTML ファイルの URL が正しいかどうかをチェック し、urlconv.plで書きかえる(urlcheck.pl を使用するには、XXXが 必要)。このスクリプトを使用するのは、www.jp.netbsd.org では mod_rewrite が使えるが、www.netbsd.org では使用できないからで ある。mogu で urlcheck.pl を定期的に実行して www-changes-ja にメイルする予定だが当面は任意のタイミングで誰かがチェックを おこなう。(注意: pkgsrc あるいは最新の HTML-Parser パッケージ では urlcheck.pl は動作しない)