Reformat documentation

docs/en/configuration.md

@@ -0,0 +1,73 @@
+Setup
+=====
+
+## Configure
+
+### Template cache
+
+```php
+$fenom->setCompileDir($dir);
+```
+
+This method set the name of the directory where template caches are stored. By default this is `/tmp`. This directory must be writeable.
+
+### Template settings
+
+```php
+// set options using factory
+$fenom = Fenom::factory($tpl_dir, $compile_dir, $options);
+// or inline using method setOptions
+$fenom->setOptions($options);
+```
+
+Options may by associative array like `'option_name' => true` or bitwise mask.
+
+| Option name            | Constant                  | Description  | Affect  |
+| ---------------------- | ------------------------- | ------------ | ------- |
+| *disable_methods*      | `Fenom::DENY_METHODS`     | disable calling methods of objects in templates.  | |
+| *disable_native_funcs* | `Fenom::DENY_NATIVE_FUNCS`| disable calling native function in templates, except allowed. | |
+| *auto_reload*          | `Fenom::AUTO_RELOAD`      | reload template if source will be changed | decreases performance |
+| *force_compile*        | `Fenom::FORCE_COMPILE`    | recompile template every time when the template renders | very decreases performance |
+| *disable_cache*        | `Fenom::DISABLE_CACHE`    | disable compile cache | greatly decreases performance |
+| *force_include*        | `Fenom::FORCE_INCLUDE`    | paste template body instead of include-tag | increases performance, increases cache size |
+| *auto_escape*          | `Fenom::AUTO_ESCAPE`      | html-escape each variables outputs | decreases performance |
+| *force_verify*         | `Fenom::FORCE_VERIFY`     | check existence every used variable | decreases performance |
+<!-- | *auto_trim*            | `Fenom::AUTO_TRIM`        | remove space-characters before and after tags | | -->
+| *disable_statics*      | `Fenom::DENY_STATICS`     | disable calling static methods in templates. | |
+| *strip*                | `Fenom::AUTO_STRIP`            | strip all whitespaces in templates. | decrease cache size |
+
+```php
+$fenom->setOptions(array(
+    "compile_check" => true,
+    "force_include" => true
+));
+// same
+$fenom->setOptions(Fenom::AUTO_RELOAD | Fenom::FORCE_INCLUDE);
+```
+
+**Note**
+By default all options disabled
+
+## Extends
+
+### Template providers
+
+Бывает так что шаблны не хранятся на файловой сиситеме, а хранятся в некотором хранилище, например, в базе данных MySQL.
+В этом случае шаблонизатору нужно описать как забирать шаблоны из хранилища, как проверять дату изменения шаблона и где хранить кеш шаблонов (опционально).
+Эту задачу берут на себя Providers, это объекты реальзующие интерфейс `Fenom\ProviderInterface`.
+
+### Callbacks and filters
+
+#### Before compile callback
+
+```php
+$fenom->addPreFilter(function () { /* ... */ });
+```
+
+#### Tag filter callback
+
+#### Filter callback
+
+#### After compile callback
+
+