Cernunnos Manual

<xslt>

Description:

Executes the specified XSL Transformation. By default, this task uses the value of the 'Attributes.NODE' request attribute as the XML source, and places the result of the trasformation under the same request attribute for subtasks.

Reagents:

Name XPath Description Reagent Type Expected Type Required
CACHE @cache A shared Map to cache items in. The default is the value of the 'Attributes.CACHE' request attribute. PHRASE java.util.Map No
CACHE_MODEL @cache-model Specify either NONE, ONE, or ALL. PHRASE java.lang.String No
ENTITY_RESOLVER @entity-resolver Optional org.xml.sax.EntityResolver to use in parsing LOCATION. By default, this task looks for an EntityResolver instance under the request attribute 'XmlAttributes.ENTITY_RESOLVER' and will use it if present. PHRASE org.xml.sax.EntityResolver No
CONTEXT @context The context from which missing elements of the STYLESHEET and LOCATION may be inferred in appropriate circumstances. The default is a URL representing the filesystem location from which Java is executing. PHRASE java.lang.String No
STYLESHEET @stylesheet Location of the XSLT stylesheet to use in transformation. May be a file system path (absolute or relative) or a URL. PHRASE java.lang.String Yes
NODE @node Optional XML node to act as the source of the transformation. If not explicitly specified, this task will attempt to use the 'Attributes.NODE' request attribute. If that attribute is not present, the LOCATION reagent will be used. PHRASE org.dom4j.Element No
LOCATION @location Optional location of an XML resource that will be transformed (assuming the NODE reagent is not provided). It may be a filesystem path or a URL, and may be absolute or relative. If relative, the location will be evaluated from the CONTEXT. If omitted, the value of the 'Attributes.LOCATION' request attribute will be used. PHRASE java.lang.String No
TO_FILE @to-file Optional file system path to which the result of the transformation will be written. It may be absolute or relative, in which case it will be evaluated from the directory in which Java is executing. If not provided, the result will be set to the value of 'Attributes.NODE' on the task request for subtasks. PHRASE java.lang.String No
SUBTASKS * The set of tasks that are children of this task. NODE_LIST java.util.List No

Examples:

Creates the documentation you are reading (when executed from the root of a Cernunnos source tree):

 
       
        <serialize-grammar> 
          <file-iterator dir="media/grammardoc" excludes="**/*.xsl"> 
            <copy-file to-dir="docs/grammardoc"/> 
          </file-iterator>  
          <xslt stylesheet="media/grammardoc/table-of-contents.xsl" to-file="docs/grammardoc/table-of-contents.html"/>  
          <node-iterator xpath="entry"> 
            <xslt stylesheet="media/grammardoc/entry.xsl" to-file="docs/grammardoc/entries/${valueOf(name)}.html"/> 
          </node-iterator> 
        </serialize-grammar>