requirements.txt

# Pip Requirements File
# https://pip.pypa.io/en/latest/user_guide/#requirements-files
#
# Usage:
#     # Create and load a Python virtual environment.
#     python3 -m venv python_modules
#     source python_modules/bin/activate
#
#     # Install packages.
#     python3 -m pip install --upgrade wheel
#     python3 -m pip install --upgrade -r requirements.txt

Sphinx==4.5.0
sphinx-rtd-theme==1.0.0

# Need to pin exact dependencies of `Sphinx==4.5.0`, to avoid future breakages.
# E.g. `sphinxcontrib-applehelp` started requiring Python 3.9 and Sphinx 5.0.
sphinxcontrib-applehelp<=1.0.4
sphinxcontrib-devhelp<=1.0.2
sphinxcontrib-jsmath<=1.0.1
sphinxcontrib-htmlhelp<=2.0.1
sphinxcontrib-serializinghtml<=1.1.5
sphinxcontrib-qthelp<=1.0.3

# Sphinx extension "sphinxcontrib.video"
# https://github.com/sphinx-contrib/video
#sphinxcontrib-video==0.0.1.dev3
# However, the extension is unmaintained and lacks some features, such as
# support for Latex (that we use to generate PDF).
# A fork exists here with needed fixes:
# https://github.com/DavidPowell/video
git+https://github.com/DavidPowell/video.git@681dc0c522a66358428fcda83034fac054c37057