[
http://jira.codehaus.org/browse/DOXIA-208?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_121625
]
Lukas Theussl commented on DOXIA-208:
-------------------------------------
viz changing apt: this was already proposed (and rejected) at DOXIA-47. Even
though we are now discussing changes to the original apt format
(http://docs.codehaus.org/display/DOXIA/Proposed+Changes+to+the+APT+Format) I'm
not in favor of this particular change, because it's not motivated by a
necessary bug fix or missing feature. IMO we risk more by confusing users and
breaking things than we gain by a more intuitive behavior.
viz. xhtml sink: there is an issue to discuss I think, eg I don't see why one
should be forced to use {{href="./other.html"}} instead of just
{{href="other.html"}} in an xdoc document (in apt you have to because there is
no other way to distinguish internal from external links).
I think we can easily define how parsers should emit link events {{link( String
name )}} : if name starts with # it's an internal link and the receiving sink
can decide what to do with it. The StructureSink.isExternalLink method is apt
specific, it should not be used by other sinks.
> change the default link from an anchor to a relative page in the apt format
> ---------------------------------------------------------------------------
>
> Key: DOXIA-208
> URL: http://jira.codehaus.org/browse/DOXIA-208
> Project: Maven Doxia
> Issue Type: Improvement
> Components: Module - Xhtml
> Affects Versions: 1.0-alpha-10
> Reporter: Andrew Williams
>
> To be inline with wikis and other formats the APT link "MyLink" should be a
> relative link whereas "#MyLink" would link to an anchor.
> This is a deviation from the apt format, but would remove confusion for new
> users and those working on supporting multiple formats.
> Edit: this is an issue with the XHTML sink, not the apt parser - anything
> link "MyLink" will be spat out as "#MyLink"
--
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
