# 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 docs/ directory with Sphinx
sphinx:
  configuration: docs/conf.py

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

# Optionally set the version of Python and requirements required to build your docs
python:
  version: 3.7
  install:
    - requirements: docs/requirements.txt
  # For RTD, we'd like to use the setup.cfg config, but then it will try to build
  # pikepdf instead of using the wheel. See the shim in docs/conf.py that avoids that.
  # We'd like to derive requirements.txt from setup.cfg, but pkg_resources doesn't
  # understand, apparently.
  # install:
  #   - method: pip
  #     path: .
  #     extra_requirements:
  #       - docs