incubator

Apache孵化器网站

这是http://incubator.apache.org/的内容和构建脚本

为网站内容做出贡献

您可以从https://github.com/apache/cubator分叉，如下所述测试您的更改并提出拉动请求。

使用常规@incubator.ao邮件列表与管理该网站的孵化器PMC联系。

自动发布 - 网站和离合器数据

由孵化器git网站自动检查并使用build_site.sh构建master分支 - 第2部分Jenkins作业。将结果推向asf-site分支的content文件夹，然后由ASF的gitwcsub机制自动发布到http://incubator.apache.org/。

The data for http://incubator.apache.org/clutch/ takes longer to build so it is handled by a separate SVN Clutch Analysis - part 1 Jenkins job that runs the build_clutch.sh script that's scheduled to run daily and is also triggered by svn changes using the Trigger-Clutch-Analysis-on-SVN-Change Jenkins job.结果存储在asf-site分支的reserve文件夹中

目前，离合器数据仍在SVN中，http://svn.apache.org/repos/asf/incubator/public/public/trunk/，有关更多信息，请参见构建脚本。项目文件夹（Podling状态页）和IP清算文件夹仍在SVN中，HTML是使用build_clutch.sh脚本中的ant docs构建的。

任何构建失败都报告给[email protected]邮件列表。

本地构建网站的先决条件

该网站是使用Jbake和Groovy模板构建的。网站的构建确实需要互联网访问。

• 从http://jbake.org/download.html安装jbake
  • 目前，它似乎需要2.6.0或更高版本。
• 创建一个环境变量JBAKE_HOME指向您的jbake安装，例如
  • export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4
• 确保您在本地拥有JVM，例如OpenJDK

在当地建立和测试该站点

要在本地测试该站点，请使用

 ./build_local.sh -b -s

这建立了该站点，并在http：// localhost：8820/and在本地提供服务，如果进行了任何更改，请迅速重建内容。

该脚本可以通过您将要传递给Jbake的任何参数来调用。

构建离合器和传统SVN内容（如果您知道自己在做什么）

警告不要运行离合器构建脚本，除非您确定自己了解它们，请注意不要将任何结果的资产和页面提交给Git Master分支。如下所述，该内容和数据仅致力于asf-site的reserve文件夹。

build_local_clutch.sh脚本可用于构建离合器数据，但是jenkins构建以build_clutch.sh形式自动更新，因此，除非您想对其进行测试，否则不需要。

Asciidoctor

网站中的大多数页面都是使用asciidoctor编写的。虽然这是一种asciidoc的形式，但确实有一些语法差异值得审查

Groovy模板

该站点模板是用Groovy脚本编写的。即使文件以.gsp结尾，它们不是GSP文件，也无法访问标签库。您可以在其中运行自定义代码，类似于homepage.gsp和projectspage.gsp中的操作。

离合器数据文件

除离合器页面外，还提供了几个数据文件：

• 离合器json包含所有当前载体的最新离合器分析。
• clutch.txt包含一个当前载体的列表，
• Report_due_1.txt开发邮件列表，用于第1组中的Podlings报告。
• Report_due_2.txt Dev邮件列表，用于第2组中的Podlings报告。
• Report_due_3.txt Dev邮件列表，用于第3组中的Podlings报告。