From a182481f429f7a3137fd0ccc4c8f74fd8efc8e09 Mon Sep 17 00:00:00 2001 From: Kenneth Hoste Date: Tue, 9 Nov 2021 18:16:18 +0100 Subject: [PATCH] fix building of docs on ReadTheDocs by pinning to old Sphinx/docutils version (cfr. https://github.com/sphinx-doc/sphinx/issues/9811) --- .readthedocs.yml | 19 +++++++++++++++++++ docs/requirements.txt | 2 ++ 2 files changed, 21 insertions(+) create mode 100644 .readthedocs.yml create mode 100644 docs/requirements.txt diff --git a/.readthedocs.yml b/.readthedocs.yml new file mode 100644 index 000000000..9e089575f --- /dev/null +++ b/.readthedocs.yml @@ -0,0 +1,19 @@ +# .readthedocs.yml +# Read the Docs configuration file +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# version of configuration file (required) +version: 2 + +# Build from the docs/ directory with Sphinx +sphinx: + configuration: docs/source/conf.py + +# also build docs in PDF format +formats: [pdf] + +# Optionally set the version of Python and requirements required to build your docs +python: + version: 3.7 + install: + - requirements: docs/requirements.txt diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 000000000..db0fafbdd --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1,2 @@ +docutils<0.18 +sphinx==1.8.5