content/_includes/utility.macros.njk
Utilities can be used just about anywhere, and that’s why we love them.
attr_if()
Pass in an attribute name and value. If the value is not falsey, we’ll display the attribute with appropriate value when necessary.
attr
{string}
The attribute name
value
{string | boolean}
= none
The value of the attribute. “True” or “true” (string or boolean) will output the attribute without any value, while falsey values will not output any attribute.
show_attrs()
Render a dictionary of attribute/value pairs into HTML-ready attributes.
attrs
{object}
style_if()
Render a dictionary of property/value pairs into an HTML-ready style attribute.
style
{object}
icon_link()
Links with icons require special handling in order to avoid awkward underline collisions.
icon
{include path}
text
{string}
url
{url}
= none
class
{string}
= none
attrs
{object}
= {}
link_if()
Return a link or span with given attributes
content
{string}
url
{url}
= none
class
{string}
= none
attrs
{object}
= {}
main_action()
Generate a “main-action” link, generally one-per-section.
content
{string}
url
{url}
= none
datetime()
Format dates and times for posts
start
{date}
end
{date | none}
format
{string | date-format}
= long
is_pubdate
{boolean}
= false