summaryrefslogtreecommitdiff
path: root/README.markdown
blob: 5cbd9767f1d3122492f920a792f55dd80afb1f9b (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 `r7r/ste` in your requirements (I suggest using the version `2.*`) and execute `composer install`. Then include composer's autoloader and you can simply use all stuff in the `\r7r\ste` namespace without further `require`s or `include`s. Awesome!


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

PHP >= 7.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 compile 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.
This is done using [phpDocumentor](https://phpdoc.org/). It will be installed as a dev-depencency by composer.

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