创建站点

您可以使用maven-archetype-site-simplemaven-archetype-site创建站点。您只需要设置您的 Maven 项目的groupIdartifactId

要启动一个简单的站点,请选择maven-archetype-site-simple

mvn archetype:create 
  -DgroupId=[your project's group id]
  -DartifactId=[your project's artifact id]
  -DarchetypeArtifactId=maven-archetype-site-simple

它将生成一个包含以下内容的maven项目。

.
 |-- src
 |   `-- main
 |       `-- site
 |           |-- apt
 |           |   `-- index.apt
 |           `-- site.xml
  `-- pom.xml

生成的index.apt是用于文档的“几乎纯文本”格式(要了解有关 APT 格式的更多信息,请参阅APT 格式指南)。

但是要创建一个更完整的站点版本,请使用maven-archetype-site

mvn archetype:create 
  -DgroupId=[your project's group id]
  -DartifactId=[your project's artifact id]
  -DarchetypeArtifactId=maven-archetype-site

这将创建一个 Maven 项目。

.
 |-- src
 |   `-- main
 |       `-- site
 |           |-- apt
 |           |   |-- format.apt
 |           |   `-- index.apt
 |           |-- fml
 |           |   `-- faq.fml
 |           |-- fr
 |           |   |-- apt
 |           |   |   |-- format.apt
 |           |   |   `-- index.apt
 |           |   |-- fml
 |           |   |   `-- faq.fml
 |           |   `-- xdoc
 |           |       `-- xdoc.xml
 |           |-- xdoc
 |           |   `-- xdoc.xml
 |           |-- site.xml
 |           `-- site_fr.xml
  `-- pom.xml

此外,两种原型都能够在现有的 Maven 项目上创建原型容器。例如,如果我们首先创建一个简单的 j2ee maven 项目。

mvn archetype:create 
  -DgroupId=sample.gid
  -DartifactId=sample-aid
  -DarchetypeArtifactId=maven-archetype-j2ee-simple

我们的 Maven 项目将具有以下内容。

.
 |-- ear
 |   `-- pom.xml
 |-- ejb
 |   |-- src   
 |   |   `-- main
 |   |       `-- resources
 |   |           `-- META-INF
 |   |               `-- ejb-jar.xml
 |   `-- pom.xml
 |-- primary-source
 |   `-- pom.xml
 |-- projects
 |   |-- logging
 |   |   `-- pom.xml
 |   `-- pom.xml
 |-- servlets
 |   |-- servlet
 |   |   |-- src
 |   |   |   `-- main
 |   |   |       `-- webapp
 |   |   |            |-- WEB-INF
 |   |   |            |   `-- web.xml
 |   |   |            `-- index.jsp
 |   |   `-- pom.xml
 |   `-- pom.xml
 |-- src
 |   `-- main
 |       `-- resources
  `-- pom.xml

如果我们从同一目录中调用以下命令。

mvn archetype:create 
  -DgroupId=sample.gid
  -DartifactId=sample-aid
  -DarchetypeArtifactId=maven-archetype-site

然后站点原型的内容将插入现有 Maven 项目的内容。

.
 |-- ear
 |   `-- pom.xml
 |-- ejb
 |   |-- src   
 |   |   `-- main
 |   |       `-- resources
 |   |           `-- META-INF
 |   |               `-- ejb-jar.xml
 |   `-- pom.xml
 |-- primary-source
 |   `-- pom.xml
 |-- projects
 |   |-- logging
 |   |   `-- pom.xml
 |   `-- pom.xml
 |-- servlets
 |   |-- servlet
 |   |   |-- src
 |   |   |   `-- main
 |   |   |       `-- webapp
 |   |   |            |-- WEB-INF
 |   |   |            |   `-- web.xml
 |   |   |            `-- index.jsp
 |   |   `-- pom.xml
 |   `-- pom.xml
 |-- src
 |   `-- main
 |       |-- resources
 |       `-- site
 |           |-- apt
 |           |   |-- format.apt
 |           |   `-- index.apt
 |           |-- fml
 |           |   `-- faq.fml
 |           |-- fr
 |           |   |-- apt
 |           |   |   |-- format.apt
 |           |   |   `-- index.apt
 |           |   |-- fml
 |           |   |   `-- faq.fml
 |           |   `-- xdoc
 |           |       `-- xdoc.xml
 |           |-- xdoc
 |           |   `-- xdoc.xml
 |           |-- site.xml
 |           `-- site_fr.xml
  `-- pom.xml

同时保留现有maven项目的pom。