Use MyST instead of pandoc with a Makefile

.github/workflows/ci.yml

@@ -45,10 +45,6 @@ jobs:
         pre-build-command: |
           python -m pip install --upgrade pip setuptools wheel
           python -m pip install -e .[docs]
-          mkdir -p docs/source/wiki/wiki_examples/selected_plots
-          cp docs/source/wiki_editable/wiki_examples/selected_plots/* docs/source/wiki/wiki_examples/selected_plots/
-          find docs/source/wiki_editable -name '*.md' -exec sh -c 'pandoc -f markdown -t rst "$$1" -o "docs/source/wiki/$$(basename "$$1" .md).rst"' _ {} \;
-          sphinx-apidoc --force --output-dir docs/source quapy
         docs-folder: "docs/"
     - name: Publish documentation
       run: |

docs/.gitignore

@@ -1,2 +1 @@
 build/
-source/wiki/

docs/Makefile

@@ -14,20 +14,7 @@ help:
 
 .PHONY: help Makefile
 
-# Convert Markdown files to reStructuredText before building HTML
-markdown_to_rst:
-	@echo "Converting Markdown files to reStructuredText"
-	@mkdir -p $(SOURCEDIR)/wiki/wiki_examples/selected_plots
-	@cp $(SOURCEDIR)/wiki_editable/wiki_examples/selected_plots/* $(SOURCEDIR)/wiki/wiki_examples/selected_plots/
-	@find $(SOURCEDIR)/wiki_editable -name '*.md' -exec sh -c 'pandoc -f markdown -t rst "$$1" -o "$(SOURCEDIR)/wiki/$$(basename "$$1" .md).rst"' _ {} \;
-	@echo "Conversion complete."
-
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-html: markdown_to_rst
+%: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-# # Catch-all target: route all unknown targets to Sphinx using the new
-# # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-# %: Makefile
-# 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/source/.gitignore

@@ -0,0 +1 @@
+!*.png

docs/source/conf.py

@@ -35,9 +35,12 @@ extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.autosummary',
     'sphinx.ext.viewcode',
-    'sphinx.ext.napoleon'
+    'sphinx.ext.napoleon',
+    'myst_parser',
 ]
 
+source_suffix = ['.rst', '.md']
+
 templates_path = ['_templates']
 
 # List of patterns, relative to source directory, that match files and

setup.py

@@ -127,7 +127,7 @@ setup(
        'bayes': ['jax', 'jaxlib', 'numpyro'],
        'composable': ['qunfold @ git+https://github.com/mirkobunse/qunfold@v0.1.3'],
        'tests': ['certifi'],
-       'docs' : ['sphinx-rtd-theme'],
+       'docs' : ['sphinx-rtd-theme', 'myst-parser', 'qunfold @ git+https://github.com/mirkobunse/qunfold@v0.1.3'],
     },
 
     # If there are data files included in your packages that need to be