<!-- $Id: sgmlnote.sgml,v 1.32 2002/11/12 11:04:15 mdk Exp $ -->

<!doctype linuxdoc system>
<article>
<title>SGML Tips for JF
<author>JF Project, (<tt>http://www.linux.or.jp/JF/</tt>) 
<date>$Date: 2002/11/12 11:04:15 $
<abstract>
この文書は JF ML で SGML を利用して文書の作成・翻訳をする際に  
覚えておくと便利なこと、注意するべきことなどをまとめたものです。 
SGML を使って文書を作成する際の基本的な約束については、 
JF にある
  <url url="http://www.linux.or.jp/JF/JFdocs/sgmlmemo.html" name="SGML Memo">
を御参照ください。
</abstract>

<toc>

<sect>SGML と DTD
<sect1>SGML について
<p>
Standard Generalized Markup Language (標準汎用マークアップ言語)
とは、文書をその構造、つまり章、節、段落など意味の上でのまとまり
(これを element、構造化要素あるいは単に要素と呼びます。
本文書ではエレメントと表記します。) を指定しながら
記述するための方法のひとつです。
(SGML には、データ交換などの用途もあります。)
<p>
厳密に言えば、SGML 自体は「文書の構造を定義する」ものではなく、
「文書の構造を定義する」ための DTD (文書型定義) を定義するための
枠組を決めたものです。つまり「SGML で文書を書く」際にはまずどの
DTD を使うのか、あらかじめ決めておかなければなりません。
<p>
DTD にはいろいろな種類があります。例えば WWW (ワールドワイドウェブ)
で利用されている HTML (この中にもいろいろな種類がありますが) も
DTD です。

<sect1>DTD について
<p>
DTD (文書型定義: Document Type Definition) というのは、SGML で文書を
記述するために利用できる「構造」を規定したものです。
<p>
例えば WWW で利用される HTML も SGML の一種であり、DTD として
HTML 3.2, HTML 4.0 Strict, HTML 4.01 Transitional などがあります。
<p>
Linux 関連の文書では LinuxDoc DTD が以前からよく利用されてきましたが、
これはもともと qwartz DTD (LaTeX 文書への変換に便利な DTD です)
をもとに、LinuxDoc-sgml ツールの開発と合わせて作成されたものです。
<p>
一方、最近では DocBook DTD を利用する例が増えてきています。
印刷関連業界でも普及してきており、また Gnome, KDE などのフリーソフトウェア
開発プロジェクトでも関連文書の作成に利用されています。
XFree86 の document でも従来は
LinuxDoc DTD に変更を加えた独自の DTD を利用していたのですが、現在
DocBook DTD への移行が企画されています。さらに LinuxDoc DTD の本家本元の
Linux Documentation Project (LDP) でも DocBook DTD
への移行が本格的に進められています。
<p>
DocBook DTD は、技術文書を SGML で作成する際の標準 DTD として
多くの人々によって普及が推進されており、また LinuxDoc DTD では
以前はサポートされていなかった図表の挿入が可能など
機能的にも優れているので、
移行はそれなりに理由のあるものと言えます。
<p>
DTD では、各エレメントの種類と、ある特定のエレメントの中に
どんなエレメントを含むことができるかということ、また、エレメントの境界
を示す「開始タグ」「終了タグ」のそれぞれについて省略可能であるか
どうかということなどを規定しています。
<p>
例えば LinuxDoc DTD では、&dquot;linuxdoc&dquot; というエレメント
(開始タグ、終了タグともに省略可能) が文書全体を表現するエレメントであり、
その中に sect、chapt、article、report、book などのエレメントを入れることが
できます。また article というエレメントの中には titlepage、header、
toc、p、sect などのエレメントを入れることができます。
<p>
エレメントの種類にはブロックエレメントとインラインエレメントがあります。
ブロックエレメントは上記の article、sect、chapt などの「意味のまとまり」
を示すエレメント、インラインエレメントはテキスト自体のように文書の内容を
示すエレメントと思っておけばよさそうです。


<sect>SGML 文書変換ツールについて
<sect1>LinuxDoc および LinuxDocTR DTD
<p>
現在 JF Project では、日本語の LinuxDoc DTD SGML 文書を
変換処理するためのツールとして、LinuxDoc-Tools を使用しています。
このツールは、Cees de Groot による SGML-Tools の最後の
LinuxDoc DTD 対応版である ver 1.0.9 をベースにしたものであり、
日本語対応のための変更などが加えられています。

<sect2>LinuxDoc-Tools
<p>
SGML-Tools の後継である SGMLtools-Lite では、LinuxDoc
DTD のサポートが廃止されてしまったので、DocBook への
移行が完了するまでの暫定措置として、新たに LinuxDoc-Tools
がリリースされることになりました。
したがって、これから LinuxDoc DTD を使って文書を作成する
場合は、LinuxDoc-Tools を使うようにしてください。
<p>
LinuxDoc-Tools については、次のサイトをご覧ください。
<p>
<url url="http://people.debian.org/~sano/linuxdoc-tools/">
<p>
JF では当初 jLinuxDoc-SGML というツールを使用していました。
その後、SGML-Tools 1.0.9 に日本語パッチを当てた SGML-Tools
1.09j というツールへと移行し、現在では LinuxDoc-Tools
が使われています。jLinuxDoc-SGML から SGML-Tools への移行時
に DTD の仕様が変更されたので、現在 &lt;hrule&gt; や &lt;faq&gt;
といった要素は使うことができません。
<p>
この上記 LinuxDoc-Tools の SRPM が <url
url="ftp://ftp.redhat.com/pub/redhat/linux/8.0/en/os/i386/SRPMS/linuxdoc-tools-0.9.20-3.src.rpm"
name="linuxdoc-tools-0.9.20-3.src.rpm"> で入手できます。
<p>
RPM パッケージを使いたい場合は、これを試してみるとよいでしょう。

<sect3>日本語コードは EUC-JP
<p>
注意点として、以前の jLinuxdoc-SGML ではオプションを指定しないでも
日本語文書が扱えましたが、SGML-Tools 1.0.9 ベースのツールや LinuxDoc-Tools
では、オプション &dquot;-l ja -c nippon &dquot;が必要になっています。
これを指定しないとちゃんと変換できません。
<p>
また扱える日本語の文字コードは EUC-JP だけです。JIS コードや Shift-JIS では
うまく処理できません。
&dquot;kcc -c&dquot;
でチェックしたり、Emacs/Mule での表示を確認しておきましょう。
特に EUC-JP コード以外で作成された既存の文書をもとに SGML 化する際などに、
うっかり忘れてしまうことがあるので、注意しましょう。
<sect3>LinuxDoc-Tools のコマンド
<p>
<itemize>
<item> 文法チェックは linuxdoc -B check -l ja -c nippon
<item> テキストへの変換は linuxdoc -B txt -l ja -c nippon -f
<item> HTML への変換は linuxdoc -B html -l ja -c nippon
</itemize>

です。なお、linuxdoc -B html では各 &lt;sect&gt; ごとに別の html ファイルに
なりますが、サイズの小さな文書では全体をひとつの html ファイルに
まとめたいという場合もあります。そのような場合には -s 0 -T 2
オプションや、sgml21html が便利でしょう。sgml21html は
<url url="http://www.linux.or.jp/JF/workshop/archives/sgml21html" 
name="JF の Web site"> から入手できます。
<p>
これらのコマンドを使う際は、例えば ``linuxdoc -B check anatano.sgml'' のように
コマンド名のあとにスペースを入れて SGML のファイル名を指定します。

<sect2>その他の LinuxDoc DTD 変換ツール
<p>
LinuxDoc DTD を使った SGML 文書の変換ツールには、LinuxDoc-Tools の他にも
doctools というソフトウェアがあります。例えば XFree86 では、FreeBSD
関連のプロジェクトで利用されてきたこの doctools を利用して
SGML 文書の変換が行なわれてきました。
doctools/XFree86 バージョン 1.1.3 以降では日本語への対応とともに、man
ページフォーマットへの対応もなされています。

<sect1>DocBook DTD
<p>
JF では、DocBook SGML を HTML に変換するためのツールとして、openjade
を使用しています。text へは html を経由して w3m で変換しています。
現時点での問題は
TeX、PS、PDF への出力で利用している jadetex が日本語対応していないために
これらのフォーマットへの出力がちゃんとできないこと、および、LDP で PS,
PDF への変換に利用されている
HTMLDOC がマルチバイトに対応していないこと、などがあります。

<sect2>DocBook のツール
<p>
html 出力には openjade を、text 出力には openjade + w3m を用います。
<p>
各ディストリビューションで用意されているパッケージでインストールすると、
環境変数などの面倒な設定をする必要がないので、とても楽です。
<p>
なお、この章内の html 出力までを行うツールに関する情報は、
<url
url="http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/index.html"
name="LDP Authors Guide">
(<url url="http://www.tldp.org/LDP/LDP-Author-Guide/index.html"
name="原文">) からの抜粋です。個々のインストールに関する詳細は、
LDP Authors Guide をご覧ください。

<sect3>DSSSL
<p>
DSSSL (Document Style Semantics and Specification Language) は、どうい
う方法で SGML 文書を印刷やオンライン用の文書にするかを openjade に指示する
ものです。たとえば、DSSSL に従って、title タグが、HTML では &lt;H1&gt; タグ
に変換され、RTF では 14 ポイントの Times Roman ボールド体に変換されます。
DSSSL に関する文書は下記の Norman Walsh DSSSL のページにあります。
DSSSL を修正することは、DocBook 自体を修正することにはならない点に注意し
てください。単にレンダリングされたテキストの見栄えを変えているにすぎません。
<p>
通常の Walsh バージョンの DSSSL である
<url url="http://docbook.sourceforge.net/projects/dsssl/"
 name="Norman Walsh DSSSL"> を、まずインストールしてください。
<p>
Red Hat でのパッケージ名は docbook-style-dsssl、Debian
でのパッケージ名は docbook-dsssl です。
<p>
次に、jf-custom.dsl を<url
 url="http://www.linux.or.jp/JF/workshop/archives/jf-custom.dsl">
より入手してください。
<p>
jf-custom.dsl を、好きなディレクトリに置いてください。
後述の説明のため /usr/local/share/sgml/stylesheets/ に置くことにします。
<p>
ツール一式をソースからインストールした場合は、
jf-custom.dsl 内に、Walsh バージョンの DSSSL
がどこにあるかを記述する必要があるかもしれません。
<p>
ファイルの先頭部分を次のように書きかえます。
(注: openjade, DocBook, DSSSL スタイルシート, iso-entities
を、ディストリビューションのパッケージでインストールした場合、
書きかえは必要ありません)
<verb>
  <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
+ <!&#045;&#045;
  <!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl>
+ &#045;&#045;>
+ <!ENTITY docbook.dsl SYSTEM "/usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl" CDATA dsssl>
  ]>
  <style-sheet>
