[DOXIASITETOOLS-266] Don't create anchors behind the user's back

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.0.0-M3
• Fix Version/s: 2.0.0-M4, 2.0.0
• Component/s: Site renderer
• Assignee: Michael Osipov
• Reporter: Michael Osipov
• Created: 23/Jul/22 14:12
• Updated: 04/Jan/24 16:28
• Resolved: 20/Aug/22 19:28

Description

SiteRendererSink wraps the actual sink and intercepts all calls to section titles. While there it automatically adds anchors not requested by the user. This creates the following problems (non exhaustive):

• The user never requested to do so
• The output differs from direct Doxia invocation and is not documented. E.g., site plugin vs direct goal
• Apt format explicitly states that no anchors are generated for section titles
• Maven Reporting Impl's AbstractRenderer in #startSection() adds anchors to the section titles which results in two anchors for the same section title.

Stop manipulating output and make it consistent with non-site usecases and the specs of respective formats.

Issue Links

• breaks: DOXIA-710 Inconsistent anchors between toc macro and headers
• breaks: DOXIA-722 Optionally create anchors for indexable entries (used in TOC macro)
• links to: GitHub Pull Request #58