[
https://issues.apache.org/jira/browse/MNG-8426?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17905798#comment-17905798
]
Matthias Bünger commented on MNG-8426:
--------------------------------------
I think the problematic thing here is the automatic transition of the braces.
The source code looks fine .
{code}
** {Bill of Materials (BOM) POMs}
{code}
According to the docs they should be stripped, but it looks that Doxia tries to
transform them
{quote}
Anchor construction
Contrary to the original APT format, an anchor/link is not its text with all
non alphanumeric characters stripped. Ideally, an anchor should be a valid
Doxia id, ie it must begin with a letter ([A-Za-z]) and may be followed by any
number of letters, digits ([0-9]), hyphens ("-"), underscores ("_"), colons
(":"), and periods ("."). Any anchor that does not satisfy this pattern is
transformed according to the following rules:
* Any whitespace at the start and end is removed
* If the first character is not a letter, prepend the letter 'a'
* Any spaces are replaced with an underscore '_'
* Any characters not matching the above pattern are stripped.
Note in particular that case is preserved in this conversation and that APT
anchors and links are case-sensitive. So the anchor for the section title in
the previous example would be Anchors_for_section_titles.
{quote}
So maybe this is an Doxia issue? [~michaelo] [~sjaranowski]
P.S. Sadly it's only possible to provide a different link/link-text for links,
but not for anchors (according to docs)
> Broken link in guide about dependency mechanism
> -----------------------------------------------
>
> Key: MNG-8426
> URL: https://issues.apache.org/jira/browse/MNG-8426
> Project: Maven
> Issue Type: Bug
> Components: Documentation: Guides
> Reporter: Matthias Bünger
> Priority: Major
>
> As of today (2024-12-20) there is a broken link in the [Guide: Introduction
> to the Dependency
> Mechanism|https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.htm]
> The TOC contains a link to the BOM section
> {code}
> <a href="#bill-of-materials-bom-poms">Bill of Materials (BOM) POMs</a>
> leads to
> https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms
> {code}
> but the anchor is broken and therefore the link above does not work
> {code}
> <a id="Bill_of_Materials_.28BOM.29_POMs">
> {code}
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
