[
https://issues.apache.org/jira/browse/DOXIA-771?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17911226#comment-17911226
]
Matthias Bünger commented on DOXIA-771:
---------------------------------------
Ok wrote two tests
1. The custom-html anchor now worked - don't know why it did not on the day
when I created the issue. Tested it back then and today with a markdown file in
site
2. the custom anchor in heading is not supported as it seems, see this test
https://github.com/Bukama/maven-doxia/blob/9becd7f4b2dda571c9f98ade7b61fa905a17c947/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java#L906
I'm okay to closing this issue as the custom html anchor seems to be working.
I'm also fine when the issuse is used to fix/introduce support for custom
anchors in headings. You decide [~kwin]
> Markdown: Generated anchors of headings are incompatible with "regular"
> inpage-links
> ------------------------------------------------------------------------------------
>
> Key: DOXIA-771
> URL: https://issues.apache.org/jira/browse/DOXIA-771
> Project: Maven Doxia
> Issue Type: Bug
> Affects Versions: 2.0.0-M12
> Reporter: Matthias Bünger
> Priority: Major
>
> (Disclaimer: I'm not sure if the issue is right here of must be placed in
> Doxiasitetools, please move it, if wrong).
> -----
> I updated a page of the Maven-Site (so I think affected version is latest
> 2.0.0-M12) and wanted to create links to section headings on the same page.
> The "regular" way according to Google is that anchors are generated with all
> lowercase, minus between words and removed special chars.
> So you can create a link like this
> {code}
> ### How do I skip unit tests when building a project?
> Create a [link to that](how-do-i-skip-unit-tests-when-building-a-project)
> {code}
> The IDE (IntelliJ) is happy with that (meaning shows no warning, that the
> anchor may not exist), but the link does not work, because DOXIA generates
> another anchor
> {code}
> <a id="How_do_I_skip_unit_tests_when_building_a_project.3F"></a>
> {code}
> Which results, that you (I did not find another way) you have to create the
> link using exactly this generated anchor
> {code}
> ### How do I skip unit tests when building a project?
> Create a [link to that](#How_do_I_skip_unit_tests_when_building_a_project.3F)
> {code}
> Which is not very intuitiv to write.
> Note:
> I also tried to manually create and use an anchor, e.g.
> {code}
> <a id="HowDoISkipUnitTests"></a>
> ### How do I skip unit tests when building a project?
> Create a [link to that](#HowDoISkipUnitTests)
> {code}
> But this manual defined anchor got totally ignored and not generated in the
> resulting HTML.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
