The following comment has been added to this issue:
Author: fabrizio giustina
Created: Thu, 9 Oct 2003 3:34 PM
Body:
all the variables set up in the tag and the user-supplied parameter are needed.
The test script transforms an xml file integrating it into the site layout: you can
try commenting out any of the parameter and the html doc generated from the test
script will be not correct.
---------------------------------------------------------------------
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
Fix Fors:
1.0-rc2
Versions:
1.0-rc1
Assignee:
Reporter: fabrizio giustina
Created: Thu, 25 Sep 2003 3:57 PM
Updated: Wed, 8 Oct 2003 12:07 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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
