[
http://jira.codehaus.org/browse/DOXIA-420?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=256086#action_256086
]
Lukas Theussl commented on DOXIA-420:
-------------------------------------
The anchors are inserted externally of doxia by the SiteRenderer's
SiteRendererSink, the doxia parser behaves correctly, see
[r1070789|http://svn.apache.org/viewvc?rev=1070789&view=rev]. 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.
> 1.1 is not supposed to generate anchors for section titles, but it does
> -----------------------------------------------------------------------
>
> Key: DOXIA-420
> URL: http://jira.codehaus.org/browse/DOXIA-420
> Project: Maven Doxia
> Issue Type: Bug
> Components: Module - Apt
> Affects Versions: 1.1.4
> Reporter: SebbASF
>
> 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:
> http://svn.apache.org/viewvc/maven/doxia/site/src/site/apt/references/doxia-apt.apt?revision=985438&view=markup
> which does not have {} round the initial section header, yet the anchor is
> still generated.
> Headers with {} around them have 2 anchors.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
