You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Michael Osipov (Jira)" <ji...@apache.org> on 2023/03/05 14:52:00 UTC

[jira] [Commented] (DOXIA-700) Streamline, update and simplify Doxia ID generation

    [ https://issues.apache.org/jira/browse/DOXIA-700?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17696575#comment-17696575 ] 

Michael Osipov commented on DOXIA-700:
--------------------------------------

[~sjaranowski], this fixes the issue from the comment link. This is how it looks now:

{noformat}
mosipov@mikaw10 MINGW64 /d/Entwicklung/Projekte/maven-site (master)
$  grep What_is target/site/pom.html
<li><a href="#What_is_the_POM.3F">What is the POM?</a></li>
<h2><a id="What_is_the_POM.3F">What is the POM?</a></h2>
{noformat}

> Streamline, update and simplify Doxia ID generation
> ---------------------------------------------------
>
>                 Key: DOXIA-700
>                 URL: https://issues.apache.org/jira/browse/DOXIA-700
>             Project: Maven Doxia
>          Issue Type: Improvement
>    Affects Versions: 2.0.0-M5
>            Reporter: Michael Osipov
>            Assignee: Michael Osipov
>            Priority: Major
>             Fix For: 2.0.0-M6
>
>
> The current ID generation suffers from these problems:
> * IDs aren't always XML id compliant ({{NCName}}
> * Sometimes they are chopped which mean that links are broken
> * Validation does not comply with production
> * Uses unnecessary one-line wrapper indirections
> A sample: https://issues.apache.org/jira/browse/DOXIA-696?focusedCommentId=17689080&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-17689080
> Solution: Simplify production rules by using XML id spec and never chop ids.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)