Improve code for list of related posts.

Signed-off-by: Tekki <[email protected]>
chipzoller · Mar 26, 2023 · f74f442 · f74f442
1 parent 5f41b65
commit f74f442
Show file tree

Hide file tree

Showing 5 changed files with 22 additions and 18 deletions.
diff --git a/exampleSite/config/_default/params.toml b/exampleSite/config/_default/params.toml
@@ -128,7 +128,8 @@ languageMenuName = "🌐"
 # notice of the footer.
 # since = 2016
 
-# Show related content at the end of an article based on the 'series' taxonomy. Can be set in post front matter.
+# Show related content at the end of an article or in the sidebar, based on the 'series' taxonomy.
+# Both parameters can be overridden in the post's front matter.
 # showRelatedInArticle = false
 # showRelatedInSidebar = false
 

diff --git a/exampleSite/content/post/bundle/index.md b/exampleSite/content/post/bundle/index.md
@@ -19,6 +19,9 @@ categories:
 tags:
   - Hugo
 series: Themes Guide
+# the following overrides the settings from params.toml:
+showRelatedInArticle: true
+showRelatedInSidebar: true
 ---
 
 [Page bundles](https://gohugo.io/content-management/page-bundles/) are an optional way to [organize page resources](https://gohugo.io/content-management/page-resources/) within Hugo.

diff --git a/layouts/_default/single.html b/layouts/_default/single.html
@@ -29,13 +29,13 @@ <h2>{{ T "overview" }}</h2>
       {{- .Content }}
     </div>
 
-    {{- $showRelatedInArticle := true }}
-    {{- if eq $s.showRelatedInArticle false }}
-      {{- $showRelatedInArticle = false }}
+    {{- $showRelatedInArticle := $s.showRelatedInArticle }}
+    {{- if eq $p.showRelatedInArticle true }}
+      {{- $showRelatedInArticle = true }}
     {{- else if eq $p.showRelatedInArticle false }}
       {{- $showRelatedInArticle = false }}
     {{- end }}
-    {{- if ne $showRelatedInArticle false }}
+    {{- if (and ($showRelatedInArticle) (isset $p "series")) }}
       {{- partial "related" . }}
     {{- end }}
 

diff --git a/layouts/partials/related.html b/layouts/partials/related.html
@@ -1,9 +1,7 @@
-{{ if isset .Params "series" }}
 {{$related := where .Site.RegularPages ".Params.series" "eq" .Params.series }}
-	<h2 class="post_related">Posts in this Series</h2>
-	<ul>
-	  {{ range $related }}
-	      <li><a href="{{ .Permalink }}" class="nav-link" title="{{ .Title }}">{{ .Title }}</a></li>
-	  {{ end }}
-	</ul>
+<h2 class="post_related">{{ T "series_posts" }}</h2>
+<ul>
+{{ range $related }}
+  <li><a href="{{ .Permalink }}" class="nav-link" title="{{ .Title }}">{{ .Title }}</a></li>
 {{ end }}
+</ul>
diff --git a/layouts/partials/sidebar.html b/layouts/partials/sidebar.html
@@ -40,21 +40,23 @@ <h2 class="mt-4">Disclaimer</h2>
       </div>
     {{ end }}
 
-    {{- $relatedInSidebar := true }}
-    {{- if eq $s.showRelatedInSidebar false }}
-      {{ $relatedInSidebar = false }}
+    {{- $showRelatedInSidebar := $s.showRelatedInSidebar }}
+    {{- if eq .Params.showRelatedInSidebar true }}
+      {{- $showRelatedInSidebar = true }}
+    {{- else if eq .Params.showRelatedInSidebar false }}
+      {{- $showRelatedInSidebar = false }}
     {{- end }}
-    {{ if (and ($relatedInSidebar) (isset .Params "series") ) }}
+    {{- if (and ($showRelatedInSidebar) (isset .Params "series")) }}
       {{$related := where .Site.RegularPages ".Params.series" "eq" .Params.series }}
-	    <h2 class="mt-4">{{ T "series_posts" }}</h2>
+      <h2 class="mt-4">{{ T "series_posts" }}</h2>
       <ul>
         {{ range $related }}
         <li>
           <a href="{{ .Permalink }}" class="nav-link" title="{{ .Title }}">{{ .Title | markdownify }}</a>
         </li>
         {{ end }}
       </ul>
-    {{ end }}
+    {{- end }}
 
     {{- $posts := where .Site.RegularPages "Type" "in" $s.mainSections }}
     {{- $featured := default 8 $s.numberOfFeaturedPosts }}