maven中使用doc插件生成漂亮的项目文档

文档示例: Javadoc 和Xref

1. 下载附件中的doc.zip.
2. doc/api 包含Javadoc的样式和图片文件.  将它们提取到已存在的Javadoc输出中并覆盖原来的样式
3. doc/xref 包含由maven-jxr-plugin生成的样式与图片。将其提取到已存在的Xref输出中并覆盖原来的样式文件即可。

在你的pom.xml加入如下的配置项:

<plugin> 
        <artifactId>maven-javadoc-plugin</artifactId> 
        <version>2.6.1</version> 
        <configuration> 
          <stylesheetfile>${basedir}/src/javadoc/stylesheet.css</stylesheetfile> 
          <javadocDirectory>${basedir}/src/javadoc</javadocDirectory> 
          <docfilessubdirs>true</docfilessubdirs> 
        </configuration> 
</plugin>

上面的配置中，images放在${basedir}/src/javadoc/resources中。
另外，还需修改样式文件，将图片的路径改成相对路径。
比如，使用url(../javadoc/resources/*)来代替url(resources/*)。

记得用jdk7生成的javadoc就比较漂亮了