# <style>

[This is preliminary documentation and subject to change.]

Processes a document via XSLT.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
style | Uri | URI or path that points to the stylesheet to use. If given as path, it can be relative to the project's basedir or absolute. | True
destdir | directory | Directory in which to store the results. The default is the project base directory. | False
extension | string | Desired file extension to be used for the targets. The default is `html`. | False
in | file | Specifies a single XML document to be styled. Should be used with the `out` attribute. | False
out | file | Specifies the output name for the styled result from the `in` attribute. | False
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False

### Nested Elements:

#### <infiles>

Specifies a group of input files to which to apply the stylesheet.

#### </infiles>

#### <parameters>

XSLT parameters to be passed to the XSLT transformation.

##### <parameter>

Represents an XSLT parameter.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
name | string | The name of the XSLT parameter. | True
value | string | The value of the XSLT parameter. | True
if | bool | Indicates if the parameter should be added to the XSLT argument list. If true then the parameter will be added; otherwise, skipped. The default is true. | False
namespaceuri | string | The namespace URI to associate with the parameter. | False
unless | bool | Indicates if the parameter should not be added to the XSLT argument list. If false then the parameter will be added; otherwise, skipped. The default is false. | False

##### </parameter>

#### </parameters>

#### <extensionobjects>

XSLT extension objects to be passed to the XSLT transformation.

##### <extensionobject>

Represents an XSLT extension object. The object should have a default parameterless constructor and the return value should be one of the four basic XPath data types of number, string, Boolean or node set.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
assembly | file | The assembly which contains the XSLT extension object. | True
typename | string | The full type name of the XSLT extension object. | True
if | bool | Indicates if the extension object should be added to the XSLT argument list. If true then the extension object will be added; otherwise, skipped. The default is true. | False
namespaceuri | string | The namespace URI to associate with the extension object. | False
unless | bool | Indicates if the extension object should not be added to the XSLT argument list. If false then the extension object will be added; otherwise, skipped. The default is false. | False

##### </extensionobject>

#### </extensionobjects>

#### <proxy>

The network proxy to use to access the Internet resource.

#### </proxy>

### Examples

- Create a report in HTML.

                  <style style="report.xsl" in="data.xml" out="report.html" />

- Create a report in HTML, with a param.

                  <style style="report.xsl" in="data.xml" out="report.html">
                      <parameters>
                          <parameter name="reportType" namespaceuri="" value="Plain" />
                      </parameters>
                  </style>

- Create a report in HTML, with a expanded param.

                  <style style="report.xsl" in="data.xml" out="report.html">
                      <parameters>
                          <parameter name="reportType" namespaceuri="" value="${report.type}" />
                      </parameters>
                  </style>

- Create some code based on a directory of templates.

                  <style style="CodeGenerator.xsl" extension="java">
                      <infiles>
                          <include name="*.xml" />
                      </infiles>
                      <parameters>
                          <parameter name="reportType" namespaceuri="" value="Plain" if="${report.plain}" />
                      </parameters>
                  <style>

- Create a report in HTML, with an extension object.

                  <style style="report.xsl" in="data.xml" out="report.html">
                      <extensionobjects>
                          <extensionobject namespaceuri="urn:Formatter" typename="XsltExtensionObjects.Formatter" assembly="XsltExtensionObjects.dll" />
                      </extensionobjects>
                  </style>

### Requirements

Assembly: NAnt.Core (0.91.3881.0)