Building Kyuubi Documentation#

Follow the steps below and learn how to build the Kyuubi documentation as the one you are watching now.

Install & Activate virtualenv#

Firstly, install virtualenv, this is optional but recommended as it is useful to create an independent environment to resolve dependency issues for building the documentation.

pip install virtualenv

Switch to the docs root directory.


Create a virtual environment named ‘kyuubi’ or anything you like using virtualenv if it’s not existing.

virtualenv kyuubi

Activate it,

source ./kyuubi/bin/activate

Install all dependencies#

Install all dependencies enumerated in the requirements.txt.

pip install -r requirements.txt

Create Documentation#

Make sure you are in the $KYUUBI_SOURCE_PATH/docs directory.

linux & macos

make html


make.bat html

If the build process succeed, the HTML pages are in $KYUUBI_SOURCE_PATH/docs/_build/html.

View Locally#

Open the $KYUUBI_SOURCE_PATH/docs/_build/html/index.html file in your favorite web browser.