Erik Martin-Dorel

Dear Günter Milde and David Goodger, Do you believe you'd have the time to take a look into this feature? it would be a very useful one anyway :) But in this case, I don't know if you'd have a preference regarding the activation of this feature? I mean, between: Applying it unconditionally (adding always self-referencing links to section titles) Applying it by default, unless we pass the CLI option --no-html-section-links Or something else? Regarding the possible output, Günter's template "self-link.html"...

Dear Günter Milde, thanks for suggesting this minimal complete example! Looks very good to me. And I like as well the fact that it smoothly integrates with CSS. Regarding the possible naming of the corresponding setting, maybe html_headinglinks or html_sectionlinks would be OK? as it is specific to <h1> etc. constructs. But personally, I'd vote for this feature to be, either unconditionnaly applied, or triggered by an optional setting that is enabled by default. Cheers, Erik

Dear Günter Milde, thanks for suggesting this minimal complete example! Looks very good to me. And I like as well the fact that it smoothly integrates with CSS. Regarding the possible naming of the corresponding setting, maybe html_headinglinks or html_sectionlinks would be OK? as it is specific to <h1> etc. constructs. But personally, I'd vote for this feature to be, either unconditionnaly applied, or triggered by an optional setting that is enabled by default. Cheers, Erik

Maybe you are after a way to easily create a bookmark (or copy a link) to the section in browsers. This could be done adding a link to itself before or after the heading (as done by, e.g., Sphinx). Indeed this is the intended feature :-) Regarding the implementation itself − a symbol such as ¶ after the section title (like Clément proposed) or just before − I've no strong opinion. The anchor already present in a section heading links back to it's ToC entry. A user can easily click on the backlink...

Sorry I realize I clicked on Submit too early (before putting a complete title to the ticket 😅)

Sorry I realized I click on Submit too early (before putting a complete title to the ticket 😅)

Make