== name ==

TBNL

== category ==

Webprogramming

== author ==

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

== author-image ==

== short-description ==

TBNL is a toolkit for dynamic websites.

== long-description ==

TBNL is a toolkit for building dynamic websites with Common Lisp. It
employs the popular href(Apache,http://httpd.apache.org/) web server
for the actual http communication between the server and the browser
and it uses Marc Battyani's
href(mod_lisp,http://www.fractalconcept.com/asp/html/mod_lisp.html)
for the communication between Apache and the Lisp image.

TBNL provides facilities like automatic session handling (with and
without cookies), logging to Apache's log files, customizable error
handling, and easy access to GET and POST parameters sent by the
client. It does not include functionality to programmatically generate
HTML output. For this task you can use any library you like,
e.g. (shameless self-plug) href(CL-WHO,http://weitz.de/cl-who/) or
href(HTML-TEMPLATE,http://weitz.de/html-template/).

TBNL talks with Apache over a socket and uses Kevin Rosenberg's
href(KMRCL,http://www.cliki.net/kmrcl) library for this task.

== examples ==

TBNL comes with an example website which demonstrates most of its
features - see the 'test' subdirectory.

== instructions ==

* Install href(Apache,http://httpd.apache.org/), either version 1.3 or version 2.
* Install the corresponding version of href(mod_lisp,http://www.fractalconcept.com/asp/html/mod_lisp.html).
* Install the Lisp libraries href(MD5,http://www.cliki.net/md5), href(KMRCL,http://www.cliki.net/kmrcl), href(CL-BASE64,http://www.cliki.net/cl-base64), href(CL-PPCRE,http://weitz.de/cl-ppcre/), and href(URL-REWRITE,http://weitz.de/url-rewrite/).
* Compile and load TBNL with ASDF:

  (asdf:oos 'asdf:load-op :tbnl)

== tutorial ==

Examples can be found in the 'test' subdirectory of the TBNL distribution.

== home-url ==

http://weitz.de/tbnl/

== doc-url ==

http://weitz.de/tbnl/

== license ==

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

== book ==

== references ==

== source-fooball ==

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

== release-date ==

2004-12-31

== release-version ==

0.3.9

== status ==

stable

== history ==

== acl-dependencies ==

== other-dependencies ==

TBNL depends on href(the Apache webserver,http://httpd.apache.org/),
the
href(mod_lisp,http://www.fractalconcept.com/asp/html/mod_lisp.html)
Apache module, and the Lisp libraries
href(MD5,http://www.cliki.net/md5),
href(KMRCL,http://www.cliki.net/kmrcl),
href(CL-BASE64,http://www.cliki.net/cl-base64),
href(CL-PPCRE,/entry-regexp-cl-ppcre-des),
and
href(URL-REWRITE,/entry-webprog-url-rewrite-des).

== platform ==

TBNL works on Linux, Mac OS X, and probably on other Unix-like platforms. It also works on Windows - see the documentation for specific notes about Win32.

== ad ==