AGE Project

Clone this repo:
  1. 2cbee25 Added MERGE documentation by Josh Innis · 4 weeks ago master
  2. ed09d17 Fix result of querying unexisting index in list (#43) by Pieterjan De Potter · 4 months ago
  3. 6556377 Explain CTEs by Pieterjan De Potter · 4 months ago
  4. 05e19f6 Fix typo by Pieterjan De Potter · 4 months ago
  5. 3763a98 Merge branch 'age_laod_documentation' into master by Shoaib · 4 months ago

Apache AGE website

Introduction

  • The master branch contains the source code of the latest version of the documentation.
  • vX.Y.Z Branches contain the source code of the documentation of releases.
  • The asf-site branch contains the static webpage code, as well as the build static version of the documenation (in the docs folder). The docs folder should not be manually updated.

Build the documentation locally (first time)

  • Install requirements (the latex and dvisvgm commands are required to display math)
sudo apt install python3 virtualenv texlive-latex-base texlive-latex-extra texlive-extra-utils
  • Clone this repository
  • Navigate to the root of the repository
  • Create a python virtual environment
virtualenv -p python3 venv
  • Activate the virtual environment
source venv/bin/activate
  • Install the python requirements
pip install -r requirements.txt
  • Build the documentation
    • From :warning: remote branches

      sphinx-multiversion docs build/html
      

      The documentation should now be in the build/html folder, with a subfolder per remote branch (version).

    • From the current folder

      sphinx-build docs build/html/current
      

      The documentation for the current local branch should now be in the build/html/current folder (no subfolders).

Build documentation locally (after initial setup)

  • Navigate to the root of the repository

  • Activate the virtual environment if not yet active

source venv/bin/activate
  • Build the documentation
    • From :warning: remote branches

      sphinx-multiversion docs build/html
      

      The documentation should now be in the build/html folder, with a subfolder per remote branch (version).

    • From the current folder

      sphinx-build docs build/html/current
      

      The updated documentation for the current local branch should now be in the build/html/current folder (no subfolders).