Use anchorlinks rather than permalinks (#13471)

## Summary

See: astral-sh/uv#7626

Author: charliermarsh

docs/stylesheets/extra.css

@@ -89,6 +89,7 @@
 .md-typeset__table {
   min-width: 100%;
 }
+
 .md-typeset table:not([class]) {
   display: table;
 }
@@ -105,7 +106,17 @@
 }
 
 /* See: https://mkdocstrings.github.io/recipes/#prevent-selection-of-prompts-and-output-in-python-code-blocks */
-.highlight .gp, .highlight .go { /* Generic.Prompt, Generic.Output */
-    user-select: none;
+.highlight .gp,
+.highlight .go {
+  /* Generic.Prompt, Generic.Output */
+  user-select: none;
+}
+
+/* Styling for anchor link headers */
+.toclink {
+  color: unset !important;
 }
 
+.toclink:hover {
+  color: var(--md-accent-fg-color) !important;
+}

mkdocs.template.yml

@@ -42,7 +42,8 @@ markdown_extensions:
   - admonition
   - pymdownx.details
   - toc:
-      permalink: "#"
+      anchorlink: true
+      anchorlink_class: "toclink"
   - pymdownx.snippets:
   - pymdownx.magiclink:
   - attr_list: