Chapter 6. Debian docbook Directory Layout

Table of Contents
6.1. Subdirectories
6.2. The docbook/custom Directory
6.3. The docbook/dtd Directory
6.4. The docbook/stylesheet Directory

This layout is faithful in spirit to the LSB spec, but uses top-level directories to provide more organization to the structure.

6.1. Subdirectories

There are three main docbook directories:

/usr/share/sgml/docbook/
custom/
dtd/
stylesheet/

A similar structure would also apply to other major dtds, such as tei.

6.1.1. Directory Descriptions and Usage

custom/

All packages derived from customizations of a "main" dtd or stylesheet distributions (or both) are placed in subdirectories of custom, thus simplify packaging of dtd/stylesheet combinations.

These customization packages put their files in a non-versioned subdirectory of custom. The package directory itself may or may not have versioned subdirectories; package maintainers can determine the strucuture as they see fit.

dtd/

Subdivided into xml and sgml subdirectories, upstream source files are placed in a versioned subdirectory of xml or sgml, whichever is appropriate. Furthermore, the name of the versioned subdirectory is the dtd version number itself, as in 4.1.2/ or 1.0b4/.

stylesheet/

Subdivided into dsssl and xsl subdirectories, stylesheet distributions are placed in a subdirectory with names derived from the upstream source (e.g. nwalsh/, onshore/). These directory names must not contain version numbers.