Liquid Filters Reference for DocOps Lab Projects

{{ "2008-11-07 1:07:54pm" | date_to_xmlschema }}

2008-11-07T13:07:54-08:00

{{ data.time | date_to_rfc822 }}

Fri, 07 Nov 2008 13:07:54 -0800

{{ data.time | date_to_string }}

07 Nov 2008

{{ data.time | date_to_string: "ordinal", "US" }}

Nov 7th, 2008

{{ data.time | date_to_long_string }}

07 November 2008

{{ data.time | date_to_long_string: "ordinal" }}

7th November 2008

{% assign filtered = data.users | where:"level", 2 %}
{{ filtered | size }}

1

{% assign member = data.users | where:"user","alice" %}
{{ member[0] | jsonify }}

{"user":"alice","level":1}

{{ data.members | where_exp:"item",
"item.grad_year == 2014" | jsonify }}

[{"user":"andie","grad_year":2014,"projects":["fooman","barbaz"]},{"user":"lonnie","grad_year":2014,"projects":["fooman"]}]

{{ data.members | where_exp:"item",
"item.grad_year < 2014" | jsonify }}

[{"user":"cindy","grad_year":2012,"projects":["fooman","foobar"]}]

{{ data.members | where_exp:"item",
"item.projects contains 'barbaz'" | jsonify }}

[{"user":"andie","grad_year":2014,"projects":["fooman","barbaz"]}]

{% assign grouped = data.members | group_by:"grad_year" | first %}
{{ grouped.name }}

2014

{{ data.members | group_by_exp: "item", "item.grad_year" | map: "name" | join: "," }}

2014,2012

{{ "<strong>some text</strong>" | xml_escape }}

<strong>some text</strong>

{{ "foo, bar; baz?" | cgi_escape }}

foo%2C+bar%3B+baz%3F

{{ "http://foo.com/?q=foo, \bar?" | uri_escape }}

http://foo.com/?q=foo,%20%5Cbar?

{{ page.content | number_of_words }}

3

{{ tags_array | array_to_sentence_string }}

foo, bar, and baz

{{ tags_array | array_to_sentence_string: "or" }}

foo, bar, or baz

{{ tags_array | jsonify }}

["foo","bar","baz"]

{{ "a    b" | normalize_whitespace }}

a b

{{ page.tags | sort | inspect }}

["Seattle", "Spokane", "Tacoma"]

{{ site.posts | sort: "author" }}

{{ site.pages | sort: "title", "last" }}

{{ site.pages | sample }}

{{ site.pages | sample: 2 }}

{{ true | to_integer }}

1

{% assign five = "5" | to_integer %}
{% if five == 5 %}Samesies!{% endif %}

Samesies!

{{ "five" | to_integer }}

0

{{ page.tags | push: "Spokane" | inspect }}

["Seattle", "Tacoma", "Spokane", "Spokane"]

{{ page.tags | pop | inspect }}

["Seattle", "Tacoma"]

{{ page.tags | shift | inspect }}

["Tacoma", "Spokane"]

{{ page.tags | unshift: "Olympia" | inspect }}

["Olympia", "Seattle", "Tacoma", "Spokane"]

{{ "test-path" | relative_url }}

/docs/test-path

{{ "test-path" | absolute_url }}

https://example.com/docs/test-path

{{ "Test with **bold** and a [link](https://example.com)." | markdownify }}

<p>Test with <strong>bold</strong> and a <a href="https://example.com">link</a>.</p>

{{ 'He said, "Hello!"' | smartify }}

He said, “Hello!”

{{ sass_text | sassify }}

body {
  color: red;
}

{{ scss_text | scssify }}

body {
  color: red;
}

{{ "The _config.yml file" | slugify }}

the-config-yml-file

{{ "The _config.yml file" | slugify: "_" }}

the_config_yml_file

{{ tags_array | inspect }}

["foo", "bar", "baz"]

{{ tags_array | inspect: "yaml" }}

