You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by ji...@codehaus.org on 2003/09/25 22:59:10 UTC
[jira] Updated: (MAVEN-853) Add a tag to the xdoc plugin to easily transform a file using the site style and navigation
The following issue has been updated:
Updater: fabrizio giustina (mailto:fgiust@sapient.com)
Date: Thu, 25 Sep 2003 3:57 PM
Comment:
added patch
Changes:
Attachment changed to xdoc.patch
---------------------------------------------------------------------
For a full history of the issue, see:
http://jira.codehaus.org/secure/ViewIssue.jspa?key=MAVEN-853&page=history
---------------------------------------------------------------------
View the issue:
http://jira.codehaus.org/secure/ViewIssue.jspa?key=MAVEN-853
Here is an overview of the issue:
---------------------------------------------------------------------
Key: MAVEN-853
Summary: Add a tag to the xdoc plugin to easily transform a file using the site style and navigation
Type: Improvement
Status: Unassigned
Priority: Major
Time Spent: Unknown
Remaining: Unknown
Project: maven
Components:
plugin-xdoc
Versions:
1.0-rc1
Assignee:
Reporter: fabrizio giustina
Created: Thu, 25 Sep 2003 3:57 PM
Updated: Thu, 25 Sep 2003 3:57 PM
Description:
the xdoc plugin offers few tags to transform xml with a user defined stylesheet, but there is no way to transform a file using the site style and navigation.
This is needed for plugins working on top of the generated docs, like linkcheck: they need to run after the performJSL is complete and they need to run the transformation again on the result.
Actually the linkchek plugin uses a specific goal, xdoc:performJSL, whick can not be used by other plugins, since it access a variable in the linkcheck plugin
// from the xdoc plugin (UGLY!):
---
<!-- This is required as the linkchecker runs as a final pass over the generated document tree -->
<goal name="xdoc:performJSL" description="Allows the LinkCheck plugin to xdoc a single directory">
<j:set var="maven.xdoc.src" value="${pom.getPluginContext('maven-linkcheck-plugin').getVariable('maven.xdoc.src')}"/>
---
The doc:jsl can't be used easily because you need to set lots of variable (using the site wide stylesheet you have to recreate navigation, report lists, etc), which are defined in the xdoc plugin context
the given patch add a new tag jslToSite to the xdoc plugin. This tag takes only a parameter @srcdir, containing the input xml file, and sets the variable needed by performJSL appropriately. This could be done directly in other plugins, but it's better for other plugins not to be dependent from the internal implementation of the xdoc task, so the appropriate position is in the xdoc plugin.
After applying the patch the xdoc:performJSL goal can also be removed and the linkcheck plugin could be modified to use:
<doc:jslToSite srcdir="${maven.build.dir}/linkcheck/docs" />
instead of:
<j:set var="maven.xdoc.src" value="${maven.build.dir}/linkcheck/docs"/>
<attainGoal name="xdoc:performJSL"/>
---------------------------------------------------------------------
JIRA INFORMATION:
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
If you want more information on JIRA, or have a bug to report see:
http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org