</verb>
<p>
上記では、Walsh バージョンの DSSSL が、
/usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl にあることを
指定しています。

<sect3>DocBook DTD
<p>
文書の DTD のバージョン に合ったものを、
<url url="http://www.oasis-open.org/docbook/sgml/">
から入手します。
<p>
Red Hat では、SGML/XML の DocBook DTD 一式が docbook-dtds
パッケージにまとめられています。
<p>
Debian では、SGML は docbook パッケージ、XML は docbook-xml
パッケージです。

<sect3>ISO8879 ENTITY SGML
<p>
ISO8879 ENTITY には、特殊な記号や文字の記述方法が定義されています。
<p>
Red Hat では、sgml-common パッケージに含まれています。
<p>
ソースからインストールする場合も、この sgml-common を
利用するのが楽です。
<url url="ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/">
に、あります。
<p>
Debian でのパッケージ名は、sgml-data です。

<sect3>openjade
<p>
html への変換に使用します。
たいていのディストリビューションでは、バイナリパッケージが
用意されています。ソースからインストールする場合は、
<url url="http://download.sourceforge.net/openjade/openjade-1.3.tar.gz"
 name="openjade-1.3">
を入手します。

<sect3>w3m
<p>
テキストへの変換に使用します。
たいていのディストリビューションでは、バイナリパッケージが
用意されています。ソースからインストールする場合は、
<url url="http://w3m.sourceforge.net/"
 name="w3m"> を入手し、次のコマンドによりインストールします。
<verb>
./configure
make
make install
</verb>
./configure で重要なのは、
<verb>
Which language do you prefer?
  1 - Japanese (charset ISO-2022-JP, EUC-JP, Shift_JIS)
  2 - English (charset US_ASCII, ISO-8859-1, etc.)
