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報告。