<?xml version="1.0" encoding="Shift_JIS"?>
<!--
  Copyright 2003-2004 The Apache Software Foundation.

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.

  $Id: index.xml,v 1.6 2005/03/19 07:56:56 nekop Exp $
-->
<document>

    <properties>
        <title>VelocityTools プロジェクト</title>
        <author email="geirm@apache.org">Geir Magnusson Jr.</author>
        <author email="sidler@apache.org">Gabriel Sidler</author>
        <projectfile>xdocs-ja/menu.xml</projectfile>
        <translator email="shinobu@ieee.org">Shinobu Kawai</translator>
        <translator email="nekop@programmers.jp">木村 貴由</translator>
        <original>VelocityTools Project</original>
    </properties>

    <body>
    <section name="Overview" alias="概要">
        <primary>
        <p>
        VelocityTools is a collection of Velocity subprojects with a common goal
        of creating tools and infrastructure for building both web and non-web
        applications using the Velocity template engine.
        </p>
        </primary>
        <p>
        Velocity Tools は Velocity テンプレートエンジンを使用して、
        Web/非Web 両方のアプリケーションを作成するのに役立つツールや、
        インフラを作成することをゴールとする Velocity のサブプロジェクトの集まりです。
        </p>

        <subsection name="GenericTools" alias="GenericTools">
            <primary>
            <p><a href="generic/">GenericTools</a> is a group of reuseable and 
            documented tools that can be added to a Velocity context. A 
            <b>tool</b> is simply a class which can perform various tasks when 
            made available to the Velocity engine. Most tools are optimized for use
            with an automatically managed toolbox (see VelocityViewServlet).</p>
            </primary>
            <p><a href="generic/">Generic Tools</a> は、
            Velocity コンテキスト内に格納できる、再利用が可能な
            ドキュメント付きのツール群です。
            <b>ツール</b>とは Velocity エンジンから利用できる、
            様々な処理を行うことのできるシンプルなクラスです。
            ほとんどのツールは自動管理されたツールボックスと一緒に利用するように最適化されています
            (VelocityViewServlet 参照)。</p>
            <br clear="all" />
        </subsection>

        <subsection name="VelocityView" alias="VelocityView">
            <primary>
            <p><a href="view/">VelocityView</a>
            contains a standalone servlet (VelocityViewServlet) which can render 
            templates for web applications. </p>
            </primary>
            <p><a href="view/">VelocityView</a>には、
            Web アプリケーションでテンプレートの表示処理を行うスタンドアロンのサーブレット
            (VelocityViewServlet) があります。</p>
            <primary>
            <p> Also included is a Toolbox Manager which can automatically make 
            &quot;view tools&quot; and data available to the templates. Any class 
            with public methods can be used as a tool in the template.
            </p>
            </primary>
            <p>また、 &quot;ビューツール&quot; を自動的に生成し、
            データをテンプレートへ提供する Toolbox Manager も含んでいます。
            public メソッドをもつクラスであれば、
            ツールとしてテンプレート内で使用することが可能です。
            </p>
            <primary>
            <p>
            <a href="view/layoutservlet.html">VelocityLayoutServlet</a> is an 
            extension of the basic VelocityViewServlet that can render screen 
            content into common layout templates.</p>
            </primary>
            <p>
            <a href="view/layoutservlet.html">VelocityLayoutServlet</a> は
            VelocityViewServlet を拡張したもので、
            汎用的なレイアウトテンプレートの中に、
            スクリーンを表示することができます。</p>
            <br clear="all" />
        </subsection>

        <subsection name="VelocityStruts" alias="VelocityStruts">
            <primary>
            <p><a href="struts/">VelocityStruts</a> is a set of tools for using the 
            Velocity template engine as the view layer for a web application built upon the
            <a href="http://jakarta.apache.org/struts/">Jakarta Struts</a> framework.</p>
            </primary>
            <p><a href="struts/">VelocityStruts</a> は、
            Velocity テンプレートエンジンを
            <a href="http://jakarta.apache.org/struts/">Jakarta Struts</a>
            フレームワーク上に構築された Web アプリケーションのビューレイヤとして使うときに利用するツールを集めたものです。</p>
            <primary>
            <p>This work leverages the <strong>VelocityViewServlet</strong> and 
            additional tools which make it easy to integrate the Velocity with 
            Struts. Several example hybrid applications are included.</p>
            </primary>
            <p>これは <strong>VelocityViewServlet</strong> と、 Velocity と
            Struts との統合を容易にする追加ツール群を利用して実現しています。
            また、いくつかのサンプルアプリケーションも含んでいます。</p>
            <br clear="all" />
        </subsection>

        <subsection name="Example Applications" alias="サンプルアプリケーション">
            <primary>
            <p>Several example applications are currently available, including
            one to demonstrate the use of Velocity as a view technology for Struts. 
            The example utilizes both Velocity and JSP files for the view in parallel 
            so that they can be compared easily. Also, resources bundle usage for 
            language localization is demonstrated there. Other examples include a demonstration
            of the use of the VelocityLayoutServlet and a minimal "simple" application.</p>
            </primary>
            <p>現在、いくつかのサンプルアプリケーションがあり、
            そのひとつは Velocity を
            Struts のビューテクノロジとして使用する方法を示すものです。
            このサンプルでは、比較のために Velocity と
            JSP の両方をビューとして使用しています。
            また、言語の地域化のためのリソースバンドルの使い方も含まれています。
            その他 VelocityLayoutServlet の使い方と、
            最小構成の "シンプルな" アプリケーションの例が含まれています。</p>
            <br clear="all" />
        </subsection>

        <subsection name="Documentation" alias="ドキュメント">
          <primary>
          <p>
            Emphasis <s>is</s> was being put on providing tool documentation that 
            is suitable for template designers. To achive this goal, a documentation
            format has been defined that captures all information relevant to the
            template designer. It is being supplied in addition to the customary
            Javadoc. This should help to achieve what we always claim for Velocity:
            "Decouple the work of template designers from the work of software
            developers". Look at the Struts 
            <a href="struts/MessageTool.html">MessageTool</a>
            for a good example of the new documentation format.
          </p>
          </primary>
          <p>
            テンプレートデザイナのためのツールドキュメントを提供することを重要視していま<s>す</s>した。
            これを実現するために、テンプレートデザイナに関係する全ての情報を網羅するドキュメント形式が定義されました。
            これは、通常の Javadoc に加えて提供されます。
            これによって、私たちがいつも Velocity に求めている事−
            "テンプレートデザイナの仕事とソフトウェア開発者の仕事を分離せよ"
            −を達成する手助けになるはずです。
            新しいドキュメント形式については、Struts の
            <a href="struts/MessageTool.html">MessageTool</a>
            が良い例となっています。
          </p>
          <primary>
          <p>
            <b>Update:</b> 
            While we value the look and readability of this format, we are presently 
            drifting away from the use of it. The primary reason for this is that the 
            developers have found it difficult to maintain (i.e. no one
            has been motivated enough to put in the extra work).  If you feel this 
            documentation format is valuable and wish to help us create and maintain
            it for the various individual tools, please see 
            <a href="#Wanna help?">below</a> 
            for more details on getting involved.  Meanwhile, we'll be putting effort
            into improving javadoc for individual tools and overview documents for 
            the sub-projects.
          </p>
          </primary>
          <p>
            <b>更新情報:</b> 
            この形式の見栄えと可読性を重宝すると同時に、
            私たちは現在その使用から遠のいています。
            一番の理由は、開発者にとってメンテナンスしにくいからです。
            (i.e. 誰も余分な作業をするほどの意欲がないのです。)
            もしこの形式に価値があると判断し、様々なツールのドキュメントを作成し、
            メンテナンスしたいと思いましたら、参加するための詳細について
            <a href="#Wanna help?">下記</a> を参照して下さい。
            当面は、各々のツールのjavadocの改善と、
            サブプロジェクトのドキュメントの見直しを努力します。
          </p>
        </subsection>
        <br clear="all"/>
    </section>    

    <section name="Download" alias="ダウンロード">
        <primary>
        <p><strong>Releases</strong></p>
        </primary>
        <p><strong>リリース</strong></p>
        <primary>
        <p>
          VelocityTools 1.1 is now available in
          <a href="http://jakarta.apache.org/site/sourceindex.cgi">source</a> or
          <a href="http://jakarta.apache.org/site/binindex.cgi">binary</a> form.
        </p>
        </primary>
        <p>
          VelocityTools 1.1 がリリースされており、
          <a href="http://jakarta.apache.org/site/sourceindex.cgi">ソース</a> または
          <a href="http://jakarta.apache.org/site/binindex.cgi">バイナリ</a>
          の形式で入手可能です。
        </p>

        <br clear="all"/>
    </section>

    <section name="CVS Repository" alias="CVS リポジトリ">
        <primary>
        <p>All VelocityTools project code is maintained in the 
        CVS repository <b>jakarta-velocity-tools</b>.</p>
        </primary>
        <p>Velocity Tools プロジェクトの全てのコードは
        <b>jakarta-velocity-tools</b> CVSリポジトリで管理されています。</p>

        <primary>
        <p>Web Browser: <a href="http://cvs.apache.org/viewcvs/jakarta-velocity-tools/">
        http://cvs.apache.org/viewcvs/jakarta-velocity-tools/</a></p>
        </primary>
        <p>Web ブラウザ: <a href="http://cvs.apache.org/viewcvs/jakarta-velocity-tools/">
        http://cvs.apache.org/viewcvs/jakarta-velocity-tools/</a></p>

        <primary>
        <p>CVS Client: <a href="http://jakarta.apache.org/site/cvsindex.html">http://jakarta.apache.org/site/cvsindex.html</a>.
        </p>
        </primary>
        <p>CVS クライアント: <a href="http://jakarta.apache.org/site/cvsindex.html">http://jakarta.apache.org/site/cvsindex.html</a>.
        </p>
        <br clear="all"/>
    </section>

    <section name="Wanna help?" alias="手伝いたい?">
        <primary>
        <p>We encourage interested developers to evaluate the project
        and send feedback to the velocity-user or velocity-dev mailing list.</p>
        </primary>
        <p>私たちは興味のある開発者に対して、ソフトウェアを評価し、
        velocity-user や velocity-dev
        メーリングリストへフィードバックをしてくれることを奨励します。</p>
        <primary>
        <p>Those interested in furthering the development of this project are
        especially welcome to jump in and help out.  Patches can be sent to the 
        mailing list or attached to a
        <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Velocity&amp;component=Tools">bugzilla</a>
        ticket.  The <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocityTools">Wiki</a>
        can also be a good place to discuss and develop ideas.</p>
        </primary>
        <p>このプロジェクトの開発を進めることに興味を持ち、
        熱心な活動と手助けを行ってくれることを特に期待しています。
        パッチはメーリングリストへ送るか、
        <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Velocity&amp;component=Tools">bugzilla</a>
        のチケットとして添付してください。
        <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocityTools">Wiki</a>
        は議論と開発のアイデアを展開するのにちょうど良いでしょう。</p>

        <primary>
        <p>A few good places to get started include:
          <ul>
            <li>Documentation (patches for the site or additions to the Wiki)</li>
            <li>Improving the example apps</li>
            <li>Contributing to the <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocimacroLibraries">VelocimacroLibraries</a></li>
          </ul>
        Other project goals and proposals can be found in the project 
        <a href="http://cvs.apache.org/viewcvs/jakarta-velocity-tools/STATUS">STATUS</a>
        file.</p>
        </primary>
        <p>手始めとしてちょうどよいものとしては以下のものがあります:
          <ul>
            <li>ドキュメント (サイトのドキュメントへのパッチ、もしくはWikiへ追加する)</li>
            <li>サンプルアプリケーションの改良</li>
            <li><a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocimacroLibraries">VelocimacroLibraries</a>への提供</li>
          </ul>
        その他のプロジェクトのゴールや提案は、プロジェクトの
        <a href="http://cvs.apache.org/viewcvs/jakarta-velocity-tools/STATUS">STATUS</a> ファイルにあります。</p>
    </section>
 </body>

</document>
