Details
-
Type:
Bug
-
Status:
Closed
-
Priority:
Major
-
Resolution: Not A Bug
-
Affects Version/s: 1.1.4
-
Fix Version/s: None
-
Component/s: Module - Apt
-
Labels:None
-
Testcase included:yes
-
Number of attachments :
Description
According to
http://maven.apache.org/doxia/references/doxia-apt.html#Anchors_for_section_titles
"Contrary to the original APT format, section titles are not implicitly defined anchors. If you want an anchor for a section title you need to define it explicitly as such:"
However, Doxia does generate anchors for section headers.
This is clear from the URL above; the underlying HTML is:
<h4><a name="Anchors_for_section_titles">Anchors for section titles</a><a name="Anchors_for_section_titles"></a></h4>
Compare with the code for
http://maven.apache.org/doxia/references/doxia-apt.html#Enhancements_to_the_APT_format
at the top of the page, and then compare with the APT source:
which does not have {} round the initial section header, yet the anchor is still generated.
Headers with {} around them have 2 anchors.
Issue Links
- is related to
-
DOXIASITETOOLS-53
SiteRender generates double anchors for section headers
-
The anchors are inserted externally of doxia by the SiteRenderer's SiteRendererSink, the doxia parser behaves correctly, see r1070789. Unfortunately, the documentation is misleading, as using the site plugin effectively leads to anchor creation. I need to check where/how to document this properly.