[jira] Closed: (DOXIA-289) Create anchor automatically from headings

["Lukas Theussl (JIRA)" <ji...@codehaus.org>]

     [ http://jira.codehaus.org/browse/DOXIA-289?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Lukas Theussl closed DOXIA-289.
-------------------------------

         Assignee: Lukas Theussl
       Resolution: Duplicate
    Fix Version/s: 1.1


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...

> Create anchor automatically from headings
> -----------------------------------------
>
>                 Key: DOXIA-289
>                 URL: http://jira.codehaus.org/browse/DOXIA-289
>             Project: Maven Doxia
>          Issue Type: New Feature
>            Reporter: Barrie Treloar
>            Assignee: Lukas Theussl
>             Fix For: 1.1
>
>
> 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.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira