Presto documentation is authored in rst format and published using Sphinx. The rst files are located in presto-docs/src/main/sphinx and sub-folders.
Building the presto-docs module requires Python3 with virtual environment. You can check if you have it installed by running:
python3 -m venv --help
To install venv:
python3 -m pip install --user virtualenv
The default build uses Apache Maven to download dependencies and generate the HTML. You can run it as follows:
cd presto-docs
mvn install
Or, to build the documentation more quickly:
cd presto-docs
./build
When the build is complete, you'll find the output HTML files in the target/html/ folder.
To view the docs, you can open the file target/html/index.html in a web browser on macOS with
open target/html/index.html
Or, you can start a web server e.g., using Python:
cd target/html/
python3 -m http.server
and open http://localhost:8000 in a web browser.