[
http://jira.codehaus.org/browse/DOXIA-138?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_109016
]
Lukas Theussl commented on DOXIA-138:
-------------------------------------
I don't deny that it's a useful feature, I used it a lot myself during my m1
days. The problem is that Doxia is a multi-format document processing engine,
and while section anchors are usually fine for xhtml output, it simply won't
work with other formats. Eg the example given at MPPDF-40 will make the fop pdf
renderer bomb. My point of view is that such sink-dependent features should be
implemented by a specialised, low-level sink, (ie the part of doxia that
produces the end-user output), eg the SiteRendererSink in the site plugin,
where you know that the output will always go to html. No parser should emit
any event that was not there in the original document. This issue is about the
apt format, if the apt parser emits anchors for section titles (before you know
which kind of sink is going to consume the event), then there's going to be
trouble.
> Review and clarify the APT guide
> --------------------------------
>
> Key: DOXIA-138
> URL: http://jira.codehaus.org/browse/DOXIA-138
> Project: Maven Doxia
> Issue Type: Task
> Components: Documentation, Module - Apt
> Affects Versions: 1.0-alpha-8
> Reporter: Lukas Theussl
> Fix For: 1.0
>
>
> Our current apt guide is a copy of
> http://www.xmlmind.com/_aptconvert/docs/userguide2.html, but there are
> several issues that need clarification, eg
> * case sensitivity and white space handling in anchors
> * anchors for section titles
> * figure handling, esp extensions
> * tables: is the first line always a header row?
> Some of these depend on how things are going to be implemented.
> We also decided to remove the apt guide at
> http://maven.apache.org/guides/mini/guide-apt-format.html and only keep the
> one on the doxia site.
--
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
