Add anchors to reference section headers

[colearendt]

This is most important to me on the "Reference" section headers, i.e. here: https://pkgdown.r-lib.org/reference/index.html

There may be other places, though. In the Changelog?

This is done automatically on the "README," for instance: https://pkgdown.r-lib.org/#in-the-wild

[klmr]

You can already link to these headers, since they all have IDs. For instance, in the first link you’ve posted the section headers have the ID section-‹header slug›, e.g. https://pkgdown.r-lib.org/reference/index.html#section-templates.

It’s just that, for some reasons, the “anchor link” image isn’t displayed next to the headers on hover specifically on the Reference page. For other pkgdown websites (but not the current ‘pkgdown’ website proper), some other pages (such as vignettes and the “Changelog” page) also don’t show anchor link images next to section headers. In those cases that’s due to <h2> elements not carrying a class="hasAnchor" attribute.

[colearendt]

Thanks for the clarification - that's a great distinction. Would it be possible to include such "anchor link" images? Is that something easily customizable by a user? Happy to rephrase my issue to be mostly about that, if it would be helpful! It greatly simplifies linking to things quickly 😄

[maelle]

That would be a feature request. At the moment anchors are added by pkgdown to the NEWS page and to pages produced from R Markdown.

At the moment in the index pages like the reference index one can use the TOC on the right to find the direct link to sections.

[hadley]

(@colearendt for future reference these are called anchor links)