Skip to content

Latest commit

 

History

History
 
 

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
sphinx-stubs
sphinx-stubs
 
 
sphinx
sphinx
 
 
CMakeLists.txt
CMakeLists.txt
 
 
README.md
README.md
 
 
make-stub.sh
make-stub.sh
 
 

README.md

Generating the sphinx documentation

The sphinx documentation is automatically built by readthedocs.io when a commit is added to the master branch. This readme describes the steps to locally build the documentation on your PC. It is written for Ubuntu 20.04, but the steps are very similar with other Linux distributions.

1. Installing the requirements

The following dependencies are required:

sudo apt install build-essential python3 python3-pip python3-sphinx
pip3 install --user sphinx_rtd_theme

Go inside the SofaPython3/docs/sphinx directory and run

pip3 install --user -r source/requirements.txt

2. Generating the stubs

Install the pybind11-stubgen:

python -m pip install git+https://github.com/sizmailov/pybind11-stubgen.git

Make sure python can find SofaPython3 modules, i.e.:

export SOFA_ROOT=/opt/sofa_v20.12/build/install
export PYTHONPATH="$SOFA_ROOT/plugins/SofaPython3/lib/python3/site-packages"

The following line can be used to make sure Sofa bindings can be found by python:

python -c "import importlib;print('OK') if importlib.util.find_spec('Sofa') else print('NOT OK');"

Go inside the SofaPython3/docs directory and run

pybind11-stubgen -o sphinx-stubs --no-setup-py --ignore-invalid=signature --root-module-suffix="" SofaRuntime
pybind11-stubgen -o sphinx-stubs --no-setup-py --ignore-invalid=signature --root-module-suffix="" Sofa
pybind11-stubgen -o sphinx-stubs --no-setup-py --ignore-invalid=signature --root-module-suffix="" SofaExporter
pybind11-stubgen -o sphinx-stubs --no-setup-py --ignore-invalid=signature --root-module-suffix="" SofaTypes
pybind11-stubgen -o sphinx-stubs --no-setup-py --ignore-invalid=signature --root-module-suffix="" splib