Files
hugo/content/functions/with.md
T
Bud Parr 7fd64f19c8 Merge bp/theme-design branch containing Bud Parr's new design
It's a beautiful thing. A thousand thanks, Bud.

See PR rdwatters/hugo-docs-concept#118
2017-05-26 14:25:22 -05:00

1.1 KiB

title, description, godocref, date, publishdate, lastmod, categories, menu, tags, ns, signature, workson, hugoversion, relatedfuncs, deprecated
title description godocref date publishdate lastmod categories menu tags ns signature workson hugoversion relatedfuncs deprecated
with Rebinds the context (`.`) within its scope and skips the block if the variable is absent. 2017-02-01 2017-02-01 2017-03-12
functions
docs
parent
functions
conditionals
fundamentals
with INPUT
false

An alternative way of writing an if statement and then referencing the same value is to use with instead. with rebinds the context (.) within its scope and skips the block if the variable is absent or unset.

The following example checks for a user-defined site variable called twitteruser. If the key-value is not set, the following will render nothing:

{{% code file="layouts/partials/twitter.html" %}}

{{with .Site.Params.twitteruser}}<span class="twitter">
<a href="https://twitter.com/{{.}}" rel="author">
<img src="/images/twitter.png" width="48" height="48" title="Twitter: {{.}}"
 alt="Twitter"></a>
</span>{{end}}

{{% /code %}}