<?xml version="1.0"?>
<document>
  <title>XTemplate -- XML Template Engine for Ruby</title>
  <body>
    <section>
      <title>XTemplate</title>
      <body>
      <p>
        XTemplate is a package of ruby libraries and programs which formats a
	XML/HTML document according to a ruby's data structure which consists
	of Hash and Array. This idea comes from <raa name="amrita">Amrita</raa>.
	So we do not need to explicitly write iterations like for-loop in
	a template. Such iterations are indicated by an expansion data.
	We can specify a data ID in XPath like expression, and reconstruct a given
	data in a template without writing ruby programs. This mechanism provides
	interoperablity between a template and a ruby script.
	We can use XML/<raa name="yaml">YAML</raa> documents as an expansion
	data (<a href="yaml.html">See also this page.</a>), since it is automatically
        converted to a ruby's Hash object.
      </p>
      </body>
    </section>

    <section>
      <title>Download</title>
      <body>
      XTemplate is provided under the term of <cvs file="xtemplate/COPYING">
      the modified BSD license</cvs>.
      <ul>
        <li><a href="http://sourceforge.net/projects/xtemplate">Project Summary Page</a></li>
	<li><a href="http://sourceforge.net/cvs/?group_id=72070">CVS Repository</a></li>
      </ul>
      <p>
      XTemplate uses one of
      <a href="http://www.ruby-lang.org/raa/list.rhtml?name=xmlscan">xmlscan</a>
      and
      <a href="http://www.ruby-lang.org/raa/list.rhtml?name=rexml-stable">REXML</a>
      to parse XML document, so you need to install it.
      Also, 'xtemplate/yaml.rb' requires <raa name="yaml">YAML4R</raa>.
      </p>
      </body>
    </section>

    <section>
      <title>Support</title>
      <body>
      <p>
      Future requests and questions are allowed to be posted to the
      <a href="http://www.walrus-ruby.org/amrita/cgi-bin/aswiki/aswiki.cgi?c=v;p=AmritaUsers">
      "Amrita Users ML"</a>.
      Of course, I will answer to quenstions posted to ruby-talk/ruby-list mailing list.
      </p>
      <p>
      If you encounter a problem, inform it to me using
      <a href="http://sourceforge.net/tracker/?atid=533276&amp;group_id=72070&amp;func=browse">
      bug tracking system</a>.
      Also,
      <a href="http://sourceforge.net/tracker/?atid=533279&amp;group_id=72070&amp;func=browse">
      feature request tracking system</a> and 
      <a href="http://sourceforge.net/tracker/?atid=533278&amp;group_id=72070&amp;func=browse">
      patch tracking system</a> are available.
      </p>
    </body>
    </section>

    <section>
      <title>Other Resources</title>
      <body>

      <ul>

      <li><raa name="xmlscan">xmlscan</raa>
      (XML parser used by XTemplate.)</li>

      <li><raa name="rexml-stable">REXML</raa>
      (XML parser used by XTemplate.)</li>

      <li><raa name="amrita">Amrita</raa>
      (The idea of XTemplate comes from Amrita, which uses REXML.)</li>

      <li><raa name="ruby-tmpl">ruby-tmpl</raa>
      (similar to eruby)</li>

      <li><raa name="eruby">ERuby</raa></li>

      <li><raa name="erb">ERB</raa>
      (another implementation of eruby, written in ruby.)</li>

      <li><a href="http://sourceforge.net/projects/xtpl/">XTemplate for PHP</a>
      (This is a PHP's library which is similar to eruby.)</li>

      <li><raa name="misen">misen</raa>
      (This is similar to amrita and supports non-HTML/XHTML document.)</li>

      <li><a href="http://www.perl.com/pub/a/2001/08/21/templating.html?page=1">
      Choosing a Templating System</a>
      : Overview of perl template systems</li>

      <li><a href="http://www.rubygarden.org/ruby?HtmlTemplates">
      Ruby: HtmlTemplates</a>
      (Overview of ruby template systems)</li>

      <li><a href="http://jakarta.apache.org/velocity/">
      Velocity</a>
      (Java based template engine)</li>

      <li><a href="http://smarty.php.net/">smarty</a>
      (PHP template engine)</li>

      <li><a href="http://pnuts.org/wiki/index.pnut?name=TemplateEngines&amp;language=ja">
      Pnuts Wiki: TemplateEngines</a> (A summary of template engines in japanese.)</li>
      </ul>
      </body>
    </section>

    <section>
      <title>Topics</title>
      <body>
        <ul>
	<li><a href="http://www2.xml.gr.jp/log.html?MLID=xmlusers&amp;N=8303">
	[xml-users:8303]</a> (2003-05-09,japanese/utf8)</li>
	</ul>
      </body>
    </section>
  </body>
</document>
