介绍
Maven https://maven.apache.org网站由以下部分组成:
- 一个主要内容,
- 多个组件参考文档,针对每个组件版本发布。
和Doxia网站具有相同的双重结构。
这些内容存储在 svn 中,并且 svnpubsub/svnwcsub 在网络服务器上维护一个工作副本/www/maven.apache.org/content
(参见svnwcsub
infra Puppet 中的配置):
/
来自https://svn.apache.org/repos/asf/maven/website/content//components
来自https://svn.apache.org/repos/asf/maven/website/components//doxia
来自https://svn.apache.org/repos/asf/maven/doxia/website/content//doxia/components
来自https://svn.apache.org/repos/asf/maven/doxia/website/components/
主要内容和组件参考文档之间的链接(例如 from/plugins/maven-xxx-plugin
到 internal /components/plugins/maven-xxx-plugin
)是通过符号链接完成的。这些链接在components.links
文件content/resources/
和子目录中配置,例如plugins/components.links。
网站发布的工作原理
有关如何发布网站内容的说明被拆分为单独的文档:
- 在每个主要内容源提交(maven-site.git和maven-doxia-site.git)上,主要内容重建和发布是通过 Jenkins 作业(maven-site 作业和doxia-site 作业)触发的,它基本上运行
mvn site-deploy
(它可以如果 CI 关闭,则在本地运行...), - 在每次 Maven 组件发布时,发布管理器都会遵循“部署 Maven 组件参考文档”,最终使用Component Reference Documentation Helper轻松准备
svnmucc
命令行。