---
- foo
- bar
- baz

{{ tags_array | inspect: "json" }}

["foo","bar","baz"]

{{ data.members | sum: "grad_year" }}

6040

{{ "Ground control to Major Tom." | remove_last: "o" }}

Ground control to Major Tm.

{{ "Ground control to Major Tom." | replace_last: "o", "0" }}

Ground control to Major T0m.

{{ "  A string that   is obviously  longer than 25 characters  " | squish }}

A string that is obviously longer than 25 characters

{{ "A string that is obviously longer than 25 characters" | wrap: 25 }}

A string that is
obviously longer than 25
characters

{{ comment_text | commentwrap: 25, "// " }}

// A string that is
// obviously longer than 25
// characters

{{ comment_text | commentwrap: 25, "xml" }}

<!-- A string that is
obviously longer than 25
characters -->

{{ comment_text | commentwrap: 25, "/*|*/" }}

/* A string that is
obviously longer than 25
characters
*/

{{ my_flat_hash | to_cli_args }}

--key1 valuu_one --key2 val_two --key3 third value

{{ my_flat_hash | to_cli_args: "long_equals" }}

--key1=valuu_one --key2=val_two --key3=third value

{{ cli_flags_hash | to_cli_args: "short_space" }}

-k valuu_one -v val_two -o third value

{{ my_flat_hash | to_cli_args: "positional" }}

valuu_one val_two third value

{{ my_flat_hash | to_cli_args: "env_arg" }}

KEY1=valuu_one KEY2=val_two KEY3=third value

{{ my_flat_hash | to_cli_args: "keyval" }}

key1=valuu_one key2=val_two key3=third value

{{ my_flat_hash | to_yaml }}

---
key1: valuu_one
key2: val_two
key3: third value

{{ my_flat_hash | to_yaml: "flow" }}

{key1: "valuu_one", key2: "val_two", key3: "third value"}

{{ page.tags | to_yaml }}

---
- Seattle
- Tacoma
- Spokane

{{ page.tags | to_yaml: "flow" }}

["Seattle", "Tacoma", "Spokane"]

{{ page.tags | to_yaml: "flow", "quotes" }}

["Seattle", "Tacoma", "Spokane"]

{{ my_flat_hash | to_json }}

{"key1":"valuu_one","key2":"val_two","key3":"third value"}

{{ page.tags | to_json }}

["Seattle","Tacoma","Spokane"]

{{ odd_keys_hash | to_json }}

{"key 1":"valuu_one","$key2":"val_two","key:3":"third value"}

{{ "hello world" | replace_regex: "world", "there" }}

hello there

{{ "one,two,three" | replace_regex: ",", "-" }}

one-two-three

{% assign matched = "testword" | match: "^.*word$" %}
{% if matched %}It matched!{% endif %}

It matched!

{{ liquidy_text | holds_liquid }}

true

{{ "This is just text." | holds_liquid }}

false

{{ data.metastore | store_list_concat: "children" | jsonify }}

["child1","child2","child3","child4","child5","child6"]

{{ data.metastore | store_list_dupes: "children" | jsonify }}

["child1"]

{{ -17 | abs }}

17

{{ "-19.86" | abs }}

19.86

{{ "/my/fancy/url" | append: ".html" }}

/my/fancy/url.html

{{ 4 | at_least: 5 }}

5

{{ 4 | at_least: 3 }}

4

{{ 4 | at_most: 5 }}

4

{{ 4 | at_most: 3 }}

3

{{ "my GREAT title" | capitalize }}

My great title

{{ 1.2 | ceil }}

2

{% assign compacted = mixed_array | compact %}
{{ compacted | join: "," }}

a,b,c

{% assign fruits = "apples, oranges" | split: ", " %}
{% assign veggies = "carrots, turnips" | split: ", " %}
{{ fruits | concat: veggies | join: "," }}

apples,oranges,carrots,turnips

{{ data.time | date: "%Y-%m-%d" }}

