From 7cdf6f1cc83e69cc78b5a610389143d7f3e53335 Mon Sep 17 00:00:00 2001 From: Stephen Diehl Date: Thu, 8 Dec 2016 12:23:15 +0000 Subject: [PATCH] markdown source processor --- docs/{Either.rst => Either.md} | 0 docs/conf.py | 12 ++++++++++-- 2 files changed, 10 insertions(+), 2 deletions(-) rename docs/{Either.rst => Either.md} (100%) diff --git a/docs/Either.rst b/docs/Either.md similarity index 100% rename from docs/Either.rst rename to docs/Either.md diff --git a/docs/conf.py b/docs/conf.py index 2b8a07eaf..afc5b41fc 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -20,6 +20,9 @@ # import sys # sys.path.insert(0, os.path.abspath('.')) +import sphinx_rtd_theme +from recommonmark.parser import CommonMarkParser + # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. @@ -40,7 +43,11 @@ templates_path = ['_templates'] # You can specify multiple suffix as a list of string: # # source_suffix = ['.rst', '.md'] -source_suffix = '.rst' + +source_parsers = { + '.md': CommonMarkParser, +} +source_suffix = ['.rst', '.md'] # The encoding of source files. # @@ -121,7 +128,7 @@ todo_include_todos = False # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # -html_theme = 'alabaster' +html_theme = "sphinx_rtd_theme" # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the @@ -131,6 +138,7 @@ html_theme = 'alabaster' # Add any paths that contain custom themes here, relative to this directory. # html_theme_path = [] +html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] # The name for this set of Sphinx documents. # " v documentation" by default.