From 1a4522b3ed63294408cbf439852fb8cf8b6e7146 Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Fri, 18 Aug 2023 20:33:55 -0700
Subject: [PATCH] Format examples

---
 content/en/templates/lists/index.md | 348 ++++++++++++++--------------
 1 file changed, 174 insertions(+), 174 deletions(-)

diff --git a/content/en/templates/lists/index.md b/content/en/templates/lists/index.md
index ec397c32b..f488f6fe9 100644
--- a/content/en/templates/lists/index.md
+++ b/content/en/templates/lists/index.md
@@ -88,23 +88,23 @@ You can now access this `_index.md`'s' content in your list template:
 
 {{< code file="layouts/_default/list.html" >}}
 {{ define "main" }}
-<main>
-  <article>
-    <header>
-      <h1>{{ .Title }}</h1>
-    </header>
-    <!-- "{{ .Content }}" pulls from the markdown content of the corresponding _index.md -->
-    {{ .Content }}
-  </article>
-  <ul>
-    <!-- Ranges through content/posts/*.md -->
-    {{ range .Pages }}
-      <li>
-        <a href="{{ .Permalink }}">{{ .Date.Format "2006-01-02" }} | {{ .Title }}</a>
-      </li>
-    {{ end }}
-  </ul>
-</main>
+  <main>
+    <article>
+      <header>
+        <h1>{{ .Title }}</h1>
+      </header>
+      <!-- "{{ .Content }}" pulls from the markdown content of the corresponding _index.md -->
+      {{ .Content }}
+    </article>
+    <ul>
+      <!-- Ranges through content/posts/*.md -->
+      {{ range .Pages }}
+        <li>
+          <a href="{{ .Permalink }}">{{ .Date.Format "2006-01-02" }} | {{ .Title }}</a>
+        </li>
+      {{ end }}
+    </ul>
+  </main>
 {{ end }}
 {{< /code >}}
 
@@ -113,17 +113,17 @@ This above will output the following HTML:
 {{< code file="example.com/posts/index.html" copy=false >}}
 <!--top of your baseof code-->
 <main>
-    <article>
-        <header>
-            <h1>My Go Journey</h1>
-        </header>
-        <p>I decided to start learning Go in March 2017.</p>
-        <p>Follow my journey through this new blog.</p>
-    </article>
-    <ul>
-        <li><a href="/posts/post-01/">Post 1</a></li>
-        <li><a href="/posts/post-02/">Post 2</a></li>
-    </ul>
+  <article>
+    <header>
+      <h1>My Go Journey</h1>
+    </header>
+    <p>I decided to start learning Go in March 2017.</p>
+    <p>Follow my journey through this new blog.</p>
+  </article>
+  <ul>
+    <li><a href="/posts/post-01/">Post 1</a></li>
+    <li><a href="/posts/post-02/">Post 2</a></li>
+  </ul>
 </main>
 <!--bottom of your baseof-->
 {{< /code >}}
@@ -137,16 +137,16 @@ Using this same `layouts/_default/list.html` template and applying it to the `qu
 {{< code file="example.com/quote/index.html" copy=false >}}
 <!--baseof-->
 <main>
-    <article>
-        <header>
-        <!-- Hugo assumes that .Title is the name of the section since there is no _index.md content file from which to pull a "title:" field -->
-            <h1>Quotes</h1>
-        </header>
-    </article>
-    <ul>
-        <li><a href="https://example.com/quote/quotes-01/">Quote 1</a></li>
-        <li><a href="https://example.com/quote/quotes-02/">Quote 2</a></li>
-    </ul>
+  <article>
+    <header>
+      <!-- Hugo assumes that .Title is the name of the section since there is no _index.md content file from which to pull a "title:" field -->
+      <h1>Quotes</h1>
+    </header>
+  </article>
+  <ul>
+    <li><a href="https://example.com/quote/quotes-01/">Quote 1</a></li>
+    <li><a href="https://example.com/quote/quotes-02/">Quote 2</a></li>
+  </ul>
 </main>
 <!--baseof-->
 {{< /code >}}
@@ -202,12 +202,12 @@ Hugo lists render the content based on metadata you provide in [front matter]. I
 
 {{< code file="layouts/partials/default-order.html" >}}
 <ul>
-    {{ range .Pages }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  {{ range .Pages }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -217,12 +217,12 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-weight.html" >}}
 <ul>
-    {{ range .Pages.ByWeight }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  {{ range .Pages.ByWeight }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -230,13 +230,13 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-date.html" >}}
 <ul>
-    <!-- orders content according to the "date" field in front matter -->
-    {{ range .Pages.ByDate }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  <!-- orders content according to the "date" field in front matter -->
+  {{ range .Pages.ByDate }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -244,13 +244,13 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-publish-date.html" >}}
 <ul>
-    <!-- orders content according to the "publishdate" field in front matter -->
-    {{ range .Pages.ByPublishDate }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  <!-- orders content according to the "publishdate" field in front matter -->
+  {{ range .Pages.ByPublishDate }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -258,12 +258,12 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-expiry-date.html" >}}
 <ul>
-    {{ range .Pages.ByExpiryDate }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  {{ range .Pages.ByExpiryDate }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -271,13 +271,13 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-last-mod.html" >}}
 <ul>
-    <!-- orders content according to the "lastmod" field in front matter -->
-    {{ range .Pages.ByLastmod }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  <!-- orders content according to the "lastmod" field in front matter -->
+  {{ range .Pages.ByLastmod }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -285,13 +285,13 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-length.html" >}}
 <ul>
-    <!-- orders content according to content length in ascending order (i.e., the shortest content will be listed first) -->
-    {{ range .Pages.ByLength }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  <!-- orders content according to content length in ascending order (i.e., the shortest content will be listed first) -->
+  {{ range .Pages.ByLength }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -299,13 +299,13 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-title.html" >}}
 <ul>
-    <!-- ranges through content in ascending order according to the "title" field set in front matter -->
-    {{ range .Pages.ByTitle }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  <!-- ranges through content in ascending order according to the "title" field set in front matter -->
+  {{ range .Pages.ByTitle }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -313,13 +313,13 @@ Lower weight gets higher precedence. So content with lower weight will come firs
 
 {{< code file="layouts/partials/by-link-title.html" >}}
 <ul>
-    <!-- ranges through content in ascending order according to the "linktitle" field in front matter. If a "linktitle" field is not set, the range will start with content that only has a "title" field and use that value for .LinkTitle -->
-    {{ range .Pages.ByLinkTitle }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .LinkTitle }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  <!-- ranges through content in ascending order according to the "linktitle" field in front matter. If a "linktitle" field is not set, the range will start with content that only has a "title" field and use that value for .LinkTitle -->
+  {{ range .Pages.ByLinkTitle }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .LinkTitle }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -348,12 +348,12 @@ Reversing order can be applied to any of the above methods. The following uses `
 
 {{< code file="layouts/partials/by-date-reverse.html" >}}
 <ul>
-    {{ range .Pages.ByDate.Reverse }}
-        <li>
-            <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
-            <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
-        </li>
-    {{ end }}
+  {{ range .Pages.ByDate.Reverse }}
+    <li>
+      <h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
+      <time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
+    </li>
+  {{ end }}
 </ul>
 {{< /code >}}
 
@@ -366,15 +366,15 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
 {{< code file="layouts/partials/by-page-field.html" >}}
 <!-- Groups content according to content section. The ".Key" in this instance will be the section's title. -->
 {{ range .Pages.GroupBy "Section" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -383,21 +383,21 @@ In the above example, you may want `{{ .Title }}` to point the `title` field you
 {{< code file="layouts/partials/by-page-field.html" >}}
 <!-- Groups content according to content section.-->
 {{ range .Pages.GroupBy "Section" }}
-<!-- Checks for existence of _index.md for a section; if available, pulls from "title" in front matter -->
-{{ with $.Site.GetPage "section" .Key }}
-<h3>{{ .Title }}</h3>
-{{ else }}
-<!-- If no _index.md is available, ".Key" defaults to the section title and filters to title casing -->
-<h3>{{ .Key | title }}</h3>
-{{ end }}
-<ul>
+  <!-- Checks for existence of _index.md for a section; if available, pulls from "title" in front matter -->
+  {{ with $.Site.GetPage "section" .Key }}
+    <h3>{{ .Title }}</h3>
+  {{ else }}
+    <!-- If no _index.md is available, ".Key" defaults to the section title and filters to title casing -->
+    <h3>{{ .Key | title }}</h3>
+  {{ end }}
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -406,15 +406,15 @@ In the above example, you may want `{{ .Title }}` to point the `title` field you
 {{< code file="layouts/partials/by-page-date.html" >}}
 <!-- Groups content by month according to the "date" field in front matter -->
 {{ range .Pages.GroupByDate "2006-01" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -425,15 +425,15 @@ In the above example, you may want `{{ .Title }}` to point the `title` field you
 {{< code file="layouts/partials/by-page-publish-date.html" >}}
 <!-- Groups content by month according to the "publishDate" field in front matter -->
 {{ range .Pages.GroupByPublishDate "2006-01" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .PublishDate.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .PublishDate.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -445,15 +445,15 @@ In the above example, you may want `{{ .Title }}` to point the `title` field you
 {{< code file="layouts/partials/by-page-expiry-date.html" >}}
 <!-- Groups content by month according to the "expiryDate" field in front matter -->
 {{ range .Pages.GroupByExpiryDate "2006-01" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .ExpiryDate.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .ExpiryDate.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -464,15 +464,15 @@ In the above example, you may want `{{ .Title }}` to point the `title` field you
 {{< code file="layouts/partials/by-page-lastmod.html" >}}
 <!-- Groups content by month according to the "lastMod" field in front matter -->
 {{ range .Pages.GroupByLastmod "2006-01" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Lastmod.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Lastmod.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -483,16 +483,16 @@ In the above example, you may want `{{ .Title }}` to point the `title` field you
 {{< code file="layouts/partials/by-page-param.html" >}}
 <!-- Groups content according to the "param_key" field in front matter -->
 {{ range .Pages.GroupByParam "param_key" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
-{{ end }}
+  </ul>
+  {{ end }}
 {{< /code >}}
 
 ### By page parameter in date format
@@ -502,15 +502,15 @@ The following template takes grouping by `date` a step further and uses Go's lay
 {{< code file="layouts/partials/by-page-param-as-date.html" >}}
 <!-- Groups content by month according to the "param_key" field in front matter -->
 {{ range .Pages.GroupByParamDate "param_key" "2006-01" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}
 
@@ -552,15 +552,15 @@ Here is the ordering for the example that follows:
 
 {{< code file="layouts/partials/by-group-by-page.html" >}}
 {{ range .Pages.GroupByDate "2006-01" "asc" }}
-<h3>{{ .Key }}</h3>
-<ul>
+  <h3>{{ .Key }}</h3>
+  <ul>
     {{ range .Pages.ByTitle }}
-    <li>
-    <a href="{{ .Permalink }}">{{ .Title }}</a>
-    <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
-    </li>
+      <li>
+        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
+      </li>
     {{ end }}
-</ul>
+  </ul>
 {{ end }}
 {{< /code >}}