<?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>
  <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://jakarta.apache.org/builds/jakarta-velocity/nightly/">夜間ビルド</a>から入手することができます。
また、すばらしい Java ベースのツールである Ant をインストールする必要があります。
Ant もまた Jakarta プロジェクトの、
<a href="http://jakarta.apache.org/ant/">ここ</a>にあります。
</p>

<p>
配布ディレクトリツリーは、以下のようになります
</p>

<source><![CDATA[
jakarta-velocity
  /build        - ビルドスクリプトが含まれる
  /bin          - 構築された jar や class が収まる場所
  /src          - Velocity, Anakia, Texen のソースコード
  /docs         - HTML 形式のドキュメント
  /docs/api     - Velocity ソースの Javadocs
  /examples     - 例とドキュメントのコード
  /convert      - WebMacro テンプレートからの変換のためのツール
  /test         - テストプログラムとテンプレート
  /xdocs        - 私たちのドキュメントのソース
]]></source>

</section>

<section name="ビルド">

<p>
Velocity を簡単に一貫性をもたせてビルドするために、Jakarta プロジェクトで
<a href="http://jakarta.apache.org/ant/">Ant</a> と呼ばれるビルドプロセスのバージョン
1.3 以降が必要です。
我々は、あなたが Ant のインストール指示に従って、
正しくそれをインストールしたと仮定しています。
それは、難しくなくないし、あなたのプログラマーの道具箱にこのすばらしいツールを追加するだろうと思います。
</p>
<p>
下記の個々の場合には、あなたが CVS からの配布やナイトリービルドや最新版を得て、
unpack に成功していると仮定しています。
また、あなたが「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>velocity-XX.jar</filename> ファイルと
同様にコンパイルされたクラス・ファイル（<filename>classes</filename> ディレクトリ内で）
が含まれます。ここで、XX は現在のバージョン番号です。
必ず Velocity の <filename>.jar</filename> ファイルを含めるためにあなたのクラスパスを更新してください。
</p>
<p>
<a href="developer-guide.html">開発者ガイド</a>で詳述されるように、
構築するためには、なにかしら構築ターゲットを指定することに注意してください。
単にターゲット名をコマンド行に追加してください。
例えば、Javadoc API ドキュメトを構築するには以下のようにします。
</p>
<source><![CDATA[
ant javadocs
]]></source>

<p>
Velocity は、「独自に」つまり、あなたの classpath から独立させて構築すべきです。
あなたが 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>