[
https://issues.apache.org/jira/browse/DOXIASITETOOLS-320?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17790215#comment-17790215
]
Michael Osipov edited comment on DOXIASITETOOLS-320 at 11/27/23 6:48 PM:
-------------------------------------------------------------------------
So I checked the code. A macro *cannot* instruct a target sink to emit
additional anchors when the actual section title is hit. We can forget the
macro idea. You should verify my findings though. I see only in
{{org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.renderDocument(Writer,
DocumentRenderingContext, SiteRenderingContext)}} for the moment. The parser
needs a setter invoked, e.g., {{setSectionTitleAnchors(true)}}.
Regarding the answers:
* I agree that handling is complex, thus a warning should do.
* I think the reports can be ignored since they aren't subject to a parser,
only sink and our solution should only fiddle with the parser.
Do you want to give it a try?
was (Author: michael-o):
So I checked the code. A macro *cannot* instruct a target sink to emit
additional anchors when the actual section title is hit. We can forget the
macro idea. You should verify my findings though. I see only in
{{org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.renderDocument(Writer,
DocumentRenderingContext, SiteRenderingContext)}} for the moment. The parser
needs a setter invoked, e.g., {{setSectionTitleAnchors(true)}}.
Regarding the answers:
* I agree that handling is complex, thus a warning should do.
* I think the reports can be ignored since they aren't subject to a parser,
only sink and our solution should only fiddle with the parser.
> 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)
