1README for the Simplified DocBook XML V4.1.2.4 DTD 2 3This is a simplified version of the DocBook XML V4.1.2 DTD. This 4DTD is my attempt to make a small subset of DocBook. I tried to 5achieve the following goals: 6 7 * Documents written in the subset must be 100% legal DocBook XML 8 documents. 9 10 * This is for small documents, articles and the like, so 11 there's no need for 'book's or 'set's, just 'article's. 12 13 * The markup should be the smallest practical subset, if you 14 need richly structured markup, use DocBook or DocBook XML. 15 16 * The result is roughly "HTML-level markup in DocBook", but I 17 didn't set out explicitly to produce that result. 18 19 * The DTD must work in IE5 (it's XML not SGML). It should be 20 small enough to download more-or-less painlessly. 21 22 * There should be a CSS stylesheet for it (mine's pretty lame). 23 24 * There should be an XSL stylesheet for it. Since I'm in the 25 somewhat privileged position of knowing how many changes are 26 coming, I'm going to wait until after the next draft ;-). 27 28Instead of DocBook's 350+ elements, this DTD has just over 100. 29 30Manifest 31-------- 32 33README - This readme file 34VERSION - The version number 35COPYRIGHT - Copyright statement 36ChangeLog - Changelog 37sdbcent.mod - Character entities 38sdbhier.mod - Hierarchy overrides 39sdbpool.mod - Information pool overrides 40sdocbook-custom.dtd - The DTD 41sdocbook.css - CSS stylesheet 42sdocbook.dtd - A flattened version of the DTD (mechanically generated) 43sinclist.mod - A set of 'ignore' parameter entities 44sdocbookref-custom.dtd - A version of Simplified DocBook for RefEntrys 45sdocbookref.dtd - A flattened version of sdocbookref-custom (mech. generated) 46test.xml - A test document 47testcss.xml - A test document for the CSS stylesheet 48testcust.xml - A test document for the raw customization layer 49testrefcust.xml - A test document for the raw RefEntry customization layer 50ent/ - The ISO character entity files used by sdocbook.dtd 51 52Installation 53------------ 54 55Place the files in this distribution somewhere on your machine. Adjust 56your catalog(s) if appropriate (XML tools frequently do not support 57catalogs, so this may be irrelevant for you). 58 59Please use the following formal public identifier to identify this DTD: 60 61 "-//Norman Walsh//DTD Simplified DocBook XML V4.1.2.4//EN" 62 63For example, if your document's top-level element is <article>, and 64you are using this DTD directly, use the FPI in the DOCTYPE 65declaration: 66 67<!DOCTYPE article 68 PUBLIC "-//Norman Walsh//DTD Simplified DocBook XML V4.1.2.4//EN" 69 "http://nwalsh.com/docbook/simple/4.1.2.4/sdocbook.dtd" [ 70... 71]> 72 73 74Note: if you are using the customization layer directly (sdocbook-custom.dtd), 75you may have to adjust the system identifier that points to the DocBook XML 76DTD. You may also have to install the DocBook XML V4.1.2.4 DTD somewhere on 77your system. 78 79 80Copyright 81--------- 82 83Copyright (C) 1999, 2000 Norman Walsh 84 85See COPYRIGHT for more information 86 87 88Warranty 89-------- 90 91THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 92EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 93OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 94NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER 95CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 96WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 97FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 98OTHER DEALINGS IN THE SOFTWARE. 99 100 101Contacting the Author 102--------------------- 103 104This DTD is maintained by Norman Walsh, <ndw@nwalsh.com>. 105 106The best way to reach norm is by email. You will find additional 107contact information at http://nwalsh.com/docbook/simple/ 108