Describes a customization layer for the DocBook 5 Modular Stylesheets. HTXS html-titlepage.xsl
Table of Contents
zdp_html.xsl: HTML customization layer
html_params.xslfile: HTML branding
email.to.author: Email address for reader comments
help.long.name: Full link text for the help link
help.short.name: Help link short text
help.url: Help link URL
home.long.name: Full home link text
home.short.name: Homepage short link text
home.url: Homepage URL
html.logo: Organizational logo image
html.stylesheet: URL of the CSS stylesheet
html-titlepage.xml: HTML title page template
docbook5.css: The CSS stylesheet for the HTML rendering
docbook5.css: General page layout
docbook5.css: Inline elements
docbook5.css: Block elements
zdp_fo.xsl: PDF customization layer
fo_params.xslfile: PDF branding
fo-titlepage.xml: PDF title page templates
DocBook is a generalized framework for writing documentation using XML. Among the many advantages of this system is that a single source document can be translated mechanically to both HTML and PDF representations.
This document contains all the files used for local customization, in “lightweight literate programming” format. For more information, see the author's Lightweight literate programming page.
A local DocBook toolchain consists of these components:
Norman Walsh's DocBook-XSL Stylesheets provide a generic styling of DocBook that can be customized with local style conventions. These stylesheets consist of XSLT scripts. For more information about XSLT, see XSL Transformations (XSLT) Version 1.0.
These style sheets can be downloaded from the SourceForge repository.
The xsltproc package implements the XSLT language. Production of the HTML output from a DocBook document needs only XSLT.
The xep processor is necessary to produce the
printable, PDF (Adobe Page Description Format) form of
a DocBook document. This transformation starts by
using xsltproc to transform the original DocBook
document into XSL, also known as XSL-FO (for Formatting
Objects). The resulting
file is input to xep, which produces the PDF output
For more information on XSL, see the standard: Extensible Stylesheet Language (XSL) Version 1.0.
Without customization, the stock DocBook-XSL Stylesheets produce a pretty bland, generic output style. This document describes a customization layer, built on top of the DocBook-XSL Stylesheets, that gives documents their local style.
Documentation for the DocBook-XSL Stylesheets is rather skeletal. Fortunately, there is an excellent book that describes the customization process in detail:
Stayton, Bob. DocBook XSL: The complete guide. Third edition, March 2005, ISBN 0-9741521-2-9.
This book will be referred to throughout this document as “Stayton.”