[jira] Commented: (MSITE-178) APT format needs some "macros" for common constructs such as links to JavaDoc

["Erik Putrycz (JIRA)" <ji...@codehaus.org>]

    [ http://jira.codehaus.org/browse/MSITE-178?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_106319 ] 

Erik Putrycz commented on MSITE-178:
------------------------------------

I totally second this idea. Has there been any progress done?

> APT format needs some "macros" for common constructs such as links to JavaDoc
> -----------------------------------------------------------------------------
>
>                 Key: MSITE-178
>                 URL: http://jira.codehaus.org/browse/MSITE-178
>             Project: Maven 2.x Site Plugin
>          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 contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira