GentooJP開発者用ドキュメント|
このドキュメントはGentooJPの開発者用です。
ただし、将来の開発者のために情報はすべて公開しています。
|
1.
GentooJP開発者とは
GentooJP開発者とは
GentooJPのプロジェクト運営を円滑に進めるための有志のことです。
GentooJPでは、ソフトウェアの開発だけでなく、ドキュメント作成者や、サーバーの管理者など、GentooJPの運営をサポートしてくれる人すべてをGentooJP開発者と呼んでいます。
GentooJP開発者になるための条件
特に条件はありません。
責任感を持って常識的な行動を取れる人なら、どなたでも大歓迎です。
2.www.gentoo.jp サイトの更新方法
更新について
AuthorがGentooJPとなっているものの更新は自由に行なってください。
また編集を加えた場合にはeditorとして自分の名前を追加してください。
ただしtypoの修正などわざわざ追加するほどでもないと判断した場合はその限りではありません。
そして周知という意味で-adminや-miscまたは-docsメーリングリストなど、
関係するところへ報告を行なってください。事後報告で構いません。
更新の内容が不安な場合には事前にメーリングリストで話し合ってください。
具体的な更新方法はwww.gentoo.jpのGithub Pagesについてを参照してください。
ニュースの追加方法
ニュースとはwww.gentoo.jpでアクセスしたときに出てくるGentooやGentooJPに関するお知らせのことです。
GentooJP開発者は誰でも自由にニュースを追加することができます。
内容についてはGentooに関係することなら何でもOKです。
一般の人向けであるGentooJPニュース掲載手順も参照しておいてください。
ニュースは/jpnewsディレクトリ以下にカテゴリ別に格納されています。
また、１ニュースが１ファイルになっています。
ファイル名は、yyyymmdd-name.xmlという形にしてください。
yyyymmddは西暦の年月日です。nameの部分は任意の名前を付けます。
サンプルとして一つあげます。
|
Code listing 2.1: ニュースファイルのサンプル |
<?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.xmlです。
このファイルは日付で降順になっていますので、
作成したファイルを一番上へ記述してください。
このファイルを追加することで実際にニュースが掲載されることになります。
|
Code listing 2.2: indexファイル |
<?xml version="1.0" encoding="UTF-8"?>
<uris>
<uri>/jpnews/main/20031029-bsdlinuxday.xml</uri>
<uri>/jpnews/main/20031017-seminar.xml</uri>
<uri>/jpnews/main/20030804-webpage.xml</uri>
(省略)
|
3.
新規開発者の登録手順
新規登録について
誘った人、または立候補の場合にはそれを受けた人、
が新規開発者の登録の各種手続きを手伝うようにしてください。
そして以下の登録をすべて確実に完了できるように、
GentooJPの各担当者と新規登録者の間に入って調整してください。
admin MLへ報告
フリーフォーマットで構わないですが以下の情報を報告してください。
- 名前 (本名でなくても構いません)
GentooJPについてで公表する名前です。
- 通常使用しているメールアドレス。xxxxxx@gentoo.gr.jpの転送先になります。
- xxxxxx@gentoo.gr.jpのメールアドレスで使用するxxxxxxの部分。
またxxxxxxは各GentooJPマシン上でのアカウントにも使用されます。
- GentooJPで担当する場所
この情報を元に各担当者が、
- gentoojp-admin MLへ登録
- xxxxxx@gentoo.gr.jpアドレスの作成と転送先を設定
を行ないます。
開発者用サーバー(現在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メーリンリグリストまでお願いします。
|