tree: 6adc6242a48cbba6d0078cb64a3db125d47b8610 [path history] [tgz]
  1. _data/
  2. _docs/
  3. _includes/
  4. _layouts/
  5. _plugins/
  6. _posts/
  7. _sass/
  8. community/
  9. css/
  10. develop/
  11. downloads/
  12. fonts/
  13. img/
  14. news/
  15. .gitignore
  16. Gemfile
  17. README.md
  18. _config.yml
  19. add-avatica-go-docs.sh
  20. doap_calcite-avatica.rdf
  21. docker-compose.yml
  22. favicon.ico
  23. index.html
site/README.md

Apache Calcite Avatica site

This directory contains the code for the Avatica web site, a sub-directory of the Apache Calcite web site.

You can build the site manually using your environment or use the docker compose file.

Building website on a host system

Setup your environment

Similar to the instructions to set up the Calcite web site.

Site generation currently works best with ruby-2.5.1.

  1. cd site
  2. git clone https://gitbox.apache.org/repos/asf/calcite-site.git target. The site will be generated to target/avatica, so it will be ready for commit.
  3. sudo apt-get install rubygems ruby2.5-dev zlib1g-dev (linux)
  4. sudo gem install bundler
  5. Add avatica-go content: ./add-avatica-go-docs.sh
  6. bundle install

Build javadoc

  1. cd $avatica_project_directory
  2. ./gradlew javadocAggregate # the result is placed to build/docs/javadocAggregate

Running website locally

Before opening a pull request, you can preview your contributions by running from within the directory:

  1. bundle exec jekyll serve
  2. Open http://localhost:4000/avatica/ (note the trailing slash)

Building the website

  1. bundle exec jekyll build
  2. The result is produced to target/avatica

Building website with Docker

Setup your environment

  1. Install docker
  2. Install docker-compose

Build site

  1. cd site
  2. docker-compose run build-site

Generate javadoc

  1. cd site
  2. docker-compose run generate-javadoc

Running development mode locally

You can preview your work while working on the site.

  1. cd site
  2. docker-compose run --service-ports dev

The web server will be started on http://localhost:4000/avatica/ (note the trailing slash)

As you make changes to the site, the site will automatically rebuild.

Pushing to site

Push the Calcite site, which includes avatica as a sub-directory, as described in its README.