Chapter 5. (X)HTML Customizations

HTML is a very important output format for the DocBook XSL stylesheets as it is not only displayed on Web sites, but also used “inside” ebooks (EPUB). It comes in several variants.

Table of Contents
5.1. Introduction
5.2. Adding Authors to Table of Contents
5.3. Creating Permalinks
5.4. Creating Simple Navigation in Chapters
5.5. Implementing “Breadcrumbs”
5.6. Moving the Table of Contents (TOC)
5.7. Implementing Syntax Highlighting with Google Code Prettify
5.8. Controlling the Chunking Process
5.9. Setting your own Files and Directories Names during Chunking

Currently, there are several HTML variants available as target formats. As such, “the” HTML does not exist, only a variety of HTML dialects:

Overview of Different HTML XSLT 1.0 Stylesheets
eclipse/eclipse.xsl, eclipse/eclipse3.xsl

Contains stylesheet to document for the Eclipse help system. The main stylesheets use code from the HTML 4.x stylesheets.

html/chunk.xsl, html/docbook.xsl

Contains stylesheets for the “classical”  HTML 4.

htmlhelp/htmlhelp.xsl

Contains stylesheets for HTMLHelp, the standard help system from Windows 3.0 through Windows XP. The main stylesheet htmlhelp.xsl uses code from the HTML 4.x stylesheets.

webhelp/xsl/webhelp.xsl

Contains the result of the GSOC 2010 and creates a Web page with a sidebar, search form, and hierarchical navigation. The stylesheet incorporates the XHTML stylesheets.

website/chunk-website.xsl, website/website.xsl

Contains stylesheets to create a “Web site”.

xhtml/chunk.xsl, xhtml/docbook.xsl

Contains stylesheets for XHTML 1.0 (“transitional XHTML”). These stylesheets are generated through an XSLT transformation from the HTML core stylesheets.

xhtml-1_1/chunk.xsl, xhtml-1_1/docbook.xsl

Contains stylesheets for XHTML 1.1. Like the one for XHTML, they are generated through an XSLT transformation. In comparison, the XHTML 1.1 omits certain attributes which were allowed in XHTML or HTML. The missing part must be implemented by CSS. The XHTML 1.1 stylesheets are also used for EPUB creation.

xhtml5/chunk.xsl, xhtml5/docbook.xsl

Contains stylesheets for HTML 5. These stylesheets customizes the XHTML stylesheets. As such it inherits all the features and parameters. The HTML 5 stylesheets are also used for EPUB3 creation.


Project@GitHubIssue#10