readthedocs.yml

# .readthedocs.yml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

# Build documentation in the doc/ directory with Sphinx
sphinx:
    configuration: doc/source/conf.py

# Optionally build your docs in additional formats such as PDF and ePub
formats:
    - pdf

# we do not use conda anymore because it consumes too much memory and thus crashes our builds
# see:
# - https://docs.readthedocs.io/en/stable/guides/build-using-too-many-resources.html#use-pip-when-possible
# - https://github.com/readthedocs/readthedocs.org/issues/6692
#conda:
#    environment: doc/environment.yml

# Optionally set the version of Python and requirements required to build your docs
python:
    version: 3.7
    install:
        - requirements: doc/requirements.txt
        - method: pip
          path: .