Merge pull request #130 from CITCOM-project/sphinx-markdown

Sphinx markdown

Author: bobturneruk

docs/source/conf.py

@@ -13,29 +13,26 @@
 import os
 import sys
 
-#Include root directory of project
+# Include root directory of project
 sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "../..")))
 
 
 # -- Project information -----------------------------------------------------
 
-project = 'Causal Testing'
-copyright = '2021, Andrew Clark, Michael Foster, Neil Walkinshaw, Rob Hierons, Bob Turner'
-author = 'Andrew Clark, Michael Foster, Neil Walkinshaw, Rob Hierons, Bob Turner'
+project = "Causal Testing"
+copyright = "2021, Andrew Clark, Michael Foster, Neil Walkinshaw, Rob Hierons, Bob Turner"
+author = "Andrew Clark, Michael Foster, Neil Walkinshaw, Rob Hierons, Bob Turner"
 
 
 # -- General configuration ---------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = [
-    'autoapi.extension',
-    'sphinx.ext.autosectionlabel'
-]
+extensions = ["autoapi.extension", "myst_parser", "sphinx.ext.autosectionlabel"]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -47,12 +44,12 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'sphinx_rtd_theme'
+html_theme = "sphinx_rtd_theme"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-#html_static_path = ['_static']
+# html_static_path = ['_static']
 
-#Path to generate documentation from using sphinx AutoAPI
-autoapi_dirs = [os.path.abspath(os.path.join('..', '..', 'causal_testing'))]
+# Path to generate documentation from using sphinx AutoAPI
+autoapi_dirs = [os.path.abspath(os.path.join("..", "..", "causal_testing"))]

docs/source/glossary.md

@@ -0,0 +1,3 @@
+# Glossary
+
+TDB

docs/source/index.rst

@@ -27,6 +27,12 @@ Causal testing is a causal inference-driven framework for functional black-box t
 
    json_front_end
 
+.. toctree::
+   :maxdepth: 1
+   :caption: Glossary
+
+   glossary
+
 Indices and tables
 ==================
 

docs/source/requirements.txt

@@ -1,3 +1,4 @@
-sphinx==4.2.0
-sphinx-autoapi==1.8.4
-sphinx-rtd-theme==1.0.0
+Sphinx==5.3.0
+myst-parser==0.18.1
+sphinx-autoapi==2.0.1
+sphinx-rtd-theme==1.1.1

setup.py

@@ -15,9 +15,19 @@
 ]
 
 # Additional dependencies for development
-dev_requirements = ["autopep8", "isort", "pytest", "pylint", "black"]
+dev_requirements = [
+    "autopep8",
+    "isort",
+    "pytest",
+    "pylint",
+    "black",
+    "autoapi",
+    "myst-parser",
+    "sphinx-autoapi",
+    "sphinx_rtd_theme",
+]
 
-readme = open("README.md", encoding = "UTF-8").read()
+readme = open("README.md", encoding="UTF-8").read()
 
 setup(
     name="causal_testing_framework",