Filters

{{ <url> | auto_discovey_link_tag: <options> }}

{{ '/projects/atom' | auto_discovery_link_tag: 'rel:alternate', 'type:application/atom+xml', 'title:A title' }}

<link rel="alternate" type="application/atom+xml" title="A title" href="/projects/atom" />

{{ <string> | concat: <array of strings> }}

{{ 'hello' | concat: 'world', 'yeah' }}

helloworldyeah

{{ <string> | dasherize }}

{{ 'hello_world' | dasherize }}

hello-world

{{ <object> | default: <value> }}

{{ params.author | default: 'John Doe' }}

John Doe

{{ <paginate object> | default_pagination: <options> }}

{{ paginate | default_pagination: next: 'Next entries', previous: 'Previous entries' }}

{{ <date> | distance_of_time_in_words: <date_or_string> }}

{{ "2013/04/05" | distance_of_time_in_words:  "2007/06/29" }}
{{ "1776-07-04" | distance_of_time_in_words: "1789-07-14" }}
{{ "20/01/2013" | distance_of_time_in_words: "01/05/2014" }}
{{ "May 1, 2010" | distance_of_time_in_words: "June 5, 2010" }}

almost 6 years
about 13 years
over 1 year
about 1 month

en:
  datetime:
    distance_in_words:
      about_x_hours:
        one: about 1 hour
        other: about %{count} hours
      about_x_months:
        one: about 1 month
        other: about %{count} months
      about_x_years:
        one: about 1 year
        other: about %{count} years
      almost_x_years:
        one: almost 1 year
        other: almost %{count} years
      half_a_minute: half a minute
      less_than_x_minutes:
        one: less than a minute
        other: less than %{count} minutes
      less_than_x_seconds:
        one: less than 1 second
        other: less than %{count} seconds
      over_x_years:
        one: over 1 year
        other: over %{count} years
      x_days:
        one: 1 day
        other: ! '%{count} days'
      x_minutes:
        one: 1 minute
        other: ! '%{count} minutes'
      x_months:
        one: 1 month
        other: ! '%{count} months'
      x_seconds:
        one: 1 second
        other: ! '%{count} seconds'

{{ <URI> | encode }}

{{ "http:://www.example.com?key=hello world" | encode }}

http%3A%3A%2F%2Fwww.example.com%3Fkey%3Dhello+world

{{ <string_or_array_or_collection> | first }}

{{ [42, 0] | first }}
{{ 'Hello World' | first }}

42
H

{{ <url> | flash_tag: <options> }}

{{ 'http://youtube.com?...' | flash_tag: width: '100px', height: '50px' }}

{{ <date> | format_date: <locale> }}

{{ <url> | image_tag: <options> }}

{{ 'http://placehold.it/350x150' | image_tag: 'alt:hello world' }}
outputs

<img src="http://placehold.it/350x150" alt="hello world" />

{{ <path_to_a_theme_asset_or_url> | javascript_tag }}

{{ 'application.js' | javascript_tag }}

<script src="/sites/<site_id>javascripts/application.js" type="text/javascript"></script>

{{ <path_to_a_theme_asset> | javascript_url }}

{{ 'application.js' | javascript_url }}

/sites/<site_id>/theme/javascripts/application.js

{{ <string_or_array_or_collection> | last }}

{{ [42, 0] | last }}
{{ 'Hello World' | last }}

0
d

{{ <date> | localized_date: <format>(, <locale>) }}

{{ today | localized_date: '%d %B' }}
{{ today | localized_date: '%d %B', 'fr' }}

01 September
01 septembre

{{ <markdown_code> | markdown }}

{{ '# Header' | markdown }}

<h1>Header</h1>

{{ product.price | money }}

{{ product.price | money: unit: "€", format: "%n %u" }}

{{ <string> | multi_line }}

{{ "hello\nworld" | multi_line }}

hello<br/>world

{{ '2015-09-26' | parse_date }}

{{ '2015-09-26 10:42pm' | parse_date_time }}

{{ <max_integer> | random }}

{{ 10 | random }}

4

{{ <string> | resize: <resize_string>(, options) }}

{{ project.screenshot | resize: '100x100' }}
{{ 'http://example.com/images/banner.png' | resize: '300x50#' }}
{{ 'http://example.com/images/banner.png' | resize: '300x50#', optimize: 50 }}

{% assign products = ['Product 1', 'Product 2', 'Product 3'] %}
{% assign random_products = products | shuffle %}

{% comment %}Take 5 random products{% endcomment %}
{% assign random_products = contents.products.all | shuffle | slice: 0, 5 %}

{{ <string> | str_modulo: <index>, <modulo> }}

{{ 'odd' | str_modulo: 1, 2 }}

odd

{{ <path_to_a_theme_asset_or_url> | stylesheet_tag(: <media>) }}

{{ 'application.css' | stylesheet_tag }}

<link href="/sites/<site_id>/theme/stylesheets/application.css" media="screen" rel="stylesheet" type="text/css" />

{{ <path_to_a_theme_asset> | stylesheet_url(: <media>) }}

{{ 'application.css' | stylesheet_url }}

"/sites/<site_id>/theme/stylesheets/application.css"

{{ <string> | textile }}

{{ 'h3. Header' | textile }}

<h3>Header</h3>

{{ <path_to_a_theme_image> | theme_image_tag(: <options>) }}

{{ 'banner.png' | theme_image_tag: 'alt:hello world' }}

<img src="/sites/<site_id>/theme/images/banner.png" alt="hello world" />

{{ <path_to_a_theme_image> | theme_image_url }}

{{ 'banner.png' | theme_image_url }}

/sites/<site_id >/theme/images/banner.png

{{ <string> | translate(: <options>) }}

{{ 'hello_world' | translate }}
{{ 'hello_world' | translate: locale: 'fr' }}

post_count_zero: 
  en: "{{ name }} has no posts"
  fr: "{{ name }} n'a aucun artucle"
post_count_one: 
  en: "{{ name }} has one post"
  fr: "{{ name }} a un seul article"
post_count_two:
  en: "{{ name }} has two posts"
  fr: "{{ name }} a deux articles"
post_count_other: 
  en: "{{ name }} has {{ count }} posts"
  fr: "{{ name }} a {{ count }} articles"

{{ 'post_count' | translate: count: posts.count, name: 'John' }}

{{ <string> | underscore }}

{{ 'FooBar' | underscore }}

foo_bar