Xslt/Style

説明

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

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

注意:JDK 1.4かそれ以上を利用しているならば、このタスクは外部のライブラリを必要せず、 Antディストリビュージョンで提供されていません。 そうでないとき、詳しくは、ライブラリ依存関係をご覧ください。

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

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

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

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

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

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

パラメータ

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

classpath

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

xmlcatalog

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

param

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

パラメータ

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

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

パラメータ

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

パラメータ

属性

プロセッサファクトリの設定を指定するために使います。 属性名と値は、プロセッサの詳細で、それを理解する実装を知っていなくてはいけない。 あなたのプロセッサのドキュメントを読んでください。
例えば、Xalan 2.xにて:

• http://xml.apache.org/xalan/features/optimize (boolean)
• http://xml.apache.org/xalan/features/incremental (boolean)
• ...

Saxon 7.xにて:

• http://saxon.sf.net/feature/allow-external-functions (boolean)
• http://saxon.sf.net/feature/timing (boolean)
• http://saxon.sf.net/feature/traceListener (string)
• http://saxon.sf.net/feature/treeModel (integer)
• http://saxon.sf.net/feature/linenumbering (integer)
• ...

パラメータ

属性	説明	必須
name	属性の名前e	Yes
value	属性の値	Yes

例

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

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>

XSL パラメータを使用

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

トップレベル要素で、グローバルパラメータの"date"を宣言したら、 <xsl:param name="date"/>になり、変数$dateは、 その後、07-01-2000という値を持ちます。

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>

factoryの設定

<xslt in="doc.xml" out="build/doc/output.xml"
      style="style/apache.xsl">
  <factory name="org.apache.xalan.processor.TransformerFactoryImpl">
    <attribute name="http://xml.apache.org/xalan/features/optimize" value="true"/>
  </factory>
</xslt>

Copyright © 2000-2004 The Apache Software Foundation. All rights Reserved.

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