doc/ja/docproj/current.sgml
Motoyuki Konno 644386f3bf Update member list
jmember.sgml

Merge from English version:
    docs.sgml                   1.66  -> 1.68
    where.sgml                  1.31  -> 1.32
    y2kbugs.sgml                1.20  -> 1.21
    copyright/daemon.sgml       1.12  -> 1.13
    docproj/current.sgml        1.10  -> 1.11
    docproj/sgml.sgml           1.7   -> 1.8
    docproj/submitting.sgml     1.2   -> 1.3
    docproj/translations.sgml   1.21  -> 1.23
    news/newsflash.sgml         1.114 -> 1.127
    news/webchanges.sgml        1.25  -> 1.40
    projects/newbies.sgml       1.8   -> 1.9
    releases/index.sgml         1.27  -> 1.28
    releases/3.1R/errata.sgml   1.1   -> 1.5

Submitted by: FreeBSD Japanese Documentation Project
                Mitsuru IWASAKI <iwasaki@jp.freebsd.org>
                TER Software Develop <jurai@jah.ne.jp>
1999-05-12 04:54:28 +00:00

277 lines
11 KiB
Text

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$Date: 1999-05-12 04:54:20 $">
<!ENTITY title "FreeBSD Documentation Project: Current projects">
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
]>
<!-- The FreeBSD Japanese Documentation Project -->
<!-- Original revision: 1.11 -->
<!-- $Id: current.sgml,v 1.7 1999-05-12 04:54:20 motoyuki Exp $ -->
<html>
&header;
<p>いま進行中のプロジェクトの一覧です (つまり freebsd-doc
メーリングリストで活発に行われているものです). ここにはいくつかの
まだ本当はお話していないものも含めていますが, おそらくは
よい考えのものでしょう. それぞれのプロジェクトの連絡担当者の一覧も
付けておきます (わたしが知っている範囲で).</p>
<p>もしあなたがこれらのどれかに貢献できると思いましたら, ためらうことなく
立ち上がり参加して下さい. あなたは特にそのプロジェクトの責任者と
話をして, あなたにどの作業をしてもらうかを見つけてもらうべきです.</p>
<p>このリストで脱落しているところがもしあればすべてわたしの責任です
(Nik Clayton, &lt;<a
href="mailto:nik@FreeBSD.ORG">nik@FreeBSD.ORG</a>&gt;).
見落としてしまったプロジェクトの方にはあらかじめお詫び致します.</p>
<ul>
<li><a href="#pr">ドキュメントの公開障害報告</a></li>
<li><a href="#freebsd4linux">Linux ユーザのための FreeBSD</a></li>
<li><a href="#fixup">FOO.TXT ファイルを用意する</a></li>
<li><a href="#handbooksection">ハンドブック および/もしくは FAQ の章を書く</a></li>
<li><a href="#rewritethehandbook">ハンドブックを書き直す :-)</a></li>
<li><a href="#newpapers">新しく文書を書く</a></li>
<li><a href="#newtutorials">新しいチュートリアルを書く</a></li>
<li><a href="#newkernelmanpages">カーネルのためのマニュアルページを書く</a></li>
<li><a href="#cgiscripts">CGI スクリプト</a></li>
<li><a href="#multilingualwebscripts">多言語 ウェブスクリプト</a></li>
<li><a href="#translations">FreeBSD ドキュメントの翻訳</a></li>
</ul>
<a name="pr"></a>
<h3><font color="#660000">ドキュメントの公開障害報告</font></h3>
<p>最新の FreeBSD の障害報告は GNATS データベースを用いて追跡
されています.</p>
ドキュメントの公開障害報告を<a
href="http://www.freebsd.org/cgi/query-pr-summary.cgi?category=docs&amp;responsible=.">見る</a>
ことができます.
<a name="freebsd4linux"></a>
<h3><font color="#660000">Linux ユーザのための FreeBSD</font></h3>
<p><b>責任者:</b> Annelise Anderson &lt;andrsn@andrsn.stanford.edu&gt;</p>
<p><b>概略:</b> FreeBSD に移ってきた Linux のユーザはシステムの違いに
混乱するおそれがあります (標準のシェルの違い, 起動時の設定の動作の仕方,
など). Annelise はこれらのポイントを扱うチュートリアルや FAQ の章の開発を
調整しています.</p>
<p>現在の質問集は <a href="http://freebsd.stanford.edu/FreeBSD/linux.html">http://freebsd.stanford.edu/FreeBSD/linux.html</a> にあります.</p>
<a name="fixup"></a>
<h3><font color="#660000">FOO.TXT ファイルを用意する</font></h3>
<p><b>責任者:</b> Doug &lt;studded@dal.net&gt;</p>
<p><b>概略:</b> "FOO.TXT" ファイルとは README ファイルのことで,
FreeBSD を手に入れたときに附属している INSTALL.TXT や, ABOUT.TXT
などがあります. Doug (やほかのひとは) これらを改訂しており,
正確で, 矛盾せず, また容易に理解できるように努めています.
とてもやりがいのある作業です.</p>
<a name="handbooksection"></a>
<h3><font color="#660000">ハンドブック および/もしくは FAQ の章を書く</font></h3>
<p><b>責任者:</b> おりません</p>
<p><b>概略:</b> FAQ やハンドブックには中身が空の章が残っており,
埋める必要があります. もしあなたが作業を終わらせるためにちょうど
これらのドキュメントを使わなくてはいけなかったということがあったり,
またはそれらに足りないところを見つけたときには, 是非時間を見つけて
あなたの経験を考えられる限り詳しく書いて下さい.</p>
<p>または, もしあなたが FAQ および/もしくは ハンドブックの中の
空な部分でなにかしなくてはならないことがちょうどあったとしたならば,
新しい章を書くことも考えてみて下さい. そのときは上に述べたような方法で
提出してください.</p>
<a name="rewritethehandbook"></a>
<h3><font color="#660000">ハンドブックを書き直す :-)</font></h3>
<p><b>責任者:</b> まだおりません</p>
<p><b>概略:</b> ハンドブックはここ数年以上にもわたってずいぶん有機的に
成長してきました. ということはいくつかの章はあるべき姿よりも
組織的でなく, そしていくつかは書き直される必要があるということを
意味しています.</p>
<p>必要なことは</p>
<ul>
<li>ハンドブック全体を読む</li>
<li>構造の改訂を提案する</li>
<li>どのようにハンドブックが書かれているかを理解すること (これは
SGML のいくつかの要素について学ぶことや, おそらくは DocBook への
移植プロジェクトと連絡をつけるということを意味しています) </li>
<li>実際に作業を行う.</li>
</ul>
<p>このハンドブックを管理できるように分割することをうまく進めるために,
ハンドブックの構成について現在の作者たちのコメントをまとめた
web ページをまず誰かに作ってもらえたら, 非常に役に立つことでしょう.
少なくともそのページを見ることで何から作業を始めたらいいのかが
わかるでしょう.</p>
<p>もし誰もこれを処理しようとしなかったら, わたしがやろうと思います.
着手するまでにはちょっと時間がかかります (DocBook への移植プロジェクトが
まず片付いてからということで).</p>
<a name="newpapers"></a>
<h3><font color="#660000">新しく文書を書く</font></h3>
<h4><font color="#660000">FreeBSD VM アーキテクチャ</font></h4>
<p><b>責任者:</b> John Dyson &lt;<a href="mailto:dyson@iquest.net">
dyson@iquest.net</a></p>
<p><b>概略:</b> FreeBSD 2.x には完全に書き直された仮想記憶の
アーキテクチャがあります. 残念なことに FreeBSD VM アーキテクチャには
まだドキュメントがなく, ソースコードやいくつかの John Dyson からの
古いメールに頼るしかありません.
最初のスナップショットについては
<a href="http://www.backplane.com/FreeBSD/FreeBSDVM.txt">
FreeBSD VM システム 概略</a> をご覧ください.
<h4><font color="#660000">FreeBSD のための新しい SCSI レイヤ (CAM)</font></h4>
<p><b>責任者:</b>
&lt;<a href="mailto:doc@freebsd.org">doc@freebsd.org</a>>,
&lt;<a href="mailto:scsi@freebsd.org">scsi@freebsd.org</a>>
<p><b>概略:</b> <a href="http://www.freebsd.org/~gibbs/">
FreeBSD SCSI サブシステムの設計と実装</a> には
最初のスナップショットがあります.
<a name="newtutorials"></a>
<h3><font color="#660000">新しいチュートリアルを書く</font></h3>
<p><b>責任者:</b>
&lt;<a href="mailto:doc@freebsd.org">doc@freebsd.org</a>
<p><b>概略:</b>
<ul>
<li>a.out から elf へのアップデートの方法</li>
<li>FreeBSD のリリースの構築方法</li>
</ul>
<a name="newkernelmanpages"></a>
<h3><font color="#660000">カーネルのためのマニュアルページを書く</font></h3>
<p><b>責任者:</b>
&lt;<a href="mailto:doc@freebsd.org">doc@freebsd.org</a>
<p><b>概略:</b> カーネルの機能についてのドキュメント, section 9
<a name="cgiscripts"></a>
<h3><font color="#660000">CGI スクリプト</font></h3>
<p><b>責任者:</b>
&lt;<a href="mailto:doc@freebsd.org">doc@freebsd.org</a>,
Wolfram Schneider &lt;<a href="mailto:wosch@freebsd.org">
wosch@freebsd.org</a>
<p><b>概略:</b>
<ul>
<li>cvsweb.cgi の cgi スクリプトを RCS perl モジュールを使って
一から書き直す.</li>
<li>man.cgi の cgi スクリプトを書き直していくつかのバグを修正する.</li>
<li>ports の INDEX のための perl モジュールを書く.
</ul>
<h3>ports モジュールを書くためのいくつかのヒント</h3>
<h4>/usr/ports/INDEX の 1 行は次のようになっています</h4>
<pre>
xfig-3.2.2|/usr/ports/graphics/xfig|/usr/X11R6|A drawing program for X11|/usr/ports/graphics/xfig/pkg/DESCR|ports@FreeBSD.ORG|graphics x11|XFree86-3.3.2 Xaw3d-1.3 jpeg-6b xpm-3.4k|XFree86-3.3.2 Xaw3d-1.3 jpeg-6b netpbm-94.3.1 tiff-3.4 transfig-3.2 xpm-3.4k
</pre>
<h4>その書式はこの通りです</h4>
<pre>
配布物の名前|port の置いてある場所|インストールされる場所|コメント| \
内容を記述しているファイル|保守者|カテゴリ|構築時に依存するもの|実行時に依存するもの
</pre>
<h4>上の INDEX の行はある無名のハッシュオブジェクトに解析されます</h4>
<pre>
$port = {
DISTRIBUTION_NAME => 'xfig-3.2.2',
PORT_PATH => '/usr/ports/graphics/xfig',
INSTALLATION_PREFIX => '/usr/X11R6',
COMMENT => 'A drawing program for X11',
DESCRIPTION_FILE => '/usr/ports/graphics/xfig/pkg/DESCR',
MAINTAINER => 'ports@FreeBSD.ORG',
CATEGORIES => ['graphics', 'x11'],
BUILD_DEPS => ['XFree86-3.3.2', 'Xaw3d-1.3', 'jpeg-6b',
'xpm-3.4k'],
RUN_DEPS => ['XFree86-3.3.2', 'Xaw3d-1.3', 'jpeg-6b',
'netpbm-94.3.1', 'tiff-3.4', 'transfig-3.2',
'xpm-3.4k']
};
</pre>
<h4>ここでいくつかの関数が必要になります</h4>
<ul>
<li>$port オブジェクトを HTML 形式で出力する
<li>$port オブジェクトを ASCII 形式で出力する
<li>user XYZ によって保守されているものすべてを検索する
<li>カテゴリ XYZ に入っているものすべてを検索する
<li>ports XYZ に 実行時/構築時 に依存するものすべてを検索する
<li>DISTRIBUTION_NAME もしくは COMMENT に
文字列 XYZ を含むものすべてを検索する
<li>DISTRIBUTION_NAME によってソートする
</ul>
<h4>最後には</h4>
<p>url.cgi, ports.cgi, pds.cgi の cgi スクリプトや
portindex スクリプトをこのモジュールを使って改造する
<p>ports モジュールの最初の<a
href="http://www.freebsd.org/~wosch/pipm/">スナップショット</a>に
ついては, Nik Clayton
&lt;<a href="mailto:nik@FreeBSD.ORG">nik@FreeBSD.ORG</a>&gt;
に<b>連絡して</b>ください.</p>
<a name="multilingualwebscripts"></a>
<h3><font color="#660000">多言語 ウェブスクリプト</font></h3>
<p><b>責任者:</b>
&lt;<a href="mailto:doc@freebsd.org">doc@freebsd.org</a>>
<p></p>
<p><b>概略:</b>
私たちの主なウェブページは(アメリカ)英語で書かれています. <a
href="translations.html">FreeBSD 翻訳プロジェクト</a>では,
ウェブページやハンドブック, FAQ を他の言語に翻訳しています.
<p>
私たちは, CGI スクリプトや Web を構築するためのスクリプトも翻訳しなければなりません.
これらのスクリプトは, 一つの言語だけでなく, 複数の言語をサポートするべきです.
ほとんどのスクリプトは perl で書かれています. </p>
<ul>
<li><a
href="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/www/en/ports/portindex">www/en/ports/portindex</a>
と<a
href="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/www/ja/ports/portindex">www/ja/ports/portindex</a>
を一つの perl スクリプトに統合する. 英語と日本語の出力に対するオプションを加える.
</li>
</ul>
<a name="translations"></a>
<h3><font color="#660000">FreeBSD ドキュメントの翻訳</font></h3>
<p><b>責任者:</b>
&lt;<a href="mailto:doc@freebsd.org">doc@freebsd.org</a>
FreeBSD ドキュメント (Web ページ, FAQ, ハンドブック, マニュアルページ) を
他の言語に翻訳します.
<a href="translations.html">FreeBSD 翻訳プロジェクト</a> を
見てください.
<p></p><a href="docproj.html">FreeBSD
ドキュメンテーションのページ</a>
&footer
</body>
</html>