Matthias Bünger created DOXIA-771:
-------------------------------------
Summary: 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
(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)
