Myst integration.

.gitignore

@@ -1,3 +1,4 @@
+venv_bash/
 # Custom -- docs build files
 docs/covasim*.rst
 docs/modules.rst

.readthedocs.yaml

@@ -16,8 +16,8 @@ sphinx:
    configuration: docs/conf.py
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF
-formats:
-   - pdf
+#formats:
+#  - pdf
 
 # Optionally declare the Python requirements required to build your docs
 python:

docs/conf.py

@@ -15,6 +15,7 @@
 import subprocess
 import sys
 import sphinx_rtd_theme
+import myst_parser
 from datetime import datetime
 import covasim as cv
 
@@ -46,6 +47,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'myst_parser',
     'sphinx.ext.mathjax',
     'sphinx.ext.githubpages',
     'sphinx.ext.autodoc',
@@ -78,7 +80,7 @@
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 master_doc = 'index'
 
 # General information about the project.

docs/requirements.txt

@@ -1,3 +1,4 @@
+myst-parser~=2.0.0
 pytest
 sphinx-rtd-theme
 sphinxcontrib-napoleon