<HTML>
<HEAD>
-<TITLE>\e$BF|K\8lHG\e(B Linuxdoc-SGML \e$B%,%$%I\e(B: SGML \e$B$GJ8=q$r=q$/$K$O\e(B</TITLE>
+<TITLE>日本語版 Linuxdoc-SGML ガイド: SGML で文書を書くには</TITLE>
</HEAD>
<BODY>
-<A HREF="jguide-2.html">\e$BA0$N%Z!<%8\e(B</A>
-<A HREF="jguide-4.html">\e$B<!$N%Z!<%8\e(B</A>
-<A HREF="jguide.html#toc3">\e$BL\<!\e(B</A>
+<A HREF="jguide-2.html">前のページ</A>
+<A HREF="jguide-4.html">次のページ</A>
+<A HREF="jguide.html#toc3">目次</A>
<HR>
-<H2><A NAME="s3">3. SGML \e$B$GJ8=q$r=q$/$K$O\e(B</A></H2>
+<H2><A NAME="s3">3. SGML で文書を書くには</A></H2>
-<P>\e$B$3$3$G$O\e(B <CODE>linuxdoc.dtd</CODE> \e$B$r;H$C$?J8=q$N=q$-J}$K$D$$$F@bL@$7$^$9!#\e(B</P>
+<P>ここでは <CODE>linuxdoc.dtd</CODE> を使った文書の書き方について説明します。</P>
-<H2><A NAME="ss3.1">3.1 \e$BJ8=q$N;O$aJ}\e(B</A></H2>
+<H2><A NAME="ss3.1">3.1 文書の始め方</A></H2>
-<P>\e$B0lHV:G=i$K3P$($J$1$l$P$J$i$J$$$3$H$r4JC1$K=q$-$^$9!#\e(B</P>
+<P>一番最初に覚えなければならないことを簡単に書きます。</P>
-<H3>SGML \e$B%U%!%$%k$N:G=i\e(B</H3>
+<H3>SGML ファイルの最初</H3>
-<P>SGML \e$B$G$O\e(B (\e$B%3%a%s%H$OJL$K$7$F\e(B) \e$BI,$:\e(B
+<P>SGML では (コメントは別にして) 必ず
<BLOCKQUOTE><CODE>
<PRE>
<!doctype linuxdoc system>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$G;O$a$J$1$l$P$J$j$^$;$s!#\e(B
-\e$B$3$NL?Na$O4JC1$K$$$&$H!"\e(B``linuxdoc.dtd'' \e$B$r;H$C$?J8=q$G$"$k;v$r;XDj$7\e(B
-\e$B$F$$$^$9!#\e(B</P>
+で始めなければなりません。
+この命令は簡単にいうと、``linuxdoc.dtd'' を使った文書である事を指定し
+ています。</P>
-<H3>\e$B;HMQ$9$kJ8;z\e(B</H3>
+<H3>使用する文字</H3>
-<P>\e$BF~NO$K;HMQ$G$-$k%-%c%i%/%?$H$7$F$O!"$+$J!"4A;z!"1Q?t;z!"$*$h$S<!$N5-9f\e(B
-\e$B$G$9!#\e(B</P>
+<P>入力に使用できるキャラクタとしては、かな、漢字、英数字、および次の記号
+です。</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P><EM>\e$B!ZCm0U![\e(B <CODE>jlinuxdoc-sgml</CODE> \e$B$G$O!"\e(B<CODE>EUC</CODE> \e$B4A;z%3!<%I$r;H$&$h$&$K$J$C$F$$$^$9$N$G!"\e(B<CODE>EUC</CODE> \e$B%3!<%I$GJ8=q$r=q$/$h$&$K$7$F2<$5$$!#\e(B
-\e$B$^$?!"H>3Q%+%J$H8F$P$l$F$$$kJ8;z$O;H$($^$;$s!#\e(B</EM></P>
-<P><EM>\e$B!ZCm0U![9TF,$r\e(B . \e$B$G;O$a$^$9$H!"%F%-%9%H$KJQ49$9$k:]$K!"LdBj$,H/@8\e(B
-\e$B$7$^$9!#$h$C$F!"9TF,$K$O\e(B . \e$B$r5-=R$7$J$$$h$&$K$7$F2<$5$$!#\e(B</EM></P>
+<P><EM>【注意】 <CODE>jlinuxdoc-sgml</CODE> では、<CODE>EUC</CODE> 漢字コードを使うようになっていますので、<CODE>EUC</CODE> コードで文書を書くようにして下さい。
+また、半角カナと呼ばれている文字は使えません。</EM></P>
+<P><EM>【注意】行頭を . で始めますと、テキストに変換する際に、問題が発生
+します。よって、行頭には . を記述しないようにして下さい。</EM></P>
-<H3>\e$BFC<lJ8;z\e(B</H3>
+<H3>特殊文字</H3>
-<P>SGML \e$B$G$O!"0J2<$N5-9f$r%3%^%s%I$H$7$FG'<1$7$F$7$^$$$^$9$N$G!"$=$N5-9f\e(B
-\e$B$rJ8;z$H$7$F;H$$$?$$>l9g$K$O2<$N$h$&$KF~NO$7$F2<$5$$!#\e(B</P>
+<P>SGML では、以下の記号をコマンドとして認識してしまいますので、その記号
+を文字として使いたい場合には下のように入力して下さい。</P>
<P>
<UL>
-<LI>\e$B:83Q$+$C$3\e(B (<CODE>[</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&lsqb;</CODE> \e$B$HF~\e(B
-\e$BNO$7$^$9\e(B</LI>
-<LI>\e$B1&3Q$+$C$3\e(B (<CODE>]</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&rsqb;</CODE> \e$B$HF~\e(B
-\e$BNO$7$^$9\e(B</LI>
-<LI>\e$B%"%s%Q%5%s%I\e(B (<CODE>&</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&amp;</CODE> \e$B$HF~\e(B
-\e$BNO$7$^$9\e(B</LI>
-<LI>\e$B:8%V%i%1%C%H\e(B (<CODE><</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&lt;</CODE> \e$B$HF~NO\e(B
-\e$B$7$^$9\e(B</LI>
-<LI>\e$B1&%V%i%1%C%H\e(B (<CODE>></CODE>) \e$B$r;H$&$K$O\e(B <CODE>&gt;</CODE> \e$B$HF~NO\e(B
-\e$B$7$^$9\e(B</LI>
-<LI>\e$B:8%V%i%1%C%H!\%9%i%C%7%e\e(B (<CODE></</CODE>) \e$B$r;H$&$K$O\e(B
-<CODE>&etago;</CODE> \e$B$HF~NO$7$^$9\e(B</LI>
-<LI>\e$B%I%k%^!<%/\e(B (<CODE>$</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&dollar;</CODE>
-\e$B$HF~NO$7$^$9\e(B</LI>
-<LI>\e$B%7%c!<%W\e(B (<CODE>#</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&num;</CODE> \e$B$HF~NO$7\e(B
-\e$B$^$9\e(B</LI>
-<LI>\e$B%Q!<%;%s%H\e(B (<CODE>%</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&percnt;</CODE>
-\e$B$HF~NO$7$^$9\e(B</LI>
-<LI>\e$B%P%C%/%9%i%C%7%e\e(B (<CODE>\</CODE>) \e$B$r;H$&$K$O\e(B
-<CODE>&bsol;</CODE> \e$B$HF~NO$7$^$9\e(B</LI>
-<LI>\e$BFs=E0zMQId$r;H$&$K$O\e(B <CODE>``</CODE> \e$B$H\e(B <CODE>''</CODE> \e$B$HF~NO$9$k$+!"\e(B
-<CODE>"</CODE> \e$B$rI=<($5$;$k$K$O\e(B <CODE>&dquot;</CODE> \e$B$HF~NO$7$^$9\e(B</LI>
+<LI>左角かっこ (<CODE>[</CODE>) を使うには <CODE>&lsqb;</CODE> と入
+力します</LI>
+<LI>右角かっこ (<CODE>]</CODE>) を使うには <CODE>&rsqb;</CODE> と入
+力します</LI>
+<LI>アンパサンド (<CODE>&</CODE>) を使うには <CODE>&amp;</CODE> と入
+力します</LI>
+<LI>左ブラケット (<CODE><</CODE>) を使うには <CODE>&lt;</CODE> と入力
+します</LI>
+<LI>右ブラケット (<CODE>></CODE>) を使うには <CODE>&gt;</CODE> と入力
+します</LI>
+<LI>左ブラケット＋スラッシュ (<CODE></</CODE>) を使うには
+<CODE>&etago;</CODE> と入力します</LI>
+<LI>ドルマーク (<CODE>$</CODE>) を使うには <CODE>&dollar;</CODE>
+と入力します</LI>
+<LI>シャープ (<CODE>#</CODE>) を使うには <CODE>&num;</CODE> と入力し
+ます</LI>
+<LI>パーセント (<CODE>%</CODE>) を使うには <CODE>&percnt;</CODE>
+と入力します</LI>
+<LI>バックスラッシュ (<CODE>\</CODE>) を使うには
+<CODE>&bsol;</CODE> と入力します</LI>
+<LI>二重引用符を使うには <CODE>``</CODE> と <CODE>''</CODE> と入力するか、
+<CODE>"</CODE> を表示させるには <CODE>&dquot;</CODE> と入力します</LI>
</UL>
</P>
-<H2><A NAME="ss3.2">3.2 \e$B%?%0\e(B</A></H2>
+<H2><A NAME="ss3.2">3.2 タグ</A></H2>
-<P>SGML \e$B$G$N%3%^%s%I$O\e(B<EM>\e$B%?%0\e(B</EM>\e$B$H8F$P$l$^$9!#%?%0$K$O3+;O%?%0$H=*N;%?\e(B
-\e$B%0$,$"$j!"3+;O%?%0$O\e(B <CODE><\e$B%?%0L>\e(B></CODE> \e$B$G$"$j!"=*N;%?%0$O\e(B
-<CODE></\e$B%?%0L>\e(B></CODE> \e$B$G$9!#$^$?!"3+;O%?%0$7$+I,MW$H$7$J$$$b$N$b$"$j\e(B
-\e$B$^$9$7!"\e(B<CODE><\e$B%?%0L>\e(B/\e$BFbMF\e(B/</CODE> \e$B$H$$$&C;=L7A<0$b$"$j$^$9!#\e(B</P>
-<P>\e$B3+;O%?%0$H=*N;%?%0$G$O$5$^$l$F$$$kItJ,$K!"$=$N%?%0$NFbMF$,E,MQ$5$l$^$9!#\e(B
-LaTeX \e$B$N4D6-$HF1$8$h$&$J$b$N$G$9$M!#\e(B</P>
+<P>SGML でのコマンドは<EM>タグ</EM>と呼ばれます。タグには開始タグと終了タ
+グがあり、開始タグは <CODE><タグ名></CODE> であり、終了タグは
+<CODE></タグ名></CODE> です。また、開始タグしか必要としないものもあり
+ますし、<CODE><タグ名/内容/</CODE> という短縮形式もあります。</P>
+<P>開始タグと終了タグではさまれている部分に、そのタグの内容が適用されます。
+LaTeX の環境と同じようなものですね。</P>
-<H2><A NAME="ss3.3">3.3 \e$B869F$N=q$-J}\e(B</A></H2>
+<H2><A NAME="ss3.3">3.3 原稿の書き方</A></H2>
-<P>\e$B%I%-%e%a%s%H$D$^$j869F$O!"$$$E$l$+$N%9%?%$%k$r;XDj$7$J$1$l$P$J$j$^$;$s!#\e(B
-\e$B%9%?%$%k$K$O0J2<$N$b$N$,;XDj$G$-$^$9!#$[$H$s$I!"\e(BLaTeX \e$B$G;H$o$l$F$$$k$b\e(B
-\e$B$N$HF1MM$G$9!#\e(B</P>
+<P>ドキュメントつまり原稿は、いづれかのスタイルを指定しなければなりません。
+スタイルには以下のものが指定できます。ほとんど、LaTeX で使われているも
+のと同様です。</P>
<P>
<DL>
-<DT><B>article</B><DD><P>\e$B$b$C$H$b%]%T%e%i!<$J%9%?%$%k$G$9!#\e(BHOWTO \e$B$K$O$3$l$r;H$$$^\e(B
-\e$B$9!#\e(B</P>
-<DT><B>report</B><DD><P>\e$B%l%]!<%H7A<0$G$9!#\e(B</P>
-<DT><B>book</B><DD><P>\e$BK\$N7A<0$G$9!#\e(B</P>
-<DT><B>manpage</B><DD><P>man \e$B%Z!<%8$N7A<0$G$9!#\e(B</P>
+<DT><B>article</B><DD><P>もっともポピュラーなスタイルです。HOWTO にはこれを使いま
+す。</P>
+<DT><B>report</B><DD><P>レポート形式です。</P>
+<DT><B>book</B><DD><P>本の形式です。</P>
+<DT><B>manpage</B><DD><P>man ページの形式です。</P>
</DL>
</P>
-<P>\e$BNc$($P\e(B article \e$B$r;H$&>l9g$K$O!"\e(B
+<P>例えば article を使う場合には、
<BLOCKQUOTE><CODE>
<PRE>
<!doctype linuxdoc system>
<article>
-\e$BK\J8\e(B
+本文
</article>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H;XDj$7$^$9!#\e(B</P>
-<P><EM>\e$B$J$*!"\e(Bman \e$B%Z!<%8$K$D$$$F$O!"8e$G>\$7$/@bL@$7$^$9!#\e(B</EM></P>
+と指定します。</P>
+<P><EM>なお、man ページについては、後で詳しく説明します。</EM></P>
-<H2><A NAME="ss3.4">3.4 \e$B%?%$%H%k\e(B</A></H2>
+<H2><A NAME="ss3.4">3.4 タイトル</A></H2>
-<P>\e$BJ8=q$N%?%$%H%k!"Cx<T!"F|IU$d35MW$O!"%9%?%$%k\e(B (\e$BNc$($P\e(B<article>)
-\e$B$N8e$K5-=R$7$^$9!#\e(B</P>
+<P>文書のタイトル、著者、日付や概要は、スタイル (例えば<article>)
+の後に記述します。</P>
<P>
<DL>
-<DT><B><title></B><DD><P>\e$BJ8=q$N%?%$%H%k$r5-=R$7$^$9!#\e(B(\e$BI,?\\e(B)</P>
-<DT><B><auther></B><DD><P>\e$BCx<T$r5-=R$7$^$9!#\e(B(\e$BI,?\\e(B)</P>
-<DT><B><trans></B><DD><P>\e$BK]Lu<T$r5-=R$7$^$9!#\e(B(\e$B%*%W%7%g%s\e(B)</P>
-<DT><B><date></B><DD><P>\e$BJ8=q$N%P!<%8%g%s$dF|IU$r5-=R$7$^$9!#\e(B(\e$B%*%W%7%g%s\e(B)</P>
-<DT><B><tdate></B><DD><P>\e$BK]Lu$5$l$?J8=q$N%P!<%8%g%s$dF|IU$r5-=R$7$^$9!#\e(B(\e$B%*%W%7%g%s\e(B)</P>
-<DT><B><abstract>...</abstract></B><DD><P>\e$B35MW$r5-=R$7$^$9!#\e(B(\e$B%*%W\e(B
-\e$B%7%g%s\e(B)</P>
+<DT><B><title></B><DD><P>文書のタイトルを記述します。(必須)</P>
+<DT><B><auther></B><DD><P>著者を記述します。(必須)</P>
+<DT><B><trans></B><DD><P>翻訳者を記述します。(オプション)</P>
+<DT><B><date></B><DD><P>文書のバージョンや日付を記述します。(オプション)</P>
+<DT><B><tdate></B><DD><P>翻訳された文書のバージョンや日付を記述します。(オプション)</P>
+<DT><B><abstract>...</abstract></B><DD><P>概要を記述します。(オプ
+ション)</P>
</DL>
</P>
-<P>\e$BNc$($P!"0J2<$N$h$&$K$J$j$^$9!#\e(B
+<P>例えば、以下のようになります。
<BLOCKQUOTE><CODE>
<PRE>
-<title>SGML \e$B$r=q$3$&!*!*\e(B
-<author>\e$B$5$H$1$s!w#F#o#r#U#s\e(B,<tt/ken@gamba.forus.or.jp/
+<title>SGML を書こう！！
+<author>さとけん＠ＦｏｒＵｓ,<tt/ken@gamba.forus.or.jp/
<date>v0.1 alpha, 20 September 1994
<abstract>
-SGML \e$B$r;H$C$FJ8=q$r=q$$$F$_$h$&!#\e(B
+SGML を使って文書を書いてみよう。
</abstract>
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P><EM>\e$B!ZCm0U![\e(B <date> \e$B$O!"\e(B<author> \e$B$b$7$/$O\e(B <trans> \e$B$N\e(B
-\e$BD>8e$G$J$$$H!"%(%i!<$H$J$j$^$9!#\e(B</EM></P>
+<P><EM>【注意】 <date> は、<author> もしくは <trans> の
+直後でないと、エラーとなります。</EM></P>
-<H2><A NAME="ss3.5">3.5 \e$BJ8>O9=@.\e(B</A></H2>
+<H2><A NAME="ss3.5">3.5 文章構成</A></H2>
-<P>\e$BJ8>O$N9=@.$G!">O$d@a$rI=$9$b$N$H$7$F!"<!$N$h$&$J%;%/%7%g%s%?%0$,MQ0U$5\e(B
-\e$B$l$F$$$^$9!#$3$l$i$O!"%?%$%H%k$N8e$K5-=R$9$k$3$H$,$G$-$^$9!#\e(B</P>
+<P>文章の構成で、章や節を表すものとして、次のようなセクションタグが用意さ
+れています。これらは、タイトルの後に記述することができます。</P>
<P>
<DL>
-<DT><B><sect></B><DD><P>\e$B%H%C%W%l%Y%k$N>O$G!"\e(BLaTeX \e$B$N\e(B section \e$B$KAjEv$7$^$9!#\e(B
+<DT><B><sect></B><DD><P>トップレベルの章で、LaTeX の section に相当します。
(1, 2, ...)</P>
-<DT><B><sect1></B><DD><P>\e$BBh\e(B 2 \e$B%l%Y%k$N>O$G!"\e(BLaTeX \e$B$N\e(B subsection \e$B$KAjEv$7$^$9!#\e(B
+<DT><B><sect1></B><DD><P>第 2 レベルの章で、LaTeX の subsection に相当します。
(1.1, 1.2, ...)</P>
-<DT><B><sect2></B><DD><P>\e$BBh\e(B 3 \e$B%l%Y%k$N>O$G!"\e(BLaTeX \e$B$N\e(B subsubsection \e$B$KAjEv$7\e(B
-\e$B$^$9!#\e(B(1.1.1, 1.1.2, ...)</P>
-<DT><B><sect3></B><DD><P>\e$BBh\e(B 4 \e$B%l%Y%k$N>O$G!"\e(BLaTeX \e$B$N\e(B paragraph \e$B$KAjEv$7$^$9!#\e(B</P>
-<DT><B><sect4></B><DD><P>\e$BBh\e(B 5 \e$B%l%Y%k$N>O$G!"\e(BLaTeX \e$B$N\e(B subparagraph \e$B$KAjEv$7$^\e(B
-\e$B$9!#\e(B</P>
+<DT><B><sect2></B><DD><P>第 3 レベルの章で、LaTeX の subsubsection に相当し
+ます。(1.1.1, 1.1.2, ...)</P>
+<DT><B><sect3></B><DD><P>第 4 レベルの章で、LaTeX の paragraph に相当します。</P>
+<DT><B><sect4></B><DD><P>第 5 レベルの章で、LaTeX の subparagraph に相当しま
+す。</P>
</DL>
</P>
-<P>\e$B$^$?!"$=$l$>$l$N%?%0$ND>8e$K!"BP1~$7$?8+=P$7$r5-=R$7$^$9!#\e(B</P>
-<P>\e$BNc$($PJ8=q$N:G=i$K\e(B``\e$B35MW\e(B''\e$B$H$$$&>O$r5-=R$9$k$K$O!"\e(B
+<P>また、それぞれのタグの直後に、対応した見出しを記述します。</P>
+<P>例えば文書の最初に``概要''という章を記述するには、
<BLOCKQUOTE><CODE>
<PRE>
-<sect>\e$B35MW\e(B
+<sect>概要
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$9$l$P$h$$$G$9$7!"$"$J$?$,:#FI$s$G$$$k$3$N>O$O\e(B
+とすればよいですし、あなたが今読んでいるこの章は
<BLOCKQUOTE><CODE>
<PRE>
-<sect1>\e$BJ8>O9=@.\e(B
+<sect1>文章構成
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H5-=R$5$l$F$$$^$9!#\e(B</P>
-<P>\e$B%;%/%7%g%s%?%0$N8e$G!"<B:]$NK\J8$r=q$/$K$O\e(B <p> \e$B%?%0$rK\J8$NA0$K\e(B
-\e$B5-=R$7$F2<$5$$!#\e(B</P>
-<P>\e$BNc$($P!"<!$N$h$&$K$J$j$^$9!#\e(B
+と記述されています。</P>
+<P>セクションタグの後で、実際の本文を書くには <p> タグを本文の前に
+記述して下さい。</P>
+<P>例えば、次のようになります。
<BLOCKQUOTE><CODE>
<PRE>
-<sect>\e$B35MW\e(B
+<sect>概要
<p>
-\e$B$3$NJ8=q$O!"\e(B<tt/jlinuxdoc-sgml/ \e$BJ8=q@07A%7%9%F%`$N\e(B...
+この文書は、<tt/jlinuxdoc-sgml/ 文書整形システムの...
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P>\e$B$3$l$O!"\e(B<CODE>sgmls</CODE> \e$B%Q!<%5!<$K>O8+=P$7$HK\J8$N6h@Z$j$r65$($F$$$k$N$G$9!#\e(B
-\e$B$7$+$7!"CJMn$N6h@Z$j$r;XDj$9$kI,MW$,$"$k$N$O!"%;%/%7%g%s%?%0$N8e$@$1$G!"\e(B
-\e$B$=$N8e$NCJMn$N6h@Z$j$O6u9T$GBg>fIW$G$9!#\e(B(\e$B$3$&$$$&CJMn$N6h@Z$jJ}$O!"\e(B
-LaTeX \e$B$G$h$/$d$i$l$F$$$k$3$H$G$7$g$&!#\e(B)</P>
-<P>\e$BNc$($P!"<!$N$h$&$K$J$j$^$9!#\e(B
+<P>これは、<CODE>sgmls</CODE> パーサーに章見出しと本文の区切りを教えているのです。
+しかし、段落の区切りを指定する必要があるのは、セクションタグの後だけで、
+その後の段落の区切りは空行で大丈夫です。(こういう段落の区切り方は、
+LaTeX でよくやられていることでしょう。)</P>
+<P>例えば、次のようになります。
<BLOCKQUOTE><CODE>
<PRE>
<p>
-\e$B$3$3$O:G=i$NCJMn$G$9!#\e(B
+ここは最初の段落です。
-\e$B$3$3$O<!$NCJMn$G$9!#\e(B
+ここは次の段落です。
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P>\e$B$?$@!":G=i$NCJMn0J30$G\e(B <p> \e$B%?%0$r;H$C$F$O$$$1$J$$$o$1$G$O$"$j$^\e(B
-\e$B$;$s!#:G=i$NCJMn$GI,$:;XDj$7$J$1$l$P$J$i$J$$$@$1$G$9!#\e(B</P>
+<P>ただ、最初の段落以外で <p> タグを使ってはいけないわけではありま
+せん。最初の段落で必ず指定しなければならないだけです。</P>
-<H2><A NAME="ss3.6">3.6 \e$BJ8$N@07A$H2~9T\e(B</A></H2>
+<H2><A NAME="ss3.6">3.6 文の整形と改行</A></H2>
-<P><CODE>jlinuxdoc-sgml</CODE> \e$B$G$O\e(B <CODE>roff</CODE>\e$B!"\e(B<CODE>LaTeX</CODE>\e$B!"\e(B<CODE>HTML</CODE> \e$B$r;H$C$F!"J8\e(B
-\e$B=q$r@07A$7$^$9$N$G!"J8;zNs$d9T$r<+F0E*$K5M$a$?$j!"2~9T$7$?$j$7$^$9!#\e(B
-\e$B$h$C$F!"@07A%k!<%k$O$=$l$>$l$N%U%)!<%^%C%?$K0MB8$7$^$9!#\e(B</P>
-<P>\e$B$^$?!"DL>o\e(B SGML \e$B$N%=!<%9J8=q$G$N2~9T$OL5;k$5$l$^$9!#6/@)E*$K2~9T$r9T$J$&\e(B
-\e$B>l9g$O\e(B<newline> \e$B$r9TKv$KA^F~$7$F$/$@$5$$!#$^$?!"6u9T$+\e(B <p>
-\e$B$rA^F~$9$k$H$=$NA0$NJ8$K2~9T$,F~$j9T4V$,6u$-$^$9!#\e(B</P>
-<P>\e$B$^$?!"6uGrJ8;z$N07$$$O%U%)!<%^%C%?$K$h$C$F0[$J$j$^$9!#%W%l!<%s%F%-%9%H\e(B
-\e$B$N>l9g$O6uGrJ8;z$r$=$N$^$^6uGr$H$7$F=PNO$7$^$9$,!"\e(BDVI \e$B$d\e(B PS, HTML \e$B$G$O\e(B
-\e$B$D$a$F=PNO\e(B(\e$BI=<(\e(B)\e$B$5$l$^$9!#\e(B</P>
+<P><CODE>jlinuxdoc-sgml</CODE> では <CODE>roff</CODE>、<CODE>LaTeX</CODE>、<CODE>HTML</CODE> を使って、文
+書を整形しますので、文字列や行を自動的に詰めたり、改行したりします。
+よって、整形ルールはそれぞれのフォーマッタに依存します。</P>
+<P>また、通常 SGML のソース文書での改行は無視されます。強制的に改行を行なう
+場合は<newline> を行末に挿入してください。また、空行か <p>
+を挿入するとその前の文に改行が入り行間が空きます。</P>
+<P>また、空白文字の扱いはフォーマッタによって異なります。プレーンテキスト
+の場合は空白文字をそのまま空白として出力しますが、DVI や PS, HTML では
+つめて出力(表示)されます。</P>
<P>
<DL>
-<DT><B>
\e$BJQ49A0!'\e(B</B><DD><P>
<BLOCKQUOTE><CODE>
<PRE>
-\e$B1+$,9_$k9_$k\e(B
-\e$B1+$,9_$k\e(B
+雨が降る降る
+雨が降る
<p>
-\e$BM7$S$K9T$-$?$7\e(B<newline>
-\e$B;1$O$J$7\e(B
+遊びに行きたし<newline>
+傘はなし
-\e$BApMz$N\e(B \e$BI!=o$b\e(B
-\e$B;$$j@Z$l$?\e(B
+草履の 鼻緒も
+擦り切れた
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<DT><B>
\e$BJQ498e!'\e(B</B><DD><P>
<BLOCKQUOTE><CODE>
-\e$B1+$,9_$k9_$k\e(B
-\e$B1+$,9_$k\e(B
-<P>\e$BM7$S$K9T$-$?$7\e(B<BR>
-\e$B;1$O$J$7\e(B</P>
-<P>\e$BApMz$N\e(B \e$BI!=o$b\e(B
-\e$B;$$j@Z$l$?\e(B</P>
+雨が降る降る
+雨が降る
+<P>遊びに行きたし<BR>
+傘はなし</P>
+<P>草履の 鼻緒も
+擦り切れた</P>
</CODE></BLOCKQUOTE>
</P>
</DL>
</P>
-<P>\e$B%?%$%H%k%Z!<%8$G$O!"2~9T$O2DG=$G$9$,6u9T$r:n$k$3$H$O$G$-$^$;$s!#=>$C$F\e(B
-<abstract> \e$B%?%0$NCf$G6u9T$r@_$1$?$j\e(B <p> \e$B$rA^F~$7$F$b%(%i!<\e(B
-\e$B$K$J$k$+L5;k$5$l$^$9!#\e(B</P>
-<P>\e$B$J$*!"\e(Broff \e$B$N@07A$O$"$^$j@:O#$5$l$F$$$J$$$?$a!"B>$N4D6-$G$b6u9T$,L5;k$5$l\e(B
-\e$B$?$j!"5U$K6u9T$,B?$9$.$?$j$9$k$3$H$,$"$j$^$9!#$=$N$?$a!"\e(Bsgml2txt \e$B$G$O\e(B
-3 \e$B9T0J>e$N6u9T$r\e(B 2 \e$B9T$N6u9T$K=L$a$F$$$^$9!#\e(B</P>
+<P>タイトルページでは、改行は可能ですが空行を作ることはできません。従って
+<abstract> タグの中で空行を設けたり <p> を挿入してもエラー
+になるか無視されます。</P>
+<P>なお、roff の整形はあまり精錬されていないため、他の環境でも空行が無視され
+たり、逆に空行が多すぎたりすることがあります。そのため、sgml2txt では
+3 行以上の空行を 2 行の空行に縮めています。</P>
-<H2><A NAME="ss3.7">3.7 \e$B%3%a%s%H\e(B</A></H2>
+<H2><A NAME="ss3.7">3.7 コメント</A></H2>
-<P>SGML \e$BJ8=q$N$J$+$K!"%U%)!<%^%C%H=PNO$K$O4^$a$J$$%3%a%s%H$r=q$/$K$O!"\e(B
+<P>SGML 文書のなかに、フォーマット出力には含めないコメントを書くには、
<BLOCKQUOTE><CODE>
<PRE>
<!--
-\e$B%3%a%s%H\e(B
+コメント
-->
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$7$^$9!#\e(B</P>
+とします。</P>
-<H2><A NAME="ss3.8">3.8 \e$BBG$A9~$s$@DL$j$K=PNO$9$k\e(B</A></H2>
+<H2><A NAME="ss3.8">3.8 打ち込んだ通りに出力する</A></H2>
-<P>LaTeX \e$B$N\e(B verbatim \e$B4D6-$HF1$8$h$&$K!"BG$A9~$s$@DL$j$K=PNO$5$;$k$K$O!"\e(B
-<verb>...</verb> \e$B$G0O$_$^$9!#\e(B</P>
-<P>\e$BNc$($P!"\e(B
+<P>LaTeX の verbatim 環境と同じように、打ち込んだ通りに出力させるには、
+<verb>...</verb> で囲みます。</P>
+<P>例えば、
<PRE>
-\e$B$3$3$O!"\e(B<verb> \e$B$H\e(B </verb> \e$B$G$+$3$^$l$F$$$^$9!#\e(B
+ここは、<verb> と </verb> でかこまれています。
</PRE>
-\e$B$H$9$k$K$O!"\e(B
+とするには、
<BLOCKQUOTE><CODE>
<PRE>
<verb>
-\e$B$3$3$O!"\e(B<verb> \e$B$H\e(B &etago;verb> \e$B$G$+$3$^$l$F$$$^$9!#\e(B
+ここは、<verb> と &etago;verb> でかこまれています。
</verb>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H5-=R$7$^$9!#$b$A$m$s!"6uGr$b$=$N$^$^=PNO$5$l$^$9!#\e(B</P>
-<P>\e$B$?$@$7!"\e(B<verb>...</verb> \e$B$NCf$G$b!"\e(B&,</ \e$B$N\e(B 2 \e$BJ8;z$O\e(B
-\e$B;H$($^$;$s$N$G!"$=$l$>$l!"\e(B</P>
+と記述します。もちろん、空白もそのまま出力されます。</P>
+<P>ただし、<verb>...</verb> の中でも、&,</ の 2 文字は
+使えませんので、それぞれ、</P>
<P>
<UL>
-<LI>\e$B%"%s%Q%5%s%I\e(B (<CODE>&</CODE>) \e$B$r;H$&$K$O\e(B <CODE>&ero;</CODE></LI>
-<LI>\e$B:8%V%i%1%C%H!\%9%i%C%7%e\e(B (<CODE></</CODE>) \e$B$r;H$&$K$O\e(B
+<LI>アンパサンド (<CODE>&</CODE>) を使うには <CODE>&ero;</CODE></LI>
+<LI>左ブラケット＋スラッシュ (<CODE></</CODE>) を使うには
<CODE>&etago;</CODE></LI>
</UL>
</P>
-<P>\e$B$HF~NO$7$^$9!#\e(B</P>
-<P>\e$B$^$?!"\e(BLaTeX \e$B$N\e(B verbatim \e$B4D6-$r;H$&4X78$G!"\e(B\end{verbatim} \e$B$O5-=R$7\e(B
-\e$B$J$$$G2<$5$$!#\e(B</P>
+<P>と入力します。</P>
+<P>また、LaTeX の verbatim 環境を使う関係で、\end{verbatim} は記述し
+ないで下さい。</P>
-<H2><A NAME="ss3.9">3.9 \e$B%W%m%0%i%`$d%"%k%4%j%:%`\e(B</A></H2>
+<H2><A NAME="ss3.9">3.9 プログラムやアルゴリズム</A></H2>
-<P>\e$B%W%m%0%i%`$d%"%k%4%j%:%`$r%U%)!<%^%C%H$9$k$K$O!"4pK\E*$K$O\e(B verb \e$B4D6-$r\e(B
-\e$BMQ$$$^$9$,!"$A$g$C$H%"%/%;%s%H$r$D$1$kJ}K!$r@bL@$7$^$9!#\e(B</P>
-<P>\e$B%W%m%0%i%`$d%"%k%4%j%:%`$N=PNO$K$O!"\e(B
+<P>プログラムやアルゴリズムをフォーマットするには、基本的には verb 環境を
+用いますが、ちょっとアクセントをつける方法を説明します。</P>
+<P>プログラムやアルゴリズムの出力には、
<DL>
-<DT><B><code>...</code></B><DD><P>\e$B%3!<%I4D6-\e(B</P>
-<DT><B><tscreen>...</tscreen></B><DD><P>\e$B%9%/%j!<%s4D6-\e(B</P>
-<DT><B><quote>...</quote></B><DD><P>\e$B%/%*!<%H4D6-\e(B</P>
+<DT><B><code>...</code></B><DD><P>コード環境</P>
+<DT><B><tscreen>...</tscreen></B><DD><P>スクリーン環境</P>
+<DT><B><quote>...</quote></B><DD><P>クオート環境</P>
</DL>
-\e$B$,;H$($^$9!#\e(B</P>
+が使えます。</P>
-<H3>\e$B%3!<%I4D6-\e(B</H3>
+<H3>コード環境</H3>
-<P><code>...</code> \e$B$G$O$5$^$l$?ItJ,$r%3!<%I4D6-$H$$$$$^$9!#\e(B
-\e$B%3!<%I4D6-$O!"$[$H$s$I\e(B verb \e$B4D6-$HF1$8$G$9$,!">e2<$K@~$,0z$+$l$^$9!#\e(B</P>
-<P>\e$BNc$($P!"\e(B
+<P><code>...</code> ではさまれた部分をコード環境といいます。
+コード環境は、ほとんど verb 環境と同じですが、上下に線が引かれます。</P>
+<P>例えば、
<HR>
<PRE>
-\e$B$3$l$O\e(B <code>...</code> \e$B$NNc$G$9!#\e(B
+これは <code>...</code> の例です。
</PRE>
<HR>
-\e$B$H$9$k$K$O!"\e(B
+とするには、
<BLOCKQUOTE><CODE>
<PRE>
<code>
-\e$B$3$l$O\e(B <code>...&etago;code> \e$B$NNc$G$9!#\e(B
+これは <code>...&etago;code> の例です。
</code>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$7$^$9!#\e(B</P>
+とします。</P>
-<H3>\e$B%9%/%j!<%s4D6-\e(B</H3>
+<H3>スクリーン環境</H3>
-<P><tscreen>...<tscreen> \e$B$G$O$5$^$l$?ItJ,$r%9%/%j!<%s4D6-$H$$\e(B
-\e$B$$$^$9!#%9%/%j!<%s4D6-$G$O!"<+F0E*$K%$%s%G%s%H!"%?%$%W%i%$%?=qBN$N;XDj\e(B
-\e$B$,9T$o$l$^$9!#<g$K\e(B verb \e$B4D6-$H$$$C$7$g$K;H$o$l$^$9!#\e(B</P>
-<P>\e$BNc$($P!"\e(B
+<P><tscreen>...<tscreen> ではさまれた部分をスクリーン環境とい
+います。スクリーン環境では、自動的にインデント、タイプライタ書体の指定
+が行われます。主に verb 環境といっしょに使われます。</P>
+<P>例えば、
<BLOCKQUOTE><CODE>
<PRE>
-\e$B$3$l$O\e(B <tscreen><verb>...</verb></tscreen> \e$B$NNc$G$9!#\e(B
+これは <tscreen><verb>...</verb></tscreen> の例です。
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$9$k$K$O!"\e(B
+とするには、
<BLOCKQUOTE><CODE>
<PRE>
<tscreen><verb>
-\e$B$3$l$O\e(B <tscreen><verb>...&etago;verb>&etago;tscreen> \e$B$NNc$G$9!#\e(B
+これは <tscreen><verb>...&etago;verb>&etago;tscreen> の例です。
</verb></tscreen>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$7$^$9!#\e(B</P>
+とします。</P>
-<H3>\e$B%/%*!<%H4D6-\e(B</H3>
+<H3>クオート環境</H3>
-<P><quote>...<quote> \e$B$G$O$5$^$l$?ItJ,$r%/%*!<%H4D6-$H$$$$$^$9!#\e(B
-\e$B%/%*!<%H4D6-$G$O!"<+F0E*$K%$%s%G%s%H$,9T$o$l$^$9!#\e(B</P>
-<P>\e$BNc$($P!"\e(B
+<P><quote>...<quote> ではさまれた部分をクオート環境といいます。
+クオート環境では、自動的にインデントが行われます。</P>
+<P>例えば、
<BLOCKQUOTE>
-\e$B$3$l$O\e(B <quote>...</quote> \e$B$NNc$G$9!#\e(B
+これは <quote>...</quote> の例です。
</BLOCKQUOTE>
-\e$B$H$9$k$K$O!"\e(B
+とするには、
<BLOCKQUOTE><CODE>
<PRE>
<quote>
-\e$B$3$l$O\e(B <quote>...&etago;quote> \e$B$NNc$G$9!#\e(B
+これは <quote>...&etago;quote> の例です。
</quote>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$7$^$9!#\e(B</P>
+とします。</P>
-<H2><A NAME="ss3.10">3.10 \e$B%U%)%s%H\e(B</A></H2>
+<H2><A NAME="ss3.10">3.10 フォント</A></H2>
-<P><CODE>jlinuxdoc-sgml</CODE> \e$B$G$O\e(B LaTeX \e$B$HF1$8$h$&$J%U%)%s%H$N;XDj$r%5%]!<%H$7\e(B
-\e$B$F$$$^$9!#$?$@$7!"%W%l!<%s%F%-%9%H$K$9$k>l9g$K$O%U%)%s%H$N;XDj$OL5;k$5\e(B
-\e$B$l$^$9!#\e(B</P>
+<P><CODE>jlinuxdoc-sgml</CODE> では LaTeX と同じようなフォントの指定をサポートし
+ています。ただし、プレーンテキストにする場合にはフォントの指定は無視さ
+れます。</P>
<P>
<DL>
-<DT><B>em</B><DD><P>\e$B6/D4\e(B (\e$BNc\e(B:<EM>em</EM>)</P>
-<DT><B>it</B><DD><P>\e$B%$%?%j%C%/\e(B (\e$BNc\e(B:<I>it</I>)</P>
-<DT><B>bf</B><DD><P>\e$B%\!<%k%I%U%'!<%9\e(B (\e$BNc\e(B:<B>bf</B>)</P>
-<DT><B>sf</B><DD><P>\e$B%5%s!&%;%j%U\e(B (\e$BNc\e(B:<SF>sf</SF>)</P>
-<DT><B>sl</B><DD><P>\e$B%9%i%s%F%C%I\e(B (\e$BNc\e(B:<I>sl</I>)</P>
-<DT><B>tt</B><DD><P>\e$B%?%$%W%i%$%?\e(B (\e$BNc\e(B:<CODE>tt</CODE>)</P>
-<DT><B>cparam</B><DD><P>cparam (\e$BNc\e(B:cparam) #LaTeX \e$B$N\e(B \cparam{}
-\e$B$KAjEv$7$^$9!#\e(B</P>
+<DT><B>em</B><DD><P>強調 (例:<EM>em</EM>)</P>
+<DT><B>it</B><DD><P>イタリック (例:<I>it</I>)</P>
+<DT><B>bf</B><DD><P>ボールドフェース (例:<B>bf</B>)</P>
+<DT><B>sf</B><DD><P>サン・セリフ (例:<SF>sf</SF>)</P>
+<DT><B>sl</B><DD><P>スランテッド (例:<I>sl</I>)</P>
+<DT><B>tt</B><DD><P>タイプライタ (例:<CODE>tt</CODE>)</P>
+<DT><B>cparam</B><DD><P>cparam (例:cparam) #LaTeX の \cparam{}
+に相当します。</P>
</DL>
</P>
-<P>\e$B%U%)%s%H$r;XDj$9$k>l9g$K$O!";XDj$9$kFbMF$r%?%0$G$O$5$_$^$9!#\e(B
-\e$BNc$($P!"%?%$%W%i%$%?=qBN$K$9$k$K$O!"0J2<$N$h$&$K$7$^$9!#\e(B
+<P>フォントを指定する場合には、指定する内容をタグではさみます。
+例えば、タイプライタ書体にするには、以下のようにします。
<BLOCKQUOTE><CODE>
<PRE>
Here is some <tt>typewriter text</tt> to be included in the document.
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P>\e$B$^$?!"FbMF$K\e(B``/''\e$B$,4^$^$l$J$$>l9g$K$O!"0J2<$NC;=L7A<0$r;H$&;v$b$G$-$^\e(B
-\e$B$9!#\e(B
+<P>また、内容に``/''が含まれない場合には、以下の短縮形式を使う事もできま
+す。
<BLOCKQUOTE><CODE>
<PRE>
Here is some <tt/typewriter text/ to be included in the document.
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P>\e$B$?$@$7!"A4$F$N=PNO7A<0\e(B (HTML \e$BEy\e(B) \e$B$G%5%]!<%H$5$l$F$$$k$o$1$G$O$J$$$N$G!"\e(B
-bf\e$B!"\e(Bit\e$B!"\e(Btt \e$B0J30$N%U%)%s%H$O$"$^$j;H$&$Y$-$G$OL5$$$G$7$g$&!#\e(Bbf\e$B!"\e(Bit\e$B!"\e(Btt
-\e$B$@$1$G$b!"J8=q$r=q$/$K$O==J,$G$7$g$&!#\e(B</P>
+<P>ただし、全ての出力形式 (HTML 等) でサポートされているわけではないので、
+bf、it、tt 以外のフォントはあまり使うべきでは無いでしょう。bf、it、tt
+だけでも、文書を書くには十分でしょう。</P>
-<H2><A NAME="ss3.11">3.11 \e$B2U>r=q$-\e(B</A></H2>
+<H2><A NAME="ss3.11">3.11 箇条書き</A></H2>
-<P><CODE>jlinuxdoc-sgml</CODE> \e$B$G$O$$$/$D$+$N2U>r=q$-\e(B (\e$B%j%9%H\e(B) \e$B$r%5%]!<%H$7$F$$$^\e(B
-\e$B$9!#%5%]!<%H$7$F$$$k$N$O!"0J2<$N\e(B 3 \e$B<oN`$N2U>r=q$-$G$9!#\e(B
+<P><CODE>jlinuxdoc-sgml</CODE> ではいくつかの箇条書き (リスト) をサポートしていま
+す。サポートしているのは、以下の 3 種類の箇条書きです。
<DL>
-<DT><B><itemize>...</itemize></B><DD><P>\e$BF,$K5-9f$rIU$1$?2U>r=q$-\e(B
-\e$B$G$9!#\e(B</P>
-<DT><B><enum>...</enum></B><DD><P>\e$B9`L\$KHV9f$rIU$1$?2U>r=q$-$G$9!#\e(B</P>
-<DT><B><descrip>...</descrip></B><DD><P>\e$B8+=P$7$rIU$1$?2U>r=q$-$G\e(B
-\e$B$9!#\e(B</P>
+<DT><B><itemize>...</itemize></B><DD><P>頭に記号を付けた箇条書き
+です。</P>
+<DT><B><enum>...</enum></B><DD><P>項目に番号を付けた箇条書きです。</P>
+<DT><B><descrip>...</descrip></B><DD><P>見出しを付けた箇条書きで
+す。</P>
</DL>
</P>
-<H3>itemize \e$B%j%9%H\e(B</H3>
+<H3>itemize リスト</H3>
-<P>itemize \e$B%j%9%H$G$O!"$=$l$>$l$N9`L\$NF,$K5-9f$,IU$1$i$l$^$9!#\e(B
-\e$BNc$($P!"\e(B
+<P>itemize リストでは、それぞれの項目の頭に記号が付けられます。
+例えば、
<BLOCKQUOTE><CODE>
-<CODE>jlinuxdoc-sgml</CODE> \e$B$K$O\e(B
+<CODE>jlinuxdoc-sgml</CODE> には
<UL>
-<LI>itemize \e$B%j%9%H\e(B</LI>
-<LI>enum \e$B%j%9%H\e(B</LI>
-<LI>descrip \e$B%j%9%H\e(B</LI>
+<LI>itemize リスト</LI>
+<LI>enum リスト</LI>
+<LI>descrip リスト</LI>
</UL>
-\e$B$,$"$j$^$9!#\e(B
+があります。
</CODE></BLOCKQUOTE>
-\e$B$H=PNO$9$k$K$O!"\e(B
+と出力するには、
<BLOCKQUOTE><CODE>
<PRE>
-<tt/jlinuxdoc-sgml/ \e$B$K$O\e(B
+<tt/jlinuxdoc-sgml/ には
<itemize>
-<item>itemize \e$B%j%9%H\e(B
-<item>enum \e$B%j%9%H\e(B
-<item>descrip \e$B%j%9%H\e(B
+<item>itemize リスト
+<item>enum リスト
+<item>descrip リスト
</itemize>
-\e$B$,$"$j$^$9!#\e(B
+があります。
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$N$h$&$K!"%j%9%H$N@hF,$G\e(B <itemize> \e$B$r5-=R$7!"$=$l$>$l$N9`L\$N@h\e(B
-\e$BF,$K$O\e(B <item> \e$B$rIU$1$F!":G8e$K\e(B </itemize> \e$B$r5-=R$7$^$9!#\e(B</P>
-<P>\e$BEvA3!"%M%9%H\e(B (\e$BF~$l;R\e(B) \e$B$b2DG=$G$9!#\e(B</P>
+のように、リストの先頭で <itemize> を記述し、それぞれの項目の先
+頭には <item> を付けて、最後に </itemize> を記述します。</P>
+<P>当然、ネスト (入れ子) も可能です。</P>
-<H3>enum \e$B%j%9%H\e(B</H3>
+<H3>enum リスト</H3>
-<P>enum \e$B%j%9%H$G$O!"$=$l$>$l$N9`L\$KHV9f$,IU$1$i$l$^$9!#\e(B
-\e$BNc$($P!"\e(B
+<P>enum リストでは、それぞれの項目に番号が付けられます。
+例えば、
<BLOCKQUOTE><CODE>
-<CODE>jlinuxdoc-sgml</CODE> \e$B$K$O\e(B
+<CODE>jlinuxdoc-sgml</CODE> には
<OL>
-<LI>itemize \e$B%j%9%H\e(B</LI>
-<LI>enum \e$B%j%9%H\e(B</LI>
-<LI>descrip \e$B%j%9%H\e(B</LI>
+<LI>itemize リスト</LI>
+<LI>enum リスト</LI>
+<LI>descrip リスト</LI>
</OL>
-\e$B$,$"$j$^$9!#\e(B
+があります。
</CODE></BLOCKQUOTE>
-\e$B$H=PNO$9$k$K$O!"\e(B
+と出力するには、
<BLOCKQUOTE><CODE>
<PRE>
-<tt/jlinuxdoc-sgml/ \e$B$K$O\e(B
+<tt/jlinuxdoc-sgml/ には
<enum>
-<item>itemize \e$B%j%9%H\e(B
-<item>enum \e$B%j%9%H\e(B
-<item>descrip \e$B%j%9%H\e(B
+<item>itemize リスト
+<item>enum リスト
+<item>descrip リスト
</enum>
-\e$B$,$"$j$^$9!#\e(B
+があります。
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$N$h$&$K!"%j%9%H$N@hF,$G\e(B <enum> \e$B$r5-=R$7!"$=$l$>$l$N9`L\$N@hF,$K\e(B
-\e$B$O\e(B <item> \e$B$rIU$1$F!":G8e$K\e(B </enum> \e$B$r5-=R$7$^$9!#\e(B</P>
-<P>\e$BEvA3!"%M%9%H\e(B (\e$BF~$l;R\e(B) \e$B$b2DG=$G$9!#\e(B</P>
+のように、リストの先頭で <enum> を記述し、それぞれの項目の先頭に
+は <item> を付けて、最後に </enum> を記述します。</P>
+<P>当然、ネスト (入れ子) も可能です。</P>
-<H3>descrip \e$B%j%9%H\e(B</H3>
+<H3>descrip リスト</H3>
-<P>descrip \e$B%j%9%H$G$O!"$=$l$>$l$N9`L\$K8+=P$7$,IU$1$i$l$^$9!#\e(B
-\e$BNc$($P!"\e(B
+<P>descrip リストでは、それぞれの項目に見出しが付けられます。
+例えば、
<BLOCKQUOTE><CODE>
-<CODE>jlinuxdoc-sgml</CODE> \e$B$G%5%]!<%H$5$l$F$$$k2U>r=q$-$N<oN`$O\e(B
+<CODE>jlinuxdoc-sgml</CODE> でサポートされている箇条書きの種類は
<DL>
-<DT><B>itemize</B><DD><P>\e$BF,$K!&$J$I$N5-9f$rIU$1$?2U>r=q$-$G$9!#\e(B</P>
-<DT><B>enum</B><DD><P>\e$B9`L\$KHV9f$rIU$1$?2U>r=q$-$G$9!#\e(B</P>
-<DT><B>descrip</B><DD><P>\e$B8+=P$7$rIU$1$?2U>r=q$-$G$9!#\e(B</P>
+<DT><B>itemize</B><DD><P>頭に・などの記号を付けた箇条書きです。</P>
+<DT><B>enum</B><DD><P>項目に番号を付けた箇条書きです。</P>
+<DT><B>descrip</B><DD><P>見出しを付けた箇条書きです。</P>
</DL>
-\e$B$N\e(B3\e$B<oN`$G$9!#\e(B
+の3種類です。
</CODE></BLOCKQUOTE>
-\e$B$H=PNO$9$k$K$O!"\e(B
+と出力するには、
<BLOCKQUOTE><CODE>
<PRE>
-<tt/jlinuxdoc-sgml/ \e$B$G%5%]!<%H$5$l$F$$$k2U>r=q$-$N<oN`$O\e(B
+<tt/jlinuxdoc-sgml/ でサポートされている箇条書きの種類は
<descrip>
-<tag/itemize/\e$BF,$K!&$J$I$N5-9f$rIU$1$?2U>r=q$-$G$9!#\e(B
-<tag/enum/\e$B9`L\$KHV9f$rIU$1$?2U>r=q$-$G$9!#\e(B
-<tag/descrip/\e$B8+=P$7$rIU$1$?2U>r=q$-$G$9!#\e(B
+<tag/itemize/頭に・などの記号を付けた箇条書きです。
+<tag/enum/項目に番号を付けた箇条書きです。
+<tag/descrip/見出しを付けた箇条書きです。
</descrip>
-\e$B$N\e(B3\e$B<oN`$G$9!#\e(B
+の3種類です。
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$N$h$&$K!"%j%9%H$N@hF,$G\e(B <descrip> \e$B$r5-=R$7!":G8e$K\e(B
-</descrip> \e$B$r5-=R$7$^$9!#$^$?!"$=$l$>$l$N9`L\$O\e(B <tag/\e$B8+=P$7\e(B/
-\e$BFbMF\e(B \e$B$H5-=R$7$^$9!#$J$*!"8+=P$7$NItJ,$K\e(B``/''\e$B$r4^$a$?$$>l9g$K$O!"\e(B
-<tag>\e$B8+=P$7\e(B</tag>\e$BFbMF\e(B \e$B$H5-=R$7$F2<$5$$!#\e(B</P>
-<P>\e$B$?$@$7!"\e(B<CODE>LaTeX</CODE> \e$B$r;H$&>l9g!"\e(B<EM>\e$B8+=P$7\e(B</EM>\e$B$NItJ,$K$O!"\e(B
-&bsol; \e$B$,F~NO$G$-$^$;$s$N$G!"Cm0U$7$F2<$5$$!#\e(B</P>
-<P>\e$BEvA3!"%M%9%H\e(B (\e$BF~$l;R\e(B) \e$B$b2DG=$G$9!#\e(B</P>
+のように、リストの先頭で <descrip> を記述し、最後に
+</descrip> を記述します。また、それぞれの項目は <tag/見出し/
+内容 と記述します。なお、見出しの部分に``/''を含めたい場合には、
+<tag>見出し</tag>内容 と記述して下さい。</P>
+<P>ただし、<CODE>LaTeX</CODE> を使う場合、<EM>見出し</EM>の部分には、
+&bsol; が入力できませんので、注意して下さい。</P>
+<P>当然、ネスト (入れ子) も可能です。</P>
-<H2><A NAME="CrossRef"></A> <A NAME="ss3.12">3.12 \e$BAj8_;2>H\e(B</A></H2>
+<H2><A NAME="CrossRef"></A> <A NAME="ss3.12">3.12 相互参照</A></H2>
-<P><sect?> \e$B$K$O<+F0E*$KDL$7HV9f$,IU$1$i$l$^$9$,!"$3$l$rJL$NItJ,$+$i\e(B
-\e$B;2>H$9$kJ}K!$r@bL@$7$^$9!#\e(B</P>
-<P>\e$B$^$:!";2>H$5$l$kItJ,$X$N%i%Y%kIU$1$r9T$$$^$9!#\e(B</P>
+<P><sect?> には自動的に通し番号が付けられますが、これを別の部分から
+参照する方法を説明します。</P>
+<P>まず、参照される部分へのラベル付けを行います。</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
-<sect1>\e$B35MW\e(B<label id="sec-intro">
+<sect1>概要<label id="sec-intro">
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P>\e$B$3$l$G!"%i%Y%k$,IU$1$i$l$^$7$?$N$G!"B>$N>l=j$G0J2<$N$h$&$K;2>H$9$k$3$H\e(B
-\e$B$,$G$-$k$h$&$K$J$j$^$9!#\e(B</P>
+<P>これで、ラベルが付けられましたので、他の場所で以下のように参照すること
+ができるようになります。</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
-\e$B35MW$K$D$$$F$O!"\e(B<ref id="sec-intro" name="\e$B35MW\e(B">\e$B$r;2>H$7$F2<$5$$!#\e(B
+概要については、<ref id="sec-intro" name="概要">を参照して下さい。
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P>\e$B$3$N>l9g!"\e(B<CODE>ref</CODE> \e$B%?%0$K$h$C$F!"\e(B<CODE>sec-intro</CODE> \e$B$N%;%/%7%g%sHV\e(B
-\e$B9f$KCV$-49$($i$l$^$9!#\e(B</P>
-<P>\e$B$^$?!"\e(B<CODE>name</CODE> \e$B$O\e(B <CODE>HTML</CODE> \e$B$d\e(B <CODE>nroff</CODE> \e$B$KJQ49$9$k>l9g\e(B
-\e$B$KI,MW$G$9!#\e(B</P>
-<P>\e$B$J$*!"\e(B<CODE>HTML</CODE> \e$B$KJQ49$7$?>l9g$K$O!"L>A0$NItJ,$r%/%j%C%/$9$k$3$H$K\e(B
-\e$B$h$C$F!"$=$N>l=j$K0\F0$G$-$^$9!#\e(B</P>
-<P>\e$BNc$($P!"$3$N>O$O\e(B
-<A HREF="#CrossRef">\e$BAj8_;2>H\e(B</A>\e$B$G$9!#\e(B</P>
+<P>この場合、<CODE>ref</CODE> タグによって、<CODE>sec-intro</CODE> のセクション番
+号に置き換えられます。</P>
+<P>また、<CODE>name</CODE> は <CODE>HTML</CODE> や <CODE>nroff</CODE> に変換する場合
+に必要です。</P>
+<P>なお、<CODE>HTML</CODE> に変換した場合には、名前の部分をクリックすることに
+よって、その場所に移動できます。</P>
+<P>例えば、この章は
+<A HREF="#CrossRef">相互参照</A>です。</P>
<P>
<DL>
-<DT><B>\e$B!ZN"5;![\e(B</B><DD><P>\e$B$;$C$+$/$NAj8_;2>H$b!"@a$d>O$7$+;2>H$G$-$J$$$N$G$O$A$g$C$H\e(B
-\e$B5!G=ITB-$G$9$M!#<B$O!"\e(Blabel \e$B$OG$0U$N>l=j$K@_Dj$9$k$3$H$,$G$-$k$N$G$9\e(B
-\e$B$,!"\e(BLaTeX \e$B$G$N;2>H$N:]$K@aHV9f$r;2>H$9$k$N$G!"@a$d>O$7$+;2>H$G$-$J$$\e(B
-\e$B$h$&$K$J$C$F$$$k$N$G$9!#\e(B
-\e$B$@$+$i$H$$$C$F$"$-$i$a$kI,MW$O$"$j$^$;$s!#\e(B<htmlurl> \e$B$H$$$&%?%0\e(B
-\e$B$r;H$C$F2r7h$9$k$3$H$,$G$-$^$9!#\e(B</P>
-<P>\e$B<!$N@a$N\e(B
-<A HREF="#htmlurl">htmlurl\e$B$N%?%0\e(B</A> \e$B$r;2>H$N$3$H!#\e(B</P>
+<DT><B>【裏技】</B><DD><P>せっかくの相互参照も、節や章しか参照できないのではちょっと
+機能不足ですね。実は、label は任意の場所に設定することができるのです
+が、LaTeX での参照の際に節番号を参照するので、節や章しか参照できない
+ようになっているのです。
+だからといってあきらめる必要はありません。<htmlurl> というタグ
+を使って解決することができます。</P>
+<P>次の節の
+<A HREF="#htmlurl">htmlurlのタグ</A> を参照のこと。</P>
</DL>
</P>
-<H2><A NAME="ss3.13">3.13 HTML \e$B$G$N\e(B URL \e$B$r5-=R$9$k$K$O\e(B</A></H2>
+<H2><A NAME="ss3.13">3.13 HTML での URL を記述するには</A></H2>
-<P><CODE>W3 (World Wide Web)</CODE> \e$B$G;H$o$l$k\e(B <CODE>URL (Universal Resource
-Locators)</CODE> \e$B$b5-=R$9$k$3$H$,$G$-$^$9!#\e(B</P>
-<P>Mosaic \e$BEy$G\e(B``Linux Documentation Project\e$B$N%[!<%`%Z!<%8\e(B''\e$B$H=q$+$l$F$$$k\e(B
-\e$BItJ,$r%/%j%C%/$9$k$3$H$G!"\e(B<CODE>sunsite.unc.edu</CODE> \e$B$N\e(B
-<CODE>/mdw/linux.html</CODE> \e$B%U%!%$%k$r;2>H$9$k$h$&$K$9$k$K$O0J2<$N$h$&$K\e(B
-\e$B$7$^$9!#\e(B</P>
+<P><CODE>W3 (World Wide Web)</CODE> で使われる <CODE>URL (Universal Resource
+Locators)</CODE> も記述することができます。</P>
+<P>Mosaic 等で``Linux Documentation Projectのホームページ''と書かれている
+部分をクリックすることで、<CODE>sunsite.unc.edu</CODE> の
+<CODE>/mdw/linux.html</CODE> ファイルを参照するようにするには以下のように
+します。</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
<url url="http://sunsite.unc.edu/mdw/linux.html"
- name="Linux Documentation Project\e$B$N%[!<%`%Z!<%8\e(B">
+ name="Linux Documentation Projectのホームページ">
</PRE>
</CODE></BLOCKQUOTE>
</P>
-<P><CODE>url</CODE> \e$B$N0z?t$K$O!"<B:]$N\e(B URL \e$B$r5-=R$7$^$9!#$^$?\e(B <CODE>name</CODE>
-\e$B$N0z?t$K$O\e(B URL \e$B$NL>A0$dFbMF$r5-=R$7$^$9$,!"$3$l$O%*%W%7%g%s$G$9$N$G5-\e(B
-\e$B=R$7$J$/$F$b7k9=$G$9!#\e(B</P>
-<P>\e$B$^$?!"\e(B<CODE>jf.gee.kyoto-u.ac.jp</CODE> \e$B$N\e(B
-<CODE>/pub/JF/misc/linuxdoc-sgml-1.5.tar.gz</CODE> \e$B$r\e(B ftp \e$B$7$FMh$k\e(B
-\e$B$h$&$K$9$k$K$O!"\e(B
+<P><CODE>url</CODE> の引数には、実際の URL を記述します。また <CODE>name</CODE>
+の引数には URL の名前や内容を記述しますが、これはオプションですので記
+述しなくても結構です。</P>
+<P>また、<CODE>jf.gee.kyoto-u.ac.jp</CODE> の
+<CODE>/pub/JF/misc/linuxdoc-sgml-1.5.tar.gz</CODE> を ftp して来る
+ようにするには、
<BLOCKQUOTE><CODE>
<PRE>
<url url=
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H$7$^$9!#\e(B</P>
-<P>\e$BNc$($P!"\e(B
-<A HREF="ftp://jf.gee.kyoto-u.ac.jp/pub/JF/misc/linuxdoc-sgml-1.5.tar.gz">\e$B!Z%*%j%8%J%k$N\e(BLinuxdoc-SGML v1.5\e$B$rF~<j$9$k$K$O$3$3$r%/%j%C\e(B \e$B%/$7$F2<$5$$!#![\e(B</A>
-\e$B$H$J$j$^$9!#\e(B</P>
+とします。</P>
+<P>例えば、
+<A HREF="ftp://jf.gee.kyoto-u.ac.jp/pub/JF/misc/linuxdoc-sgml-1.5.tar.gz">【オリジナルのLinuxdoc-SGML v1.5を入手するにはここをクリッ クして下さい。】</A>
+となります。</P>
<P>
<A NAME="htmlurl"></A>
-\e$B$5$i$K!"$h$j5!G=$N9b$$\e(B HTML \e$B$N\e(B URL \e$B$rI=5-$9$k$?$a$K$O\e(B
-<htmlurl url=.... > \e$B$H$$$&%?%0$r;H$$$^$9!#Nc$($P!"%a!<%k$rAw$k\e(B
-\e$B$?$a$N%"%I%l%9$r=q$/$H$-$K$O!"\e(B
+さらに、より機能の高い HTML の URL を表記するためには
+<htmlurl url=.... > というタグを使います。例えば、メールを送る
+ためのアドレスを書くときには、
<BLOCKQUOTE><CODE>
<PRE>
<htmlurl url="mailto:ono@jf.gee.kyoto-u.ac.jp"
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$N$h$&$K=q$/$3$H$K$h$j!"\e(BNetscape \e$B$J$I$N\e(B WWW \e$B%V%i%&%6>e$G%a!<%k$rAw$k\e(B
-\e$B$?$a$N%U%)!<%`$r=P$9$3$H$,$G$-$k$h$&$K$J$j$^$9!#\e(B
+のように書くことにより、Netscape などの WWW ブラウザ上でメールを送る
+ためのフォームを出すことができるようになります。
<DL>
-<DT><B>\e$BNc!'\e(B</B><DD><P>\e$B$4MQL?$N:]$O\e(B
-<A HREF="mailto:ono@jf.gee.kyoto-u.ac.jp">ono@jf.gee.kyoto-u.ac.jp</A> \e$B$^$G!#\e(B</P>
+<DT><B>例：</B><DD><P>ご用命の際は
+<A HREF="mailto:ono@jf.gee.kyoto-u.ac.jp">ono@jf.gee.kyoto-u.ac.jp</A> まで。</P>
</DL>
</P>
-<P><htmlurl> \e$B%?%0$r;H$($P0J2<$N$h$&$K$7$F!"F10lJ8=qCf$N%i%Y%k$rD>@\\e(B
-\e$B;XDj$9$k$3$H$b$G$-$^$9!#\e(B
+<P><htmlurl> タグを使えば以下のようにして、同一文書中のラベルを直接
+指定することもできます。
<BLOCKQUOTE><CODE>
<PRE>
-<htmlurl url="#CrossRef" name="\e$BAj8_;2>H$N@a\e(B"> \e$B$r;2>H$N$3$H!#\e(B
+<htmlurl url="#CrossRef" name="相互参照の節"> を参照のこと。
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>
-<A HREF="#CrossRef">\e$BAj8_;2>H$N@a\e(B</A> \e$B$r;2>H$N$3$H!#\e(B</P>
+<A HREF="#CrossRef">相互参照の節</A> を参照のこと。</P>
-<H2><A NAME="ss3.14">3.14 \e$BL\<!\e(B</A></H2>
+<H2><A NAME="ss3.14">3.14 目次</A></H2>
-<P>\e$BL\<!$r:n$k$N$O4JC1$G$9!#L\<!$r$$$l$?$$ItJ,$K\e(B
+<P>目次を作るのは簡単です。目次をいれたい部分に
<BLOCKQUOTE><CODE>
<PRE>
<toc>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$r5-=R$9$k$@$1$G$9!#BgDq$O!"\e(B</abstract> \e$B$N8e$K5-=R$5$l$k$N$,$h$$\e(B
-\e$B$G$7$g$&!#\e(B</P>
-<P>\e$B$?$@$7!"<B:]$KL\<!$,A^F~$5$l$k$N$O!"\e(B<CODE>LaTeX</CODE> \e$B$rDL$7$F:n$i$l$k\e(B
-<CODE>dvi</CODE> \e$B$H\e(B <CODE>PS</CODE> \e$B%U%!%$%k$N$_$G$9!#\e(B
-<CODE>text</CODE>\e$B%U%!%$%k$G$OC1$KL5;k$5$l$k$@$1$G$9$7!"\e(B<CODE>html</CODE>\e$B%U%!%$\e(B
-\e$B%k$G$O;XDj$7$J$/$F$b!":n@.$5$l$^$9!#\e(B</P>
+を記述するだけです。大抵は、</abstract> の後に記述されるのがよい
+でしょう。</P>
+<P>ただし、実際に目次が挿入されるのは、<CODE>LaTeX</CODE> を通して作られる
+<CODE>dvi</CODE> と <CODE>PS</CODE> ファイルのみです。
+<CODE>text</CODE>ファイルでは単に無視されるだけですし、<CODE>html</CODE>ファイ
+ルでは指定しなくても、作成されます。</P>
-<H2><A NAME="ss3.15">3.15 \e$B2#@~$r0z$/$K$O\e(B</A></H2>
+<H2><A NAME="ss3.15">3.15 横線を引くには</A></H2>
-<P>\e$BJ8=qCf$G\e(B
+<P>文書中で
<HR>
-\e$B$3$N$h$&$K2#@~$r0z$/$K$O!"\e(B
+このように横線を引くには、
<BLOCKQUOTE><CODE>
<PRE>
<hrule>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H5-=R$9$k$@$1$G$9!#\e(B</P>
+と記述するだけです。</P>
-<H2><A NAME="ss3.16">3.16 FAQ \e$B$r5-=R$9$k$K$O\e(B</A></H2>
+<H2><A NAME="ss3.16">3.16 FAQ を記述するには</A></H2>
-<P>\e$B$3$3$G$O!"\e(B<CODE>Linux \e$B%3%_%e%K%F%#\e(B</CODE>\e$B$GMxMQ$5$l$F$$$k\e(B <CODE>FAQ</CODE>\e$B%U%)!<\e(B
-\e$B%^%C%H$r5-=R$9$kJ}K!$r@bL@$7$^$9!#\e(B</P>
-<P>\e$B$?$H$($P!"\e(B
-<DL><DT><B>[Item] </B>
\e$B%=%U%HL>$d%O!<%I%&%'%"$d5,3J!&8@8l$J$I$N%-!<%o!<%I\e(B<P>
-<DT><B>[\e$BEj9F<T\e(B] </B> \e$BH/8@<T$NL>A0$H%a!<%k%"%I%l%9\e(B<BR>
-<DT><B>[\e$BF|IU\e(B] </B> \e$BH/8@$7$?F|IU\e(B<BR>
-<DT><B>[\e$B<ALd\e(B]</B>
-<DD>
\e$B<ALd$N>\:Y\e(B<P>
-<DT><B>[\e$B2sEz\e(B]</B>
-<DD>
\e$B<ALd$KBP$9$k2sEz\e(B<P>
-<DT><B>[\e$BEj9F<T\e(B] </B> \e$BH/8@<T$NL>A0$H%a!<%k%"%I%l%9\e(B<BR>
-<DT><B>[\e$B%3%a%s%H\e(B]</B>
-<DD>
\e$B<ALd$"$k$$$O2sEz$KBP$9$k%3%a%s%H\e(B(\e$B2sEz$K<+?H$,$J$$>l9g$J$I\e(B)<P>
+<P>ここでは、<CODE>Linux コミュニティ</CODE>で利用されている <CODE>FAQ</CODE>フォー
+マットを記述する方法を説明します。</P>
+<P>たとえば、
+<DL><DT><B>[Item] </B>
ソフト名やハードウェアや規格・言語などのキーワード<P>
+<DT><B>[投稿者] </B> 発言者の名前とメールアドレス<BR>
+<DT><B>[日付] </B> 発言した日付<BR>
+<DT><B>[質問]</B>
+<DT><B>[回答]</B>
+<DT><B>[投稿者] </B> 発言者の名前とメールアドレス<BR>
+<DT><B>[コメント]</B>
+<DD>
質問あるいは回答に対するコメント(回答に自身がない場合など)<P>
</DL>
-\e$B$H=PNO$7$?$$>l9g$O!"\e(B
+と出力したい場合は、
<BLOCKQUOTE><CODE>
<PRE>
<faq>
-<keyword>\e$B%=%U%HL>$d%O!<%I%&%'%"$d5,3J!&8@8l$J$I$N%-!<%o!<%I\e(B
-<poster>\e$BH/8@<T$NL>A0$H%a!<%k%"%I%l%9\e(B
-<pdate>\e$BH/8@$7$?F|IU\e(B
+<keyword>ソフト名やハードウェアや規格・言語などのキーワード
+<poster>発言者の名前とメールアドレス
+<pdate>発言した日付
<question>
+質問の詳細
</question>
<answer>
-
\e$B<ALd$KBP$9$k2sEz
\e(B
+質問に対する回答
</answer>
-<poster>\e$BH/8@<T$NL>A0$H%a!<%k%"%I%l%9\e(B
+<poster>発言者の名前とメールアドレス
<coment>
-\e$B<ALd$"$k$$$O2sEz$KBP$9$k%3%a%s%H\e(B(\e$B2sEz$K<+?H$,$J$$>l9g$J$I\e(B)
+質問あるいは回答に対するコメント(回答に自身がない場合など)
</coment>
</faq>
</PRE>
</CODE></BLOCKQUOTE>
-\e$B$H5-=R$7$^$9!#\e(B</P>
-<P><EM>\e$B!ZCm0U
OSDN Git Service
