Just to give you all a heads-up in case anyone else asks, yes, the docbkx maven
plugin works with DocBook 5.
I set its dependency for it to the following Maven XML snippet:
<dependency>
<groupId>net.sf.docbook</groupId>
<artifactId>docbook-xml</artifactId>
<version>5.0-all</version>
<classifier>resources</classifier>
<type>zip</type>
<scope>runtime</scope>
</dependency>
instead of what the documentation for the plugin has, which was:
<dependency>
<groupId>org.docbook</groupId>
<artifactId>docbook-xml</artifactId>
<version>4.4</version>
<scope>runtime</scope>
</dependency>
That's all I needed to do.
If you were wanting to use DocBook 4.5 instead of 4.4 you'd have to use the
Sonatype repository at
http://oss.sonatype.org/content/repositories/releases/
to get it. Its maven coordinates are docbook:docbook-xml:4.5:jar should you
need that.
By the way...
I'm working on a maven plugin to take the HTML produced by the docbkx plugin
and run it through Velocity to put Doxia-like header, footer, and navigation
elements around the document body contents. It will also substitute maven
project properties. This makes the DocBook documentation fit better with the
normal maven site generated documentation without removing all the good DocBook
formatting the way Doxia like to do.
It's pretty preliminary and rough, but it currently does what I need. See the
site documentation for the Sea Glass Look and Feel for Swing at
http://www.kathrynhuxtable.org/projects/site/seaglasslookandfeel
and the DocBook source at
http://code.google.com/p/seaglass/source/browse/svn/seaglass/trunk/seaglass/src/site/docbook
for examples. If you're interested you can look at the maven POM at
http://code.google.com/p/seaglass/source/browse/svn/seaglass/trunk/seaglass
The plugin info is at
http://www.kathrynhuxtable.org/projects/site/htmlfilter-site-maven-plugin
-K
