用maven-jdocbook-plugin简单配置docbook5.0环境

用maven-jdocbook-plugin简单配置docbook5.0环境2011-02-04 BlogJava kuuyee很多人都说docbook配置环境比较繁琐,今天看了一下docbook5的文档,5.0不再使用旧的SGML DTD，转而使用XML，感觉配置相对容易多了,网上有篇文章介绍5.0的编译环境,真的比较简单.不过我今天看了看jboss seam的文档构建过程,构建环境搭建真是简单的不能再简单了,jboss seam使用maven来发布docbook文档,用到了maven-jdocbook-plugin,我把jboss seam的构建提取出来,大家可以参考来方便构建自己的docbook.

创建一个最最简单的maven空项目,pom.xml内容如下:

<？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/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.kuuyee</groupId>
     <artifactId>first-docbook</artifactId>
     <packaging>jar</packaging>
     <version>1.0-SNAPSHOT</version>
     <name>first-docbook</name>
             <build>
                 <plugins>
                <！-- the docbook generation plugin for the user guide -->
                     <plugin>
                         <groupId>org.jboss.maven.plugins</groupId>
                         <artifactId>maven-jdocbook-plugin</artifactId>
                         <version>2.1.1</version>
                         <extensions>true</extensions>
                         <dependencies>
                             <dependency>
                                 <groupId>org.jboss</groupId>
                                 <artifactId>jbossorg-docbook-xslt</artifactId>
                                 <version>1.1.0</version>
                             </dependency>
                             <dependency>
                                 <groupId>org.jboss</groupId>
                                 <artifactId>jbossorg-jdocbook-style</artifactId>
                                 <version>1.1.0</version>
                                 <type>jdocbook-style</type>
                             </dependency>
                         </dependencies>
                         <executions>
                             <execution>
                                 <id>tutorial_zh_CN</id>
                                 <phase>package</phase>
                                 <goals>
                                     <goal>resources</goal>
                                     <goal>generate</goal>
                                 </goals>
                                 <configuration>
                                     <sourceDocumentName>master.xml</sourceDocumentName>
                                     <sourceDirectory>${basedir}/src/main/docbook/zh_CN</sourceDirectory>
                                     <imageResource>
                                         <directory>${basedir}/src/main/docbook/images</directory>
                                     </imageResource>
                                     <cssResource>
                                         <directory>${basedir}/src/main/docbook/css</directory>
                                     </cssResource>
                                     <targetDirectory>${basedir}/target/docbook/zh_CN</targetDirectory>
                                     <formats>
                                         <format>
                                             <formatName>pdf</formatName>
                                             <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource>
                                             <finalName>zh_CN.pdf</finalName>
                                         </format>
                                         <format>
                                             <formatName>html</formatName>
                                             <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource>
                                             <finalName>index.html</finalName>
                                         </format>
                                         <format>
                                             <formatName>html_single</formatName>
                                             <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource>
                                             <finalName>index.html</finalName>
                                         </format>
                                     </formats>
                                     <options>
                                         <xincludeSupported>true</xincludeSupported>
                                     </options>
                                 </configuration>
                             </execution>
                         </executions>
                     </plugin>
                 </plugins>
             </build>

     <！-- basic JBoss repository so that the common parent POM in jbosscache-support can be found -->
     <repositories>
         <repository>
             <id>snapshots.jboss.org</id>
             <url>http://snapshots.jboss.org/maven2</url>
         </repository>
         <repository>
             <id>repository.jboss.org</id>
             <url>http://repository.jboss.org/maven2</url>
         </repository>
     </repositories>
</project>