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>
+```
+
+A co když tag není na řádku sám, ale je tam i další obsah? Bílé znaky před tagem pak patří *dovnitř* tagu:
+
+```latte
+<div>
+	{if $foo}hello{/if}
+</div>
+```
+
+Odsazení je tedy fakticky uvnitř `{if}`: pokud je `$foo` false, nevypíše se nic – ani odsazení, ani prázdný řádek. Pokud je `$foo` 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>
+```
+
+What if a tag isn't alone on a line, but appears alongside other content? The whitespace before the tag then belongs *inside* the tag:
+
+```latte
+<div>
+	{if $foo}hello{/if}
+</div>
+```
+
+The indentation is effectively inside `{if}`: when `$foo` is false, nothing is output – not even the indentation or a blank line. When `$foo` is true, the output naturally includes the indentation. You simply write well-structured templates and the output is always clean.
+
+
 Syntactic Sugar
 ===============