From deceb17144c509e4d1728c3395d276f305701bc9 Mon Sep 17 00:00:00 2001
From: Jimmy <jimmy@cai.im>
Date: Tue, 27 Jan 2026 12:00:40 +0100
Subject: [PATCH] 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                                     | 3 ++-
 layouts/_partials/article/components/related-content.html | 2 +-
 layouts/_partials/helper/paginator.html                   | 4 +---
 layouts/_partials/widget/archives.html                    | 3 +--
 layouts/archives.html                                     | 3 +--
 layouts/{rss.xml => home.rss.xml}                         | 1 -
 layouts/list.html                                         | 1 -
 layouts/page/search.json                                  | 4 +---
 8 files changed, 7 insertions(+), 14 deletions(-)
 rename layouts/{rss.xml => home.rss.xml} (97%)

diff --git a/archetypes/default.md b/archetypes/default.md
index 0556d3a..6075e9a 100644
--- a/archetypes/default.md
+++ b/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
 ---
\ No newline at end of file
diff --git a/layouts/_partials/article/components/related-content.html b/layouts/_partials/article/components/related-content.html
index aba88e3..f3094eb 100644
--- a/layouts/_partials/article/components/related-content.html
+++ b/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>
diff --git a/layouts/_partials/helper/paginator.html b/layouts/_partials/helper/paginator.html
index f05dc96..2153abf 100644
--- a/layouts/_partials/helper/paginator.html
+++ b/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 */}}
diff --git a/layouts/_partials/widget/archives.html b/layouts/_partials/widget/archives.html
index b193fc3..e42da27 100644
--- a/layouts/_partials/widget/archives.html
+++ b/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 := $filtered.GroupByDate "2006" }}
+        {{ $archives := $pages.GroupByDate "2006" }}
         
         <div class="widget-archive--list">
             {{ range $index, $item := first (add $limit 1) ($archives) }}
diff --git a/layouts/archives.html b/layouts/archives.html
index ce77f47..70ea6b3 100644
--- a/layouts/archives.html
+++ b/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>
diff --git a/layouts/rss.xml b/layouts/home.rss.xml
similarity index 97%
rename from layouts/rss.xml
rename to layouts/home.rss.xml
index 730467b..14f967c 100644
--- a/layouts/rss.xml
+++ b/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 -}}
diff --git a/layouts/list.html b/layouts/list.html
index 26e2a61..efeee2e 100644
--- a/layouts/list.html
+++ b/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 */}}
diff --git a/layouts/page/search.json b/layouts/page/search.json
index 3a86dc7..1045cc2 100644
--- a/layouts/page/search.json
+++ b/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) -}}