2008-11-07

{{ nonexistent_var | default: "fallback" }}

fallback

{{ 16 | divided_by: 4 }}

4

{{ 20 | divided_by: 7 }}

2

{{ 20 | divided_by: 7.0 }}

2.857142857142857

{{ "Parker Moore" | downcase }}

parker moore

{{ "Have you read 'James & the Giant Peach'?" | escape }}

Have you read 'James & the Giant Peach'?

{{ "1 < 2 & 3" | escape_once }}

1 < 2 & 3

{{ "1 < 2 & 3" | escape_once }}

1 < 2 & 3

{{ "Ground control to Major Tom." | split: " " | first }}

Ground

{{ 1.2 | floor }}

1

{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{{ beatles | join: " and " }}

John and Paul and George and Ringo

{{ "Ground control to Major Tom." | split: " " | last }}

Tom.

{{ "   So much room   " | lstrip }}!

So much room   !

{{ data.members | map: "user" | join: "," }}

andie,lonnie,cindy

{{ 4 | minus: 2 }}

2

{{ 16 | minus: 4 }}

12

{{ 3 | modulo: 2 }}

1

{{ 24 | modulo: 7 }}

3

{% capture s %}Hello
there{% endcapture %}{{ s | newline_to_br }}

Hello<br />
there

{{ 4 | plus: 2 }}

6

{{ "apples, oranges, and bananas" | prepend: "Some fruit: " }}

Some fruit: apples, oranges, and bananas

{{ "I strained to see the train through the rain" | remove: "rain" }}

I sted to see the t through the

{{ "I strained to see the train through the rain" | remove_first: "rain" }}

I sted to see the train through the rain

{{ "Take my protein pills and put my helmet on" | replace: "my", "your" }}

Take your protein pills and put your helmet on

{{ "Take my protein pills and put my helmet on" | replace_first: "my", "your" }}

Take your protein pills and put my helmet on

{% assign arr = "apples, oranges, peaches, plums" | split: ", " %}
{{ arr | reverse | join: ", " }}

plums, peaches, oranges, apples

{{ 1.2 | round }}

1

{{ 2.7 | round }}

3

{{ 183.357 | round: 2 }}

183.36

{{ "   So much room   " | rstrip }}!

   So much room!

{{ "Ground control to Major Tom." | size }}

28

{{ "Liquid" | slice: 0 }}

L

{{ "Liquid" | slice: 2, 3 }}

qui

{{ "Liquid" | slice: -3, 2 }}

ui

{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{{ beatles | join: "|" }}

John|Paul|George|Ringo

{{ "   So much room   " | strip }}!

So much room!

{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}

Have you read Ulysses?

{% capture s %}Hello
there{% endcapture %}{{ s | strip_newlines }}

Hellothere

{{ 3 | times: 2 }}

6

{{ "Ground control to Major Tom." | truncate: 20 }}

Ground control to...

{{ "Ground control to Major Tom." | truncate: 25, ", and so on" }}

Ground control, and so on

{{ "Ground control to Major Tom." | truncatewords: 3 }}

Ground control to...

{% assign arr = "ants, bugs, bees, bugs, ants" | split: ", " %}
{{ arr | uniq | join: "," }}

ants,bugs,bees

{{ "Parker Moore" | upcase }}

PARKER MOORE

{{ "%27Stop%21%27+said+Fred" | url_decode }}

'Stop!' said Fred

{{ "john@liquid.com" | url_encode }}

john%40liquid.com

{{ "Tetsuro Takara" | url_encode }}

Tetsuro+Takara

{{ "Test with *bold* and a http://example.com[link]." | asciidocify }}

<div class="paragraph">
<p>Test with <strong>bold</strong> and a <a href="http://example.com">link</a>.</p>
</div>

{{ "Test with *bold* and a http://example.com[link]." | asciidocify: "inline" }}

Test with <strong>bold</strong> and a <a href="http://example.com">link</a>.