Debian Codegraph @

tests/docbook/dtd/simple/4.1.2.4/README

raw
1 README for the Simplified DocBook XML V4.1.2.4 DTD
2
3 This is a simplified version of the DocBook XML V4.1.2 DTD. This
4 DTD is my attempt to make a small subset of DocBook. I tried to
5 achieve 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
28 Instead of DocBook's 350+ elements, this DTD has just over 100.
29
30 Manifest
31 --------
32
33 README - This readme file
34 VERSION - The version number
35 COPYRIGHT - Copyright statement
36 ChangeLog - Changelog
37 sdbcent.mod - Character entities
38 sdbhier.mod - Hierarchy overrides
39 sdbpool.mod - Information pool overrides
40 sdocbook-custom.dtd - The DTD
41 sdocbook.css - CSS stylesheet
42 sdocbook.dtd - A flattened version of the DTD (mechanically generated)
43 sinclist.mod - A set of 'ignore' parameter entities
44 sdocbookref-custom.dtd - A version of Simplified DocBook for RefEntrys
45 sdocbookref.dtd - A flattened version of sdocbookref-custom (mech. generated)
46 test.xml - A test document
47 testcss.xml - A test document for the CSS stylesheet
48 testcust.xml - A test document for the raw customization layer
49 testrefcust.xml - A test document for the raw RefEntry customization layer
50 ent/ - The ISO character entity files used by sdocbook.dtd
51
52 Installation
53 ------------
54
55 Place the files in this distribution somewhere on your machine. Adjust
56 your catalog(s) if appropriate (XML tools frequently do not support
57 catalogs, so this may be irrelevant for you).
58
59 Please use the following formal public identifier to identify this DTD:
60
61 "-//Norman Walsh//DTD Simplified DocBook XML V4.1.2.4//EN"
62
63 For example, if your document's top-level element is <article>, and
64 you are using this DTD directly, use the FPI in the DOCTYPE
65 declaration:
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
74 Note: if you are using the customization layer directly (sdocbook-custom.dtd),
75 you may have to adjust the system identifier that points to the DocBook XML
76 DTD. You may also have to install the DocBook XML V4.1.2.4 DTD somewhere on
77 your system.
78
79
80 Copyright
81 ---------
82
83 Copyright (C) 1999, 2000 Norman Walsh
84
85 See COPYRIGHT for more information
86
87
88 Warranty
89 --------
90
91 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
92 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
93 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
94 NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER
95 CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
96 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
97 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
98 OTHER DEALINGS IN THE SOFTWARE.
99
100
101 Contacting the Author
102 ---------------------
103
104 This DTD is maintained by Norman Walsh, <[email protected]>.
105
106 The best way to reach norm is by email. You will find additional
107 contact information at http://nwalsh.com/docbook/simple/