tree: 7307695976d0b9a60e6888832d046a6b6bca7f53 [path history] [tgz]
  1. _data/
  2. _includes/
  3. _layouts/
  4. _plugins/
  5. _sass/
  6. bps/
  7. community/
  8. css/
  9. docker/
  10. docs/
  11. fonts/
  12. img/
  13. js/
  14. project/
  15. scripts/
  16. .gitignore
  17. _config.apache.yml
  18. _config.local.yml
  19. _config.staging.yml
  20. _config.yml
  21. Gemfile
  22. Gemfile.lock
  23. index.html
  24. Makefile
  25. README.md
  26. releases.md
site/README.md

The BookKeeper Website

Welcome to the code for the Apache BookKeeper website! Instructions on building the site and running it locally can be found here in this README.

Tools

The site is built using Jekyll and Sass.

I'll provide more specific info here later.

Prerequisities

In order to run the site locally, you need to have the following installed:

  • Ruby 2.3.1 and Rubygems
  • The Javadoc CLI tool

Setup

$ make setup

Building the site

$ make build

Please note that this will not build the Javadoc. That requires a separate command:

$ make javadoc

Serving the site locally

To run the site in interactive mode locally:

$ make serve

Then navigate to localhost:4000. As you make changes, the browser will auto-update.

Staging website for reviews

When you submit a pull request for modifying website or documentation, you are recommended to make your changes live for reviews.

Here are a few steps to follow to stage your changes:

  1. You need to create a github repo called bookkeeper-staging-site under your github account. You can fork this staging repo as well.
  2. In your bookkeeper-staging-site repo, go to Settings > GitHub Pages. Enable GitHub Pages on master branch /docs folder.
  3. Make changes to the website, follow the steps above to verify the changes locally.
  4. Once the changes are verified locally, you can run make staging. It will generate the files under site/local-generated.
  5. Run scripts/staging-website.sh. It would push the generated website to your bookkeeper-staging-site.
  6. Your changes will be live on https://<your-github-id>.github.io/bookkeeper-staging-site.

If you have any ideas to improve the review process for website, please feel free to contact us at dev@bookkeeper.apache.org.