Update README.md

Author: wanze

README.md

@@ -1,6 +1,6 @@
 TemplateEngineFactory
 =====================
-ProcessWire module helping to separate logic from markup. It turns ProcessWire templates into *controllers* which can interact over a new API variable with various template engines like Smarty or Twig. Any template engine can be added to the factory as separate module.
+ProcessWire module helping to separate logic from markup. It turns ProcessWire templates into "controllers" which can interact over a new API variable with various template engines like "Smarty" or "Twig". Any template engine can be added to the factory as separate module.
 
 ##Implemented engines
 * **ProcessWire** Default engine using the class *TemplateFile* of ProcessWire. This engine ships with this module.
@@ -10,19 +10,25 @@ ProcessWire module helping to separate logic from markup. It turns ProcessWire t
 ##Installation
 Install the module just like any other ProcessWire module. Check out the following guide: http://modules.processwire.com/install-uninstall/
 
+##Motivation
+The goal of this module is to implement the MVC pattern as simple as possible. The ProcessWire template files under /site/templates/ *can* act as controllers, containing pure logic. A controller delegates the output/markup to a corresponding template file. This delegation is abstracted by the module so that any template engine can be used by the developer.
+
 ##Configuration
-* **Template Engine** The template engine that is used to render your templates. Any installed engine is listed here. By default, you can choose *ProcessWire*, the engine that ships with this module. To use another engine like Smarty or Twig, download the module (see links above) and install it. Once installed, the engine is recognized and selectable here.
+* **Template Engine** The template engine that is used to render your templates. Any installed engine is listed here. By default, you can choose "ProcessWire", the engine that ships with this module. To use another engine like "Smarty" or "Twig", download the module (see links above) and install it. Once installed, the engine is recognized and selectable here.
 * **API variable** This is the variable you can use in the controllers (ProcessWire templates) to access the template of the current page.
 
-Any configurations related to the engines are set in the config options of the engine itself, e.g. *TemplateEngineProcesswire*.
+Any specific configurations related to the engines are set in the config options of the engine itself, e.g. "TemplateEngineProcesswire". Each engine has the following default config options available:
+* **Path to templates** Relative path from the site directory where template files are stored. E.g. "templates/views/" resolves to "/site/templates/views/"
+* **Template files suffix** File extension of template files
+* **Global template file** Filename of a template file that is used as main template behind the API variable
 
 ##How does it work?
-For each controller that should output markup a corresponding template file should exist (in the directory configured per engine). The convention is that the template file *must* have the same name as the controller (aka ProcessWire template):
+For each controller that is outputting markup, a corresponding template file should exist (in the template files directory configured per engine). The default convention is that the template file has the same name as the controller (aka ProcessWire template):
 
 * Template `/site/templates/views/home.php` corresponds to controller `/site/templates/home.php`
 * Template `/site/templates/views/product.php` corresponds to controller `/site/templates/product.php`
 
-The factory tries to load the template file of the current page's controller. If a template file is found, an instance of it is accessible over the API variable. If no template file is found, the factory assumes that the controller does not output markup over the template engine. In this case, the hook to modify the behaviour of Page::render() are not attached - everything works "normal".
+Depending on the setting "Global template file" of the activated engine, the factory tries to load the template file of the current page's controller or the global template file. If a template file is found, an instance of it is accessible over the API variable. If no template file is found, the factory assumes that the controller does not output markup over the template engine. In this case, the hook to modify the behaviour of Page::render() is not attached - everything works "normal".
 
 The following example uses the ProcessWire template engine:
 ```php
@@ -37,7 +43,7 @@ $view->set('foo', 'bar');
 $view->set('show_nav', true);
 $view->set('nav_pages', $pages->get('/')->children());
 ```
-In the example above, some logic is processed if a form was sent. Note that there is no markup generated, because this should now be done by the corresponding template file! Over the new API variable *$view*, key/value pairs are passed to the template. Here is an example how the template file could look like:
+In the example above, some logic is processed if a form was sent. Note that there is no markup generated, because this should now be done by the corresponding template file! Over the new API variable `$view`, key/value pairs are passed to the template. Here is an example how the template file could look like:
 ```php
 // In template file: /site/templates/view/home.php
 
@@ -52,7 +58,7 @@ In the example above, some logic is processed if a form was sent. Note that ther
   </ul>
 <?php endif; ?>
 ```
-Assume there is installed the module TemplateEngineSmarty and Smarty is chosen as the active template engine. The template file could look like this:
+Assume there is installed the module "TemplateEngineSmarty" and Smarty is chosen as the active template engine. The template file could look like this:
 ```php
 // In template file: /site/templates/smarty/home.tpl
 
@@ -67,10 +73,10 @@ Assume there is installed the module TemplateEngineSmarty and Smarty is chosen a
   </ul>
 {/if}
 ```
-The introduced API variable acts as a gateway to the active template engine. This means that the template engine can be switched at any time without the need to change the controller logic! In the previous example, the controller logic is still the same but the template engine was switched from ProcessWire to Smarty. 
+The introduced API variable acts as a gateway to the active template engine. This means that the template engine can be switched at any time without the need to change the controller logic. In the previous example, the controller logic is still the same but the template engine was switched from "ProcessWire" to "Smarty". 
 
 ### Load and output markup of other template files
-Use the TemplateEngineFactory module to load any template file and output it's markup:
+Use the "TemplateEngineFactory" module to load any template file and output it's markup:
 ```php
 // In controller file: /site/templates/product.php
 
@@ -81,12 +87,12 @@ $chunk->set('date', date('d.m.Y'));
 $chunk_output = $chunk->render();
 $view->set('chunk', $chunk_output);
 ```
-The example above loads a template file called *product_chunk.tpl* and sets some variables. Calling *render()* returns the rendered markup.
+The example above loads a template file called "product_chunk.tpl" and passes some variables. Calling "render()" returns the rendered markup of the template file.
 
 ## Important: Caching
 Since former ProcessWire templates are now controllers that generally do not output any markup, the ProcessWire template cache should *NOT* be active. Deactivate cache in the settings of your template under the section "Cache".
 
-It is possible for any template engine to support additional caching. At the moment only Smarty supports caching of it's own templates. In this case, the following methods are available for you (advanced usage):
+It is possible for any template engine to support additional caching. At the moment only "Smarty" supports caching of it's own templates. If caching is supported by the engine, the following methods are available for you (advanced usage):
 ```php
 // These methods are only available if the selected engine supports caching!!
 
@@ -104,7 +110,7 @@ $view->clearAllCache();
 If caching is supported by the engine, the TemplateEngineFactory module takes care of clearing the cache whenever pages are saved or deleted.
 
 # Implementing a template engine
-Implementing another template engine is straightforward. Please take a look at the implemented engines like Smarty or Twig to see some examples. Your engine needs to extend the abstract class TemplateEngine and implement some methods.
+Implementing another template engine is straightforward. Please take a look at the implemented engines like "Smarty" or "Twig" to see some examples. Your engine needs to extend the abstract class "TemplateEngine" and implement some methods.
 ```php
 class TemplateEngineMyEngine extends TemplateEngine implements Module, ConfigurableModule
 {
@@ -125,4 +131,4 @@ class TemplateEngineMyEngine extends TemplateEngine implements Module, Configura
   }
 }
 ```
-After installing TemplateEngineMyEngine module, the engine should be recognized by the TemplateEngineFactory and can be used to render the markup.
+After installing the "TemplateEngineMyEngine" module, the engine is recognized by the "TemplateEngineFactory" and can be used to render the markup.