<?xml version="1.0" encoding="Shift_JIS"?>

<document>

 <properties>
  <title>Migration To Velocity</title>
  <author email="jvanzyl@locus.apache.org">Velocity Documentation Team</author>
  <translator>熊坂祐二</translator>
  <original>migration</original>
 </properties>

<body>

<section name="テンプレート変換">

<p>
既存の文書は、どんなソフトウェアの移行でも頭痛の種です。
Velocity チームは、現存のテンプレートを Velocity で使用できるように
変更することをできるだけ簡単にそして確実にしようと試みました。
</p>

<p>
現在、WebMacro だけがVelocity テンプレート・コンバータがありますが、
Tea もしくは FreeMarker から Velocity へのテンプレート・コンバータの計画をしています。
</p>

</section>

<section name="WebMacro から Velocity へテンプレート変換">

<p>
<code>convert</code> ディレクトリにある
<code>convert-wm.sh</code> スクリプトは、
単一の WebMacro テンプレート (<code>*.wm</code>) を
Velocity テンプレート(<code>*.vm</code>)に変換したり、
WebMacro テンプレートのディレクトリ構造まるごと
Velocity テンプレートに変換します。
</p>

<p>
    <code>convert-wm.sh</code> スクリプトは、単一の WebMacro テンプレートを Velocity テンプレートに変換します。
</p>

<source><![CDATA[
./convert-wm.sh template.wm
]]></source>

<p>
これは、
<code>template.wm</code> という名前の WebMacro テンプレートから
単一の <code>template.vm</code> という名前の Velocity テンプレート
を生成します。元の WebMacro テンプレートは保存されます。
</p>

<p>
WebMacro テンプレートのディレクトリ構造を丸ごと変換するには、
<code>convert-wm.sh</code> スクリプトを使用して、
単純にテンプレート名の替わりにディレクトリ名を以下のように指定します。
</p>

<source><![CDATA[
./convert-wm.sh templates
]]></source>

<p>
これは、<code>templates/[template].vm</code>
という名前のテンプレートのディレクトリ構造を生成します。
変換時には、もとの WebMacro テンプレートは保存されます。
</p>
</section>

</body>
</document>
