docs refresh, support markdown && move to furo (#2131)

python · Aug 28, 2022 · 8e9dedc · 8e9dedc
1 parent 2c3c073
commit 8e9dedc
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 9 deletions.
diff --git a/docs-requirements.txt b/docs-requirements.txt
@@ -1,2 +1,3 @@
-Sphinx
-sphinx_rtd_theme
+sphinx
+myst-parser
+furo
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -8,6 +8,7 @@
     'sphinx.ext.autodoc',
     'sphinx.ext.todo',
     'sphinx.ext.viewcode',
+    'myst_parser',
 ]
 
 templates_path = ['_templates']
@@ -22,18 +23,19 @@
 # The full version, including alpha/beta/rc tags.
 release = '1.0'
 
+html_title = 'Python.org Website'
+
 pygments_style = 'sphinx'
 
-try:
-    import sphinx_rtd_theme
-except ImportError:
-    html_theme = 'default'
-else:
-    html_theme = 'sphinx_rtd_theme'
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+html_theme = "furo"
 
 htmlhelp_basename = 'PythonorgWebsitedoc'
 
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+
 
 # -- Options for LaTeX output ---------------------------------------------