Maven 專案文件

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

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

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

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

<
project
>

  ...
<
build
>

<
pluginManagement
>

    
<
plugins
>

        
<
plugin
>

          
<
groupId
>
org.apache.maven.plugins
</
groupId
>

          
<
artifactId
>
maven-site-plugin
</
artifactId
>

          
<
version
>
3.3
</
version
>

        
</
plugin
>

        
<
plugin
>

          
<
groupId
>
org.apache.maven.plugins
</
groupId
>

          
<
artifactId
>
maven-project-info-reports-plugin
</
artifactId
>

          
<
version
>
2.7
</
version
>

        
</
plugin
>

    
</
plugins
>

    
</
pluginManagement
>

</
build
>

 ...
</
project
>

不然執行 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] -------------------------------------------------------------------

Maven 專案文件

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

Maven 專案文件

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

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

Maven 專案文件

Maven 專案文件

相關文章