latte: info about whitespace

Author: dg

latte/cs/syntax.texy

@@ -218,6 +218,39 @@ Uvnitř značek fungují PHP komentáře:
 ```
 
 
+Řízení bílých znaků
+====================
+
+Latte zachází s bílými znaky inteligentně. Kód můžete volně odsazovat pro čitelnost a výstup zůstane čistý. Když se tag objeví na řádku sám, celý řádek (odsazení i konec řádku) se z výstupu odstraní:
+
+```latte
+<ul>
+	{foreach $items as $item}
+	<li>{$item}</li>
+	{/foreach}
+</ul>
+```
+
+Vypíše:
+
+```html
+<ul>
+	<li>foo</li>
+	<li>bar</li>
+</ul>
+```
+
+Navíc bílé znaky před tagem na řádku s obsahem logicky patří *dovnitř* tagu:
+
+```latte
+<div>
+	{if $foo}hello{/if}
+</div>
+```
+
+Chová se to, jako by odsazení bylo uvnitř `{if}`: pokud je `$foo` false, nevypíše se nic, ani odsazení, ani prázdný řádek. Pokud je true, výstup přirozeně obsahuje odsazení. Prostě pište přehledně odsazené šablony a výstup bude vždy čistý.
+
+
 Syntaktický cukr
 ================
 

latte/en/syntax.texy

@@ -218,6 +218,39 @@ PHP comments work inside tags:
 ```
 
 
+Whitespace Control
+==================
+
+Latte handles whitespace intelligently. You can freely indent your code for readability, and the output stays clean. When a tag appears alone on a line, the entire line (indentation and newline) is removed from the output:
+
+```latte
+<ul>
+	{foreach $items as $item}
+	<li>{$item}</li>
+	{/foreach}
+</ul>
+```
+
+Outputs:
+
+```html
+<ul>
+	<li>foo</li>
+	<li>bar</li>
+</ul>
+```
+
+Furthermore, whitespace before a tag on a line with content logically belongs *inside* the tag:
+
+```latte
+<div>
+	{if $foo}hello{/if}
+</div>
+```
+
+This behaves as if the indentation were inside `{if}`: when `$foo` is false, nothing is output, not even the indentation or a blank line. When true, the output naturally includes the indentation. You simply write well-structured templates and the output is always clean.
+
+
 Syntactic Sugar
 ===============