From 99478576c0fa2e45ef4c55e1d8d4cb6a8f009d29 Mon Sep 17 00:00:00 2001
From: Razon Yang <razonyang@gmail.com>
Date: Sat, 2 Dec 2023 14:05:58 +0800
Subject: [PATCH] feat: add the numberifyHeadings page parameter (#1011)

---
 .../content/docs/configuration/page-params/index.md |  1 +
 .../docs/configuration/page-params/index.zh-hans.md |  1 +
 .../docs/configuration/page-params/index.zh-hant.md |  1 +
 layouts/_default/_markup/render-heading.html        | 13 ++++++++++++-
 4 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/exampleSite/content/docs/configuration/page-params/index.md b/exampleSite/content/docs/configuration/page-params/index.md
index 506c98f1b..8e793594b 100644
--- a/exampleSite/content/docs/configuration/page-params/index.md
+++ b/exampleSite/content/docs/configuration/page-params/index.md
@@ -57,3 +57,4 @@ Page parameters are located in page's [Front Matter](https://gohugo.io/content-m
 | `recentPostCount` | Integer/Boolean | `5` | The number of recent posts shown in sidebar. Turn off by setting it to `false`.
 | `relatedPostCount` | Integer/Boolean | `5` | The number of related posts. Turn off by setting it to `false`.
 | `featuredImageAlt` | String | - | The alternative text for featured images, fallback to page title if not present.
+| `numberifyHeadings` | Boolean | `true` | When `false`, headings won't be numebrified.
diff --git a/exampleSite/content/docs/configuration/page-params/index.zh-hans.md b/exampleSite/content/docs/configuration/page-params/index.zh-hans.md
index 2ffced9b2..498404ab8 100644
--- a/exampleSite/content/docs/configuration/page-params/index.zh-hans.md
+++ b/exampleSite/content/docs/configuration/page-params/index.zh-hans.md
@@ -56,3 +56,4 @@ authors = ["RazonYang"]
 | `recentPostCount` | Integer/Boolean | `5` | 最近文章数，`false` 则隐藏。
 | `relatedPostCount` | Integer/Boolean | `5` | 相关文章数，`false` 则隐藏。
 | `featuredImageAlt` | String | - | 封面的可选文本，若未指定则使用页面标题。
+| `numberifyHeadings` | Boolean | `true` | 为 `false` 时，不对标题进行编号。
diff --git a/exampleSite/content/docs/configuration/page-params/index.zh-hant.md b/exampleSite/content/docs/configuration/page-params/index.zh-hant.md
index 7bbffdfd9..8a6c10b49 100644
--- a/exampleSite/content/docs/configuration/page-params/index.zh-hant.md
+++ b/exampleSite/content/docs/configuration/page-params/index.zh-hant.md
@@ -56,3 +56,4 @@ authors = ["RazonYang"]
 | `recentPostCount` | Integer/Boolean | `5` | 最近文章數，`false` 則隱藏。
 | `relatedPostCount` | Integer/Boolean | `5` | 相關文章數，`false` 則隱藏。
 | `featuredImageAlt` | String | - | 封面的可選文字，若未指定則使用頁面標題。
+| `numberifyHeadings` | Boolean | `true` | 為 `false` 時，不對標題進行編號。
diff --git a/layouts/_default/_markup/render-heading.html b/layouts/_default/_markup/render-heading.html
index a1f2dfbb5..eba3dd454 100644
--- a/layouts/_default/_markup/render-heading.html
+++ b/layouts/_default/_markup/render-heading.html
@@ -1,2 +1,13 @@
 {{- $anchor := printf "<a class=\"anchor ms-1\" href=\"#%s\"></a>" .Anchor | safeHTML -}}
-{{ printf "<h%d id=\"%s\" data-numberify>%s%s</h%d>" .Level .Anchor .PlainText $anchor .Level | safeHTML }}
+{{- $numberifyHeadings := true }}
+{{- if isset .Page.Params "numberifyheadings" }}
+  {{- $numberifyHeadings = .Page.Params.numberifyHeadings }}
+{{- end }}
+{{ printf "<h%d id=\"%s\"%s>%s%s</h%d>"
+  .Level
+  .Anchor
+  (cond $numberifyHeadings ` data-numberify` ``)
+  .PlainText
+  $anchor
+  .Level | safeHTML
+}}