用項目布局和用法記錄Maven原型

Question

當我使用生成的站點文檔site的插件，都讓我在看到About頁面是的描述archetype是我在所指定<description>原型的POM的元素。

我怎么能看到類似生成的項目的布局和原型使用像這樣 ？ 我是否只需要手動執行？

Answer 1

Maven Site插件在src/site查找文檔。 默認情況下，它期望使用Doxia標記語言編寫文檔 。 您引用的項目結構是使用此標記編寫的。 您可以在Maven原型項目的src/site/apt/index.apt的源代碼中找到它。

您提到的項目結構的標記在此處定義：

34  +----+
35  
36  project
37  |-- pom.xml
38  `-- src
39      `-- site
40          |-- apt
41          |   |-- format.apt
42          |   `-- index.apt
43          |-- fml
44          |   `-- faq.fml
45          |-- fr
46          |   |-- apt
47          |   |   |-- format.apt
48          |   |   `-- index.apt
49          |   |-- fml
50          |   |   `-- faq.fml
51          |   `-- xdoc
52          |       `-- xdoc.xml
53          |-- xdoc
54          |   `-- xdoc.xml
55          |-- site_fr.xml
56          `-- site.xml
57  
58  +----+

顯而易見，如何為自己的結構編寫標記。 如果您希望自動生成這樣的結構，那么我懷疑您可能需要編寫一個簡單的Maven插件來遍歷項目目錄。 我不知道有任何預先存在的插件，但是在那里找到一個我不會感到驚訝。