Copy page

Template Language

JSON-T Formatters

Formatters can be used to control the formatting of data for a given variable.

The syntax of a formatter is {variable-name|formatter-name}.

JSON

Code
{variable|json}

Output the variable as JSON data.

Prettified JSON

Code
{variable|json-pretty}

Output the variable as formatted JSON data.

Date/Time Formatters

Date

Code
{addedOn|date %A, %B %d}

Format a date in-line using the YUI date format.

Timesince Date

Code
{addedOn|timesince}

Displays the time/date in a term relative to right now. Also referred to as 'time ago' or 'twitter-style' date format.

String Formatters

Slugify

Code
{variable|slugify}

Converts a human readable string variable to lowercase, removes non-word characters (alphanumerics and underscores) and converts spaces to hyphens. For example, "Test Example" would become "test-example".

Smartypants

Code
{variable|smartypants}

Translates plain ASCII punctuation characters into "smart" typographic punctuation HTML entities (source).

URL Encode

Code
{variable|url-encode}

Encodes a variable so it can be safely used in a URL. For instance, "Test Example" would become "Test%20Example".

HTML

Code
{variable|html}

Encodes a variable so it can be safely used in HTML, replacing the characters <, >, and & with their corresponding entities. For example, <script> would become <script>.

HTML Attribute

Code
{variable|htmlattr} or {variable|htmltag}

Similar to html but additionally escapes quotes, replacing the characters <, >, &, and " with their corresponding entities, to ensure it can be used in an attribute (src="X", for instance) within an HTML tag.

Truncate

Code
{variable|truncate 250}

Limits the length of a string to the number following the formatter, and once truncated includes an ellipsis.

NOTE: should be combined with safe if truncating a string that contains HTML.

Safe

Code
{variable|safe}

Make the variable 'safe' by stripping away unsafe HTML, such as injected script tags.

Item Count

Code
{items|count}

Output the length of the items array

Twitter Links

Code
{variable|activate-twitter-links}

Make links and @names link to the appropriate places on twitter. For instance, @squarespace (the string) would become @squarespace.