feat(pagination): add option to disable prev/next navigation

* Feature: disable next/previous pagination buttons site-wide

* Moved the displayPagination to the layout level and adjusted the documentation.

* fix: improve pagination docs and layout whitespace

- Fix indentation in docs layout templates
- Add pagination documentation for all languages (fa, ja, zh-cn)
- Simplify documentation to be more succinct

---------

Co-authored-by: Xin <xin@imfing.com>

docs/content/docs/guide/configuration.fa.md

@@ -121,6 +121,19 @@ params:
       height: 20
 ```
 
+### صفحه‌بندی
+
+برای غیرفعال کردن ناوبری قبلی/بعدی در پایین صفحات مستندات یا مقالات وبلاگ:
+
+```yaml {filename="hugo.yaml"}
+params:
+  page:
+    displayPagination: false  # برای صفحات مستندات
+  blog:
+    article:
+      displayPagination: false  # برای مقالات وبلاگ
+```
+
 ## نوار کناری
 
 ### نوار کناری اصلی

docs/content/docs/guide/configuration.ja.md

@@ -121,6 +121,19 @@ params:
       height: 20
 ```
 
+### ページネーション
+
+ドキュメントページやブログ記事の下部にある前へ/次へナビゲーションを無効にするには：
+
+```yaml {filename="hugo.yaml"}
+params:
+  page:
+    displayPagination: false  # ドキュメントページ用
+  blog:
+    article:
+      displayPagination: false  # ブログ記事用
+```
+
 ## サイドバー
 
 ### メインサイドバー

docs/content/docs/guide/configuration.md

@@ -128,6 +128,19 @@ params:
       height: 20
 ```
 
+### Pagination
+
+To disable the previous/next navigation at the bottom of docs pages or blog articles:
+
+```yaml {filename="hugo.yaml"}
+params:
+  page:
+    displayPagination: false  # for docs pages
+  blog:
+    article:
+      displayPagination: false  # for blog articles
+```
+
 ## Sidebar
 
 ### Main Sidebar

docs/content/docs/guide/configuration.zh-cn.md

@@ -121,6 +121,19 @@ params:
       height: 20
 ```
 
+### 分页导航
+
+禁用文档页面或博客文章底部的上一篇/下一篇导航：
+
+```yaml {filename="hugo.yaml"}
+params:
+  page:
+    displayPagination: false  # 文档页面
+  blog:
+    article:
+      displayPagination: false  # 博客文章
+```
+
 ## 侧边栏
 
 ### 主侧边栏

layouts/docs/list.html

@@ -15,7 +15,9 @@
           {{ .Content }}
         </div>
         {{ partial "components/last-updated.html" . }}
-        {{ partial "components/pager.html" . }}
+        {{- if (site.Params.page.displayPagination | default true) -}}
+          {{- partial "components/pager.html" . -}}
+        {{- end -}}
         {{ partial "components/comments.html" . }}
       </main>
     </article>

layouts/docs/single.html

@@ -15,7 +15,9 @@
           {{ .Content }}
         </div>
         {{ partial "components/last-updated.html" . }}
-        {{ partial "components/pager.html" . }}
+        {{- if (site.Params.page.displayPagination | default true) -}}
+          {{- partial "components/pager.html" . -}}
+        {{- end -}}
         {{ partial "components/comments.html" . }}
       </main>
     </article>