From 1263b364095d7e55064e1d0a104f53815feb2bfb Mon Sep 17 00:00:00 2001 From: Conor MacNeill Date: Tue, 9 Jan 2001 11:45:52 +0000 Subject: [PATCH] Documentation update for the new param element of the style task and other style task changes. Submitted by: Jeff Martin git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268423 13f79535-47bb-0310-9956-ffa450edef68 --- docs/index.html | 91 ++++++++++++++++++++++++++++++++++++------------- 1 file changed, 68 insertions(+), 23 deletions(-) diff --git a/docs/index.html b/docs/index.html index c04ef17f2..0370fade2 100644 --- a/docs/index.html +++ b/docs/index.html @@ -4349,11 +4349,12 @@ finally with the defaultexcludes attribute, you can specify whether you want to use default exclusions or not. See the section on directory based tasks, on how the inclusion/exclusion of files works, and how to write patterns.

-

This task forms an implicit FileSet and -supports all attributes of <fileset> -(dir becomes basedir) as well as the nested -<include>, <exclude> and -<patternset> elements.

+

This task forms an implicit FileSet and supports all + attributes of <fileset> (dir becomes basedir) + as well as the nested <include>, <exclude> + and <patternset> elements.

+

Style supports the use of a <param> element which is use to pass values + to an <xsl:param> declaration.

Parameters

@@ -4373,8 +4374,8 @@ supports all attributes of <fileset> - + @@ -4385,34 +4386,35 @@ supports all attributes of <fileset> + "trax" for a TraX compliant processor, "xslp" for the + XSL:P processor, "xalan" for the Apache XML Xalan (version 1) + processor, or the name of an arbitrary XSLTLiaison class. Defaults to trax, + followed by xslp then xalan (in that order). The first one found in your + class path is the one that is used. - + - + - + - + @@ -4421,14 +4423,57 @@ found in your class path is the one that is used. ("yes"/"no"). Default excludes are used when omitted. + + + + + + + + + + +
extensiondesired file extension to be used for the targets. - If not specified, the default is "html".desired file extension to be used for the targets. If not + specified, the default is "html". No
processor name of the XSLT processor to use. Permissible values are -"trax" for a TraX compliant processor, "xslp" for the XSL:P -processor, "xalan" for the Apache XML Xalan (version 1) processor, or the name of an arbitrary XSLTLiaison class. -Defaults to trax, followed by xslp then xalan (in that order). The first one -found in your class path is the one that is used. No
includescomma separated list of patterns of files that must be - included. All files are included when omitted.comma separated list of patterns of files that must be included. + All files are included when omitted. No
includesfilethe name of a file. Each line of this file is - taken to be an include patternthe name of a file. Each line of this file is taken to be + an include pattern No
excludescomma separated list of patterns of files that must be - excluded. No files (except default excludes) are excluded when omitted.comma separated list of patterns of files that must be excluded. + No files (except default excludes) are excluded when omitted. No
excludesfilethe name of a file. Each line of this file is - taken to be an exclude patternthe name of a file. Each line of this file is taken to be + an exclude pattern No
No
inspecifies a single XML document to be styled. Should be used + with the out attribute.No
outspecifies the output name for the sytled result from the + in attribute.No
+

Parameters specified as nested elements

+

param

+

Param is used to pass a parameter to the XSL stylesheet.

+

Parameters

+ + + + + + + + + + + + + + + +
AttributeDescriptionRequired
nameName of the XSL parameterYes
expressionXSL expression to be placed into the param. To pass a text + value into the style sheet it needs to be escaped using single quotes.Yes

Examples

- 

+  

+  
 <style basedir="doc" destdir="build/doc"
-       extension="html" style="style/apache.xml"/>
-

-
+ extension="html" style="style/apache.xsl"/> +


+ Using XSL parameters
+

+ 
<style basedir="doc" destdir="build/doc"
+		extension="html" style="style/apache.xsl">
+	<param name="date" expression="'07-01-2000'"/>
+</style>
+

This will replace an xsl:param definition<xsl:param name="date"></xsl:param> + with the text value 07-01-2000

+

Tar

Description