Writing documentation with DocBook-XML 4.3 |  |
Writing documentation with DocBook-XML 4.3 | |
Abstract
Describes a system for writing general documentation for presentation in both Web and PDF form.
This publication is available in Web form and also as a PDF document.
Please forward any comments to tcc-doc@nmt.edu.
Table of Contents
simpara and
paramakeThe DocBook system has these advantages over other methods of creating documentation:
The same document can be translated mechanically to both Web-based and printable formats.
You as an author can concentrate on the content of your document, without worrying about how it will appear.
The Tech Computer Center supplies a locally-customized installation of the DocBook translation software for output to PDF or Web form.
The Modular Style Sheets web site provides a base set of HTML and PDF stylesheets. You may use these as the basis for your own customizations.
Customization of the 4.3 DocBook XSL Stylesheets for the TCC describes how the Modular Style Sheets were customized for this location.
The mechanical translation to various formats can be improved and tuned independently of the writing process. These improvements do not at all affect the DocBook files you write.
This document assumes you are using DocBook-XML revision 4.3. If your document was done under the SGML versions, see Section 22, “Converting DocBook 3.0 documents” and Section 21, “Converting DocBook-SGML 4.1 documents” below.