Linux Today: Linux News On Internet Time.

Slashdot: Docbook: The Definitive Guide [Book Review]

Mar 17, 2000, 19:34 (1 Talkback[s])

"DocBook, a SGML DTD for technical writing and documentation, has been widely adopted by a number of organizations and authors. Many commercial and free tools support it, and the specification is under active development. DocBook: The Definitive Guide is the official documentation."

"The first section of the Guide discusses SGML and XML concepts, as well as the specifics of DocBook. Be warned that this is not a particularly gentle introduction -- familiarity with well-formed HTML will help, but the Guide is a reference, not a tutorial....

"The bulk of this book is a reference section which lists DocBook elements alphabetically. Each element has a content model lifted straight from the DTD, a list of applicable attributes, a list of parameter entities in which the element occurs, a description of what is is and where it might be used, processing expectations, and examples of its use mentioning any gotchas. Some elements are very simple, while elements higher in the hierarchy have much more complex requirements and nuances. Deprecated elements are marked with the appropriate version of the specification, with valid replacements suggested."

Complete Story

Related Stories: