refactor: migrate page visibility control from Params.hidden to the new build.list parameter. (#1249)

* refactor: migrate page visibility control from `Params.hidden` to the new `build.list` parameter.

* Rename rss.xml to home.rss.xml

archetypes/default.md

@@ -5,7 +5,8 @@ date: {{ .Date }}
 image: 
 math: 
 license: 
-hidden: false
 comments: true
 draft: true
+build:
+    list: always    # Change to "never" to hide the page from the list
 ---

layouts/_partials/article/components/related-content.html

@@ -1,4 +1,4 @@
-{{ $related := (where (.Site.RegularPages.Related .) "Params.hidden" "!=" true) | first 5 }}
+{{ $related := (.Site.RegularPages.Related .) | first 5 }}
 {{ with $related }}
 <aside class="related-content--wrapper">
     <h2 class="section-title">{{ T "article.relatedContent" }}</h2>

layouts/_partials/helper/paginator.html

@@ -3,15 +3,13 @@
 
 {{- if .IsHome -}}
     {{ $pages = where .Site.RegularPages "Section" "in" .Site.Params.mainSections }}
-    {{ $pages = where $pages "Params.hidden" "!=" true }}
     {{- $hasPages = true -}}
 {{- else if eq .Kind "term" -}}
-    {{ $pages = where .Pages "Params.hidden" "!=" true }}
+    {{ $pages = .Pages }}
     {{- $hasPages = true -}}
 {{- else if or (eq .Kind "section") (eq .Kind "taxonomy") -}}
     {{ $subsections := .Sections }}
     {{ $pages = .Pages | complement $subsections }}
-    {{ $pages = where $pages "Params.hidden" "!=" true }}
 
     {{- if eq (len $pages) 0 -}}
         {{/* See complete logic in list.html */}}

layouts/_partials/widget/archives.html

@@ -10,8 +10,7 @@
         <h2 class="widget-title section-title">{{ T "widget.archives.title" }}</h2>
 
         {{ $pages := where $context.Site.RegularPages "Type" "in" $context.Site.Params.mainSections }}
-        {{ $filtered := where $pages "Params.hidden" "!=" true }}
+        {{ $archives := $pages.GroupByDate "2006" }}
-        {{ $archives := $filtered.GroupByDate "2006" }}
         
         <div class="widget-archive--list">
             {{ range $index, $item := first (add $limit 1) ($archives) }}

layouts/archives.html

@@ -16,9 +16,8 @@
     </header>
 
     {{ $pages := where .Site.RegularPages "Type" "in" .Site.Params.mainSections }}
-    {{ $filtered := where $pages "Params.hidden" "!=" true }}
 
-    {{ range $filtered.GroupByDate "2006" }}
+    {{ range $pages.GroupByDate "2006" }}
     {{ $id := lower (replace .Key " " "-") }}
     <div class="archives-group" id="{{ $id }}">
         <h2 class="archives-date section-title"><a href="{{ $.RelPermalink }}#{{ $id }}">{{ .Key }}</a></h2>

layouts/home.rss.xml

@@ -6,7 +6,6 @@
 {{- else -}}
 {{- $pages = $pctx.Pages -}}
 {{- end -}}
-{{- $pages := where $pages "Params.hidden" "!=" true -}}
 {{- $limit := .Site.Config.Services.RSS.Limit -}}
 {{- if ge $limit 1 -}}
 {{- $pages = $pages | first $limit -}}

layouts/list.html

@@ -31,7 +31,6 @@
 
     {{- $subsections := .Sections -}}
     {{- $pages := .Pages | complement $subsections -}}
-    {{- $pages = where $pages "Params.hidden" "!=" true -}}
     
     {{- if eq (len $pages) 0 -}}
         {{/* If there are no normal pages, display subsections in list style, with pagination */}}

layouts/page/search.json

@@ -1,9 +1,7 @@
 {{- $pages := where .Site.RegularPages "Type" "in" .Site.Params.mainSections -}}
-{{- $filtered := where $pages "Params.hidden" "!=" true -}}
-
 {{- $result := slice -}}
 
-{{- range $filtered -}}
+{{- range $pages -}}
     {{- $data := dict "title" .Title "date" .Date "permalink" .RelPermalink "content" (.Plain) -}}
 
     {{- $image := partial "helper/image" (dict "Image" .Params.image "Resources" .Resources) -}}