feat: better tag support (#116)

This PR adds the following features:

* The ability to list a post's tags in `list.html` with a parameter to
toggle that defaults to off.
* Update baseof.html to support a custom "title" block that defines the
page's <title>. Default content matches current implementation.
* A terms.html template that will display tags or categories sorted by
post count.
* A fix for list.html's conditional logic. The original `(or "tags"
"categories")` just returns `"tags"` being logically equivalent to `(in
.Page.RelPermalink "tags")`
* The `tag` class from the post description is hoisted up, uses
`text-transform: lowercase` along with the `before`, and can be applied
outside of a post description.
* The `category` class has also been hoisted similarly.

assets/scss/style.scss

@@ -551,6 +551,19 @@ p.img-404 {
     margin-left: 1em;
     @include dimmed;
   }
+
+  .post-tags {
+    display: flex;
+    flex-wrap: wrap;
+    flex-shrink: 0;
+    font-size:x-small;
+    @include dimmed;
+
+    a {
+      margin-right: 0.5em;
+    }
+  }
+
   .post-description {
     font-size:x-small;
     flex-shrink: 0;
@@ -750,6 +763,18 @@ a.footnote-ref {
   }
 }
 
+.tag {
+  text-transform: lowercase;
+  &::before {
+    {{- with .Site.Params.tagSymbol | default "#" -}}content: "{{ . }}"{{- end -}}
+  }
+}
+.category {
+  &::before {
+    {{- with .Site.Params.categorySymbol | default "⊲" -}}content: "{{ . }}"{{- end -}}
+  }
+}
+
 .post-description {
   font-size: .8rem;
   line-height: normal;
@@ -769,17 +794,9 @@ a.footnote-ref {
 
   .tag {
     margin-right: .5em;
-
-    &::before {
-      {{- with .Site.Params.tagSymbol | default "#" -}}content: "{{ . }}"{{- end -}}
-    }
   }
   .category {
     margin-right: .5em;
-
-    &::before {
-      {{- with .Site.Params.categorySymbol | default "⊲" -}}content: "{{ . }}"{{- end -}}
-    }
   }
 }
 

hugo.toml.example

@@ -113,7 +113,8 @@ expiryDate = ["expiryDate"]
   # categorySymbol = "⊲"
   # pinned = "Pinned Posts"
   # pinnedSVGname = "pin"
-  # descriptionInPosts= true
+  # descriptionInPosts = true
+  # tagsInPost = false
   # initialPublish = "Initally Posted on: "
   # human = ["single","posts"]
   # noIndex = false

layouts/_default/baseof.html

@@ -7,7 +7,7 @@
 {{- partial "site-meta.html" . -}}
 {{- partial "structure-extra.html" . -}}
 {{- partial "webschema.html" . -}}
-<title>{{.Title}}</title>
+<title>{{ block "title" . }}{{ .Title }}{{ end }}</title>
 {{ range .AlternativeOutputFormats -}}
 {{ printf `<link rel="%s" type="%s" href="%s" title="%s" />` .Rel .MediaType.Type .Permalink $.Title | safeHTML }}
 {{ end -}}

layouts/_default/list.html

@@ -2,16 +2,28 @@
 {{ partialCached "header.html" . }}
 {{ end }}
 
+{{ define "title" }}
+	{{- if in .Page.RelPermalink "tags" -}}
+    {{- with .Site.Params.tagSymbol | default "#" -}}{{ . }}{{- end -}}{{ .Title | lower }}
+	{{- else -}}
+		{{ .Title }}
+	{{- end -}}
+{{ end }}
+
 {{ define "main" }}
 	<main class="site-main section-inner thin {{- if ne false .Site.Params.usesAnimation }} animated fadeIn faster{{- end -}}">
+	{{- if in .Page.RelPermalink "tags" -}}
+		<h1 class="tag">{{ .Title }}</h1>
+	{{- else -}}
 		<h1>{{ .Title }}</h1>
+	{{- end -}}
 		{{- if .Content }}
 		<div class="content">
 			{{ .Content }}
 		</div>
 		{{- end }}
 
-		{{- if and (ge (len (where .Site.Pages ".Params.pin" true)) 1) (.Site.Params.pinned) (not (in .Page.RelPermalink (or "tags" "categories"))) -}}
+		{{- if and (ge (len (where .Site.Pages ".Params.pin" true)) 1) (.Site.Params.pinned) (not (or (in .Page.RelPermalink "tags") (in .Page.RelPermalink "categories"))) -}}
 		<h2>{{- .Site.Params.pinned -}}</h2>
 		<div class="pinned-posts-group">
 			<ul class="pinned-posts-list">
@@ -40,6 +52,13 @@ <h2>{{- .Site.Params.pinned -}}</h2>
 					{{- if and .Page.Params.description .Site.Params.descriptionInPosts -}}
 					<span class="post-description">{{ .Page.Params.description }}</span>
 					{{- end -}}
+					{{- if and .Page.Params.tags .Site.Params.tagsInPosts -}}
+					<span class="post-tags">
+						{{- range .Page.Params.tags -}}
+						<a href="{{- printf "/tags/%s" . | urlize -}}" class="tag">{{- . -}}</a>
+						{{- end -}}
+					</span>
+					{{- end -}}
 				</li>
 				{{- end }}
 			</ul>

layouts/_default/terms.html

@@ -0,0 +1,35 @@
+{{ define "header" }}
+{{ partialCached "header.html" . }}
+{{ end }}
+
+{{ define "main" }}
+	<main class="site-main section-inner thin {{- if ne false .Site.Params.usesAnimation }} animated fadeIn faster{{- end -}}">
+		<h1>{{ .Title }}</h1>
+		{{- if .Content }}
+		<div class="content">
+			{{ .Content }}
+		</div>
+		{{- end }}
+
+		{{- range .Data.Terms.ByCount }}
+		<div class="posts-group">
+			<ul class="posts-list">
+				<li class="post-item">
+					<a href="{{.Page.RelPermalink}}">
+          {{- if in .Page.RelPermalink "tags" -}}
+              <span class="post-title tag">{{.Page.LinkTitle }}</span>
+          {{- else if in .Page.RelPermalink "categories" -}}
+              <span class="post-title category">{{.Page.LinkTitle}}</span>
+          {{- else -}}
+              <span class="post-title">{{.Page.LinkTitle}}</span>
+          {{- end -}}
+						<span class="post-day">{{ .Count }}</span>
+					</a>
+				</li>
+			</ul>
+		</div>
+		{{- end -}}
+	</main>
+{{ end }}
+{{ define "footer" }}<footer id="site-footer" class="section-inner thin {{- if ne false .Site.Params.usesAnimation }} animated fadeIn faster {{- end -}}">{{- if templates.Exists "partials/list-footer.html" -}}{{- partialCached "list-footer.html" . -}}{{- else -}}{{- partial "footer.html" . -}}{{- end -}}</footer>
+{{ end }}