== name ==

HTML-TEMPLATE

== category ==

Webprogramming

== author ==

Dr. Edmund Weitz (mailto(edi@agharta.de), mailto(edi@weitz.de))

== author-image ==

== short-description ==

HTML-TEMPLATE is a template language like Perl's href(HTML::Template,http://html-template.sf.net/).

== long-description ==

HTML-TEMPLATE is a portable library for Common Lisp which can be used
to fill templates with arbitrary (string) values at
runtime. (Actually, it doesn't matter whether the result is HTML. It's
just very likely that this will be what the library is mostly used
for.)

It is loosely modeled after the Perl module
href(HTML::Template,http://html-template.sf.net/) and compatible with
a subset of its syntax, i.e. it should be possible to use your
HTML-TEMPLATE templates with HTML::Template as well (but usually not
the other way around).

HTML-TEMPLATE translates templates into efficient closures which can
be re-used as often as needed. It uses an intelligent cache mechanism
so you can nevertheless update templates while your program is running
and have the changes take effect immediately.

== examples ==

This is how a template might look like:

  <table border=1>
    <!-- TMPL_LOOP rows -->
      <tr>
        <!-- TMPL_LOOP cols -->
          <!-- TMPL_IF colorful-style -->
            <td align="right" bgcolor="pink"><!-- TMPL_VAR content --></td>
          <!-- TMPL_ELSE -->
            <td align="right" ><!-- TMPL_VAR content --></td>
          <!-- /TMPL_IF -->
        <!-- /TMPL_LOOP -->
      </tr>
    <!-- /TMPL_LOOP -->
  </table>

And this could be the corresponding Lisp code:

  (let* ((rows (loop for i below 49 by 7
                     collect (list :cols
                                   (loop for j from i below (+ i 7)
                                         for string = (format nil "~R" j)
                                         collect (list :content string
                                                       :colorful-style (oddp j))))))
         (values (list :rows rows)))
    (fill-and-print-template #p"/tmp/foo.tmpl" values))

== instructions ==

Just load the file 'load.lisp' or use ASDF:

  (asdf:oos 'asdf:load-op :html-template)

== tutorial ==

Various examples can be found in the documentation.

== home-url ==

http://weitz.de/html-template/

== doc-url ==

http://weitz.de/html-template/

== license ==

HTML-TEMPLATE comes with a href(BSD license,http://www.opensource.org/licenses/bsd-license.php).

== book ==

== references ==

You can check out the Perl module href(HTML::Template,http://html-template.sf.net/) for more examples and motivation.

== source-fooball ==

Download the source code from
href(http://weitz.de/files/html-template.tgz,http://weitz.de/files/html-template.tgz)
or
href(ftp://ftp.franz.com/pub/lispwire/edi/html-template-0.1.2.tgz,ftp://ftp.franz.com/pub/lispwire/edi/html-template-0.1.2.tgz).
bold(NOTE: Edi's site might have a newer version.)

== release-date ==

2003-07-15

== release-version ==

0.1.2

== status ==

stable

== history ==

== acl-dependencies ==

== other-dependencies ==

== platform ==

== ad ==