chore: Template upgrade

pawamoy · pawamoy · commit 51f217f38af9 · 2025-06-30T22:47:11.000+02:00
diff --git a/.copier-answers.yml b/.copier-answers.yml
@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier.
-_commit: 1.7.1
+_commit: 1.8.4
 _src_path: gh:pawamoy/copier-uv
 author_email: dev@pawamoy.fr
 author_fullname: Timothée Mazzucotelli
diff --git a/docs/css/mkdocstrings.css b/docs/css/mkdocstrings.css
@@ -35,3 +35,48 @@ td code {
 li.md-nav__item:has(> a[href*="("]) {
   display: none;
 }
+
+/* Tree-like output for backlinks. */
+.doc-backlink-list {
+  --tree-clr: var(--md-default-fg-color);
+  --tree-font-size: 1rem;
+  --tree-item-height: 1;
+  --tree-offset: 1rem;
+  --tree-thickness: 1px;
+  --tree-style: solid;
+  display: grid;
+  list-style: none !important;
+}
+
+.doc-backlink-list li > span:first-child {
+  text-indent: .3rem;
+}
+.doc-backlink-list li {
+  padding-inline-start: var(--tree-offset);
+  border-left: var(--tree-thickness) var(--tree-style) var(--tree-clr);
+  position: relative;
+  margin-left: 0 !important;
+
+  &:last-child {
+    border-color: transparent;
+  }
+  &::before{
+    content: '';
+    position: absolute;
+    top: calc(var(--tree-item-height) / 2 * -1 * var(--tree-font-size) + var(--tree-thickness));
+    left: calc(var(--tree-thickness) * -1);
+    width: calc(var(--tree-offset) + var(--tree-thickness) * 2);
+    height: calc(var(--tree-item-height)  * var(--tree-font-size));
+    border-left: var(--tree-thickness) var(--tree-style) var(--tree-clr);
+    border-bottom: var(--tree-thickness) var(--tree-style) var(--tree-clr);
+  }
+  &::after{
+    content: '';
+    position: absolute;
+    border-radius: 50%;
+    background-color: var(--tree-clr);
+    top: calc(var(--tree-item-height) / 2 * 1rem);
+    left: var(--tree-offset) ;
+    translate: calc(var(--tree-thickness) * -1) calc(var(--tree-thickness) * -1);
+  }
+}
diff --git a/docs/reference/api.md b/docs/reference/api.md
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -34,7 +34,7 @@ nav:
   - Guides:
     - Recipes: recipes.md
     - Troubleshooting: troubleshooting.md
-- API reference: reference/mkdocstrings.md
+- API reference: reference/api.md
 - Development:
   - Contributing: contributing.md
   - Code of Conduct: code_of_conduct.md
@@ -143,6 +143,7 @@ plugins:
         - https://markupsafe.palletsprojects.com/en/stable/objects.inv
         paths: [src]
         options:
+          backlinks: tree
           docstring_options:
             ignore_init_summary: true
           docstring_section_style: list
@@ -161,16 +162,17 @@ plugins:
           signature_crossrefs: true
           summary: true
 - llmstxt:
-    files:
-    - output: llms-full.txt
-      inputs:
+    full_output: llms-full.txt
+    sections:
+      Usage:
       - index.md
       - usage/index.md
       - usage/handlers.md
       - usage/theming.md
       - recipes.md
       - troubleshooting.md
-      - reference/**.md
+      API:
+      - reference/api.md
 - git-revision-date-localized:
     enabled: !ENV [DEPLOY, false]
     enable_creation_date: true
@@ -179,14 +181,15 @@ plugins:
     redirect_maps:
       theming.md: usage/theming.md
       handlers/overview.md: usage/handlers.md
-      reference/index.md: reference/mkdocstrings.md#mkdocstrings
-      reference/extension.md: reference/mkdocstrings.md#mkdocstrings.extension
-      reference/handlers/index.md: reference/mkdocstrings.md#mkdocstrings.handlers
-      reference/handlers/base.md: reference/mkdocstrings.md#mkdocstrings.handlers.base
-      reference/handlers/rendering.md: reference/mkdocstrings.md#mkdocstrings.handlers.rendering
-      reference/inventory.md: reference/mkdocstrings.md#mkdocstrings.inventory
-      reference/loggers.md: reference/mkdocstrings.md#mkdocstrings.loggers
-      reference/plugin.md: reference/mkdocstrings.md#mkdocstrings.plugin
+      reference/mkdocstrings.md: reference/api.md
+      reference/index.md: reference/api.md#mkdocstrings
+      reference/extension.md: reference/api.md#mkdocstrings.extension
+      reference/handlers/index.md: reference/api.md#mkdocstrings.handlers
+      reference/handlers/base.md: reference/api.md#mkdocstrings.handlers.base
+      reference/handlers/rendering.md: reference/api.md#mkdocstrings.handlers.rendering
+      reference/inventory.md: reference/api.md#mkdocstrings.inventory
+      reference/loggers.md: reference/api.md#mkdocstrings.loggers
+      reference/plugin.md: reference/api.md#mkdocstrings.plugin
 - minify:
     minify_html: !ENV [DEPLOY, false]
 - group:
diff --git a/pyproject.toml b/pyproject.toml
@@ -66,7 +66,7 @@ getter = "scripts.get_version:get_version"
 
 [tool.pdm.build]
 # Include as much as possible in the source distribution, to help redistributors.
-excludes = ["**/.pytest_cache"]
+excludes = ["**/.pytest_cache", "**/.mypy_cache"]
 source-includes = [
     "config",
     "docs",
@@ -112,7 +112,7 @@ ci = [
     "mkdocs>=1.6",
     "mkdocs-coverage>=1.0",
     "mkdocs-git-revision-date-localized-plugin>=1.2",
-    "mkdocs-llmstxt>=0.1",
+    "mkdocs-llmstxt>=0.2",
     "mkdocs-material>=9.5",
     "mkdocs-minify-plugin>=0.8",
     "mkdocs-redirects>=1.2.1",
diff --git a/tests/test_api.py b/tests/test_api.py
@@ -155,7 +155,11 @@ def test_inventory_matches_api(
     public_api_paths = {obj.path for obj in public_objects}
     public_api_paths.add("mkdocstrings")
     for item in inventory.values():
-        if item.domain == "py" and "(" not in item.name:
+        if (
+            item.domain == "py"
+            and "(" not in item.name
+            and (item.name == "mkdocstrings" or item.name.startswith("mkdocstrings."))
+        ):
             obj = loader.modules_collection[item.name]
             # YORE: Bump 1: Remove block.
             if any(obj.path.startswith(f"mkdocstrings.{module}") for module in deprecated_modules):
diff --git a/tests/test_extension.py b/tests/test_extension.py
@@ -198,7 +198,6 @@ def test_removing_duplicated_headings(ext_markdown: Markdown) -> None:
     assert output.count(">Heading one<") == 1
     assert output.count(">Heading two<") == 1
     assert output.count(">Heading three<") == 1
-    assert output.count('class="mkdocstrings') == 0
 
 
 def _assert_contains_in_order(items: list[str], string: str) -> None:
