[DOXIA-700] Streamline, update and simplify Doxia ID generation

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.0.0-M5
• Fix Version/s: 2.0.0-M6, 2.0.0
• Assignee: Michael Osipov
• Reporter: Michael Osipov
• Created: 05/Mar/23 14:45
• Updated: 14/Dec/23 16:47
• Resolved: 19/Mar/23 11:13

Description

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.

Issue Links

• is related to: DOXIA-710 Inconsistent anchors between toc macro and headers
• links to: GitHub Pull Request #155