Alessandro Bonazzi
8c43d5cf2f
Files correlati : cg0.exe cg0700a.msk cg0700b.msk cg3.exe cg4.exe Bug : Commento: Merge 1.0 libraries
108 lines
3.6 KiB
Plaintext
108 lines
3.6 KiB
Plaintext
README for the Simplified DocBook XML V4.1.2.4 DTD
|
|
|
|
This is a simplified version of the DocBook XML V4.1.2 DTD. This
|
|
DTD is my attempt to make a small subset of DocBook. I tried to
|
|
achieve the following goals:
|
|
|
|
* Documents written in the subset must be 100% legal DocBook XML
|
|
documents.
|
|
|
|
* This is for small documents, articles and the like, so
|
|
there's no need for 'book's or 'set's, just 'article's.
|
|
|
|
* The markup should be the smallest practical subset, if you
|
|
need richly structured markup, use DocBook or DocBook XML.
|
|
|
|
* The result is roughly "HTML-level markup in DocBook", but I
|
|
didn't set out explicitly to produce that result.
|
|
|
|
* The DTD must work in IE5 (it's XML not SGML). It should be
|
|
small enough to download more-or-less painlessly.
|
|
|
|
* There should be a CSS stylesheet for it (mine's pretty lame).
|
|
|
|
* There should be an XSL stylesheet for it. Since I'm in the
|
|
somewhat privileged position of knowing how many changes are
|
|
coming, I'm going to wait until after the next draft ;-).
|
|
|
|
Instead of DocBook's 350+ elements, this DTD has just over 100.
|
|
|
|
Manifest
|
|
--------
|
|
|
|
README - This readme file
|
|
VERSION - The version number
|
|
COPYRIGHT - Copyright statement
|
|
ChangeLog - Changelog
|
|
sdbcent.mod - Character entities
|
|
sdbhier.mod - Hierarchy overrides
|
|
sdbpool.mod - Information pool overrides
|
|
sdocbook-custom.dtd - The DTD
|
|
sdocbook.css - CSS stylesheet
|
|
sdocbook.dtd - A flattened version of the DTD (mechanically generated)
|
|
sinclist.mod - A set of 'ignore' parameter entities
|
|
sdocbookref-custom.dtd - A version of Simplified DocBook for RefEntrys
|
|
sdocbookref.dtd - A flattened version of sdocbookref-custom (mech. generated)
|
|
test.xml - A test document
|
|
testcss.xml - A test document for the CSS stylesheet
|
|
testcust.xml - A test document for the raw customization layer
|
|
testrefcust.xml - A test document for the raw RefEntry customization layer
|
|
ent/ - The ISO character entity files used by sdocbook.dtd
|
|
|
|
Installation
|
|
------------
|
|
|
|
Place the files in this distribution somewhere on your machine. Adjust
|
|
your catalog(s) if appropriate (XML tools frequently do not support
|
|
catalogs, so this may be irrelevant for you).
|
|
|
|
Please use the following formal public identifier to identify this DTD:
|
|
|
|
"-//Norman Walsh//DTD Simplified DocBook XML V4.1.2.4//EN"
|
|
|
|
For example, if your document's top-level element is <article>, and
|
|
you are using this DTD directly, use the FPI in the DOCTYPE
|
|
declaration:
|
|
|
|
<!DOCTYPE article
|
|
PUBLIC "-//Norman Walsh//DTD Simplified DocBook XML V4.1.2.4//EN"
|
|
"http://nwalsh.com/docbook/simple/4.1.2.4/sdocbook.dtd" [
|
|
...
|
|
]>
|
|
|
|
|
|
Note: if you are using the customization layer directly (sdocbook-custom.dtd),
|
|
you may have to adjust the system identifier that points to the DocBook XML
|
|
DTD. You may also have to install the DocBook XML V4.1.2.4 DTD somewhere on
|
|
your system.
|
|
|
|
|
|
Copyright
|
|
---------
|
|
|
|
Copyright (C) 1999, 2000 Norman Walsh
|
|
|
|
See COPYRIGHT for more information
|
|
|
|
|
|
Warranty
|
|
--------
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
|
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER
|
|
CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
|
OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
|
|
Contacting the Author
|
|
---------------------
|
|
|
|
This DTD is maintained by Norman Walsh, <ndw@nwalsh.com>.
|
|
|
|
The best way to reach norm is by email. You will find additional
|
|
contact information at http://nwalsh.com/docbook/simple/
|