Fix mentor guide bullets.  Added FAQ to header, fixed HTML left overs.
3 files changed
tree: c3701d531c63dbf9941f4f32243a0c85358864fc
  1. .gitignore
  2. README.md
  3. assets/
  4. bake.sh
  5. build_site.sh
  6. incubator-site-groovy.iml
  7. jbake.properties
  8. pages/
  9. templates/
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.

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

Jenkins Setup

Commits to the jbake-site branch are automatically checked out and built using build_site.sh. Once this goes live those commits will go against master. The jenkins job can be found at https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20Site/ The result of the commits are pushed to the asf-site branch which are then published 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