+{{ matched pairs of curly brackets (ie, braces) }}
+
+
+* Tag markup (which cannot resolve to text) is surrounded by
+
+
+{% matched pairs of curly brackets and percent signs %}
+
+
+h1. Output
+
+Here is a simple example of Output:
+
+
+Hello {{name}}
+Hello {{user.name}}
+Hello {{ 'tobi' }}
+
+
+
+
+h2. Advanced output: Filters
+
+Output markup takes filters.
+Filters are simple methods.
+The first parameter is always the output of the left side of the filter.
+The return value of the filter will be the new left value when the next filter is run.
+When there are no more filters, the template will receive the resulting string.
+
+
+Hello {{ 'tobi' | upcase }}
+Hello tobi has {{ 'tobi' | size }} letters!
+Hello {{ '*tobi*' | textilize | upcase }}
+Hello {{ 'now' | date: "%Y %h" }}
+
+
+h3. Standard Filters
+
+* **date** - reformat a date ("syntax reference":http://liquid.rubyforge.org/classes/Liquid/StandardFilters.html#M000012)
+* **capitalize** - capitalize words in the input sentence
+* **downcase** - convert an input string to lowercase
+* **upcase** - convert an input string to uppercase
+* **first** - get the first element of the passed in array
+* **last** - get the last element of the passed in array
+* **join** - join elements of the array with certain character between them
+* **sort** - sort elements of the array
+* **map** - map/collect an array on a given property
+* **size** - return the size of an array or string
+* **escape** - escape a string
+* **escape_once** - returns an escaped version of html without affecting existing escaped entities
+* **strip_html** - strip html from string
+* **strip_newlines** - strip all newlines (\n) from string
+* **newline_to_br** - replace each newline (\n) with html break
+* **replace** - replace each occurrence **e.g.** {{ 'foofoo' | replace:'foo','bar' }} #=> 'barbar'
+* **replace_first** - replace the first occurrence **e.g.** {{ 'barbar' | replace_first:'bar','foo' }} #=> 'foobar'
+* **remove** - remove each occurrence **e.g.** {{ 'foobarfoobar' | remove:'foo' }} #=> 'barbar'
+* **remove_first** - remove the first occurrence **e.g.** {{ 'barbar' | remove_first:'bar' }} #=> 'bar'
+* **truncate** - truncate a string down to x characters
+* **truncatewords** - truncate a string down to x words
+* **prepend** - prepend a string **e.g.** {{ 'bar' | prepend:'foo' }} #=> 'foobar'
+* **append** - append a string **e.g.** {{ 'foo' | append:'bar' }} #=> 'foobar'
+* **minus** - subtraction **e.g** {{ 4 | minus:2 }} #=> 2
+* **plus** - addition **e.g** {{ '1' | plus:'1' }} #=> '11', {{ 1 | plus:1 }} #=> 2
+* **times** - multiplication **e.g** {{ 5 | times:4 }} #=> 20
+* **divided_by** - division **e.g** {{ 10 | divided_by:2 }} #=> 5
+* **split** - split a string on a matching pattern **e.g.** {{ "a~b" | split:~ }} #=> ['a','b']
+
+h1. Tags
+
+Tags are used for the logic in your template.
+New tags are very easy to code, so I hope to get many contributions to the standard tag library after releasing this code.
+
+Here is a list of currently supported tags:
+
+* **assign** - Assgins some value to a variable
+* **capture** - Block tag that captures text into a variable
+* **case** - Block tag, its the standard case...when block
+* **comment** - Block tag, comments out the text in the block
+* **cycle** - Cycle is usually used within a loop to alternate between values, like colors or DOM classes.
+* **for** - For loop
+* **if** - Standard if/else block
+* **include** - Includes another template, useful for partials
+* **unless** - Mirror of if statement
+
+h2. Comments
+
+Comment is the simplest tag.
+It just swallows content.
+
+
+We made 1 million dollars {% comment %} in losses {% endcomment %} this year
+
+
+h2. If / Else
+
+@if / else@ should be well known from any imaginable programming language.
+Liquid allows you to write simple expressions in the @if@ or @unless@ (and optionally, @elsif@ and @else@) clause:
+
+
+{% if user %}
+ Hello {{ user.name }}
+{% endif %}
+
+{% if user.name == 'tobi' %}
+ Hello tobi
+{% elsif user.name == 'bob' %}
+ Hello bob
+{% endif %}
+
+{% if user.name == 'tobi' or user.name == 'bob' %}
+ Hello tobi or bob
+{% endif %}
+
+{% if user.name == 'bob' and user.age > 45 %}
+ Hello old bob
+{% endif %}
+
+{% if user.name != 'tobi' %}
+ Hello non-tobi
+{% endif %}
+
+# Same as above
+{% unless user.name == 'tobi' %}
+ Hello non-tobi
+{% endunless %}
+
+# Check if the user has a credit card
+{% if user.creditcard != null %}
+ poor sob
+{% endif %}
+
+# Same as above
+{% if user.creditcard %}
+ poor sob
+{% endif %}
+
+# Check for an empty array
+{% if user.payments == empty %}
+ you never paid !
+{% endif %}
+
+{% if user.age > 18 %}
+ Login here
+{% else %}
+ Sorry, you are too young
+{% endif %}
+
+# array = 1,2,3
+{% if array contains 2 %}
+ array includes 2
+{% endif %}
+
+# string = 'hello world'
+{% if string contains 'hello' %}
+ string includes 'hello'
+{% endif %}
+
+
+h2. Case Statement
+
+If you need more conditions, you can use the @case@ statement:
+
+
+{% case condition %}
+{% when 1 %}
+hit 1
+{% when 2 or 3 %}
+hit 2 or 3
+{% else %}
+... else ...
+{% endcase %}
+
+
+*Example:*
+
+
+{% case template %}
+
+{% when 'label' %}
+ // {{ label.title }}
+{% when 'product' %}
+ // {{ product.vendor | link_to_vendor }} / {{ product.title }}
+{% else %}
+ // {{page_title}}
+{% endcase %}
+
+
+h2. Cycle
+
+Often you have to alternate between different colors or similar tasks.
+Liquid has built-in support for such operations, using the @cycle@ tag.
+
+
+{% cycle 'one', 'two', 'three' %}
+{% cycle 'one', 'two', 'three' %}
+{% cycle 'one', 'two', 'three' %}
+{% cycle 'one', 'two', 'three' %}
+
+will result in
+
+one
+two
+three
+one
+
+
+If no name is supplied for the cycle group,
+then it's assumed that multiple calls with the same parameters are one group.
+
+If you want to have total control over cycle groups, you can optionally specify the name of the group.
+This can even be a variable.
+
+
+
+{% cycle 'group 1': 'one', 'two', 'three' %}
+{% cycle 'group 1': 'one', 'two', 'three' %}
+{% cycle 'group 2': 'one', 'two', 'three' %}
+{% cycle 'group 2': 'one', 'two', 'three' %}
+
+will result in
+
+one
+two
+one
+two
+
+
+h2. For loops
+
+Liquid allows @for@ loops over collections:
+
+
+{% for item in array %}
+ {{ item }}
+{% endfor %}
+
+
+During every @for@ loop, the following helper variables are available for extra styling needs:
+
++forloop.length # => length of the entire for loop +forloop.index # => index of the current iteration +forloop.index0 # => index of the current iteration (zero based) +forloop.rindex # => how many items are still left? +forloop.rindex0 # => how many items are still left? (zero based) +forloop.first # => is this the first iteration? +forloop.last # => is this the last iternation? ++ +There are several attributes you can use to influence which items you receive in your loop + +*limit:int* lets you restrict how many items you get. +*offset:int* lets you start the collection with the nth item. + +
+# array = [1,2,3,4,5,6]
+{% for item in array limit:2 offset:2 %}
+ {{ item }}
+{% endfor %}
+# results in 3,4
+
+
+Reversing the loop
+
+
+{% for item in collection reversed %} {{item}} {% endfor %}
+
+
+Instead of looping over an existing collection, you can define a range of numbers to loop through.
+The range can be defined by both literal and variable numbers:
+
+
+# if item.quantity is 4...
+{% for i in (1..item.quantity) %}
+ {{ i }}
+{% endfor %}
+# results in 1,2,3,4
+
+
+h2. Variable Assignment
+
+You can store data in your own variables, to be used in output or other tags as desired.
+The simplest way to create a variable is with the @assign@ tag, which has a pretty straightforward syntax:
+
+
+{% assign name = 'freestyle' %}
+
+{% for t in collections.tags %}{% if t == name %}
+ Freestyle!
+{% endif %}{% endfor %}
+
+
+Another way of doing this would be to assign @true / false@ values to the variable:
+
+
+{% assign freestyle = false %}
+
+{% for t in collections.tags %}{% if t == 'freestyle' %}
+ {% assign freestyle = true %}
+{% endif %}{% endfor %}
+
+{% if freestyle %}
+ Freestyle!
+{% endif %}
+
+
+If you want to combine a number of strings into a single string and save it to a variable, you can do that with the @capture@ tag. This tag is a block which "captures" whatever is rendered inside it, then assigns the captured value to the given variable instead of rendering it to the screen.
+
+
+ {% capture attribute_name %}{{ item.title | handleize }}-{{ i }}-color{% endcapture %}
+
+
+
+
\ No newline at end of file