Fix pydata theme compat for real (#70)

Author: flying-sheep

pyproject.toml

@@ -61,6 +61,11 @@ source = 'vcs'
 [tool.hatch.build.hooks.vcs]
 version-file = 'src/scanpydoc/_version.py'
 
+[tool.hatch.envs.docs]
+features = ['doc']
+[tool.hatch.envs.docs.scripts]
+build = 'sphinx-build -M html docs docs/_build/html'
+
 [[tool.hatch.envs.test.matrix]]
 python = ['3.8', '3.9', '3.10', '3.11']
 [tool.hatch.envs.test]

src/scanpydoc/definition_list_typed_field.py

@@ -68,8 +68,8 @@ def handle_item(
 
         field_name = nodes.field_name("", self.label)
         assert not self.can_collapse
-        # “simple” for pydata sphinx theme
-        body_node = self.list_type(classes=["simple"])
+        # “field-list” for pydata sphinx theme
+        body_node = self.list_type(classes=["field-list"])
         for field_arg, content in items:
             body_node += handle_item(field_arg, content)
         field_body = nodes.field_body("", body_node)

src/scanpydoc/elegant_typehints/example.py

@@ -7,7 +7,6 @@ def example_func(a: str | None, b: str | int | None = None) -> dict[str, int]:
     Hover over the parameter and return type annotations to see the long versions.
 
     Args:
-    ----
         a: An example parameter
         b: Another, with a default
     Returns:

src/scanpydoc/elegant_typehints/formatting.py

@@ -85,12 +85,10 @@ def format_annotation(annotation: type[Any], config: Config) -> str | None:
     it tries to achieve a simpler style as seen in numeric packages like numpy.
 
     Args:
-    ----
         annotation: A type or class used as type annotation.
         config: Sphinx config containing ``sphinx-autodoc-typehints``’s options.
 
     Returns:
-    -------
         reStructuredText describing the type
     """
     curframe = inspect.currentframe()

src/scanpydoc/rtd_github_links.py

@@ -110,11 +110,9 @@ def github_url(qualname: str) -> str:
     """Get the full GitHub URL for some object’s qualname.
 
     Args:
-    ----
         qualname: The full qualified name of a function, class, method or module
 
     Returns:
-    -------
         A GitHub URL derived from the :confval:`html_context`.
     """
     try: