summaryrefslogtreecommitdiff
path: root/README.markdown
blob: ec1379f625d329aa83d084ceb3f0c827e4b88829 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
STE Template Engine
===================

The STE Template Engine (STE) is a template engine for the PHP programming
language.

Get it via composer / packagist
-------------------------------

[Composer](https://getcomposer.org) is a dependency manager and package manager for PHP. Using composer is the recommended way of installing STE.

Just put `kch42/ste` in your requirements (I suggest using the version `1.*`) and execute `composer install`. Then include composer's autoloader and you can simply use all stuff in the `\kch42\ste` namespace without further `require`s or `include`s. Awesome!


Requirements
------------

PHP >= 5.3

Why should you use it?
----------------------

* It's syntax (inspired by Textpattern's template syntax) is very easy and
  similar to the syntax of (X)HTML. So it should be easy for designers to learn
  this system.
* It has a simple, yet powerful plugin interface. You can easily define your
  own template functions / tags. It is even possible to write them in the
  template language itself, which makes it kind of a programming language...
* It can transcompile templates into PHP.
* You can use anonymous functions to define custom tags.

Documentation
-------------

The `docu` directory contains the documentation of the template language.
If you need the documentation of the php code / the API, you can create it with the `mkdocu.sh` script.
You will need [NaturalDocs](http://www.naturaldocs.org/) for that.

There is also a mirror of the documentation [here](http://r7r.kch42.net/ste_docu/).