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