Theme

Author: palewire

Pipfile

@@ -17,6 +17,8 @@ mock = "*"
 setuptools-scm = "*"
 wheel = "*"
 pre-commit = "*"
+sphinx-palewire-theme = "*"
+myst-parser = "*"
 
 [requires]
 python_version = "3.11"

Pipfile.lock

@@ -1,38 +1,32 @@
-import typing
+"""Configure Sphinx configuration."""
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any
 from datetime import datetime
 
-extensions: typing.List[typing.Any] = []
-templates_path = ["_templates"]
-source_suffix = ".rst"
+sys.path.insert(0, os.path.abspath(".."))
+
+source_suffix = ".md"
 master_doc = "index"
 
 project = "django-postgres-copy"
 year = datetime.now().year
-copyright = f"{year} Ben Welsh"
+copyright = f"{year} palewire"
 
 exclude_patterns = ["_build"]
 
-html_theme = "alabaster"
-html_sidebars = {
-    "**": [
-        # 'about.html',
-        # 'navigation.html',
-        "relations.html",
-        "searchbox.html",
-        "donate.html",
-    ]
-}
-html_theme_options = {
+html_theme = "palewire"
+html_sidebars: dict[Any, Any] = {}
+html_theme_options: dict[Any, Any] = {
     "canonical_url": f"https://palewi.re/docs/{project}/",
-    "github_user": "palewire",
-    "github_repo": project,
-    "donate_url": "https://github.com/sponsors/palewire",
-    "show_powered_by": False,
+    "nosidebar": True,
 }
 
-html_static_path = ["_static"]
-html_css_files = [
-    "css/custom.css",
-]
-
 pygments_style = "sphinx"
+
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+]

docs/_static/css/custom.css

@@ -1,48 +1,3 @@
-.. raw:: html
-
-    <nav>
-      <div class="row">
-        <div class="sevencol">
-          <div class="shingle">
-            <a href="https://palewi.re/">
-              <div rel="rnews:copyrightedBy rnews:hasSource rnews:providedBy">
-                <div about="http://palewi.re/" typeof="rnews:Organization">
-                  <div property="rnews:name">palewire</div>
-                </div>
-              </div>
-            </a>
-          </div>
-        </div>
-        <div class="fivecol last links">
-          <ul>
-            <li>
-              <a href="http://palewi.re/posts/" title="Posts">
-                Posts
-              </a>
-            </li>
-            <li>
-              <a href="http://palewi.re/work/" title="Work">
-                Work
-              </a>
-            </li>
-            <li>
-              <a href="http://palewi.re/talks/" title="Talks">
-                Talks
-              </a>
-            </li>
-            <li>
-              <a href="http://palewi.re/who-is-ben-welsh/" title="Who is Ben Welsh?">
-                About
-              </a>
-            </li>
-          </ul>
-        </div>
-      </div>
-    </nav>
-    <div class="row topbar">
-        <div class="twelvecol last"></div>
-    </div>
-
 ====================
 django-postgres-copy
 ====================