docs: add CSS for nicer signatures

The parameters of call signatures now each get their own line, making it much more readable.
rmnldwg · Mar 4, 2024 · c020660 · c020660
1 parent 6a60059
commit c020660
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 2 deletions.
diff --git a/docs/source/_static/css/custom.css b/docs/source/_static/css/custom.css
@@ -0,0 +1,11 @@
+/* Indent by four spaces */
+.sig-param::before {
+    content: "\a\20\20\20\20";
+    white-space: pre;
+}
+
+/* Don't indent closing bracket */
+dt em.sig-param:last-of-type::after {
+    content: "\a";
+    white-space: pre;
+}
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -93,4 +93,7 @@
 # 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".
-# html_static_path = ['./_static']
+html_static_path = ['./_static']
+html_css_files = [
+    "css/custom.css",
+]
diff --git a/docs/source/types.rst b/docs/source/types.rst
@@ -8,4 +8,4 @@ Types
 
 .. automodule:: lymph.types
     :members:
-    :special-members: __init__
+    :show-inheritance: