Xslt/Style

Description

説明

Process a set of documents via XSLT.

XSLT によりドキュメントの集合を処理します。

This is useful for building views of XML based documentation, or for generating code.

これは、XMLベースのドキュメントの見やすい形式を作ったり、 コードを生成するのに便利です。

Note: This task depends on external libraries not included in the Ant distribution. See Library Dependencies for more information.

注意: このタスクは Ant ディストリビューションに含まれていない外部ライブラリに依存しています。 詳しくはライブラリ依存関係をご覧ください。

It is possible to refine the set of files that are being processed. This can be done with the includes, includesfile, excludes, excludesfile and defaultexcludes attributes. With the includes or includesfile attribute you specify the files you want to have included by using patterns. The exclude or excludesfile attribute is used to specify the files you want to have excluded. This is also done with patterns. And 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.

処理するファイルの集合を区別することも可能です。 これは、 includesincludesfileexcludesexcludesfile、 およびdefaultexcludes属性によりできます。 includesincludesfile 属性により、 パターンを用いて含めたいファイルを指定します。 excludeexcludesfile 属性は 除外したいファイルを指定するのに使われます。 これもパターンにより指定されます。 そして最後に、 defaultexcludes 属性により、 デフォルトのファイル除外定義を使うかどうかを指定できます。 ファイルの選択と除外の仕組みや、 パターンの書き方については、 ディレクトリベースのタスクをご覧ください。

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.

このタスクは暗黙的な ファイルセットを生成し、 ネストされた <include><exclude>および <patternset>要素と同様に <fileset> (dirbasedirとなります) の全ての属性をサポートしています。

This task supports the use of a nested <param> element which is used to pass values to an <xsl:param> declaration.

このタスクは、 <xsl:param> 宣言に値を渡すために使うネストされた<param>要素の使用をサポートしています。

This task supports the use of a nested xmlcatalog element which is used to perform Entity and URI resolution

このタスクは、 エンティティとURIの解決を行うために使われる ネストされた xmlcatalog 要素の使用をサポートしています。

<style> and <xslt> refer to the same Ant task and can be used interchangeably.

<style> および <xslt> は、 同じ Ant タスクを参照しており、 入れ替えて使用可能です。

If you want to use Xalan-J 1 or XSL:P, you also need Ant's optional.jar

If you want to use Xalan-J 1 または XSL:P を使いたい場合、 Ant の optional.jar も必要になります。

Parameters

パラメータ

Attribute Description Required
basedir where to find the source XML file, default is the project's basedir. No
destdir directory in which to store the results. Yes, unless in and out have been specified.
extension desired file extension to be used for the targets. If not specified, the default is ".html". No
style name of the stylesheet to use - given either relative to the project's basedir or as an absolute path DEPRECATED - can be specified as a path relative to the basedir attribute of this task as well. Yes
classpath the classpath to use when looking up the XSLT processor. No
classpathref the classpath to use, given as reference to a path defined elsewhere. No
force Recreate target files, even if they are newer than their corresponding source files or the stylesheet. No; default is false
processor name of the XSLT processor to use. Permissible values are "trax" for a TraX compliant processor (ie JAXP interface implementation such as Xalan 2 or Saxon), "xslp" for the XSL:P processor, "xalan" for the Apache XML Xalan (version 1) processor the name of an arbitrary XSLTLiaison class. Defaults to trax, followed by xalan and then xslp (in that order). The first one found in your class path is the one that is used. DEPRECATED - XSL:P and xalan are deprecated and no more supported.. No
includes comma- or space-separated list of patterns of files that must be included. All files are included when omitted. No
includesfile the name of a file. Each line of this file is taken to be an include pattern No
excludes comma- or space-separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted. No
excludesfile the name of a file. Each line of this file is taken to be an exclude pattern No
defaultexcludes indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted. No
in specifies a single XML document to be styled. Should be used with the out attribute. No
out specifies the output name for the styled result from the in attribute. No
scanincludeddirectories If any directories are matched by the includes/excludes patterns, try to transform all files in these directories. Default is true No
an exclude pattern
属性 説明 必須
basedir ソース XML ファイルを探す場所。 デフォルトはプロジェクトのベースディレクトリ No
destdir 結果を保存するディレクトリ in および out が指定されない限りは必須
extension ターゲットに用いられる望まれるファイル拡張子。 指定されない場合、デフォルトは ".html" No
style 使用するスタイルシート名。- プロジェクトベースディレクトリからの相対パスか、 絶対パスで与えられる。 非推奨 - 同様に、このタスクの basedir 属性に対する相対パスとして指定することができます。 Yes
classpath XSLT プロセッサを探すときに使われるクラスパス No
classpathref 使用するクラスパス。 他の場所で定義されたパスへの 参照として与えられます。 No
force 依存するソースファイルやスタイルシートよりも新しかったとしても、 ターゲットファイルを(強制的に)再生成します。 No; デフォルトは false
processor 使用する XSLT プロセッサの名前。 使用可能な値は、 TraX 互換のプロセッサ (即ち Xalan 2 や Saxon といった JAXP インタフェースの実装) では "trax" 、 XSL:P プロセッサでは "xslp"、 Apache XML Xalan (バージョン 1) では "xalan"、 または任意の XSLTLiaison クラスの名前です。 デフォルトは traxで、 次に xalan、xslp (と、その順序で)となります。 クラスパス中に最初のものが見つかると、それが使われます。 非推奨 - XSL:P および xalan 非推奨であり、今後サポートされません。 No
includes カンマあるいは空白で区切られた選択されるファイルのパターンのリスト; 省略された場合全てのファイルが選択される。 No
includesfile ファイルの名前; このファイルの各行が includes パターンとして扱われる No
excludes カンマあるいは空白で区切られた除外するファイルのパターンのリスト; 省略された場合、(デフォルト除外ファイルを除き)何も除外しない。 No
excludesfile ファイルの名前; このファイルの各行が excludes パターンとして扱われる No
defaultexcludes デフォルト除外パターンを使うかどうか指定します。 ("yes"/"no") 省略された場合デフォルト除外パターンは使われます。 No
in スタイルシートを適用される一つの XML ドキュメントを指定します。 out 属性と共に使用しなければなりません。 No
out in 属性にスタイルシートを適用した結果の出力名を指定します。 No
scanincludeddirectories ディレクトリがincludes/excludes パターンにマッチしたら、 これらのディレクトリにある全てのファイルの変換を試みます。 デフォルトはtrue No

