Various cosmetic improvements to the manual

docs/_static/custom.css

@@ -0,0 +1,13 @@
+div.body, div.footer, code, div.code-block-caption,
+div.body h1, div.body h2, div.body h3, div.body h4, div.body h5, div.body h6,
+a.toc-backref
+   {color: black}
+
+div.body p, div.body dd, div.body li, div.body blockquote
+   {hyphens: manual}
+
+a
+   {color: navy}
+a:visited
+   {color: purple}
+

docs/conf.py

@@ -24,13 +24,19 @@
 # Read the Docs might dirty its checkout, so strip the dirty flag.
 hy_version = re.sub(r"[+.]dirty\Z", "", hy_version)
 
-templates_path = ["_templates"]
+html_theme = "nature"
+html_theme_options = dict(
+    nosidebar = True,
+    body_min_width = 0,
+    body_max_width = 'none')
+html_css_files = ['custom.css']
 source_suffix = ".rst"
 
 master_doc = "index"
+html_title = f'Hy {hy_version} manual'
 
 # General information about the project.
-project = "hy"
+project = "Hy"
 copyright = "%s the authors" % time.strftime("%Y")
 
 # The version info for the project you're documenting, acts as replacement for
@@ -48,13 +54,6 @@
 exclude_patterns = ["_build", "coreteam.rst"]
 add_module_names = True
 
-pygments_style = "sphinx"
-
-import sphinx_rtd_theme
-
-html_theme = "sphinx_rtd_theme"
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
-
 # 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".
@@ -76,10 +75,3 @@
 
 import hy
 hy.I = type(hy.I)  # A trick to enable `hy:autoclass:: hy.I`
-
-
-# ** Sphinx App Setup
-
-
-def setup(app):
-    app.add_css_file("overrides.css")

docs/index.rst

@@ -1,5 +1,5 @@
-The Hy Manual
-=============
+Contents
+========
 
 .. image:: _static/hy-logo-small.png
    :alt: Hy

requirements-dev.txt

@@ -3,5 +3,4 @@ pytest >= 7
 # documentation
 Pygments @ git+https://github.com/Kodiologist/pygments@hylex
 Sphinx == 5.0.2
-sphinx_rtd_theme == 1.2.2
 git+https://github.com/hylang/sphinxcontrib-hydomain.git