[
https://issues.apache.org/jira/browse/DOXIASITETOOLS-320?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17789832#comment-17789832
]
Michael Osipov edited comment on DOXIASITETOOLS-320 at 11/26/23 7:10 PM:
-------------------------------------------------------------------------
Very interesting idea...let's assume this is technically possible, but how can
this then address:
* User wants anchors by default, regardless of the TOC
* It will do nothing or overwrite if the user creates anchors by himself, e.g.,
Apt does not:
https://maven.apache.org/doxia/references/doxia-apt.html#Anchors_for_section_titles
If this is technically possible, maybe we need a {{auto-anchor}}/{{auto-id}}
macro (TOC macro my imly this functionally)? What about reports? Do we require
that the report plugin author will use {{AbstractMavenReportRenderer}} to have
anchors generated by default?
was (Author: michael-o):
Very interesting idea...let's assume this is technically possible, but how can
this then address:
* User wants anchors by default, regardless of the TOC
* It will do nothing or overwrite if the user creates anchors by himself, e.g.,
Apt does not:
https://maven.apache.org/doxia/references/doxia-apt.html#Anchors_for_section_titles
If this is technically possible, maybe we need a {{auto-anchor}}/{{auto-id}}
macro (TOC macro my imly this functionally)? What about reports? Do we require
that the report plugin author will use {{AbstractMavenReport}} to have anchors
generated by default?
> 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)
