4 Replies Latest reply on Mar 20, 2007 12:39 PM by Paul Gier

    Mavenizing docbook project

    Anil Saldanha Master

      The Doc Book project uses ant for building. Are there any plans with migrating this to a maven setup? There is a maven docbook plugin available.

      I went through the JIRA issues for JBBUILD and I did not see one for docbook.

        • 1. Re: Mavenizing docbook project
          Paul Gier Master

          Yes, eventually we will migrate as much as possible to maven. I created this jira issue for mavenizing docbook:
          http://jira.jboss.com/jira/browse/JBBUILD-346

          • 2. Re: Mavenizing docbook project
            Scott Stark Master

            What about using the com.agilejava.docbkx plugin? All it took to get the 1.0 mc docbook to build was a pom.xml like the following:

            <?xml version="1.0"?>
            <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
             <modelVersion>4.0.0</modelVersion>
             <groupId>jboss</groupId>
             <artifactId>mc-getting-started</artifactId>
             <version>1.0</version>
             <packaging>pom</packaging>
             <name>JBossMC Getting Started Guide</name>
             <description>The JBossMC getting started guide</description>
            
             <repositories>
             <repository>
             <id>agilejava</id>
             <name>AgileJava</name>
             <url>http://agilejava.com/maven/</url>
             </repository>
             </repositories>
             <pluginRepositories>
             <pluginRepository>
             <id>agilejava</id>
             <name>AgileJava</name>
             <url>http://agilejava.com/maven/</url>
             </pluginRepository>
             </pluginRepositories>
            
            
             <build>
             <plugins>
             <plugin>
             <!--
             See the following for config options:
             http://www.agilejava.com/docbkx/docbkx-maven-plugin/generate-html-mojo.html
             -->
             <groupId>com.agilejava.docbkx</groupId>
             <artifactId>docbkx-maven-plugin</artifactId>
             <version>2.0.3</version>
             <executions>
             <execution>
             <goals>
             <goal>generate-pdf</goal>
             <goal>generate-html</goal>
             </goals>
             <phase>generate-sources</phase>
             </execution>
             </executions>
             <dependencies>
             <dependency>
             <groupId>org.docbook</groupId>
             <artifactId>docbook-xml</artifactId>
             <version>4.4</version>
             <scope>runtime</scope>
             </dependency>
             </dependencies>
            
             <configuration>
             <foCustomization>${basedir}/src/styles/docbook-fo.xsl</foCustomization>
             <includes>master.xml</includes>
            
             <!-- use separate pages per chapter for HTML -->
             <chunkedOutput>true</chunkedOutput>
            
             <entities>
             <entity>
             <name>version</name>
             <value>${version}</value>
             </entity>
             </entities>
            
             <xincludeSupport>true</xincludeSupport>
             <sourceDirectory>${basedir}/src/docbkx/en</sourceDirectory>
             <headerRule>0</headerRule>
             <footerRule>0</footerRule>
             <draftMode>0</draftMode>
             <bodyFontFamily>Helvetica</bodyFontFamily>
             </configuration>
             </plugin>
             </plugins>
             </build>
            </project>
            


            Its checked into:
            https://svn.jboss.org/repos/jbossas/projects/microcontainer/trunk/docs/gettingstarted/pom.xml


            • 3. Re: Mavenizing docbook project
              Anil Saldanha Master

              I will use that for the security docbook project.

              • 4. Re: Mavenizing docbook project
                Paul Gier Master

                Should I add this as a module to the parent pom, so that it can be built from the parent?

                There are also docs under kernel, should I add something similar to the kernel pom?