|author||Dave Fisher <firstname.lastname@example.org>||Sat Oct 10 11:51:18 2020 -0700|
|committer||GitHub <email@example.com>||Sat Oct 10 11:51:18 2020 -0700|
This is the content and build scripts for http://incubator.apache.org/
You can fork from https://github.com/apache/incubator, test your changes as described below and raise a pull request.
Use the firstname.lastname@example.org mailing list to contact the Incubator PMC which manages this website.
Commits to the
master branch are automatically checked out and built using
build_site.sh by the Incubator GIT Site - part 2 Jenkins job. The results are pushed to the
content folder of the
asf-site branch which is in turn published automatically to http://incubator.apache.org/ by the ASF's
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 regularly. The results are stored in the
reserve folder of the
For now that Clutch data is still managed in svn, at http://svn.apache.org/repos/asf/incubator/public/trunk/ , see the build scripts for more info. The projects folder (podling status pages) and the ip-clearance folders are also still in svn and the html is built using
ant docs in the
Any build failures are reported to email@example.com mailing list.
The website is built using JBake and Groovy templates. The builds for the website do require internet access.
JBAKE_HOMEpointing to your JBake installation, e.g.
To test the site locally, use
./build_local.sh -b -s
This builds the site, serves it locally at http://localhost:8820/ and rebuilds the content fairly quickly if any changes are made.
That script can be called with any of the arguments you would pass to jbake.
Warning do not run the clutch build scripts unless you are sure you understand them, and please be careful not to commit any of the resulting assets and pages to the git master branch. That content and data is only committed to the
reservefolder as mentioned below.
build_local_clutch.sh script can be used to build the Clutch data, but that‘s updated automatically by the Jenkins builds as
build_clutch.sh mentioned below so it’s not required unless you want to test that.
Most of the pages in the site are written using Asciidoctor. While it is a form of asciidoc it does have some syntax differences that are worth reviewing
The site templates are written in groovy scripts. Even though the files end with
.gsp they are not GSP files and do not have access to tag libraries. You can run custom code in them, similar to what is done in homepage.gsp and projectspage.gsp.
In addition to the clutch pages several data files are provided: