[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Q] How to write SGML

久保田です。

debian-devel@debian.or.jp と debian-devel@lists.debian.org で
書いている、i18n についての文書を SGML にして、DDP による管理へと
移行することを考えています。

そこで、SGML で書き直す必要があり、debiandoc-sgml-doc パッケージに
含まれている SGML のマニュアルを読んでいます。

しかし、DDP に登録されているさまざまな SGML ファイルは、あきらかに、
debiandoc-sgml-doc に含まれているマニュアルに書かれている知識
だけでは書くことができません。

たとえば、たいていの SGML ファイルで、先頭は次のようになっています。
以下に示すのは、debian-policy 3.0.1.1 に含まれる、
/usr/doc/policy.sgml.gz の先頭からの抜粋です。

-------
<!doctype debiandoc system [
<!-- include version information so we don't have to hard code it
     within the document -->
<!entity % versiondata SYSTEM "version.ent"> %versiondata;
]>
<debiandoc>
-------

しかし、/usr/doc/debiandoc-sgml/debiandoc-sgml.txt.gz によると、

-------
     The first line of the document should be

          <!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN">

     or

          <!doctype debiandoc system>

     to indicate that the document is a Debiandoc-SGML file.

     The document should start with the `<book>' tag and end with
     `</book>'.
-------

とあり、これを勉強しただけでは policy.sgml.gz のような書き方はできません。

たぶん、debiandoc-sgml だけの知識では SGML は書けないのでしょうが、
なにを勉強すればいいのでしょうか。それとも、てきとうな SGML ファイル
をテンプレートにして作ってしまってもかまわないのでしょうか。

/***********************************************************
 * 久保田智広  Tomohiro KUBOTA
 * tkubota@xxxxxxxxxxx / kubota@debian.or.jp
 ***********************************************************/