diff --git a/content/en/templates/shortcode-templates.md b/content/en/templates/shortcode-templates.md index 14add6f77..888b7ca42 100644 --- a/content/en/templates/shortcode-templates.md +++ b/content/en/templates/shortcode-templates.md @@ -88,14 +88,14 @@ For the second position, you would just use: `with` is great when the output depends on a parameter being set: ``` -{{ with .Get "class"}} class="{{.}}"{{ end }} +{{ with .Get "class" }} class="{{ . }}"{{ end }} ``` `.Get` can also be used to check if a parameter has been provided. This is most helpful when the condition depends on either of the values, or both: ``` -{{ if or (.Get "title") (.Get "alt") }} alt="{{ with .Get "alt"}}{{.}}{{else}}{{.Get "title"}}{{end}}"{{ end }} +{{ if or (.Get "title") (.Get "alt") }} alt="{{ with .Get "alt" }}{{ . }}{{ else }}{{ .Get "title" }}{{ end }}"{{ end }} ``` #### `.Inner` @@ -130,16 +130,16 @@ The `.IsNamedParams` variable checks whether the shortcode declaration uses name For example, you could create an `image` shortcode that can take either a `src` named parameter or the first positional parameter, depending on the preference of the content's author. Let's assume the `image` shortcode is called as follows: ``` -{{}} +{{}} ``` You could then include the following as part of your shortcode templating: ``` {{ if .IsNamedParams }} - + {{ else }} - + {{ end }} ``` @@ -213,17 +213,17 @@ You have created the shortcode at `/layouts/shortcodes/img.html`, which loads th {{< code file="/layouts/shortcodes/img.html" >}}
- {{ with .Get "link"}}{{ end }} - - {{ if .Get "link"}}{{ end }} - {{ if or (or (.Get "title") (.Get "caption")) (.Get "attr")}} + {{ with .Get "link" }}{{ end }} + + {{ if .Get "link" }}{{ end }} + {{ if or (or (.Get "title") (.Get "caption")) (.Get "attr") }}
{{ if isset .Params "title" }}

{{ .Get "title" }}

{{ end }} - {{ if or (.Get "caption") (.Get "attr")}}

+ {{ if or (.Get "caption") (.Get "attr") }}

{{ .Get "caption" }} - {{ with .Get "attrlink"}} {{ end }} + {{ with .Get "attrlink" }} {{ end }} {{ .Get "attr" }} - {{ if .Get "attrlink"}} {{ end }} + {{ if .Get "attrlink" }} {{ end }}

{{ end }}
{{ end }} @@ -289,7 +289,7 @@ The following is taken from `highlight`, which is a [built-in shortcode][] that The template for the `highlight` shortcode uses the following code, which is already included in Hugo: ``` -{{ .Get 0 | highlight .Inner }} +{{ .Get 0 | highlight .Inner }} ``` The rendered output of the HTML example code block will be as follows: @@ -308,8 +308,8 @@ Hugo's [`.Parent` shortcode variable][parent] returns a boolean value depending The following example is contrived but demonstrates the concept. Assume you have a `gallery` shortcode that expects one named `class` parameter: {{< code file="layouts/shortcodes/gallery.html" >}} -
- {{.Inner}} +
+ {{ .Inner }}
{{< /code >}} @@ -318,10 +318,10 @@ You also have an `img` shortcode with a single named `src` parameter that you wa {{< code file="layouts/shortcodes/img.html" >}} {{- $src := .Get "src" -}} {{- with .Parent -}} - + {{- else -}} -{{- end }} +{{- end -}} {{< /code >}} You can then call your shortcode in your content as follows: