GentooJP開発者用ドキュメント|
このドキュメントはGentooJPの開発者用です。
ただし、将来の開発者のために情報はすべて公開しています。
|
1.
GentooJP開発者とは
GentooJP開発者とは
GentooJPのプロジェクト運営を円滑に進めるための有志のことです。
GentooJPでは、ソフトウェアの開発だけでなく、ドキュメント作成者や、サーバーの管理者など、GentooJPの運営をサポートしてくれる人すべてをGentooJP開発者と呼んでいます。
GentooJP開発者になるための条件
特に条件はありません。
責任感を持って常識的な行動を取れる人なら、どなたでも大歓迎です。
2.www.gentoo.gr.jp サイトの更新方法
更新について
AuthorがGentooJPとなっているものの更新は自由に行なってください。
また編集を加えた場合にはeditorとして自分の名前を追加してください。
ただしtypoの修正などわざわざ追加するほどでもないと判断した場合はその限りではありません。
そして周知という意味で-adminや-miscまたは-docsメーリングリストなど、
関係するところへ報告を行なってください。事後報告で構いません。
更新の内容が不安な場合には事前にメーリングリストで話し合ってください。
更新の基本的な仕組み
現在www.gentoo.gr.jp上のコンテンツは、
GentooJPのCVSにて管理を行なっています。
そしてそのCVSからwww.gentoo.gr.jpへ10分間隔で定期的にコピーを行なっています。
コンテンツの取得手順
CVS上には、いくつかレポジトリがありますが現在はwwwしか使用していません。
wwwレポジトリが、そのままhttps://www.gentoo.gr.jp/になります。
|
Code listing 2.1: checkoutの例(GentooJP開発者の場合) |
$ cvs -d [email protected]:/var/cvsroot co www
|
CVSの詳しい使い方については他のドキュメントや資料を参照してください。
Note: 参照だけの場合にはViewCVSを使用したwebインターフェースもありますので、目的に応じて使用してください。 |
Warning:
現在、anonymous CVSは停止中です。GentooJP開発者でない方は、
上記ViewCVSを使用してください。
|
コンテンツの更新手順
ドキュメントを更新した場合には、commitをする前に必ずxmllintでXMLの文法チェックを行なってください。
文法が間違っているとWeb上で"Internal Error"になってしまい、たくさんの人に迷惑をかけることになってしまいます。
|
Code listing 2.2: XMLの文法チェック |
$ xmllint --noout developer.html
$
(何も出力されなければ問題ありません。
エラーがある場合にはエラーメッセージが表示されます。)
|
これで準備完了です。commitしてください。
commit後、最大10分で更新されますので、必ず変更箇所を確認してください。
ニュースの追加方法
ニュースとはwww.gentoo.gr.jpでアクセスしたときに出てくるGentooやGentooJPに関するお知らせのことです。
GentooJP開発者は誰でも自由にニュースを追加することができます。
内容についてはGentooに関係することなら何でもOKです。
一般の人向けであるGentooJPニュース掲載手順も参照しておいてください。
ニュースは/jpnewsディレクトリ以下にカテゴリ別に格納されています。
また、１ニュースが１ファイルになっています。
ファイル名は、yyyymmdd-name.htmlという形にしてください。
yyyymmddは西暦の年月日です。nameの部分は任意の名前を付けます。
サンプルとして一つあげます。
|
Code listing 2.3: ニュースファイルのサンプル |
<?xml version='1.0' encoding='UTF-8'?>
<?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
<news gentoo="yes" category="gentoojp">
<poster>中野正智</poster>
<date>15 November 2003</date>
<title>翻訳者募集</title>
<body>
<p>
GentooJP翻訳プロジェクトでは下記の文章を翻訳してくれる人を捜しています。
興味のある人は、<uri link="/jpmain/translation.html">
翻訳プロジェクトのドキュメント</uri>を参照の上、
<uri link="/jpmain/about-gentoojp.html#doc_chap4">
ドキュメントメーリングリスト</uri>に参加してください。
<pre caption="募集中の新規翻訳ドキュメント">
-- 省略 --
</pre>
</p>
</body>
</news>
|
1,2行目は固定です。必ずこれを入れてください。
3行目のcategoryはいくつかあるのでニュースにあったものを選択します。
これによってニュース本文の横の画像が変わります。
いろいろあるのですが、ほとんどGentooプロジェクトのニュースの翻訳で使用しているものです。
GentooJP発のニュースとして新規にニュースを作成する場合は以下のどれかを使用します。
| 指定する文字 |
意味 |
画像 |
| gentoojp |
GentooJP関連のニュースです。 |
 |
| gentoo |
Gentooの一般的なニュースです。 |
 |
| moo |
これもGentooの一般的なニュースです。気分によって使いわけましょう。 |
 |
ニュースが書けたら、次はindexファイルを更新します。
indexファイルは/jpnews/{main|gwn|org}/news-index.htmlです。
このファイルは日付で降順になっていますので、
作成したファイルを一番上へ記述してください。
このファイルを追加することで実際にニュースが掲載されることになります。
|
Code listing 2.4: indexファイル |
<?xml version="1.0" encoding="UTF-8"?>
<uris>
<uri>/jpnews/main/20031029-bsdlinuxday.html</uri>
<uri>/jpnews/main/20031017-seminar.html</uri>
<uri>/jpnews/main/20030804-webpage.html</uri>
(省略)
|
3.
新規開発者の登録手順
新規登録について
誘った人、または立候補の場合にはそれを受けた人、
が新規開発者の登録の各種手続きを手伝うようにしてください。
そして以下の登録をすべて確実に完了できるように、
GentooJPの各担当者と新規登録者の間に入って調整してください。
admin MLへ報告
フリーフォーマットで構わないですが以下の情報を報告してください。
この情報を元に各担当者が、
を行ないます。
開発者用サーバー(現在dev.gentoo.gr.jp)へのCVS/shellアカウントの作成
新規登録者がサーバー管理担当者に公開鍵をメールで送信するようにしてください。
これが完了したら、CVSの設定の確認を兼ねて以下の登録を各自(新規登録者)でお願いします。CVSの使い方とドキュメント修正方法についてはこのドキュメントにありますので、参照してください。
内部メーリングリスト(-admin)について
GentooJP開発者には非公開の-adminメーリングリストに入ってもらっています。
もし漏れている方がいましたら連絡してください。
このメーリングリストは外部には流せないような内容、たとえばサーバーのセキュリティについてなどを話すときのみに使用します。
その他のことは、それにふさわしいメーリングリストに投稿してください。ふさわしいメーリングリストが見つからない場合には-miscメーリングリストがいいでしょう。
個人用Webスペースについて
http://dev.gentoo.gr.jp/~account/ に個人用のWebスペースを持つことができます。
各ホームディレクトリ以下にpublic_htmlディレクトリを作成してその下にコンテンツを置いてください。
このスペースでは、自己紹介や、各種ドキュメント、ちょっとしたファイルの配布など自由に使ってもらって構わないです。
現在のところ内容や容量の制限などのルールを設けていませんが、
常識の範囲内でよろしくお願いします。
必要なソフトウェア(mod_*など)がありましたら、
-adminまたは-miscメーリンリグリストまでお願いします。
|