work in progress
Copyright © 1997-2000, 2001-2002 David Rugge, Mark Galassi, Eric Bischoff, Michel Goossens
This document can be freely redistributed according to the terms of the GNU General Public License.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".
|Revision 0.0||2001-07-21||[email protected]|
|Initial version, started from DocBook-Intro.xml written by Mark Galassi (Cygnus) and crash-course of David Rugge, Mark Galassi, Eric Bischoff|
|Revision 0.3||2002-03-05||[email protected]|
|Start clean up source|
|Revision 0.4||2002-03-21||[email protected]|
|First public release with many additions for CERN|
|Revision 0.5||2002-07-24||[email protected]|
|Change to use version 4.2 of DocBook DTD throughout|
This document is a tutorial on how to write documentation in DocBook, and generate HTML and PDF from the XML sources. The description of the DTD elements is general in nature, whereas some tools and the location of system files relate to the CERN XML set-up.
This material is based in part on "A crash-course in DocBook", which was itself created from a fusion of three documents:
the "Introduction to DocBook" by Mark Galassi
the "KDE crash-course to DocBook" by David Rugge
parts of Eric Bischoff's tutorial about DocBook
I have freely adapted the above material to CERN, and have complemented it in many places. On the other hand, for reasons of maintainability, I have completely eliminated all references to SGML and DSSSL, since at CERN I only want to maintain the XSLT stylesheets to render DocBook source material.
Table of Contents
List of Figures
List of Examples