Maven 專案文件

本章節我們主要學習如何建立 Maven 專案文件。

比如我們在 C:/MVN 目錄下，建立了 consumerBanking 專案，Maven 使用下面的命令來快速建立 java 專案：

mvn archetype:generate -DgroupId=com.companyname.bank -DartifactId=consumerBanking -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

修改 pom.xml，新增以下配置（如果沒有的話）：

不然執行  mvn site 命令時出現  java.lang.NoClassDefFoundError: org/apache/maven/doxia/siterenderer/DocumentContent 的問題， 這是由於 maven-site-plugin 版本過低，升級到 3.3+ 即可。

開啟 consumerBanking 資料夾並執行以下 mvn 命令。

C:\MVN\consumerBanking> 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 2012[INFO] Final Memory: 23M/148M[INFO] -------------------------------------------------------------------

開啟  C:\MVN\consumerBanking\target\site 資料夾。點選  index.html 就可以看到文件了。

Maven 使用一個名為  的文件處理引擎來建立文件，它能將多種格式的原始碼讀取成一種通用的文件模型。要為你的專案撰寫文件，你可以將內容寫成下面幾種常用的，可被 Doxia 轉化的格式。

格式名	描述	參考
Apt	純文字文件格式
Xdoc	Maven 1.x 的一種文件格式
FML	FAQ 文件適用
XHTML	可擴充套件的 HTML 文件