Using Sphinx for building documentation

Author:

Zhenyu Yang <yangzhenyu@sust.edu.cn>

Date:

Mar 22, 2026

Sphinx is a powerful documentation generator that converts reStructuredText files into various output formats, including HTML and PDF.

This guide provides an overview of how to use Sphinx for building the documentation of this project.

Installation

To install Sphinx, you can use pip:

python3 -m venv .venv
source .venv/bin/activate
pip install -r docs/requirements.txt

Building the documentation

To build the documentation, navigate to the docs directory and run the following command:

make html

This will generate the HTML documentation in the _build/html directory. You can open the index.html file in a web browser to view the documentation.