[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Subject: Re: DOCBOOK: Any suggestions for a GOOD XML reference?
You wrote:Hello All,
I am learning XML while using the docbook DTD and really need a good
reference. For example, I have "DocBook: The Definitive Guide" and "XML
Bible" that do not provide information about the following DTD constructs:
<!ENTITY % local.list.class "">
When I go through the various modules in the docbook DTD I cannot figure
out where "class" comes from or what "local.list.class" actually means.
You definitely should do as Bob suggested and take another look at
Chapter 5, "Customizing DocBook" in "DocBook: The Definitive Guide" -
The %local.*; parameter entities are a local extension mechanism. You
can add markup to most entity declarations simply by declaring the
appropriate local parameter entity.
Classes group elements of a similar type: for example all the
lists are in the %list.class;.
If you want to add a new kind of something (a new kind of list or
a new kind of verbatim environment, for example), you generally
want to add the name of the new element to the appropriate class.Can someone please provide what they consider a good reference that
explains what is going on in the docbook (XML programming in general)?
I would like to either alter the DTD for my purposes or suggest a change
intelligently but I can't until I understand what's going on.
It sounds like what you're looking for isn't really a reference for XML
programming, but one for DTD development and customization. As far as
that goes, if you plan on doing a much DTD development/customization
work, you should read Eve Maler and Jeanne El Andaloussi's book
"Developing SGML DTDs". It'll give you a lot of insight into the thought
that went into the design and organization of the DocBook DTD.
But for now, if your immediate need is to alter or suggest specific
changes to the DocBook DTD, the best starting point is still Chapter 5
of "DocBook: The Definitive Guide".
Powered by eList eXpress LLC