经常问的问题

  1. mvn site和mvn site:site有什么区别？
  2. 如何将静态 (X)HTML 页面集成到我的 Maven 站点中？
  3. 为什么我的绝对链接会被翻译成相对链接？
  4. 为什么我运行“”时父模块和子模块之间的链接不起作用mvn site？
  5. 如何包含自定义 Doxia 模块，例如 Twiki？
mvn site和mvn site:site有什么区别？
mvn网站
使用关联阶段（即站点前、站点、站点后、站点部署） 调用站点生命周期。请参阅生命周期参考。
mvn 站点：站点
从站点插件调用站点目标。请参阅站点：站点。
[最佳]
如何将静态 (X)HTML 页面集成到我的 Maven 站点中？

您可以按照以下步骤集成静态页面：

  • 将您的静态页面放在资源目录中，${basedir}/src/site/resources
  • 创建site.xml并放入${basedir}/src/site
  • 通过修改菜单部分链接到静态页面，创建项目并将它们映射到静态页面的文件名
[最佳]
为什么我的绝对链接会被翻译成相对链接？

发生这种情况是因为站点插件会在可能的情况下尝试使所有 URL 相对。如果您在以下内容中定义了类似的内容 pom.xml： 

<url>http://www.your.site.com/</url>
site.xml并在您的（只是一个示例） 中创建链接，如下所示：
<links>
  <item name="Your Site" href="http://www.your.site.com/"/>
  <item name="Maven 2" href="http://maven.apache.org/maven2/"/>
</links>
您将看到“您的站点”的链接将是一个相对链接，但“Maven 2”的链接将是一个绝对链接。

JIRA 中有一个 问题，您可以在其中阅读更多相关信息。

[最佳]
为什么我运行“”时父模块和子模块之间的链接不起作用mvn site？

mvn site在多项目构建中， “ ”将为您做的mvn site就是为父级及其所有模块单独运行“” 。父子之间的链接在 这里不起作用。但是，当您部署站点时， 它们将起作用。

如果您想在部署之前对此进行测试，您可以 按照使用文档site:stage中的描述运行目标 。

[最佳]
如何包含自定义 Doxia 模块，例如 Twiki？

该站点插件处理开箱即用的 apt、xdoc 和 fml 格式。如果你想使用像 Twiki 这样的自定义格式，你需要指定 Doxia Twiki 依赖，即： 

<project>
  ...
  <build>
    <plugins>
      ...
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <dependencies>
          <dependency>
            <groupId>org.apache.maven.doxia</groupId>
            <artifactId>doxia-module-twiki</artifactId>
            <version>1.0</version>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
  </build>
  ...
</project>

[最佳]