Add support for post tags

funnelfiasco · mlieberman85 · commit 677a6ec08d8e · 2024-08-19T19:50:33.000-04:00
This makes it easier to see the posts in a series, etc. I will tag existing posts in a subsequent commit. This one is just the infrastructure necessary to support it. Partial implementation of #50 Signed-off-by: Ben Cotton <ben@kusari.dev>
diff --git a/README.md b/README.md
@@ -31,7 +31,11 @@ Other formats *might* work, but why take chances?)
 This is the date used by Hugo to sort the posts.
 *If you use a date in the future, it will not be listed on the blog page.*
 * `authors` (optional): An array of names to list as the author.
-If you only have one author, it still needs to be quoted and in square brackets.
+If you only have one author, it still needs to be quoted and in square brackets or in a yaml list format.
+* `tags` (optional): An array of tags to use for the post.
+Prefer existing tags whenever possible.
+When in doubt, don't add a tag.
+An incomplete list of tags we use is given below.
 
 A complete header looks something like:
 
@@ -40,17 +44,29 @@ A complete header looks something like:
 title: This is a great blog post
 date: 2023-04-13
 authors: ["Ben Cotton", "Jane Doe", "Blogger McBlogface"]
+tags:
+  - releases
+  - events
 ---
 ```
 
 Below the header, write the content.
 For ease of writing, use Markdown by default.
 You may use HTML when needed.
 
+#### Tags
+
+This is a partial list of tags we use on blog posts.
+If you use a new tag, add it here.
+
+* *community*: Posts about the community itself
+* *docs*: Posts about the documentation
+* *events*: Conferences, webinars,etc
+* *meetings*: Community Meetings and Maintainers Meetings
+* *releases*: Release announcements
+
 ## Layout
 
 * config.yml — Site configuration and main page content
 * content/blog/* — Blog posts
 * content/* — Other pages
-
-
diff --git a/config.yaml b/config.yaml
@@ -11,10 +11,6 @@ outputs:
   section:
     - html
     - rss
-# Disables warnings
-disableKinds:
-- taxonomy
-- taxonomyTerm
 services:
   rss:
     limit: 10
@@ -24,6 +20,7 @@ markup:
       unsafe: true # Allows you to write raw html in your md files
 
 params:
+  date_format: "2006-01-02"
   include_footer: true
   # Open graph allows easy social sharing. If you don't want it you can set it to false or just delete the variable
   openGraph: true
diff --git a/themes/hugo-fresh/layouts/_default/taxonomy.html b/themes/hugo-fresh/layouts/_default/taxonomy.html
@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="{{ .Site.LanguageCode }}">
+  <head>
+    {{ partial "meta.html" . }}
+    <title>{{ block "title" . }}{{ .Site.Title }}{{ end }}</title>
+    {{ partial "css.html" . }}
+  </head>
+  <body>
+    <!-- Preloader -->
+    <div id="preloader">
+      <div id="status"></div>
+    </div>
+
+    {{ partial "navbar.html" . }}
+    {{ partial "navbar-clone.html" . }}
+
+    <section class="section is-medium">
+      <div class="container">
+        <div class="columns">
+          <div class="column is-centered-tablet-portrait">
+
+            <h1 class="title section-title">{{ .Title }} posts</h1>
+              {{ .Content }}
+              {{ range .Pages }}
+                <p>{{ .Date.Format .Site.Params.date_format }} — <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></p>
+              {{ end }}
+
+          </div>
+        </div>
+      </div>
+    </section>
+
+    {{ $include_footer := .Params.include_footer | default .Site.Params.include_footer }}
+    {{ if $include_footer }}
+    {{ partial "footer.html" . }}
+    {{ end }}
+
+
+    <!-- Back To Top Button -->
+    <div id="backtotop"><a href="#"></a></div>
+
+    {{ if .Params.sidebar }}
+    {{ partial "single/sidebar.html" . }}
+    {{ end }}
+
+    {{ partial "javascript.html" . }}
+
+  </body>
+</html>
diff --git a/themes/hugo-fresh/layouts/partials/single/content.html b/themes/hugo-fresh/layouts/partials/single/content.html
@@ -18,5 +18,10 @@ <h5 class="subtitle is-5 is-muted">{{ .Params.Subtitle }}</h5>
     <div class="content">
       {{ .Content }}
     </div>
+
+    {{ if gt (.Param "tags") 0 }}
+      {{ $maxIndex := sub ( len .Params.tags ) 1 }}
+      <p class="tagList">Tags: {{ range $index, $tag := .Param "tags"  }}<a href="/tags/{{ $tag }}">{{ $tag }}</a>{{ if and ( ne $maxIndex 0 ) ( lt $index $maxIndex ) }} | {{ end }}{{ end }}</p>
+    {{ end }}
   </div>
 </section>
