You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "SebbASF (JIRA)" <ji...@codehaus.org> on 2011/02/15 02:56:22 UTC
[jira] Created: (DOXIA-420) 1.1 is not supposed to generate anchors
for section titles, but it does
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
[jira] Commented: (DOXIA-420) 1.1 is not supposed to generate
anchors for section titles, but it does
Posted by "SebbASF (JIRA)" <ji...@codehaus.org>.
[ http://jira.codehaus.org/browse/DOXIA-420?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=256118#action_256118 ]
SebbASF commented on DOXIA-420:
-------------------------------
In that case. there is a bug in the SiteRenderer - it should not add the extra anchors. Issue created.
> 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
[jira] Commented: (DOXIA-420) 1.1 is not supposed to generate
anchors for section titles, but it does
Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
[ 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
[jira] Closed: (DOXIA-420) 1.1 is not supposed to generate anchors
for section titles, but it does
Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
[ http://jira.codehaus.org/browse/DOXIA-420?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Lukas Theussl closed DOXIA-420.
-------------------------------
Resolution: Not A Bug
Assignee: Lukas Theussl
> 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
> Assignee: Lukas Theussl
>
> 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