Parameters specified as nested elements

ネストされる要素で指定されるパラメータ

classpath

The classpath to load the processor from can be specified via a nested <classpath>, as well - that is, a path-like structure.

プロセッサをロードするクラスパスは、 パスのような構造であり、 ネストされた<classpath> 要素により指定されます。

xmlcatalog

The xmlcatalog element is used to perform Entity and URI resolution.

xmlcatalog 要素は エンティティや URI を解決するのに使われます。

param

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

param はパラメータを XSL スタイルシートに渡すのに使われます。

Parameters

パラメータ

Attribute Description Required
name Name of the XSL parameter Yes
expression XSL 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
属性 説明 必須
name XSL パラメータの名前 Yes
expression param に置き換えられる XSL 式。 スタイルシートにテキスト値を渡すには、 シングルクォートを使ってエスケープしなければなりません。 Yes

outputproperty ('trax' processors only)

outputproperty ('trax' プロセッサのみ)

Used to specify how you wish the result tree to be output as specified in the XSLT specifications.

XSLT 仕様書で規定されたように 出力結果の木構造を生成したいか指定するのに使います。

Parameters

パラメータ

Attribute Description Required
name Name of the property Yes
value value of the property. Yes
属性 説明 必須
name プロパティ名 Yes
value プロパティの値 Yes

Examples

<style basedir="doc" destdir="build/doc"
       extension=".html" style="style/apache.xsl"/>

Using an xmlcatalog

xmlcatalogを使用

<xslt basedir="doc" destdir="build/doc"
      extension=".html" style="style/apache.xsl">
  <xmlcatalog refid="mycatalog"/>
</xslt>

<xslt basedir="doc" destdir="build/doc"
   extension=".html" style="style/apache.xsl">
   <xmlcatalog>
       <dtd 
         publicId="-//ArielPartners//DTD XML Article V1.0//EN"
         location="com/arielpartners/knowledgebase/dtd/article.dtd"/>
   </xmlcatalog>
</xslt>

Using XSL parameters

XSL パラメータを使用

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

Then if you declare a global parameter "date" with the top-level element <xsl:param name="date"/>, the variable $date will subsequently have the value 07-01-2000.

Using output properties

output プロパティを使用

<xslt in="doc.xml" out="build/doc/output.xml"
      style="style/apache.xsl">
  <outputproperty name="method" value="xml";/>
  <outputproperty name="standalone" value="yes"/>
  <outputproperty name="encoding" value="iso8859_1"/>
  <outputproperty name="indent" value="yes"/>  
</xslt>

Copyright © 2000-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは漆島賢二が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]