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] -------------------------------------------------------------------

打開 c:\mvn\consumerbanking\target\site 文件夾。點擊 index.html 就可以看到文檔了。

maven 使用一個名為 doxia的文檔處理引擎來創建文檔，它能將多種格式的源碼讀取成一種通用的文檔模型。要為你的項目撰寫文檔，你可以將內容寫成下面幾種常用的，可被 doxia 轉化的格式。