MavenDocBook - docbook/wiki GitHub Wiki

Maven artifacts containing the XSL Schemas (XSD, RNG ...).

Description

The namespaced stylesheets (used for docbook 5) can be used with:

<dependency>
<groupId>net.sf.docbook</groupId>
<artifactId>docbook-xml</artifactId>
<version>5.0-all</version>
<type>zip</type>
<classifier>resources</classifier>
</dependency>

This artifact contains most of the content of the regular docbook release you can download except that the root directory is '''docbook/''' for ease of version migration. Here is the content of docbook/ of this artifact:

<DIR> dtd
<DIR> rng
<DIR> sch
<DIR> tools
<DIR> xsd
3 287 catalog.xml
46 419 ChangeLog
430 docbook.nvdl
1 182 README
4 VERSION

Common usage

A common usage of these artifacts is extracting it in a temporary directory and using it for XML validation, this can be done as the following:

<!--
First we need to extract the xml schemas somewhere
-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>unpack-shared-resources</id>
<goals>
<goal>unpack-dependencies</goal>
</goals>
<!-- linked with generate-resources phase -->
<phase>generate-resources</phase>
<configuration>
<outputDirectory>${project.build.directory}/generated-resources</outputDirectory>
<includeGroupIds>net.sf.docbook</includeGroupIds>
<includeArtifactIds>docbook-xml</includeArtifactIds>
<includeClassifiers>resources</includeClassifiers>
<excludeTransitive>true</excludeTransitive>
</configuration>
</execution>
</executions>
</plugin>

Then use xml plugin to validate against the docbook schema, this can be done as the following:

<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>xml-maven-plugin</artifactId>
<version>1.0-beta-2</version>
<executions>
<execution>
<goals>
<goal>validate</goal>
</goals>
<!-- linked with generate-resources phase -->
<phase>generate-resources</phase>
</execution>
</executions>
<configuration>
<!-- validationSets are used for the goal validate -->
<validationSets>
<validationSet>
<dir>src/main/docbook/</dir>
<systemId>${project.build.directory}/generated-resources/docbook/xsd/docbook.xsd</systemId>
</validationSet>
</validationSets>
</configuration>
</plugin>

A complete example can be find in the svn at http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/maven/docbook-sample/

⚠️ **GitHub.com Fallback** ⚠️