[DOXIA-257] APT local anchor / link doesn't work when there is a whitespace in the anchor name

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.0-alpha-11
• Fix Version/s: 1.1
• Component/s: Module - Apt
• Environment: Maven version: 2.0.9; Java version: 1.5.0_11; OS name: "windows xp" version: "5.1" arch: "x86" Family: "windows"
• Assignee: Lukas Theussl
• Reporter: Olivier Berlanger
• Created: 30/Sep/08 09:22
• Updated: 07/Apr/15 18:15
• Resolved: 01/Oct/08 05:48

Description

An local anchor and link defined in APT doesn't work if it contains white spaces.
The problem come in HTML generated from the APT using a Maven "site:site" goal.

Example APT:
-----------------------------------------------------------

• {Element group}
  
  An element group is a set of {{{Element}elements}}
  
  * {Element}
  
  An element is a component of an Element group
  
  -----------------------------------------------------------
  in this example, the {Element} anchor will work, while the {Element group}

  will not.
  The documentation of APT says "The name of an anchor/link is its text with all non alphanumeric characters stripped."
  It's not the case in the generated HTML, the whitespace is there in the HTML causing the problem.

There are cases (as shown in the example) where it's difficult to find another name for the anchor.
Mainly because (unlike the link) you cannot specify an anchor name different from the anchor displayed text.

Issue Links

• relates to: DOXIA-208 standardize link/anchor handling: remove usage of StructureSinkUtils