Details
-
Type:
New Feature
-
Status:
Closed
-
Priority:
Major
-
Resolution: Duplicate
-
Affects Version/s: None
-
Fix Version/s: 1.1
-
Component/s: None
-
Labels:None
Description
When writing the apt pages you often want to cross reference pages and link to headings.
Instead of manually placing the headings in an anchor block {} the site generation should do this automatically.
It would also be nice to validate that the cross reference is valid as spaces will get replaced with underscores and typos are easy to make.
The only recommended way in Doxia 1.1 is to explicitly specify anchors for section titles, see
DOXIA-266.However, for backward compatibility reasons, the anchor generation has been moved from the xdoc parser to the SiteRendererSink, see
DOXIA-152. That means that if you only generate html (site plugin) you can rely on atomatic anchor generation, but the links will be broken if you generate another output format (pdf). So the recommendation is still to specify anchors manually...DOXIA-266. However, for backward compatibility reasons, the anchor generation has been moved from the xdoc parser to the SiteRendererSink, seeDOXIA-152. That means that if you only generate html (site plugin) you can rely on atomatic anchor generation, but the links will be broken if you generate another output format (pdf). So the recommendation is still to specify anchors manually...