********************************************************************************
* What you need
********************************************************************************

To use the Temply template parser, you only need to add the following
files to your project (if you already have one):
- ITagHandler.class.php
- EmptyTagHandler.class.php
- Temply.class.php 

Make sure all classes are loaded when running your scripts! The loading
order should be the same as in the listing above.


********************************************************************************
* Define your own tags to be used within the templates
********************************************************************************

With Temply, you need to write your own tag handler(s) to define any tags.
All you need to do is to create a class implementing the interface ITagHandler,
and have Temply use this class as its handler.
Have a look at the examples to see how it works.


********************************************************************************
* The tag syntax
********************************************************************************

The syntax for a single tag is 
[ tagname : attrname = attrvalue ... / ]

The syntax for a block tag is 
[ tagname : attrname = attrvalue ... ] block content [ /tagname ]

You can specify as many attributes as you want! Also, tags don't need to be
limited to just one line. You can, for example, write all tag attributes
in a row for better readability. Here is an example how this might look like:

[ myTag : firstAttribute  = "Hello World"
          secondAttribute = "This is great"
          thirdAttribute  = "Isn't it?" /]

If you don't want to specify any attributes, you don't have to. You can as well
use tags like this:

[ myTag /]

The parser can also handle nested tags like

[ firstTag ] [ anotherTag /] [ /firstTag ]


********************************************************************************
* Contact
********************************************************************************

If you have any questions or ideas for improvement, don't hesitate
on contacting me! Either drop me an e-mail, or leave a comment on my website!

Mail:
mail@oliver-matuschin.de

Website:
http://www.oliver-matuschin.de