[
https://issues.apache.org/jira/browse/DOXIASITETOOLS-320?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17789829#comment-17789829
]
Konrad Windszus commented on DOXIASITETOOLS-320:
------------------------------------------------
{quote}Doxia itself does not create any anchors unless you explicitly instruct
it..and this is logically correct. Even if you use the TOC macro this says
nothing whether the target of the links exist or not. It assumes that they are
created by some means.
{quote}
I think this is fundamentally wrong. As soon as the TOC macro is used, anchors
must be generated by Doxia as well. Relying on some other mechanism will never
work reliably due to differences of how anchor names/ids can be generated. I
agree that generating anchors in Doxia Sitetools that are leveraged by the TOC
from Doxia is architecturally wrong. I would therefore propose to auto-generate
anchors for each item in a TOC in Doxia.
Doxia Sitetools should not need to generate any anchor.
The skins may optionally add additional anchors.
> Inconsistent anchors between toc macro and headers
> --------------------------------------------------
>
> Key: DOXIASITETOOLS-320
> URL: https://issues.apache.org/jira/browse/DOXIASITETOOLS-320
> Project: Maven Doxia Sitetools
> Issue Type: Bug
> Components: Site renderer
> Reporter: Slawomir Jaranowski
> Priority: Critical
>
> In markdown document add:
> {code:java}
> <!-- MACRO{toc|fromDepth=2} -->
> {code}
> Then anchors generated by toc macro looks like: {{#Your_First_Mojo}}
> and anchors generated by skin looks like: {{#your-first-plugin}}
> - Doxia Site Renderer 2.0.0-M4
> - Fluido Skin 1.11.1
> Tested on Maven main site without more investigate.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
