From 396c81e2a73d5a0eb7d77d7dcf45834f6c83e3cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Trevor=20Ba=C4=8Da?= <trevor.baca@gmail.com>
Date: Sat, 4 Jan 2025 16:53:44 -0500
Subject: [PATCH] Clean up conf.py

Sets pygments_style = "sphinx" to style code examples somewhat
differently than before.

Sets sticky navigation to false; sidebar now stays in one place while
main frame moves.
---
 docs/source/conf.py | 37 ++++++++++++++++++++++---------------
 1 file changed, 22 insertions(+), 15 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 16295bf0cc..84251dfdbf 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -1,9 +1,11 @@
+### https://www.sphinx-doc.org/en/master/usage/configuration.html ###
+
 import abjad
 
-### GENERAL SPHINX SETTINGS ###
-### https://www.sphinx-doc.org/en/master/usage/configuration.html ###
+autodoc_member_order = "groupwise"
 
 copyright = "2008-2025, Trevor Bača & Joséphine Oberholtzer."
+
 extensions = [
     "abjad.ext.sphinx",
     "sphinx.ext.autodoc",
@@ -19,6 +21,10 @@
     "uqbar.sphinx.inheritance",
     "uqbar.sphinx.style",
 ]
+
+graphviz_dot_args = ["-s32"]
+graphviz_output_format = "svg"
+
 html_favicon = "_static/favicon.ico"
 html_logo = "_static/abjad-logo.png"
 html_show_copyright = False
@@ -32,9 +38,19 @@
     # navigation_depth=1 makes sidebar completely flat;
     # leave flat navigation in place forever:
     "navigation_depth": 1,
+    "sticky_navigation": False,
+    "style_external_links": True,
     "style_nav_header_background": "#eeccaa",
 }
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+    "sphinx": ("http://www.sphinx-doc.org/en/master/", None),
+}
+
 project = "Abjad"
+pygments_style = "sphinx"
+
 release = abjad.__version__
 rst_epilog = """
 ..  _Bača: https://github.com/trevorbaca
@@ -50,11 +66,11 @@
 rst_prolog = """
 ..  role:: author
 """
+
 smartquotes = True
-templates_path = ["_templates"]
-version = abjad.__version__
 
-### UQBAR ###
+templates_path = ["_templates"]
+todo_include_todos = True
 
 uqbar_api_title = "Abjad API"
 uqbar_api_source_paths = ["abjad"]
@@ -104,13 +120,4 @@
 except ImportError:
     pass
 
-### OTHER EXTENSIONS ###
-
-autodoc_member_order = "groupwise"
-graphviz_dot_args = ["-s32"]
-graphviz_output_format = "svg"
-intersphinx_mapping = {
-    "python": ("https://docs.python.org/3", None),
-    "sphinx": ("http://www.sphinx-doc.org/en/master/", None),
-}
-todo_include_todos = True
+version = abjad.__version__