docbook-simple for Debian
-----------------------------
The Simplified DocBook XML DTD is a small subset of the DocBook XML DTD
having only ~100 elements. The full version has >350 elements.
Online documentation of the content models for this dtd is here:
http://www.oasis-open.org/docbook/xml/simple/
This DTD only supports simple documents, e.g. 'article' or 'refentry', rather
than the more complex documents like 'book' or 'set' which is supported by the
full docbook DTD.
I. How to write an article that uses the Simplified Docbook DTDs:
==================================================================
Use one of the following two prologs in your XML file to use
the Simplified DocBook Document Type in your document prolog:
EITHER --------------------------------------------------------------
...
OR ------------------------------------------------------------------
if you wish to customize the Simplified DocBook DTD...
...
II. How to write a manual page that uses the Simplified DocBook DTDs:
======================================================================
The sdocbookref.dtd (and sdocbookref-custom.dtd) provide a simplified subset
of DocBook to support writing manual pages.
Use one of the following two prologs in your XML file to use
the Simplified DocBook Document Type in your document prolog:
EITHER --------------------------------------------------------------
...
OR ------------------------------------------------------------------
if wish to customize the Simplified Refentry DTD...
...
III. How to validate a document that uses the Simplified Docbook DTD:
======================================================================
If you have the libxml2 package installed, then you can use the
command 'xmllint' to validate a document.
The following is the contents of a file named "simple.xml":
This is a test.
Then this document can be validated using:
SGML_CATALOG_FILES=/etc/sgml/catalog xmllint --valid --catalogs simple.xml
See also the Makefile and examples in /usr/share/doc/docbook-simple/examples/.
Acknowledgement: This is revision of an extensive README originally written by
Susan Kleinmann . The revision was written by
Mark Johnson and edited by Daniel Leidert.
-- Daniel Leidert , Sun, 15 Apr 2007 02:01:35 +0200