1README for the Simplified DocBk XML V3.1.7.1 DTD 2 3This is a simplified version of the DocBk XML V3.1.3 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 DocBk 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 DocBk 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 fewer than 100. 29 30 31Manifest 32-------- 33 34README - This readme file 35VERSION - The version number 36COPYRIGHT - Copyright statement 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 44test.xml - A test document 45testcss.xml - A test document for the CSS stylesheet 46testcust.xml - A test document for the raw customization layer 47ent/ - The ISO character entity files used by sdocbook.dtd 48 49 50Installation 51------------ 52 53Place the files in this distribution somewhere on your machine. Adjust 54your catalog(s) if appropriate (XML tools frequently do not support 55catalogs, so this may be irrelevant for you). 56 57Please use the following formal public identifier to identify this DTD: 58 59 "-//Norman Walsh//DTD Simplified DocBk XML V3.1.7.1//EN" 60 61For example, if your document's top-level element is <article>, and 62you are using this DTD directly, use the FPI in the DOCTYPE 63declaration: 64 65<!DOCTYPE article 66 PUBLIC "-//Norman Walsh//DTD Simplified DocBk XML V3.1.7.1//EN" 67 "/system/identifier/on/your/system/sdocbook.dtd" [ 68... 69]> 70 71 72Note: if you are using the customization layer directly (sdocbook-custom.dtd), 73you may have to adjust the system identifier that points to the DocBk XML 74DTD. You will also have to install the DocBk XML V3.1.3 DTD somewhere on 75your system. 76 77 78Copyright 79--------- 80 81Copyright (C) 1998, 1999 Norman Walsh 82 83See COPYRIGHT for more information 84 85 86Warranty 87-------- 88 89THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 90EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 91OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 92NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER 93CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 94WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 95FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 96OTHER DEALINGS IN THE SOFTWARE. 97 98 99Contacting the Author 100--------------------- 101 102This DTD is maintained by Norman Walsh, <ndw@nwalsh.com>. 103 104The best way to reach norm is by email. You will find additional 105contact information at http://nwalsh.com/docbook/simple/ 106