[1]? 
</verb>
と、
<verb>
Input your display kanji code.
	S - Shift JIS
	E - EUC-JP
	j - JIS: ESC $@ - ESC (J
	N - JIS: ESC $B - ESC (J
	n - JIS: ESC $B - ESC (B
	m - JIS: ESC $@ - ESC (B

Which? E
</verb>
です。ブラウザ用途にしないのであれば、
<verb>
Let's do some configurations. Choose config option among the list.

1 - Baby model    (no color, no menu, no mouse, no cookie, no SSL)
2 - Little model  (color, menu, no mouse, no cookie, no SSL)
3 - Mouse model   (color, menu, mouse, no cookie, no SSL)
4 - Cookie model  (color, menu, mouse, cookie, no SSL)
5 - Monster model (with everything; you need openSSL library)
6 - Customize

Which? 1
</verb>
で baby model を選び、他の質問には、enter で構いません。

<sect3>RPM によるインストール
<p>
openjade は、<url
url="ftp://rpmfind.net/linux/redhat/8.0/en/os/i386/RedHat/RPMS/openjade-1.3.1-9.i386.rpm">にあります。
<p>
まず、次のパッケージがインストールされているか確認してください。
<itemize>
<item>sgml-common
<item>docbook-dtds
<item>docbook-style-dsssl
</itemize>
<p>
Jade Wrapper は docbook-utils パッケージに含まれています。

<sect3>変換のコマンド
<p>
openjade, DocBook, DSSSL スタイルシート, iso-entities を
ソースからインストールした場合のみ、環境変数
SGML_CATALOG_FILES を適切に設定する必要があります。
<p>
以下に一例を示します:
<verb>
export SGML_CATALOG_FILES=\
/usr/local/share/sgml/iso-entities-8879.1986/iso-entities.cat:\
/usr/local/share/sgml/docbk41/docbook.cat:\
/usr/local/share/sgml/openjade-1.3/catalog:\
/usr/local/share/sgml/docbook-dsssl-1.74b/catalog
</verb>
<p>
設定に関する詳細は、
<url
url="http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/jade.html"
name="LDP Authors Guide">
(<url url="http://www.tldp.org/LDP/LDP-Author-Guide/jade.html"
name="原文">)をご覧ください。
<p>
ディストリビューションのパッケージですべてインストールした場合、
SGML_CATALOG_FILES の設定は不要です。
<p>
分割された html 出力
<verb>
openjade -t sgml -i html \
   -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
     filename.sgml
</verb>
<p>
単一 html 出力
<verb>
openjade -t sgml -i html -V nochunks \
  -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
    filename.sgml > filename.html
</verb>
<p>
テキスト出力
<p>
事前に単一の html ファイルを作ります。上述の方法では、ulink のリンク先が
文字列として出力されないので、これを用いることはできません。
<verb>
「<ulink url="http://tldp.org/">LDP&etago;ulink> から、入手可能です。」
</verb>
と SGML ソースに書いた場合、テキスト出力は、
<verb>
「LDP から、入手可能です。」
</verb>
になってしまいます。jf-custom.dsl はこれに対応するためのオプションを持っ
ています。次のコマンドで、テキスト出力用の単一 html ファイルが作成できます。
<verb>
openjade -t sgml -i html -V nochunks -V %show-ulinks% \
  -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
    filename.sgml > filename.html
</verb>
<p>
次に作成したばかりの単一 html ファイルを用い、テキストに変換します。
<verb>
w3m -dump -T text/html -cols 72 -S filename.html > filename.txt
</verb>
<p>
前記の例で、テキスト出力は、
<verb>
「LDP <http://tldp.org/> から、入手可能です。」
</verb>
となります。
   
<sect3>docbook-utils (Jade Wrapper) の使用
<p>
docbook-utils (Jade Wrapper) を使うと、とても簡単に
HTML や text に変換できます。
<p>
入手方法
<p>
RedHat, Debian, Slackware では、パッケージが用意されています。
ソースは
<url url="ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/">
から、入手できます。
<p>
使用方法
<p>
分割された html 出力
<verb>
docbook2html -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
filename.sgml
</verb>
<p>
単一 html 出力
<verb>
docbook2html -u -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
filename.sgml
</verb>
<p>
テキスト出力
<verb>
docbook2txt -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
filename.sgml
</verb>

<sect3>PSGML
<p>
LinuxDoc 用に YaSGML を入れている場合は、モードを切り替えて使う必要
があります。
<p>
<url url="http://www.lysator.liu.se/~lenst/about_psgml/" 
> から、入手できます。
<p>
使い方は、<url
url="http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/editing.html"
name="LDP Authors Guide の編集ツール">をご覧ください。

<sect3>翻訳にあたって
<p>
翻訳者の追記方法は、以下のようにします。
<p>
原文の最初の方に
<verb>
  <author>
   <firstname>Kevin&etago;firstname>
   <surname>Taylor&etago;surname>
   <affiliation>
     <address>
      <email>kevin@northants.lug.org.uk&etago;email>
     &etago;address>
   &etago;affiliation>
  &etago;author>
</verb>
とありますので、次のように変更します。
<verb>
  <authorgroup>
   <author>
    <firstname>Kevin&etago;firstname>
    <surname>Taylor&etago;surname>
    <affiliation>
      <address>
       <email>kevin@northants.lug.org.uk&etago;email>
      &etago;address>
    &etago;affiliation>
   &etago;author>

   <othercredit role="translator" lang="ja">
    <surname>野本&etago;surname>
    <firstname>浩一&etago;firstname>
    <contrib>日本語訳&etago;contrib>
    <affiliation>
      <address>
       <email>hng@ps.ksky.ne.jp&etago;email>
      &etago;address>
    &etago;affiliation>
   &etago;othercredit>
  &etago;authorgroup>
</verb>

<sect3>日本語での著作者表記
<p>
著作者を日本語で書く方法は、以下のようにします。
<p>
<verb>
  <author lang="ja">
   <surname>野本&etago;surname>
   <firstname>浩一&etago;firstname>
   <affiliation>
     <address>
      <email>hng@ps.ksky.ne.jp&etago;email>
     &etago;address>
   &etago;affiliation>
  &etago;author>
</verb>


<sect1>DocBook XML
<p>
LDP には、DocBook XML の文書も登録されています。
冒頭の部分が以下のようなものです。

<verb>
  <?xml version="1.0"?>

  <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN">
</verb>
<sect2>DocBook XML のツール
<p>
DocBook XML を HTML や text に変換するツールには、
openjade, xmlproc, cocoon などがありますが、
現在 JF では DocBook SGML 同様に openjade を使っています。
<p>
お使いの Linux ディストリビューションに、docbook2html
コマンドなどを含む docbook-utils が用意されている場合は、
これを使うのが一番簡単です。
<p>
分割された html 出力
<verb>
docbook2html -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
filename.xml
</verb>
<p>
以下は、openjade を直接使う場合を説明します。
<p>
XML 用の DocBook が必要です。
<url url="http://www.oasis-open.org/docbook/xml/">
から、必要なバージョンのものを入手します。
<p>
Debian の場合、パッケージ名は docbook-xml です。

<sect3>変換のコマンド
<p>
openjade, DocBook, DSSSL スタイルシート, iso-entities を
ソースからインストールした場合のみ、環境変数
SGML_CATALOG_FILES を XML 向けに再設定する必要があります。
<p>
分割された html 出力
<p>
文書ファイルの直前に、必ず xml.dcl を指定する必要があります。
<verb>
openjade -t sgml -i html \
     -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
     /usr/share/sgml/xml.dcl \
     filename.sgml
</verb>


<sect>使える文字、使えない文字
<p>
もとになった情報は「日本語版 LinuxDoc-SGML ガイド」に書いてある内容を、
ほぼそのまま写したものですが、JF ML で意見を頂いたおかげで
いくつか増えています。

<sect1>コメント中の &dquot;--&dquot;
<p>
JF では多くの LDP 文書を日本語に翻訳していますが、その際、校正などに
便利なよう、原文をコメントとして訳文中に残すことが行なわれています。
ところが、SGML の仕様上コメント中に &dquot;<tt>--</tt>&dquot; を入れることはできません。
そこで原文をコメントアウトする際、 &dquot;<tt>--</tt>&dquot; を
 &dquot;<tt>&amp;&num;045;&amp;&num;045;</tt>&dquot; に変換する必要があります。
例えば

<verb>
cat original.sgml | \
perl -e 'while(&lt;&gt;) { s/--/&amp;#045;&amp;#045;/g; print; }' | \
sed -e 's/^/&lt;!-- 0 /' -e 's/$/ --&gt;/' &gt; commentout.sgml
</verb>
あるいは
<verb>
cat original.sgml | \
perl -e 'while(&lt;&gt;){s/--/&amp;#045;&amp;#045;/g;s/^\s+$/ --&gt;\n\n&lt;!-- O \n/;print;}' \
 &gt; commentout.sgml
</verb>

などのコマンドを使って、あらかじめ原文全体をコメントアウトしてから
翻訳作業にかかると良いかもしれません。

<sect1>LinuxDoc DTD で使えない文字
<p>
LinuxDoc では、以下の文字はそれぞれ右に示すように書いて下さい。
テキストや HTML へ変換する時に意図した文字に置き換えられます。
<p>
なお、LinuxDoc および LinuxDocTR では、西本さんの yasgml.el を
Emacs/Mule と組み合わせて使うと、
この「書き換え」を自動的に行なってくれます。

<descrip>
<tag>チルダ &dquot;&tilde;&dquot; (<tt>&tilde;</tt>)</tag>
→ <tt>&amp;tilde;</tt>
<tag>左角かっこ (<tt>&lsqb;</tt>)</tag>
→ <tt>&amp;lsqb;</tt>
<tag>右角かっこ (<tt>&rsqb;</tt>)</tag>
→ <tt>&amp;rsqb;</tt>
<tag>アンパサンド (<tt>&amp;</tt>)</tag>
→ <tt>&amp;amp;</tt>
<tag>左向き不等号 (<tt>&lt;</tt>)</tag>
→ <tt>&amp;lt;</tt>
<tag>右向き不等号 (<tt>&gt;</tt>)</tag>
→ <tt>&amp;gt;</tt>
<tag>左向き不等号＋スラッシュ (<tt>&etago;</tt>)</tag>
→ <tt>&amp;etago;</tt>
<tag>ドルマーク (<tt>&dollar;</tt>)</tag>
→ <tt>&amp;dollar;</tt>
<tag>シャープ (<tt>&num;</tt>)</tag>
→ <tt>&amp;num;</tt>
<tag>パーセント (<tt>&percnt;</tt>)</tag>
→ <tt>&amp;percnt;</tt>
<tag>バックスラッシュ (<tt>&bsol;</tt>)</tag>
→ <tt>&amp;bsol;</tt>
<tag>二重引用符 (<tt>&dquot;</tt>)</tag>
→ <tt>&amp;dquot;</tt>
</descrip>
<p>
「わかった」と思っても、最初は意外と見落し易いものです。
もしチェックコマンド (linuxdoc -B check) でエラーになったら、
ログの出力をしっかり見直しましょう。

<sect1>LinuxDoc DTD で使える文字
<p>
さて、「使える文字」には、普通のかな、漢字、英数字に加えて
次の記号が含まれます。

<tscreen><verb>
: ; . , ? ! ` ' ( ) - / * @ ^ _ + = { } |
</verb></tscreen>

これらについては、本文中でなら普通に使ってしまって構いません。
ただし、 &lt;author&gt; のところでメールアドレスを書くために @ を
そのまま使うとエラーになる場合があるみたいです。 (私はなりました。) 
<p>
この場合はメールアドレスを &lt;tt/user@domain/ のように
 &lt;tt/ と / で囲むと良いようです。お試し下さい。
<p>
なお、「コメント中の &dquot;--&dquot;」 の個所も参照しておいてください。

<sect1>DocBook DTD で使えない文字
<p>
DocBook の場合、使えない文字は &dquot;&lt;&dquot; と &dquot;&amp;&dquot; だけです。
<descrip>
<tag>左向き不等号 (<tt>&lt;</tt>)</tag>
→ <tt>&amp;lt;</tt>
<tag>アンパサンド (<tt>&amp;</tt>)</tag>
→ <tt>&amp;amp;</tt>
</descrip>

<sect1>LinuxDoc から DocBook への変換時の注意

<p>
LinuxDoc DTD には、独自に拡張していた SGML エンティティがあります。
これらは DocBook では使えません。次に示す変更を行うことにより、ほぼ、同等
の変換出力が行える SGML ソースになります。

<itemize>
<item>&amp;congr; → ~=
<item>&amp;dArr;  → &amp;dArr;
<item>&amp;dquot; → &amp;quot;
<item>&amp;ero;   → &amp;amp;
<item>&amp;etago; → &amp;lt;&amp;sol;
<item>&amp;hArr;  → &amp;hArr;
<item>&amp;harr;  → &amp;harr;
<item>&amp;mid;   → &amp;mid;
<item>&amp;mu;    → &amp;micro;
<item>&amp;oplus; → &amp;oplus;
<item>&amp;otimes;→ &amp;otimes;
<item>&amp;setmn; → &amp;setmn;
<item>&amp;tm     → &amp;trade;
<item>&amp;uArr;  → &amp;uArr;
<item>&amp;vDash; → &amp;vDash;
<item>&amp;vdash; → &amp;vdash;
</itemize>

上記で、&amp;setmn; &amp;vDash; &amp;vdash; の独自エンティティを同じ名
前の ISO エンティティに置きかえていますが、
<verb>
  "ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN"
  "ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN"
</verb>

などの ISO エンティティに定義されているもので、主に過去との互換性のため
に含まれているものと考えられ、実際にこれらのエンティティを利用した
LinuxDoc 文書はほとんどないでしょう。
<p>
どうしても必要な場合は Unicode を使ってそれぞれ &amp;&num;x2216;,
&amp;&num;x22A2;, &amp;&num;x22A8; とするか、あるいは特定のフォントに
依存すること、またすこし形が違うことを承知のうえで、&dquot;&bsol;&dquot;
(backslash)、&dquot;|-&dquot; (縦棒とハイフン)、 &dquot;|=&dquot; (縦棒
と等号) などで代用してください。
<p>
また、独自エンティティとして、&amp;urlnam; &amp;refnam; も定義されていま
すが、これらは実装上の都合による中間処理のためのエンティティ定義なので、
SGML ソースにこれらのエンティティを含めることは禁止されています。


<sect>LinuxDoc DTD の修飾 (タグ)
<p>
この章の記述は、LinuxDoc DTD を使った場合の修飾タグです。
DocBook DTD を使う場合は、
<url url="http://www.linux.or.jp/JF/JFdocs/docbook-intro/"
name="実用 DocBook 入門">や
<url
url="http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/index.html"
name="LDP-Author-Guide">(<url
url="http://tldp.org/LDP/LDP-Author-Guide/index.html"
name="原文">) もしくは
<url url="http://www.docbook.org/tdg/html/docbook.html"
name="DocBook Definitive Guide"> をご覧ください。
<p>
以下のようなタグを覚えておくと便利でしょう。

<sect1>&lt;url ... &gt; or &lt;htmlurl ... &gt;
<p>
HTML に変換した時に、クリックすると他の場所の URL へ
ジャンプできるようにするためのタグです。
<p>
Web ブラウザで &dquot;JF (Japanese FAQ Project)&dquot; と表示されている
部分をクリックすることで、 <tt>&lt;http://www.linux.or.jp/JF/&gt;</tt> へ
ジャンプできるようにするには

<tscreen>
<verb>
&lt;url url="http://www.linux.or.jp/JF/" 
     name="JF (Japanese FAQ Project)"&gt;
</verb>
</tscreen>

という風に書きます。
<p>
<tt>url</tt> の引数には、実際の URL を書きます。
また <tt>name</tt> の引数にはURL の名前や内容を書きます。
これはオプションなので、特に &lt;url ... &gt; タグを使う場合には
書かなくても問題無いです。
<p>
&lt;url ... &gt; と似たようなタグとして &lt;htmlurl ... &gt; が
あります。&lt;url ... &gt; と &lt;htmlurl ... &gt; の違いは、
sgml2txt を使ってテキストに変換した際に URL が出力されるかどうかです。
<p>
例えば

<itemize>
<item>&lt;url url=&dquot;http://case1.org&dquot; name=&dquot;例 1&dquot;&gt;
<item>&lt;url url=&dquot;http://case2.com&dquot;&gt;
<item>&lt;htmlurl url=&dquot;http://case3.edu&dquot; name=&dquot;例 3&dquot;&gt;
<item>&lt;htmlurl url=&dquot;http://case4.gov&dquot;&gt;
</itemize>

という SGML ソースを linuxdoc -B html にかけると HTML のソースレベルで

<itemize>
<item>&lt;a href=&dquot;http://case1.org&dquot;&gt;例1&etago;a&gt;
<item>&lt;a href=&dquot;http://case2.com&dquot;&gt;http://case2.com&etago;a&gt;
<item>&lt;a href=&dquot;http://case3.edu&dquot;&gt;例 3&etago;a&gt;
<item>&lt;a href=&dquot;http://case4.gov&dquot;&gt;&etago;a&gt;
</itemize>

に変換されます。一方 linuxdoc -B txt にかけると

<itemize>
<item>例 1 &lt;http://case1.org&gt;
<item>&lt;http://case2.com&gt;
<item>例 3
<item>(何も出力されない)
</itemize>

のようになります。4 番目の例のような出力は、通常は誰も期待しない
でしょうから、 &lt;htmlurl ... &gt; タグを使う場合は name= で
表示する文字列を指定してやる必要があります。
<p>
結局、Web 経由でアクセスできる文書などのように、テキスト中に URI を
示す必要がある場合には、&lt;url ...&gt; を使うほうが適切でしょう。
&lt;htmlurl ...&gt; のほうが適しているのは、メールアドレスを 
&lt;mailto:&gt; リンクしたり、ニュース記事 or ニュースグループを
&lt;news:&gt; リンクしたりするような場合、と言えます。

<sect1>&lt;itemize&gt; と &etago;itemize&gt;
<p>
箇条書きで使います。

例えば
<tscreen>
<tt/SGML (LinuxDoc)/ での箇条書きは
<itemize>
<item>項目 1
<item>項目 2
<item>項目 3
</itemize>
こんな風になります。
</tscreen>
と出力したい場合は
<tscreen><verb>
&lt;tt/SGML (LinuxDoc)/ での箇条書きは
&lt;itemize&gt;
&lt;item&gt;項目 1
&lt;item&gt;項目 2
&lt;item&gt;項目 3
&etago;itemize&gt;
こんな風になります。
</verb></tscreen>
のように、リストの先頭に <tt>&lt;itemize&gt;</tt> を置き、
それぞれの項目の先頭に <tt>&lt;item&gt;</tt> を付けて、
最後に <tt>&etago;itemize&gt;</tt> で締めます。
<p>
箇条書き用には、他にも「見出しを付けた箇条書」のための

<tscreen>
<verb>
&lt;descrip&gt;
&lt;tag&gt;見出し&etago;tag&gt;内容
&etago;descrip&gt;
</verb>
</tscreen>

や、「項目に番号を付けた箇条書」のための

<tscreen>
<verb>
&lt;enum&gt;
&lt;item&gt;ここに項目を書くと、それぞれの項目に番号がつく
&etago;enum&gt;
</verb>
</tscreen>

などがあります。
<p>
これらについては、「日本語版 Linuxdoc-SGML ガイド」の SGML 原稿
ファイルである jguide.sgml を JF の Web site から取得して
じっくり調べてみると、いろいろ参考になるでしょう。


<sect1>&lt;verb&gt; と &etago;verb&gt;
<p>
入力した文章を整形せずにそのまま出力されるためのタグです。
この 2 つのタグで囲まれた部分はそのまま出力されます。
ただし、 &amp; と &etago; はこれでも使えませんので、それぞれ

<itemize>
<item>アンパサンド (<tt>&amp;</tt>) → <tt>&amp;ero;</tt>
<item>左向き不等号＋スラッシュ (<tt>&etago;</tt>) → <tt>&amp;etago;</tt>
</itemize>

を使って下さい。

<sect1>&lt;sect1&gt;
<p>
&lt;sect&gt; の下をさらに分割する際に使います。
「節 (セクション)」の下の「小節 (サブセクション)」に
相当するものです。
<p>
ちなみに、 &lt;sect&gt; から &lt;sect4&gt; まで 5 段階の分割レベルが
用意されています。本文の前に &lt;p&gt; が必要なのはどの分割レベルでも
同じです。

<sect1>&lt;newline&gt;
<p>
強制的に改行させる場合に使います。使い過ぎに注意しましょう。

<sect1>&lt;label id=...&gt;
<p>
主に &lt;sect&gt;,&lt;sect1&gt; などの段落分けの見出し部分に
追加する、「相互参照」のためのタグです。これを &lt;ref id=...&gt; と
組み合わせることで、参照先のセクション番号を自動的に計算して
置き換える、といったことができます。HTML への変換では、これによって
該当個所へのリンクも設定されるようです。(未確認)
<p>
なお、HTML への変換では &lt;htmlurl&gt; のタグを使って相互参照を
実現することも可能です。これらについても詳細は「
<url url="http://www.linux.or.jp/JF/workshop/sgml-jguide/jguide.html" name="日本語版 LinuxDoc-SGML ガイド">
」を見てください。

<sect>LinuxDoc DTD での画像の挿入と表組み
<p>
LinuxDoc においても画像や表を文書に組み込むことができます。
どうしても必要な場合にお使いください。

<sect1>画像の挿入
<p>
画像を挿入したい場合は、&lt;figure&gt; が使えます。

<tscreen>
<verb>
&lt;figure&gt;
&lt;ph vspace="0"&gt;
&lt;img src="ファイル名"&gt;
&lt;/figure&gt;
</verb>
</tscreen>

上記設定を使うと、HTML 変換の場合は画像が挿入され、テキスト変換の場合は
なにも表示されません。テキスト変換の際に代替テキストを表示させたい場合は、
次のようにしてください。

<tscreen>
<verb>
&lt;&num;if output="html"&gt;
&lt;figure&gt;
&lt;ph vspace="0"&gt;
&lt;img src="ファイル名"&gt;
&lt;/figure&gt;
&lt;/&num;if&gt;
&lt;&num;unless output="html"&gt;
代替テキスト
&lt;/&num;if&gt;
</verb>
</tscreen>

実例は、<url 
url="http://www.linux.or.jp/JF/JFdocs/The-Linux-Kernel-2.html" 
name="The-Linux-Kernel"> をご覧ください。

<sect1>表組み
<p>
表組みには、&lt;table&gt; タグが利用できます。以下はその一例です。

<tscreen>
<verb>
&lt;&num;if output="html"&gt;
&lt;table loc="tbp"&gt;
&lt;tabular ca="ccc"&gt;
列1 | 列2 | 列3 @
内容1 | 内容2 | 内容3 @
&lt;/tabular&gt;
&lt;/table&gt;
&lt;/&num;if&gt;

&lt;&num;unless output="html"&gt;
&lt;descrip&gt;
&lt;tag&gt;列1&lt;/tag&gt;内容1
&lt;tag&gt;列2&lt;/tag&gt;内容2
&lt;tag&gt;列3&lt;/tag&gt;内容3
&lt;/descrip&gt;
&lt;/&num;if&gt;
</verb>
</tscreen>

表はテキスト変換時にエラーとなるので、必ず出力を分けて利用して
ください。

実例は、<url url="http://www.linux.or.jp/JF/JFdocs/ISAPnP-HOWTO-3.html" 
name="ISAPnP-HOWTO"> をご覧ください。


<sect>参考文献など
<p>

<sect1>FAQ およびガイド
<p>
もし LinuxDoc SGML についてもっと詳しく知りたければ、
まずは jLinuxDoc-SGML のソースに含まれている FAQj と jguide を
読むことをお勧めします。
この 2 つの文書はテキスト型式 (.txt) のものと SGML 型式 (.sgml) のものが
両方用意されているので、テキストを見ながら SGML を参照すると
いろいろと書き方の参考になります。
ただし、これらの中で説明されているタグの中には、LinuxDoc-Tools では
使えないものがあることに注意してください。
<p>
現在、これらのファイルは JF の Web ページから
<p>
<descrip>
<tag>日本語版 LinuxDoc-SGML に関するＱ＆Ａ</tag>

<itemize>
<item> <url url="http://www.linux.or.jp/JF/workshop/linuxdoc-sgml/FAQj.html"
   name="(HTML 版)"> 
<item> <url url="http://www.linux.or.jp/JF/workshop/linuxdoc-sgml/FAQj.txt"
   name="(テキスト版)"> 
<item> <url url="http://www.linux.or.jp/JF/workshop/linuxdoc-sgml/FAQj.sgml"
   name="(SGML 版)"> 
</itemize>

<tag>日本語版 LinuxDoc-SGML ガイド</tag>

<itemize>
<item> <url url="http://www.linux.or.jp/JF/workshop/sgml-jguide/jguide.html"
   name="(HTML 版)"> 
<item> <url url="http://www.linux.or.jp/JF/workshop/sgml-jguide/jguide.txt"
   name="(テキスト版)"> 
<item> <url url="http://www.linux.or.jp/JF/workshop/sgml-jguide/jguide.sgml"
   name="(SGML 版)"> 
</itemize>

</descrip>

として読むことができます。

<sect1>SGML 一般について
<p>
LinuxDoc-SGML ではなく、SGML 一般については、
上記の JF のページ
 <url url="http://www.linux.or.jp/JF/workshop/guidance-sgml.html"
   name="JF Workshop Guidance: SGML 文書作成"> 
の中の
 <url url="http://www.linux.or.jp/JF/workshop/guidance-sgml.html#sgml-links"
   name="SGML 参考リンク集">
を見ると参考になるでしょう。

<sect1>HTML について
<p>
SGML そのものについてではありませんが、linuxdoc -B html での出力について
検討する際など HTML についての知識が必要になる場合もあるかも
しれませんので、JF ml で教えて頂いた参考資料を記載しておきます。

<descrip>
<tag>矢野啓介さん 好ましい文書を書くための方法と考え方</tag>
  <url url="http://www.asahi-net.or.jp/~wq6k-yn/konomac.html">
<tag>矢野啓介さん HTMLのDTDを読んでみよう</tag>
  <url url="http://www.asahi-net.or.jp/~wq6k-yn/readdtd.html">
<tag>神崎 正英 さんの ごく簡単なHTMLの説明</tag>
  <url url="http://kanzaki.com/docs/htminfo.html">
<tag>オンライン・ハイパーテキストのためのスタイルガイド</tag>
  <url url="http://kanzaki.com/docs/Style/index.html">
</descrip>

<sect1>便利なツール
<p>
また、上記の JF のページには
「LinuxDoc SGML 文書作成を支援するツール」として
<p>
<url url="http://www.linux.or.jp/JF/workshop/archives/yasgml_1.5-5.tar.gz"
   name="yasgml.el">
<p>
も紹介されています。これ、私も最近多用していますが、非常に便利です。
まだ使ったことが無ければ、是非一度試してみることをお勧めします。
<p>
特にまだ LinuxDoc SGML での文書作成に慣れていない人にとっては、
メニューから &lt;sect&gt; などの挿入を選択できる機能が
とてもありがたいです。&tilde; などの「使えない記号」は自動的に
変換して入力してくれます。
<p>
なお、Debian の安定版である woody には yasgml のパッケージが
含まれています。Debian ユーザーの方は、こちらをインストールすると
便利でしょう。

<sect1>DocBook DTD, jade
<p>
Debian のメンバーである Stephane Bortzmeyer
 &lt;bortzmeyer@pasteur.fr&gt; が
<descrip>
<tag>The Debian SGML/XML HOWTO</tag>
   <url url="http://www.debian.org/~bortz/SGML-HOWTO/">
</descrip>
という文書を書いて公開しています。Debian/Debian JP メンバーの
武藤さんが翻訳してくださった日本語版もあります。
<descrip>
<tag>日本語版 The Debian SGML/XML HOWTO</tag>
   <url url="http://www.topstudio.co.jp/~kmuto/debian/Debian-HOWTO/potato/">
</descrip>

<p>

特に

<p>
<descrip>
<tag>あなたが実際に SGML について知る必要があること</tag>
   <url url="http://www.topstudio.co.jp/~kmuto/debian/Debian-HOWTO/potato/x67.html">
<tag>DocBook でドキュメントを作成</tag>
   <url url="http://www.topstudio.co.jp/~kmuto/debian/Debian-HOWTO/potato/x174.html">
<tag>LinuxDoc によるドキュメントの作成</tag>
   <url url="http://www.topstudio.co.jp/~kmuto/debian/Debian-HOWTO/potato/x268.html">
<tag>参照</tag>
   <url url="http://www.topstudio.co.jp/~kmuto/debian/Debian-HOWTO/potato/x406.html">
</descrip>
<p>

といったあたりは結構参考になりそうなので、読んでおくと
ためになるかもしれません。なお最後の References には

<descrip>
<tag>SGML CD, Bob DuCHARME, Edited by Prentice-Hall, 0-13-475740-8</tag>
   <url url="http://www.snee.com/bob/sgmlfree/">
<tag>DocBook: The Definitive Guide, Norman Walsh, Leonard Muellner, Edited by O'Reilly, 1-56592-580-7</tag>
   <url url="http://www.docbook.org/">
</descrip>

が紹介されていました。前者は &dquot;A very good and practical book 
about the tools needed to write and process SGML on Unix and Windows NT. 
Does not cover XML. A very good chapter about Emacs' SGML mode, psgml 
and a nice page of PSGML tricks.&dquot; また後者は
&dquot;I didn't read it yet. The entire book is also online.&dquot; と
コメントされています。

<p>
また、以前 debian-sgml@lists.debian.org ML で教えてもらったのですが、
以下の場所に DocBook DTD の解説などがあるようです。

<descrip>
<tag>The DocBook DTD</tag>
   <url url="http://www.oasis-open.org/docbook/">
<tag>DocBook intro</tag>
   <url url="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html">
<tag>Nik Clayton, FreeBSD Documentation Project Primer for New Contributors</tag>
   <url url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/fdp-primer/">
<tag>John Shipman, How to write documentation with DocBook 4.1</tag>
   <url url="http://www.nmt.edu/tcc/help/pubs/docbook/">
<!--
<tag>John Fieber, DocBook Resources</tag>
   <url url="http://fallout.campusview.indiana.edu/~jfieber/docbook/">
-->
</descrip>

<p>
あと、 SGMLtools v2 の

<code>
 sgmltools -b ld2db
</code>

を実行すると、LinuxDoc DTD な SGML 文書を DocBook DTD に変換してくれる
らしいです。ただしまだ完全ではないので、変換後の修正は必要だとのこと。
 SGMLtools v2 と SGML-Tools v1 を両方使える環境の人は、試してみると
良いでしょう。

 (すくなくとも Debian potato では SGML-Tools パッケージと SGMLtools-2 
パッケージ、それに jade が共存できるように作成されています。)


<sect>おわりに
<p>
この文書は JF 全体の共有財産として育てていきたいので、
JF プロジェクトに参加して committer に登録された方は
JF の CVS レポジトリにあるオリジナルの文書を自由に改変して
くださって結構です。その際は最後の &dquot;CREDITS&dquot; の
ところに名前と変更個所を追記しておいてください。
<p>
この文書は LTGP 用に書いた SGML Memo に対して、JF ML でいろいろと
内容追加を要望してくださった川岸さんの御意見にヒントを得て、
「JF 文書作成用」のレファレンスとして使ってもらいたいという希望のもとで、
作成したものです。
<p>
文書の内容は「日本語版 LinuxDoc-SGML ガイド」から頂いてきたものを
中心に、JF ML で頂いた多くの有益なヒントをまとめたものです。
いろいろと有益な情報をくださった JF 参加者のみなさんに感謝します。

<sect1>この文書の配布について
<p>
<verb>
 Copyright (c) 1999 Taketoshi Sano
 Copyright (c) 2002 JF Project
</verb>
<p>
この文書は GNU General Public License (GPL) バージョン 2 かそれ以降
の条件、あるいは標準的な Linux ドキュメントプロジェクト (LDP) の条件に
基づいた配布ならば自由にしていただいてかまいません。これらのライセンス
はこのドキュメントが入手できるようなサイトから入手できます。LDP の条件は
(翻訳をのぞく) いかなる修正も許可していません。修正されたバージョンは
GPL の基でのみ配布されるものとすることが可能です。

<sect1>CREDITS
<p>
<itemize>
<item>佐野武俊 (<tt>kgh12351@nifty.ne.jp</tt>) : 最初の雛型を作成
<item>千旦裕司 (<tt>ysenda@pop01.odn.ne.jp</tt>) : 画像と表組を追加
<item>野本浩一 (<tt>hng@ps.ksky.ne.jp</tt>) : DocBook のツールを追加
<item>小林雅典 (<tt>zap03216@nifty.ne.jp</tt>) : 現状にあわせて更新
</itemize>


</article>

<!--
Revision 1.32  2001/05/09 19:00:00 h.nomoto
added ulink of DocBook for text

Revision 1.31  2001/04/16 17:00:00 h.nomoto
added notes of DocBook

Revision 1.3  2001/03/12 17:30:00 h.nomoto
added tools of DocBook

$Log: sgmlnote.sgml,v $
Revision 1.32  2002/11/12 11:04:15  mdk
	* sgmlnote.sgml: fix some url markups.

Revision 1.31  2002/11/08 11:51:38  mdk
	* sgmlnote.sgml: fix dead links.

Revision 1.30  2002/10/23 11:14:46  mdk
	* docs/sgmlnote/sgmlnote.sgml: totally updated.

Revision 1.29  2002/01/09 16:25:06  takes
change ">" into &gt;

Revision 1.28  2001/12/06 12:39:17  nakano
repl < with &lt;

Revision 1.27  2001/05/09 12:16:00  cnakatani
message

Revision 1.26  2001/03/05 16:33:10  senda
fixed a typo, yuji senda

Revision 1.25  2001/03/05 13:30:45  senda
画像と表組みについての記述を追加, yuji senda

Revision 1.24  2000/11/18 18:54:53  takes
docs/sgmlnote/sgmlnote.sgml: fix a markup typo in sample perl script

Revision 1.23  2000/07/25 01:17:26  takes
apply patch from SEI Hideki <seih@dig-it-all.net>. Thanks to him!

Revision 1.22  2000/07/03 08:09:43  takes
replace ">" in <verb> with &gt; because weblint warns about the output.

Revision 1.21  2000/06/30 09:39:50  takes
 * docs/sgmlnote/sgmlnote.sgml: update (jf.linux.or.jp ->
 * docs/sgmlmemo/sgmlmemo.sgml: www.linux.or.jp/JF/) based
   on kamo-san's advice. Thanks.

Revision 1.20  2000/06/30 02:35:54  takes
update for the recent LinuxDoc-Tools upload (the archive name is changed!)

Revision 1.19  2000/06/28 23:45:39  takes
docs/sgmlnote/sgmlnote.sgml: update for LinuxDoc-Tools, and add some
explanation for bug in jf7 patch.

Revision 1.18  2000/05/24 08:58:02  takes
fix the bug in sample perl script, and added another sample.

Revision 1.17  2000/05/07 15:21:47  takes
add description of SGML and DTD, and update some part.

Revision 1.16  2000/02/13 06:57:08  fujiwara
fixed an errata about ISO standard.

Revision 1.15  2000/01/26 03:53:37  takes
change <itemize> to <descrip> in order to use <tag>
 (hope this makes better appearance)

Revision 1.14  2000/01/24 17:34:47  fujiwara
fixed a typo

Revision 1.13  2000/01/11 15:26:28  takes
update to use diff.sgml-tools.jf6.gz

Revision 1.12  2000/01/07 14:24:21  takes
update the note for the updated JF patch for SGML-Tools 1.0.9

Revision 1.11  1999/12/16 08:47:45  takes
update the URI of new patch for SGML-Tools 1.0.9

Revision 1.10  1999/12/15 07:22:47  takes
debiantips.sgml: update SGML-Tools and patches description
sgmlmemo.sgml, sgmlnote.sgml: update SGML-Tools related,
and new URI for yasgml.el (yasgml.tar.gz)
workshop/guidance-sgml.m4: update URI for yasgml.el

Revision 1.9  1999/11/10 14:38:38  takes
update <utl ...> & <htmlurl ...> related description, and
add some references for HTML

Revision 1.8  1999/10/21 15:21:32  takes
SGMLnote: add reference to "The Debian SGML/XML HOWTO"

Revision 1.7  1999/09/12 14:04:57  takes
www/index.m4: added some description for JF's work
www/links.m4: added link to "The previous JF page"
docs/sgmlnote/sgmlnote.sgml: added some information for DocBook DTD

Revision 1.6  1999/08/27 15:57:50  fuku
correct a tag

Revision 1.5  1999/08/27 02:18:22  takes
add reference for DocBook DTD

Revision 1.4  1999/08/25 18:19:03  takes
update

Revision 1.3  1999/08/24 15:45:35  takes
update description for SGML-Ttools, and fix some typo.

Revision 1.2  1999/08/20 14:33:32  takes
1st release of SGML Note

Revision 1.1  1999/08/01 07:31:41  takes
SGML Note - 1.1 : SGML reference for JF work

Revision 1.3  1999/05/25 19:01:07  sano
add package info on Vine Linux 1.0 for jLinuxDoc-SGML

Revision 1.3  1999/05/24 12:05:53  sano
add description about debian package of yasgml.el

-->
