用maven-jdocbook-plugin简单配置docbook5.0环境[Java编程]

很多人都说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>

　　以上是“用maven-jdocbook-plugin简单配置docbook5.0环境[Java编程]”的内容，如果你对以上该文章内容感兴趣，你可以看看七道奇为您推荐以下文章：