Merge pull request #658 from pz-max/doc-patch

fix docs build in readthedocs
PyPSA · May 7, 2023 · 1fbe971 · 1fbe971
2 parents 4c41411 + 702bb59
commit 1fbe971
Show file tree

Hide file tree

Showing 4 changed files with 12 additions and 3 deletions.
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -4,8 +4,14 @@
 
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  apt_packages:
+  - graphviz
+
 python:
-  version: 3.8
   install:
   - requirements: doc/requirements.txt
-  system_packages: true
+  system_packages: false
diff --git a/doc/conf.py b/doc/conf.py
@@ -36,6 +36,7 @@
 extensions = [
     #'sphinx.ext.autodoc',
     #'sphinx.ext.autosummary',
+    "myst_parser",
     "sphinx.ext.autosectionlabel",
     "sphinx.ext.intersphinx",
     "sphinx.ext.todo",

diff --git a/doc/release_notes.rst b/doc/release_notes.rst
@@ -17,7 +17,7 @@ Upcoming Release
 
 * Renamed script file from PyPSA-EUR ``build_load_data`` to ``build_electricity_demand`` and ``retrieve_load_data`` to ``retrieve_electricity_demand``.
 
-
+* Fix docs readthedocs built
 
 * Add plain hydrogen turbine as additional re-electrification option besides
   hydrogen fuel cell. Add switches for both re-electrification options under

diff --git a/doc/requirements.txt b/doc/requirements.txt
@@ -2,9 +2,11 @@
 #
 # SPDX-License-Identifier: CC0-1.0
 
+setuptools
 sphinx
 sphinx_book_theme
 sphinxcontrib-bibtex
+myst-parser  # recommark is deprecated, https://stackoverflow.com/a/71660856/13573820
 
 pypsa
 vresutils>=0.3.1