DocBook

From open-encyclopedia.com - the free encyclopedia.

DocBook is a markup language for technical documentation, originally intended for authoring technical documents relating to computer hardware and software but it can be used for any other sort of documentation. It is maintained and standardized by the DocBook Technical Committee at OASIS (originally SGML Open).

DocBook exists as both an SGML and an XML DTD. It originally started as an SGML application, but an equivalent XML application was developed and has now replaced the SGML one for most uses. (The XML DTD started with version 4 of the SGML DTD and keeps the versioning from there.)

DocBook is widely used. Examples include the Linux Documentation Project, the GNOME and GTK+ API references, and the Linux kernel documentation. The Solaris Operating Environment manpages and user guides are generated from documents using a DTD based on DocBook.

Norman Walsh and the DocBook Open Repository development team maintain a set of DSSSL and XSL stylesheets for generating print/PDF, RTF and HTML output from DocBook documents (as well as generating other formats, including man pages and HTML Help). Walsh is also the principal author of the book DocBook: The Definitive Guide, the official documentation of DocBook. This book is available online under the GFDL, and also as a print publication.

Sample code

<book id="simple_book">
  <title>Very simple book</title>
  <chapter id="simplechapter">
    <title>Chapter 1</title>
    <para>Hello world!</para>
  </chapter>
</book>

References

• Norman Walsh: DocBook: The Definitive Guide, O'Reilly Associates, ISBN 1-56592-580-7
• Bob Stayton: DocBook Xsl: The Complete Guide, Sagehill Enterprises, ISBN 0-9741521-1-0
• Joe Brockmeier: DocBook Publishing - A Better Way to Create Professional Documents, Prima Tech's Linux Series, ISBN 0-7615-3331-1

External links

• DocBook.org official site
• The original DocBook wiki has been abandoned in March 2004 after continued acts of (apparently automated) vandalism. The new DocBook wiki requires user registration to prevent automated attacks.
• XML editors A comprehensive list of WYSIWYG and WYSIWYM XML editors.
• Wikitext and Linuxdoc
• DocBook LiveCD.
• DocBook FAQ.
• DocBook Reference.
• DocBook at OASIS (Organization for the Advancement of Structured Information Standards).
• DocBook Open Repository Project at SourceForge.
• DocBook: The Definitive Guide.
• DocBook validator, XML -> HTML/PDF transformer.
• DocBook Newbie Guide.
• Documention with DocBook on Windows.
• Comparison of DocBook to LinuxDoc
• DocBook avec OpenOffice sous debian
• Docbook sous Windows et FreeBSD

de:DocBook es:DocBook fr:DocBook