You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

The ZooKeeper website is built using Jekyll formatted in Markdown. The production website is updated using gitpubsub via the zookeeper.git/asf-site branch.

The source to generate the website can be found here: https://github.com/apache/zookeeper/tree/website

The live website is whatever is committed to asf-site, here: https://github.com/apache/zookeeper/tree/asf-site . Any changed committed to this branch are immediately replicated to the live production website at http://zookeeper.apache.org/

Information on running the website generation process can be found in the README.md file on the website branch, similar for managing the asf-site.

Steps to update the site:

  1. git clone -b website https://git-wip-us.apache.org/repos/asf/zookeeper.git
  2. update the appropriate pages, typically a markdown file e.g. credits.md, etc...
  3. jekyll build
  4. cp -rp _released_docs _site/doc # these are the static release docs, they are not generated
  5. # at thispoint verify that the site is working properly - open _site/index.html
    # once you are happy move on to the next step...
  6. git commit -m "<appropriate commit message>"
  7. git checkout asf-site
  8. rm -fr content
  9. mv _site content
  10. git add content
  11. # verify that content/index.html and other generated files are proper, open in a browser
    "git status" should show modified files for the markdown that you changed
  12. git commit -m "<appropriate commit message>"
  • No labels