Build documentation¶
The main documentation and Python documentation is written in reStructuredText and generated by sphinx. The C++ API documentation is generated by Doxygen.
Documentation can be built on Ubuntu or macOS. Building documentation on Windows may also be possible but it is not officially tested.
If you’re building documentation on a computer without a display, please use Headless rendering, otherwise the Jupyter tutorials will fail to execute.
Prerequisites¶
1. Install system dependencies¶
Ubuntu
sudo apt-get -y install doxygen texlive texlive-latex-extra ghostscript pandoc
macOS
First, install a TeX distribution such as MacTeX.
brew install ghostscript pandoc doxygen
2. Install Python dependencies¶
pip install -r docs/requirements.txt
Build¶
First, clone and build Open3D from source and install the Open3D Python package. Visit Build from source for details. After configuration, install the Open3D Python package with:
make install-pip-package -j$(nproc)
cd docs
# Run `python make_docs.py --help` to usage of the flags.
# Example usage: execute notebooks when it has not been executed.
python make_docs.py --clean_notebooks --execute_notebooks=auto --sphinx --doxygen
The docs html will be saved in docs/_out
folder.
Preview¶
Open docs/_out/html/index.html
in a web browser to preview the docs.
google-chrome docs/_out/html/index.html