feat: support inline link anchors

[miketheman]

Refs: https://docs.rs/comrak/latest/comrak/options/struct.Extension.html#structfield.header_ids
Refs: https://docutils.sourceforge.io/docs/user/config.html#section-self-link

[di]

How is this going to work on PyPI for URLs like:

• https://pypi.org/project/sampleproject/#history
• https://pypi.org/project/sampleproject/#files
• etc?

[miketheman]

Good callout - hadn't thought of those, I was so excited to see something available 😓

I'll convert to draft to continue iterating on this - it might be something where we'd look at prefixes or something to make the description anchors distinct from the "outer" anchors.

[di]

I did mention it here but that was almost eight years ago, so I don't blame you for missing it 😂

I think switching to a prefix for PyPI + finding a way to prevent anchors with those prefixes from being rendered here is probably a good option.

[miketheman]

Thanks @di - definitely missed that! 🙈

I'm considering a non-pypi-specific prefix of user-content- so that if anyone else uses the library (no clue who, but hey, they might) aren't "polluted" with a PyPI string.

... finding a way to prevent anchors with those prefixes from being rendered here ...

I don't understand your meaning here. Why wouldn't we want to render anchors with prefixes?
Unless you were thinking that we change the anchors on PyPI's project pages?