commit | 980dcec09b9124965cf6b14337601274d868842e | [log] [tgz] |
---|---|---|
author | Anthony Baker <abaker@apache.org> | Mon Sep 11 17:10:50 2017 -0700 |
committer | Anthony Baker <abaker@apache.org> | Mon Sep 11 17:10:50 2017 -0700 |
tree | 97f9202221dbde36a6de52a9b53b30f07543f84e | |
parent | 9485c488a2044897f2a53f48e5b1c2dc81e7c860 [diff] |
Add S1P event to community page
This directory contains the source files for the project website. Website content is written in Markdown and the site files are generated from that source by a tool called Pandoc.
Source files for the website are in website/content
. Generated files for the website are in build/content
.
NOTE: To make changes to the Apache Geode User Guide, which is published to the website:
geode-book
directory for information about building a local version of the guide and adding it to the website.The website is updated by a “sync” tool that monitors the asf-site branch of our Git repo, so after making changes you must place your updated source and generated files on the asf-site branch and push. The content will be published to the Geode website after a 5-10 minute delay.
To generate the site locally, you need to install java and docker.
Source files for the website are in website/content
. When changing the content of the site, find the Markdown files that you need to edit and make your change. If you need to change the layout or styling of the site, then you will probably need to change an HTML, JS or CSS file.
To generate the site content, navigate to the top level directory of the repo and use gradle to run the nanoc
compiler:
$ ./gradlew compile
To view the generated site, run:
$ ./gradlew view
and point your browser at http://localhost:3000
. To make further changes, stop the build, edit files, recompile, and view again.
Once you are happy with your changes, commit them to the master branch. The changes also need to be propagated to the asf-site branch. Run the gradle command
$ ./gradlew publish
to checkout the asf-site branch and copy the website files. You will need to manually commit and push your changes on the asf-site branch.
The site should update in 5-10 minutes. If it does not, file a JIRA against the INFRA project or ask for advice on the Infrastructure project's HipChat room #asfinfra.