readthedocs.yml

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

# Required
version: 2

# Build all formats
formats:
  - epub

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

# don't use submodules for documentation (readthedocs fails when using submodules)
submodules:
  exclude: all
  
# https://nbsphinx.readthedocs.io/en/0.8.0/usage.html#Automatic-Creation-of-HTML-and-PDF-output-on-readthedocs.org
python:
  version: 3
  install:
    - requirements: docs/requirements.txt
  system_packages: true

# https://nbsphinx.readthedocs.io/en/0.3.3/usage.html#Automatic-Creation-of-HTML-and-PDF-output-on-readthedocs.org
# conda:
#   file: docs/environment.yml