介绍
本文档提供了部署主要 Maven https://maven.apache.org网站的分步说明。
过时此文档已过时:随着站点源代码迁移到 Git,不再使用 Apache CMS。它被 Git 编辑(最终通过 GitHub 以及可从面包屑访问的“编辑”链接)取代,然后是 Jenkins 作业以构建并提交到 svnpubsub。
有关整个网站发布的说明,请参阅Maven 网站介绍。
概述
自2012年12月起,整体网站使用svnpubsub机制,主网站使用Apache CMS:
主要网站发布的工作原理
Maven 主网站 ( https://maven.apache.org ) 是使用maven-site-plugin从存储在 svn 中的源代码树生成的:https://svn.apache.org/repos/asf/maven/site/trunk。
编辑源内容
您可以通过 2 种方式编辑源内容:
- 通过 Web 浏览器
使用CMS UI :
- 转到https://cms.apache.org/maven/。
- 单击链接“获取 Maven 工作副本”。
- 导航到要修改的内容。
- 修改内容后,使用“提交”按钮提交。
- 在本地签出源内容,使用您喜欢的文本编辑器对其进行修改,最终测试结果 (
mvn site
),然后签入源修改。
在 svn 中修改源码树后,会触发Buildbot 作业:
- 它使用maven-site-plugin构建 HTML 站点:
mvn site
, - 它将生成的 HTML 内容发布到CMS 暂存 svn 区域,
- svnpubsub 机制将 svn CMS 登台内容传输到实时 CMS 登台站点:http ://maven.staging.apache.org ,
发布网站内容
如果一切正常,请使用CMS 发布操作发布修改。
引擎盖下:
- CMS 将 CMS 暂存 svn 区域内容复制到网站生产 svn 区域,
- svnpubsub 机制将 svn 制作内容传输到现场制作站点:http ://maven.apache.org 。
Doxia 网站发布的工作原理
Doxia 使用完全相同的机制:
- 您可以在本地或通过CMS UI编辑svn 源代码树,
- Buildbot 作业构建网站并更新网站登台 svn 区域,
- svnpubsub 发布到现场临时站点,
- 如果一切正常,请使用CMS 发布操作发布修改,
- CMS 将 CMS 暂存 svn 区域内容复制到网站生产 svn 区域,
- svnpubsub 机制将 svn 制作内容传输到现场制作站点:http ://maven.apache.org/doxia ,其
extpaths.txt