<?xml version="1.0" encoding="Shift_JIS"?>

<document>

 <properties>
  <title>Velocity Installation</title>
  <author email="jvanzyl@locus.apache.org">Velocity Documentation Team</author>
  <translator>熊坂祐二</translator>
  <translator>高橋達男</translator>
  <original>install</original>
 </properties>

<body>

<section name="インストール">

<p>
Velocity は、Java 2 VM がインストールしてあるさまざまなプラットホームで実行できます。
ソースコードから Velocity をコンパイルしたい場合には、J2SDK が必要です。
</p>
<p>
配布から Velocity をビルドするのに必要なものはすべて、
<a
href="http://jakarta.apache.org/getinvolved/cvsindex.html">CVS</a> または
<a
href="http://cvs.apache.org/builds/jakarta-velocity/nightly/">夜間ビルド</a>から入手できます。
また、優れた Java ベースのビルドツールである Ant をインストールする必要があります。
Ant もまた Jakarta プロジェクトで、
<a href="http://jakarta.apache.org/ant/">ここ</a>にあります。
<br/>
[訳注：現在、Ant は Apache のトップレベルプロジェクトとして、
Jakarta プロジェクトから独立しています。サイトも
<a href="http://ant.apache.org/">http://ant.apache.org/</a> に移動しました。]
</p>

<p>
配布のディレクトリツリーは、以下のようになります
</p>

<source><![CDATA[
jakarta-velocity
  /build        - ビルドスクリプトが含まれる
  /bin          - 構築された jar や class が収まる場所
  /src          - Velocity, Anakia, Texen のソースコード
  /docs         - HTML 形式のドキュメント
  /docs/api     - Velocity のソースの Javadoc
  /examples     - サンプルとドキュメントのコード
  /convert      - WebMacro テンプレートからの変換ツール
  /test         - テストプログラムとテンプレート
  /xdocs        - ドキュメントのソース
]]></source>

</section>

<section name="ビルド">

<p>
Velocity を簡単に一貫性をもたせてビルドするには、Apache のプロジェクトである
<a href="http://ant.apache.org/">Ant</a> のバージョン 1.3 以降が必要です。
<br/>
[訳注：上の訳注のとおり、URLが変わっています。このリンクは変更済みです]
<br/>
Ant のインストール指示に従って正しくそれをインストールしていることを前提にします。
インストールも難しくありませんし、素晴らしいプログラミングツールだと思います。
</p>
<p>
以下の各手順では、あなたが CVS からの配布か夜間ビルドの取得に成功していて、
夜間ビルドの場合は、解凍に成功していることを前提にしています。
そして、「jakarta-velocity」ディレクトリ(配布ツリーのルート)
で作業を行っていると仮定しています。
ディレクトリ参照はすべて「jakarta-velocity」の相対パスです。
</p>
<p>
<filename>build</filename> ディレクトリに移動してください (<code>cd build</code>)。
それから、jarファイルをビルドするには、単に以下のようにタイプしてください。
</p>

<source><![CDATA[
ant
]]></source>

<p>
このスクリプトを実行すると、Velocity 配布ディレクトリの中に
<filename>bin</filename> ディレクトリが作成されます。
<filename>bin</filename> ディレクトリにはコンパイルされたクラスファイル
(<filename>classes</filename> ディレクトリ内にあります) と
 <filename>velocity-XX.jar</filename> ファイル (XX は現在のバージョン番号)
が入っています。クラスパスを Velocity の <filename>.jar</filename> ファイル
を含めて更新したことを確認してください。
</p>
<p>
ビルドターゲット (<a href="developer-guide.html">開発者ガイド</a>で詳述) の
いずれかをビルドするには、コマンドラインでターゲット名を加えるだけです。
例えば、Javadoc API ドキュメトをビルドするには以下のようにします。
</p>
<source><![CDATA[
ant javadocs
]]></source>

<p>
Velocity は、「独自に」、つまりクラスパスに依存せずにビルドすべきです。
Velocity のビルドでエラーが出た場合には、別の夜間ビルドを試してみるか
(時にはミスがあって、夜間スナップショットの時点で必要なものが CVS にそろってない
こともあります)、CVSから再取得してください
(開発者によるチェックイン中にCVS スナップショットを取得したのかもしれません)。
</p>
<p>
問題がずっと解決しないようでしたら、迷わず、メーリングリストを通して Velocity 
コミュニティで質問してください。
メーリングリストについては<a href="http://jakarta.apache.org/site/mail.html">ここ</a>
で情報を得られます。Jakarta メーリングリストに参加するためのガイドラインを
読んで理解してください。
</p>
</section>

<section name="インストール後のテスト">

<p>
Velocity 開発者は自動テスト機能を使いますが、この機能は配布にも含まれています。
Velocity のビルドで全て問題ないことを確認するのに使うことができます。
</p>

<p>
テストスイートを実行するには、<filename>test</filename> というビルドターゲット
を使ってビルドします。
</p>


<source><![CDATA[
ant test
]]></source>

<p>
うまくいけば、出力はこうなります。
</p>

<source><![CDATA[
test:
Running JUnit template tests for Velocity ...
Adding TemplateTestCase : arithmetic
Adding TemplateTestCase : array
Adding TemplateTestCase : block
   .
   .
   .
Adding TemplateTestCase : math
Adding TemplateTestCase : range
Adding TemplateTestCase : get
Adding TemplateTestCase : velocimacro2
Adding TemplateTestCase : foreach-type
Adding ContextSafetyTestCase.
......................................
Time: 2.553

OK (38 tests)
]]></source>

<p>
テスト数は上記と異なるかもしれませんが、
テストの実行後に 'OK' が表示されればすべて OK です。
これで Velocity を使うことができます。
</p>
</section>

</body>
</document>