ricemery / docbkx-tools

The official docbkx-tools maven plugin (previously on code.google.com/p/docbkx-tools)

Docbkx Tools

This is the official repository of Docbkx Tools, previously hosted at Google Code prior to that at sonatype.org and prior to that at Sourceforge. The documentation is still hosted at Sourceforge.

• https://code.google.com/p/docbkx-tools/
• http://docbkx-tools.sourceforge.net/

Fork this repo to contribute. Do not export the Google Code repo to GitHub since that version is old.

What is it?

The Docbkx Tools project provides a number of tools supporting DocBook in a Maven environment. This may seem odd to you, since 1) Maven 2 is supposed to support DocBook natively, relying on Doxia, and 2) there is already another DocBook plugin at mojo.codehaus.org.

The thruth however is that DocBook support in Doxia is fairly limited, mainly because Doxia as a framework supports only a small fraction of the concepts found in DocBook. The subset of DocBook supported by Doxia is not even close to simplified DocBook.

The DocBook plugin at mojo.codehaus.org is supporting a wider range of DocBook markup, and is in fact more similar to the DocBook tools provided with this project. There are however some significant differences.

Differences with other Maven plugins

• The focus is on ease of use.
• You should not be required to install additional stuff to your hard disk in order to generate content from your DocBook sources. Simply adding a reference to the plugin in your POM should be sufficient.
• This project focuses on providing dedicated support for particular DocBook XSL stylesheet distributions. That means you can rely on the dedicated parameterization mechanism of Maven Plugins to pass in the XSLT parameters defined for a particular version and type of XSLT stylesheet.
• In the DocBook Plugin found at mojo.codehaus.org, you will be required to download a specific version of the DocBook XSL stylesheets manually. The plugins packaged contain the stylesheets as well. (In this project, a particular version of the stylesheets is closely tied to a particular version of the plugin. That you means you can always rely on the plugin's documentation to know which parameters you could pass in.)
• The DocBook plugin found at mojo.codehaus.org requires you to have access to the Internet in order allow the plugin to resolve URI's. The plugins provided in this project act differently: if your DocBook sources are referening to a DTD, then you can simply add a dependency to a jar file containing the DTD and related entities, and the plugin will make sure that all references will be resolved correctly.

I want to know more

Find the User Guide of the Maven Docbkx Plugin http://docbkx-tools.sourceforge.net/docbkx-maven-plugin/plugin-info.html.

Projects

The project contains the following components:

Docbkx Maven Base

Base classes to be subclassed by objects generating output from DocBook sources.

Docbkx Maven Plugin Builder

A Maven plugin for generating Maven plugins specific to a certain version of the DocBook XSL stylesheet distribution.

Docbkx Maven Plugin

Maven plugins for generating output from DocBook sources, largely generated by the aforementioned Dockbx Builder Maven Plugin.

Dockbx Samples

Examples showing how to generate DocBook XSL outputs from an existing Maven project.

Docbkx FOP Support

Supports FOP 1.1.

Docbkx Maven quickstart archetype

Maven archetype for starting a DocBook build project.

Building

Install Maven and GPG. Fork the repo. Go to the directory, and create a branch. Then run mvn install.