Add theme overrides to make text display better

docs/conf.py

@@ -71,7 +71,33 @@
 # further. For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+# ░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒░░▒▓██████▓▒░░▒▓███████▓▒░░▒▓███████▓▒░░▒▓█▓▒░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓█▓▒░
+# ░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
+# ░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░ ░▒▓█▓▒░
+# ░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓████████▓▒░▒▓███████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒▒▓███▓▒░▒▓█▓▒░
+# ░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
+# ░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░
+# ░▒▓█████████████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░░▒▓██████▓▒░░▒▓█▓▒░
+# NB (MSB 2024-08-30): I am doing some very funky CSS injections here to make things
+# look appropriate (since the Alabaster theme doesn't expose a ton of options).
+# The `body_text` option is technically a color override, but it's used here make
+# the text width more reasonable.
+# See more of the configuration options here:
+# https://alabaster.readthedocs.io/en/latest/customization.html
+html_theme_options = {
+ # Set a hard width for the sidebar to keep the title text and logo consistent
+ "sidebar_width": "255px",
+ # Make the sidebar fixed so it scrolls along with the user
+ "fixed_sidebar": True,
+ # Use the LPL logo in the docs
+ "logo": "lpl-logo.png",
+ # Include the project name below the LPL logo
+ "logo_name": True,
+ # Make the page width larger, but with a minimum of 800px at the smallest
+ "page_width": "max(60%, 800px)",
+ # Hack to allow the body content to expand to fill the whole page box
+ "body_text": "#3E4349;max-width: unset;",
+}
 
 # 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,