The Roller website is generated using JBake and Maven. Content is written in Markdown. Page layouts are written in HTML within FreeMarker template files. The HTML uses the Bootstrap framework. The website is stored in a Git repository and when you push your changes to the asf_site branch, after a short delay, the changes will go live on the website.
This page is not a tutorial. To update the website you will have to understand how JBake, Markdown and possibly HTML and Bootstrap work. Refer to the links above for documentation on those topics. You'll also need this software installed on your machine to update the website:
|-- content <-- The automatically generated website, don't edit things here!
|
|-- sources
|
|-- pom.xml <-- Maven POM file that controls the generation
|
|-- src
|
|-- main
|
|-- jbake
|
|-- assets <-- Static files to be copied into the generated website
|
|-- content <-- One markdown page for each page of the website
|
|-- templates <-- Freemarker templates for website HTML layout
Use Git to clone the roller-website repo, for example:
git clone https://git-wip-us.apache.org/repos/asf/roller-website.git
Go to the roller-website directory, make sure you are on the asf-site branch:
cd roller-website
git checkout asf-site
Make your changes to Markdowna (.md) and FreeMarker (.ftl) files under the source directory.
Generate the website via Maven. Running mvn install will generate the website into the roller-website/content directory.
cd roller-website/sources
mvn install
Or alternatively, run mvn jbake:inline so you can view the website locally at http://localhost:8080
Once the site looks good, commit your changes to the asf_site branch.
git commit -m "my wonderful changes" .
git push origin asf-site
Push your changes to the ASF Git repo. The ASF website infrastructure will pick up your changes and publish them to the website.