| 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/ |