blob: 55f7415d71f13ed603c82dd47c6526ec71f50e6d (
plain) (
tree)
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
<TITLE>w3m ドキュメント整備の方針</TITLE>
</HEAD>
<BODY>
<DIV ALIGN="center">
w3m ドキュメント整備の方針
</DIV>
<DIV ALIGN="right">
Yoshinobu Sakane February 15, 2001
</DIV>
<OL>
<H1><LI>方針</H1>
<DIV>
<P>
w3mに関するドキュメント類を以下の方針で整備したいと考えています。
<P>
<UL>
<LI>現時点(w3m-0.1.11-pre)で散文しているドキュメントを一定のルールのもとにまとめる
<LI>入門程度のドキュメントと深みにはめる:-)ためのドキュメントを用意する
<LI>HTML版とプレインテキスト版を用意する。ただし、ソースとなるドキュメントは一つ
</UL>
</DIV>
<BR>
<H1><LI>骨組みドキュメントの説明</H1>
<DIV>
<P>
<TABLE BORDER>
<CAPTION>《コンテンツ》</CAPTION>
<TR>
<TD><A HREF="w3mdoc.pl">w3mdoc.pl</A></TD>
<TD><A HREF="http://www2u.biglobe.ne.jp/~hsaka/">坂本さん</A>ご謹製のperlスクリプト</TD>
<TR>
<TD><A HREF="mkdocs">mkdocs</A></TD>
<TD>ドキュメント整形用シェルスクリプト</TD>
<TR>
<TD>README.html</TD>
<TD>このファイル</TD>
<TR>
<TD>*.html.in</TD>
<TD>各章/節毎のドキュメントソース</TD>
<TR>
<TD>*.wd</TD>
<TD>各種定義ファイル</TD>
</TABLE>
<P>
w3mdoc.plの使い方については、坂本さんが書かれた<A HREF="sample/README">README</A>、及び、サンプルソースを参照してください。<br>
</DIV>
<BR>
<H1><LI>ドキュメント整備の進め方</H1>
<DIV>
<P>
<UL>
<LI>有志(以降、<B>w3m-docメンバ</B>と記す)による分割作業
<LI>分割の単位はw3m-docメンバ間で調整
<LI>今回示す骨組みはあくまで指針。状況/都合によりw3m-docメンバ間で調整し変更する
<LI>まずは日本語版のドキュメントを作り、状況を見て英訳する
<LI>ある程度できたところから、逐次、w3m-dev MLメンバのレビューを受ける
</UL>
<P>
と、考えています。
</DIV>
</OL>
</BODY>
</HTML>
|