/ 
YATT-Lite-0.0.6
/ README.md

YATT::Lite version 0.0_5

YATT is Yet Another Template Toolkit, aimed at Web Designers, rather than well-trained programmers. To achieve this goal, YATT provides more readable syntax for HTML/XML savvy designers, lint for static syntax checking and many safer default behaviors, ie. automatic output escaping based on argument type declaration and config file naming convention which helps access protection.

YATT::Lite is template-syntax-compatible, lightweight, full rewrite of YATT with superior functionalities.

INSTALLATION

It's all pure Perl, so it's ok to put the .pm files (or git repo itself) in their appropriate perl @INC path. (But see NON-STANDARD DIRECTORY STRUCTURE)

The easiest way to use this distribution in your project is:

git clone git://github.com/hkoba/yatt_lite.git lib/YATT

# or If your project is managed in git, clone as submodule like this:

git submodule add git://github.com/hkoba/yatt_lite.git lib/YATT
git submodule init
git submodule update

To create a yatt-enabled webapp, just copy sample app.psgi and run plackup:

cp lib/YATT/samples/app.psgi .
mkdir html
plackup

Now you are ready to write your first yatt app. Open your favorite editor and create F<html/index.yatt> like this:

<!yatt:args x y>
<h2>Hello &yatt:x; world!</h2>
&yatt:y;

Then try to access:

 http://0:5000/
 http://0:5000/?x=foo
 http://0:5000/?x=foo&y=bar

DOCUMENTS

Basic documents are placed under YATT/Lite/docs. You can read them via: http://ylpodview-hkoba.dotcloud.com/ (But for now, most pods are not yet finished and written only in Japanese.)

Also, you can run ylpodview (document viewer) locally like:

cd lib
plackup YATT/samples/ylpodview/approot/app.psgi

and try to access http://0:5000/

NON-STANDARD DIRECTORY STRUCTURE

Unfortunately, YATT::Lite distribution doesn't conform normal CPAN style structure. This is experimental, but intentional. Because:

  1. Engine(modules) and support scripts should be directly bundled together. To achieve this, scripts/* and elisp/* is placed in YATT/.

  2. Since YATT::Lite is still evolving, single (system-wide) installation may not fit for multi-service site. To isolate instability risk, individual service should have its own installation of engine. To achieve this, runyatt.cgi uses runyatt.lib first.

SUPPORT AND DOCUMENTATION

You can also look for Source Code Repository at:

    https://github.com/hkoba/yatt_lite
    git://github.com/hkoba/yatt_lite.git

Copyright (C) 2007..2013 "KOBAYASI, Hiroaki"

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.