@waylan noticed that links created by autorefs with the [title][id] syntax do not have a title HTML attribute. It would be nice to have a title in any case:
- for object headings, using the object's complete identifier (dotted-path in Python) as title
- for text headings, using the actual title
As to how to record these:
- mkdocstrings'
do_headingfilter can probably use the passedid - when picking up the rest of headings, autorefs could register their contents alongside their slugs and URLs
An alternative would be to reuse the provided identifier in [title][id] as title HTML attribute if it is different than the provided title, but that would only make sense for objects, not regular headings (we don't want to show a tooltip on hover with a heading's slug).
mkdocstrings / autorefs
Automatically link across pages in MkDocs.
50
How does funding with Polar work?
1
Pay now to fund the work behind this issue.
2
Get updates on progress being made.
3
Maintainer is rewarded once the issue is completed.
FAQ
Backer
You're funding impactful open source efforts
Contributor
You want to contribute to this effort
Maintainer
You want to get funding like this too