Simplify documentation requirements

dev-requirements.txt

@@ -7,8 +7,7 @@ pymongo>=3.3,<4.0
 twine
 twython
 spacy>=2.3,<3.0
-sphinx>=5.3,<8.1
-sphinx_rtd_theme
+sphinx>=5.3,<8.2
 pyyaml>=5.3,<5.4
 git+https://github.com/gunthercox/chatterbot-corpus.git@master
 https://github.com/explosion/spacy-models/releases/download/en_core_web_sm-2.3.0/en_core_web_sm-2.3.0.tar.gz#egg=en_core_web_sm

docs/conf.py

@@ -1,8 +1,8 @@
 import os
 import sys
 import configparser
+from pathlib import Path
 from datetime import datetime
-import sphinx_rtd_theme
 
 
 config = configparser.ConfigParser()
@@ -17,6 +17,7 @@
 # This lets us ensure that the source package is imported, and used to generate the documentation.
 sys.path.insert(0, parent_directory)
 
+sys.path.append(str(Path('_ext').resolve()))
 
 # Sphinx extension modules
 extensions = [
@@ -27,7 +28,8 @@
     'sphinx.ext.intersphinx',
     'sphinx.ext.mathjax',
     'sphinx.ext.todo',
-    'sphinx.ext.viewcode'
+    'sphinx.ext.viewcode',
+    'github',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -80,16 +82,25 @@
 
 # -- Options for HTML output ----------------------------------------------
 
-html_theme = 'sphinx_rtd_theme'
+html_theme = 'classic'
 
 # 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 = {
-    'logo_only': True
+    'externalrefs': True,
+    'sidebarbgcolor': '#300a24',
+    'relbarbgcolor': '#26001b',
+    'footerbgcolor': '#13000d',
+    'headbgcolor': '#503949',
+    'headtextcolor': '#e8ffca',
+    'headlinkcolor': '#e8ffca',
+    'sidebarwidth': '300px',
 }
 
-html_show_sourcelink = False
+root_doc = 'index'
+
+html_show_sourcelink = True
 
 # A shorter title for the navigation bar. Default is the same as html_title.
 # html_short_title = None
@@ -116,10 +127,16 @@
 # If not None, a 'Last updated on:' timestamp is inserted at every page
 # bottom, using the given strftime format.
 # The empty string is equivalent to '%b %d, %Y'.
-# html_last_updated_fmt = None
+html_last_updated_fmt = None
 
 # Custom sidebar templates, maps document names to template names.
-# html_sidebars = {}
+html_sidebars = {
+    '**': ['searchbox.html', 'globaltoc.html', 'sidebar_ad.html']
+}
+
+html_css_files = [
+    'style.css'
+]
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.