You need to have a good understanding of Ant before reading this tutorial. If you don't, I suggest you read the Ant User Manual first.

このチュートリアルを読む前に、Ant についての深い知識が必要です。 そうでない場合、あらかじめ Ant ユーザーマニュアルを読むことをお勧めします。

This tutorial explains how to install Ant properly to be able to run the Sample application provided with the Cactus distribution and also build the Cactus distribution from the sources.

本チュートリアルでは Cactus ディストリビューションに付属のサンプルアプリケーションを正しく実行できるよう Ant をインストールする方法、および、、 ソースから Cactus ディストリビューションをビルドする方法についても説明します。

Cactus uses the following optional tasks of Ant :

Cactus は、以下の Ant のオプションタスクを利用しています :

• The stylebook task : it is used to build the Cactus web site and Cactus documentation. The Stylebook version required by the Cactus build is the Stylebook 1.0b3 for Xalan2 (named stylebook-1.0-b3_xalan-2.jar) which needs the Xalan 2.0 jar and the Xerces jar. The stylebook task is not used by the Cactus Sample application build process, so it is only needed if you're building from the Cactus sources. This task is normally found in the optional.jar Ant jar.
• stylebook タスク : これは Cactus ウェブサイトと Cactus のドキュメントを生成するのに使われています。 Cactus のビルドに必要な stylebook タスクのバージョンは、 Stylebook 1.0b3 for Xalan2 (stylebook-1.0-b3_xalan-2.jarというファイル名です)。 これには Xalan 2.0 jar および Xerces jar アーカイブが必要です。 stylebook タスクは Cactus サンプルアプリケーションのビルドには使われていません。 ですから、Cactus のソースからビルドする時にのみ必要となります。 このタスクは通常 optional.jarという Ant の jar アーカイブの中にあります。
• The junit task : it is used to run the unit tests of Cactus itself and the Cactus unit tests of the Sample application. This task is normally found in the optional.jar Ant jar.
• junit タスク : Cactus 自身のユニットテスト、および、 サンプルアプリケーションの Cactus ユニットテストを行うのに使われます。 このタスクは通常 optional.jarという Ant の jar アーカイブの中にあります。
• The Cactus Sample application uses some Ant custom tasks provided by Cactus in the cactus-ant.jar jar file ( found in the lib/ directory where you unpacked the Cactus distribution).
• Cactus サンプルアプリケーションでは、 cactus-ant.jar jar ファイルの中にある Cactus で提供された、幾つかの Ant のカスタムタスクを使っています。
• The checkstyle task : it is used only to buidl Cactus from the sources (i.e. not needed for building the Cactus sample application). The version of Checkstyle used is 2.2+.
• checkstyle タスク : これは Cactus をソースからビルドする時にのみ使われます。 (即ち、Cactus サンプルアプリケーションをビルドするには必要ありません)) 使われている Checkstyle のバージョンは 2.2+ です。

In order to simplify the installation of Ant and the gathering of the required Ant tasks as described above, we provide a prepackaged zip containing everything needed. This is available from the downloads section.

Ant のインストール、および、上述の必要な Ant タスクの設定を簡単にするために、 必要な全てのファイルをあらかじめパッケージしたZIPファイルを提供しています。 これは、 ダウンロードの節にあります。

Follow the steps below to install Ant :

Ant をインストールするには以下の手順に従ってください :

1. Download Jakarta Ant (jakarta-ant-<version>-bin.zip) from here. I recommend version 1.4.1 or above. Alternatively you can download the prepackaged Ant version, as mentioned above.
2. ここより Jakarta Ant(jakarta-ant-<version>-bin.zip)をダウンロードします。 バージョン 1.4.1 以上を推奨します。 代りに、先に述べた、あらかじめパッケージ化されたバージョンのAntをダウンロードしても構いません。
3. Unzip it in a directory. Let's call this directory antroot,
4. これを任意のディレクトリに解凍します。 これを antroot ディレクトリとしましょう。
5. Create an environment variable named ANT_HOME that points to the antroot directory,
6. antroot ディレクトリを参照するような ANT_HOME という名前の環境変数を作成します。
7. Modify the PATH environment variable to include the %ANT_HOME%\bin directory (so that you'll be able to type ant in a DOS shell, in whatever directory and it will call the %ANT_HOME%\bin\ant.bat script,
8. 環境変数PATHに、 %ANT_HOME%\binディレクトリを加えます。 (そうすると、どのディレクトリにいてもantと打てば、 %ANT_HOME%\bin\ant.bat スクリプトが呼び出されます。)
9. Download the Ant optional task jar (jakarta-ant-<version>-optional.jar) from here and put it in %ANT_HOME%\lib. Note that this step is needed only if you haven't downloaded the prepackaged zip,
10. Ant のオプショナルタスクのjarアーカイブ (jakarta-ant-<version>-optional.jar)を、 ここよりダウンロードし、 %ANT_HOME%\libに置きます。 このステップは、あらかじめパッケージ化されたZIPをダウンロードしていない場合のみ必要になります。
11. If you haven't downloaded the prepackaged Ant zip, you'll need to download the Stylebook 1.0b3 for Xalan 2 jar, the latest Xalan, the latest Xerces, the latest JUnit and the latest Checkstyle jars. You'll also need to ensure that you use a JAXP 1.1 parser. You can download one (crimson) from here. Put all these jars in %ANT_HOME%\lib.
12. あらかじめパッケージ化された Ant の ZIP ファイルをダウンロードしていない場合、 Stylebook 1.0b3 for Xalan 2 jar、 最新の Xalan、 最新のXerces、 最新のJUnit、 および最新のCheckstyle jar アーカイブをダウンロードしなければなりません。 さらに、JAXP 1.1 パーザーを使っているか確認する必要があります。 その一つ (crimson) は ここからダウンロード可能です。 これらの jar アーカイブを%ANT_HOME%\libに置きます。

You should ensure that the Ant optional jar that you download contains the <stylebook> and <junit> tasks. Alternatively you can download the prepackaged Ant zip as mentionned above.

<stylebook> 、<junit> タスクが Ant のオプションの jar アーカイブに含まれているか確認してください。 あるいは、先に述べた通り、あらかじめパッケージにそれらが入った Ant の ZIP ファイルをダウンロードすることもできます。