[
https://issues.apache.org/jira/browse/DOXIASITETOOLS-320?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17789956#comment-17789956
]
Konrad Windszus commented on DOXIASITETOOLS-320:
------------------------------------------------
bq. User wants anchors by default, regardless of the TOC
I don't think this is related to this issue, but we can introduce some flag to
enable this independent of the TOC macro
bq. 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
I think APT and XHTML are the only source formats which supports generating
anchors natively. We should probably add some validation steps which checks for
duplicates and warn accordingly (automatically fixing/deduplicating is IMHO too
complicated/dangerous) as this may have subtle effects on CSS styling
bq. What about reports? Do we require that the report plugin author will use
AbstractMavenReportRenderer to have anchors generated by defaultc or do you
consider it to be their problem since this is about handwritted docs only?
I am not sure I understand this remark, IMHO anchor generation should happen
when writing to the sink, therefore it should not really matter what the source
is (as long as Sink API is used).
> 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)
