Mirror of Apache incubator
CSS Groovy JavaScript Shell HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assets Redirect /wave to status page. Jan 27, 2018
pages
templates
.gitignore
README.md
bake.sh
build_site.sh
incubator-site-groovy.iml
jbake.properties

README.md

Apache Incubator Website

Prerequisites

The website is built using JBake and a Groovy template. The builds for the website do require internet access.

Clone the Source code

If you have write access to incubator, you should clone it from https://git-wip-us.apache.org/repos/asf/incubator.git otherwise you can fork from our github mirror https://github.com/apache/incubator and raise a pull request.

Building & Running the site

There is a custom bake.sh file that is used to build the website. You can call it with any of the arguments you would pass to jbake. The easiest way to use it is to run ./bake.sh -b -s This will start up JBake in a watching mode as you make changes it will refresh after a short period of time. While working with it locally, you'll notice that the site URLs redirect to incubator.apache.org; to change this edit jbake.properties and uncomment the line referencing localhost

Automatic build and publishing - Jenkins Setup

Commits to the master branch are automatically checked out and built using build_site.sh.

The corresponding jenkins job can be found at https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20Site/

The result of the website build are pushed to the asf-site branch which are then published automatically using gitwcsub

Asciidoctor

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

Groovy Templates

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 .