commit | c3cb8a588ccafc020dd2c71a22a61f4e3c1c956a | [log] [tgz] |
---|---|---|
author | Bertrand Delacretaz <bdelacretaz@apache.org> | Wed Apr 03 10:49:18 2019 +0200 |
committer | Bertrand Delacretaz <bdelacretaz@apache.org> | Wed Apr 03 10:49:35 2019 +0200 |
tree | 90c0f3bd813de3383c849d02427a7be5ef4ea5b2 | |
parent | 724327ee8e074808c20c607b0ed7e453ebbb8133 [diff] |
Check for JBAKE_HOME
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 general@incubator.a.o mailing list to contact the Incubator PMC which manages this website.
The website is built using JBake and Groovy templates. The builds for the website do require internet access.
JBAKE_HOME
pointing to your JBake installation.export JBAKE_HOME=/home/jenkins/tools/jbake/jbake-2.6.3
export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4
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.
The build_clutch.sh
script can be used to build the Clutch data, but that‘s updated automatically by the Jenkins builds mentioned below so it’s not required unless you want to test that.
TODO: not sure if this is still valid, JBake 2.6.4 replaces the site.host variable automatically when running locally so everything should by fine provided all URLs are computed based on the
site.host
variable.
By default the site URLs redirect to incubator.apache.org
; to change this edit jbake.properties
and uncomment the line referencing localhost
. Alternatively you can rename jbake-local.properties
, but do not commit unwanted changes to that file!
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 gitwcsub
mechanism.
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 asf-site
branch
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.
Any build failures are reported to cvs@incubator.a.o mailing list.
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.