Maven项目文档

本教程学习如何一步到位地创建应用程序的文档。因此现在开始我们进入到  C:\MVN 创建 java 应用程序项目:consumerBanking。 进入到项目文件夹中执行以下命令 mvn 命令。 

C:\MVN>mvn site

Maven 将开始构建这个项目,输出结果如下:

[INFO] Scanning for projects...
[INFO] -------------------------------------------------------------------
[INFO] Building consumerBanking
[INFO]    task-segment: [site]
[INFO] -------------------------------------------------------------------
[INFO] [site:site {execution: default-site}]
[INFO] artifact org.apache.maven.skins:maven-default-skin: 
checking for updates from central
[INFO] Generating "About" report.
[INFO] Generating "Issue Tracking" report.
[INFO] Generating "Project Team" report.
[INFO] Generating "Dependencies" report.
[INFO] Generating "Continuous Integration" report.
[INFO] Generating "Source Repository" report.
[INFO] Generating "Project License" report.
[INFO] Generating "Mailing Lists" report.
[INFO] Generating "Plugin Management" report.
[INFO] Generating "Project Summary" report.
[INFO] -------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] -------------------------------------------------------------------
[INFO] Total time: 16 seconds
[INFO] Finished at: Wed Jul 11 18:11:18 IST 2015
[INFO] Final Memory: 23M/148M
[INFO] -------------------------------------------------------------------

完成后,在你的项目文件已构建完成。 Maven 会在 target  目录中创建一个 site 目录,如下图所示:

documentation site pages

打开 C:\MVN\consumerBanking\target\site 文件夹。点击 index.html 打开此文档,看到结果如下图所示:

consumer web  page

Maven会使用一个文件处理引擎: Doxia,它将会读取多个源格式并将它们转换为通用文档模型文档。以下几个是常用的格式使用来编写项目文档,这是由 Doxia 解析编写内容。

格式名称描述参考
APT 纯文本文档格式 http://maven.apache.org/doxia/format.html
XDoc Maven1.x 的文档格式 http://jakarta.apache.org/site/jakarta-site2.html
FML 用于常问问题(FQA)文件 http://maven.apache.org/doxia/references/fml-format.html
XHTML 可扩展HTML http://en.wikipedia.org/wiki/XHTML

posted @   borter  阅读(171)  评论(0编辑  收藏  举报
编辑推荐:
· 为什么说在企业级应用开发中,后端往往是效率杀手?
· 用 C# 插值字符串处理器写一个 sscanf
· Java 中堆内存和栈内存上的数据分布和特点
· 开发中对象命名的一点思考
· .NET Core内存结构体系(Windows环境)底层原理浅谈
阅读排行:
· 为什么说在企业级应用开发中,后端往往是效率杀手?
· DeepSeek 解答了困扰我五年的技术问题。时代确实变了!
· 本地部署DeepSeek后,没有好看的交互界面怎么行!
· 趁着过年的时候手搓了一个低代码框架
· 推荐一个DeepSeek 大模型的免费 API 项目!兼容OpenAI接口!
点击右上角即可分享
微信分享提示