resources.ExecuteAsTemplate

The resources.ExecuteAsTemplate function returns a resource created from a Go template, parsed and executed with the given context, caching the result using the target path as its cache key.

Hugo publishes the resource to the target path when you call its Publish, Permalink, or RelPermalink methods.

Let’s say you have a CSS file that you wish to populate with values from your project configuration:

body {
  background-color: {{ site.Params.style.bg_color }};
  color: {{ site.Params.style.text_color }};
}

And your project configuration contains:

params:
  style:
    bg_color: '#fefefe'
    text_color: '#222'

[params]
  [params.style]
    bg_color = '#fefefe'
    text_color = '#222'

{
   "params": {
      "style": {
         "bg_color": "#fefefe",
         "text_color": "#222"
      }
   }
}

Place this in your baseof.html template:

{{ with resources.Get "css/template.css" }}
  {{ with resources.ExecuteAsTemplate "css/main.css" $ . }}
    <link rel="stylesheet" href="{{ .RelPermalink }}">
  {{ end }}
{{ end }}

The example above:

1. Captures the template as a resource
2. Executes the resource as a template, passing the current page in context
3. Publishes the resource to css/main.css

The result is:

body {
  background-color: #fefefe;
  color: #222;
}