由 Maven 构建

创建皮肤

如果您想调整网站的外观，您可以使用自定义外观来提供您自己的 CSS 样式表。如果这还不够，您甚至可以调整 Maven 用来生成站点文档的输出模板。

有关站点定制的深入讨论，请查看Maven：完整参考，第 10 章。Sonatype 提供的站点生成。

关于

皮肤包含以下元素：

  • 要复制到每个项目中的资源（例如 CSS 使用的图像）
  • 几个 CSS 文件，包含视觉样式
  • /META-INF/maven/site.vm中的可选 Velocity 模板，用于站点的备用 HTML 呈现（默认情况下，使用Doxia Site Renderer的default-site.vm
  • 从 Maven Site Plugin 3.5 开始， /META-INF/maven/ skin.xml中的可选皮肤描述符包含有关皮肤的元数据

Maven 站点皮肤原型

maven-archetype-site-skin原型可用于轻松创建一个完整的新皮肤项目，包括其专用的/META-INF/maven/site.vm。

建筑

皮肤像任何其他 JAR一样构建 - 带有jar包装。不需要额外的插件。

资源应该放在正常的src/main/resources目录中。

构建和部署 JAR 后，项目就可以使用它。

构建 CSS

如果您对构建自己的 CSS 感兴趣，建议您从 Maven Default Skin 中复制文件maven-theme.css并对其进行修改以满足您的需求。

使用 Velocity 模板自定义 HTML 输出

Velocity 模板的格式目前超出了本文档的范围。要尝试此操作，首先将default-site.vm复制到项目中的src/main/resources/META-INF/maven/site.vm，然后根据需要对其进行修改。

有关如何编写 Velocity 模板的更多信息，请参阅Velocity 用户指南和Velocity 模板语言参考指南。

请注意，从 Maven Site Plugin 3.5 开始使用 Velocity 1.7，但之前使用的是 1.5 版本。