Merge commit 'a6e635ca7d905d9ec3ffd708db2694f680b03aae'

docs/content/en/methods/pager/PageSize.md

@@ -1,6 +1,6 @@
 ---
 title: PageSize
-description: Returns the maximum number of pages per pager.
+description: Returns the number of pages per pager.
 categories: []
 keywords: []
 action:
@@ -8,8 +8,20 @@ action:
     - methods/page/Paginate
   returnType: int
   signatures: [PAGER.PageSize]
+expiryDate: 2025-06-09 # deprecated 2024-06-09
 ---
 
+{{% deprecated-in 0.128.0 %}}
+Use [`PAGER.PagerSize`] instead.
+
+[`PAGER.PagerSize`]: /methods/pager/pagersize/
+{{% /deprecated-in %}}
+
+The number of pages per pager is determined by the optional second argument passed to the [`Paginate`] method, falling back to the `pagerSize` as defined in your [site configuration].
+
+[`Paginate`]: /methods/page/paginate/
+[site configuration]: /templates/pagination/#configuration
+
 ```go-html-template
 {{ $pages := where site.RegularPages "Type" "posts" }}
 {{ $paginator := .Paginate $pages }}

docs/content/en/methods/pager/PagerSize.md

@@ -0,0 +1,31 @@
+---
+title: PagerSize
+description: Returns the number of pages per pager.
+categories: []
+keywords: []
+action:
+  related:
+    - methods/page/Paginate
+  returnType: int
+  signatures: [PAGER.PagerSize]
+---
+
+{{< new-in 0.128.0 >}}
+
+The number of pages per pager is determined by the optional second argument passed to the [`Paginate`] method, falling back to the `pagerSize` as defined in your [site configuration].
+
+[`Paginate`]: /methods/page/paginate/
+[site configuration]: /templates/pagination/#configuration
+
+```go-html-template
+{{ $pages := where site.RegularPages "Type" "posts" }}
+{{ $paginator := .Paginate $pages }}
+
+{{ range $paginator.Pages }}
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+{{ end }}
+
+{{ with $paginator }}
+  {{ .PagerSize }}
+{{ end }}
+```