docs: Use RTD theme locally

Ensure out local docs builds look similar to what's on ReadTheDocs.

Some unnecessary noise is removed from the doc configuration file.

Signed-off-by: Stephen Finucane <stephen@that.guru>

Author: stephenfin

docs/conf.py

@@ -2,6 +2,12 @@
 #
 # git-pw documentation build configuration file
 
+try:
+    import sphinx_rtd_theme
+    has_rtd_theme = True
+except ImportError:
+    has_rtd_theme = False
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -46,11 +52,6 @@
 # Usually you set "language" from the command line for these cases.
 language = None
 
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = []
-
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
 
@@ -65,15 +66,5 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'default'
-
-# 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
-# documentation.
-#
-# html_theme_options = {}
-
-# 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 = []
+if has_rtd_theme:
+    html_theme = 'sphinx_rtd_theme'

test-requirements.txt

@@ -3,3 +3,4 @@ sphinx>=1.5,<2.0
 sphinx-click>=1.0,<2.0
 click-man>=0.2,<0.3
 reno>=2.0,<3.0
+sphinx_rtd_theme==0.3.1