3. Why use DocBook?

3.1. Formatting

So far the contributions to the newbieDoc project have been submitted in text and HTML formats. The structure and layout of these documents has varied widely. The newbieDoc project does not have a consistent look and feel.

Writing documentation using the DocBook SGML DTD will give all the newbieDoc documents a highly polished, `professional' appearance. What is more, an SGML document can be rendered to more formats than just HTML. It is possible to produce plain text and postscript files from the same SGML source.

3.2. Contents

The Linux Documentation Project stylesheet automatically generates a contents section for DocBook documents.

 

SGML provides for more than just formatting. You can automatically build indexes, table of contents, and links within the document or to outside. The Jade and OpenJade packages also let you render to LaTeX, info, text, HTML, and RTF. From these basic formats, you can then create other formats such as MS Word, PostScript, PDF and so on … In the end, SGML is more concerned about the way elements work instead of the way they look. A big distinction,and one that will let you write faster, since you don't have to worry about placement of paragraphs, font sizes, font types, and so on.

 
-- LDP-Author-Guide