[
https://jira.codehaus.org/browse/DOXIA-293?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=287702#comment-287702
]
Robert Scholte commented on DOXIA-293:
--------------------------------------
The main problem is that Doxia can't determine the position of these files.
I've seen {{apidocs/}},. {{api/}}, {{javadocs/}}.
Only the maven-site-plugin can pass this information to Doxia.
So this has to be fixed in both projects.
> APT format needs some "macros" for common constructs such as links to JavaDoc
> -----------------------------------------------------------------------------
>
> Key: DOXIA-293
> URL: https://jira.codehaus.org/browse/DOXIA-293
> Project: Maven Doxia
> Issue Type: New Feature
> Reporter: Howard M. Lewis Ship
> Priority: Minor
>
> Some form of macro processing for APT format files would be nice.
> I often find myself writing very verbose links form APT to documentation, i.e.
> {{{apidocs/org/package/MyClass.html}MyClass}}
> (Not that I ever get to use something that terse, more like
> org.apache.tapestry.internal.ioc.RegistryImpl, etc.).
> I would love some alternate link forms, maybe something like:
> {{{api:MyClass}}}
> or
> {{{api:org.package.MyClass}}}
> and let Maven build the links for me.
> I also do some copious cross-linking of my documentation, so something akin
> to the Forrest site: prefix would be great (a way to reference another
> document by a logical id rather than a relative path).
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://jira.codehaus.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
