JBoss.org Community Documentation

Chapter 3. Maintaining the JBoss DocBook system

The structure of the docbook-support project is illustrated in Figure 3.1, “The docbook-support project ”. The contents are as follows:

The docbook-support project

Figure 3.1. The docbook-support project


  • The docs directory contains the DocBook source for this guide to serve as a template for other projects.

  • The jbossorg-documentation directory contains the maven plugin source for the parent POM that is referenced by each project's pom.xml file. The parent POM contains common configuration information so that it does not have to be duplicated across multiple JBoss.org projects.

  • The jbossorg-docbook-xslt directory contains the maven plugin source for the default JBoss.org XSL stylesheets. These stylesheets produce XHTML, PDF and Eclipse Help output.

  • The jbossorg-jdocbook-style directory contains the maven plugin source for the default JBoss.org CSS and image files. These provide the JBoss.org community-driven look & feel.

  • The styles and support directories together with the support.xml file are provided for backwards compatibility with projects that wish to continue using Ant instead of Maven. The styles directory contains XSL stylesheets together with CSS files to produce HTML and PDF outputs. The support directory contains the DocBook libraries and DTDs along with the standard XSL stylesheets. The support.xml file contains common Ant tasks to perform the build.