Hugo Templating Basics

    ---    title: Home    ---

    <p>A Go template is a normal HTML page. When you want to execute a piece of     code, you can use double curly braces like this: {{ "Hello!" }}.</p>

    <!-- You can reference a variable from your front matter in a layout with .Params. For example, you     could output the title on your pages with: -->    <title>{{ .Params.title }}</title>

    <!-- Sometimes you'll want to set a variable globally in your config.toml.     Hugo has already initalized a title in your config.toml. You can access    a variable from your global config with site. For example: -->    <title>{{ .Params.title }} | {{ .Site.title }}</title>

    <!-- We might want to check if the front matter title exists. If    it exists, output it; if not, use the global config title. -->    {{ if isset .Params "title" }}      <title>{{ .Params.title }}</title>    {{ else }}      <title>{{ .Site.title }}</title>    {{ end }}

    <!-- variables at set with a $ sign. For example: -->    {{ $favorite_food := "Gazelle" }}    {{ $favorite_food }}

    <!-- In Go, an array that can change size is called a slice.    You can iterate over an array or slice using range. -->    {{ $best_friends := slice "pumbaa" "timon" "nala" "rafiki" }}    <ul>    {{ range $best_friends }}      <li>{{ . }}</li>    {{ end }}    </ul>

    ---    title: Appearance    apperance:      eyes: green      snoot: boopable      whiskers: true      limbs:        - claws: 5          side: left          position: front        - claws: 4          side: right          position: front        - claws: 3          side: left          position: back        - claws: 5          side: right          position: back    ---

    <!-- If we want to output all of these variables, we could call     .Params.appearance.x for each one. Instead we could use `with` to change     the context to '.'. It also has the benefit of checking whether the     variable exists and won't run the block if it doesn't. -->    {{ with .Params.appearance }}    <h3>My top appearance traits</h3>    <dl>        <dt>Eyes</dt>      <dd>{{ .eyes }}</dd>      <dt>Snoot</dt>      <dd>{{ .snoot }}</dd>      <dt>Whiskers</dt>      <dd>{{ .whiskers }}</dd>        {{ with .limbs }}        <dt>Claws</dt>        <dd>            <ul>          {{ range . }}            <li>{{ .position }} {{ .side }} {{ .claws }</li>          {{ end }}          </ul>        </dd>      {{ end }}    </dl>    {{ end }}

    [params]    name = 'Simba'

    {{ with .Params.hide_footer }}      <!-- No footer here! -->    {{ else }}      <footer>        Website made by {{ .Site.Params.name }} in {{ now.Year }}      </footer>    {{ end }}

    {{ partial "footer.html" . }}

    hide_footer: true