标签：项目 images doc nts targe apt 常用 point 生成
Maven项目可以通过maven-site-plugin插件生成项目文档，无论什么项目都可以生成。
执行命令：
mvn site
生成完成的输出目录在${basedir}/target/site文件夹，直接点击index.html查看即可。
原理解释：
Maven 使用一个名为Doxia的文档处理引擎来创建文档，它能将多种格式的源码读取成一种通用的文档模型。要为你的项目撰写文档，你可以将内容写成下面几种常用的，可被 Doxia 转化的格式。
| 格式名 | 描述 | 参考 |
|---|---|---|
| Apt | 纯文本文档格式 | http://maven.apache.org/doxia/references/apt-format.html |
| Xdoc | Maven 1.x 的一种文档格式 | http://jakarta.apache.org/site/jakarta-site2.html |
| FML | FAQ 文档适用 | http://maven.apache.org/doxia/references/fml-format.html |
| XHTML | 可扩展的 HTML 文档 | http://en.wikipedia.org/wiki/XHTML |
更多的格式参考：http://maven.apache.org/doxia/references/index.html
以上参考：https://ayayui.gitbooks.io/tutorialspoint-maven/content/book/maven_project_documents.html
标签：项目 images doc nts targe apt 常用 point 生成
原文地址：http://www.cnblogs.com/EasonJim/p/6851484.html
