release: 3.27.0

fix: site config key paginate was deprecated

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -4,7 +4,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to fill out this bug report! Please provide as much information as possible and make sure you have checked the [documentation](https://stack.jimmycai.com/).
+        Thanks for taking the time to fill out this bug report! Please provide as much information as possible and make sure you have checked the [documentation](https://stack.jimmycai.com/guide/).
   - type: textarea
     id: what-happened
     attributes:

assets/scss/partials/article.scss

@@ -131,6 +131,7 @@
 .article-tags {
     display: flex;
     gap: 10px;
+    flex-wrap: wrap;
 
     a {
         color: var(--accent-color-text);

assets/scss/partials/layout/article.scss

@@ -67,7 +67,6 @@
             }
 
             .article-tags {
-                flex-wrap: wrap;
                 text-transform: unset;
             }
 
@@ -222,6 +221,28 @@
         margin-inline-start: calc((var(--card-padding)) * -1);
         padding-inline-start: calc(var(--card-padding) - var(--heading-border-size));
         border-inline-start: var(--heading-border-size) solid var(--accent-color);
+        position: relative;
+
+        a.header-anchor {
+            transition: opacity 0.3s ease;
+            opacity: 0;
+            position: absolute;
+            left: 0;
+            width: var(--card-padding);
+            text-align: center;
+            color: var(--accent-color);
+
+            &:before {
+                content: "#";
+            }
+        }
+
+        &:hover,
+        &:focus {
+            a.header-anchor {
+                opacity: 1;
+            }
+        }
     }
 
     figure {

assets/scss/partials/menu.scss

@@ -127,10 +127,8 @@
 }
 
 /* Menu style */
-.menu {
-    padding-left: 0;
+#main-menu {
     list-style: none;
-    flex-direction: column;
     overflow-y: auto;
     flex-grow: 1;
     font-size: 1.4rem;
@@ -141,13 +139,15 @@
     margin: 0 calc(var(--container-padding) * -1);
 
     padding: 30px 30px;
+
     @include respond(xl) {
         padding: 15px 0;
     }
 
-    &,
-    .menu-bottom-section {
+    &, .menu-bottom-section ol {
+        flex-direction: column;
         gap: 30px;
+
         @include respond(xl) {
             gap: 25px;
         }
@@ -200,17 +200,19 @@
                 font-weight: bold;
             }
         }
-    }
 
-    .menu-bottom-section {
+        &.menu-bottom-section {
             margin-top: auto;
+
+            ol {
                 display: flex;
-        flex-direction: column;
-        width: 100%;
+                padding-left: 0;
+            }
+        }
     }
 }
 
-.social-menu {
+.menu-social {
     list-style: none;
     padding: 0;
     margin: 0;

config.yaml

@@ -28,6 +28,7 @@ params:
             src: img/avatar.png
 
     article:
+        headingAnchor: false
         math: false
         toc: true
         readingTime: true
@@ -51,6 +52,12 @@ params:
             issueTerm: pathname
             label:
 
+        beaudar:
+            repo:
+            issueTerm: pathname
+            label:
+            theme:        
+
         remark42:
             host:
             site:
@@ -64,7 +71,7 @@ params:
             clientSecret:
             autoCreateIssue: false
 
-        # Waline client configuration see: https://waline.js.org/en/reference/client.html
+        # Waline client configuration see: https://waline.js.org/en/reference/client/props.html
         waline:
             serverURL:
             lang:
@@ -75,9 +82,9 @@ params:
             requiredMeta:
                 - nick
                 - mail
-            placeholder:
             locale:
                 admin: Admin
+                placeholder:
 
         twikoo:
             envId:

data/external.yaml

@@ -21,17 +21,17 @@ PhotoSwipe:
       type: style
 
 KaTeX:
-    - src: https://cdn.jsdelivr.net/npm/katex@0.15.6/dist/katex.min.css
-      integrity: sha256-J+iAE0sgH8QSz9hpcDxXIftnj65JEZgNhGcgReTTK9s=
+    - src: https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css
+      integrity: sha384-n8MVd4RsNIU0tAv4ct0nTaAbDJwPJzDEaqSD1odI+WdtXRGWt2kTvGFasHpSy3SV
       type: style
 
-    - src: https://cdn.jsdelivr.net/npm/katex@0.15.6/dist/katex.min.js
-      integrity: sha256-InsNdER1b2xUewP+pKCUJpkhiqwHgqiPXDlIk7GzBu4=
+    - src: https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.js
+      integrity: sha384-XjKyOOlGwcjNTAIQHIpgOno0Hl1YQqzUOEleOLALmuqehneUG+vnGctmUb0ZY0l8
       type: script
       defer: true
 
-    - src: https://cdn.jsdelivr.net/npm/katex@0.15.6/dist/contrib/auto-render.min.js
-      integrity: sha256-y39Mpg7V3D4lhBX4x6O0bUqTV4pSrfgwEfGKfxkOdgI=
+    - src: https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/contrib/auto-render.min.js
+      integrity: sha384-+VBxd3r6XgURycqtZ117nYw44OOcIax56Z4dCRWbxyPt0Koah1uHoK0o4+/RRE05
       type: script
       defer: true
 

exampleSite/README.md

@@ -1 +1,3 @@
-Example site modified from https://github.com/gohugoio/hugoBasicExample
+This is an example site used for solely for testing purposes. **It is not meant to be used as a template for your site**. 
+
+To create a new site, please use the starter template: [CaiJimmy/hugo-theme-stack-starter](https://github.com/CaiJimmy/hugo-theme-stack-starter/)

exampleSite/content/page/about/index.md

@@ -15,7 +15,7 @@ menu:
             icon: user
 ---
 
-Written in Go, Hugo is an open source static site generator available under the [Apache Licence 2.0.](https://github.com/gohugoio/hugo/blob/master/LICENSE) Hugo supports TOML, YAML and JSON data file types, Markdown and HTML content files and uses shortcodes to add rich content. Other notable features are taxonomies, multilingual mode, image processing, custom output formats, HTML/CSS/JS minification and support for Sass SCSS workflows.
+Written in Go, Hugo is an open source static site generator available under the [Apache License 2.0.](https://github.com/gohugoio/hugo/blob/master/LICENSE) Hugo supports TOML, YAML and JSON data file types, Markdown and HTML content files and uses shortcodes to add rich content. Other notable features are taxonomies, multilingual mode, image processing, custom output formats, HTML/CSS/JS minification and support for Sass SCSS workflows.
 
 Hugo makes use of a variety of open source projects including:
 
@@ -29,6 +29,6 @@ Hugo is ideal for blogs, corporate websites, creative portfolios, online magazin
 
 Hugo is for people who want to hand code their own website without worrying about setting up complicated runtimes, dependencies and databases.
 
-Websites built with Hugo are extremelly fast, secure and can be deployed anywhere including, AWS, GitHub Pages, Heroku, Netlify and any other hosting provider.
+Websites built with Hugo are extremely fast, secure and can be deployed anywhere including, AWS, GitHub Pages, Heroku, Netlify and any other hosting provider.
 
 Learn more and contribute on [GitHub](https://github.com/gohugoio).

exampleSite/content/post/math-typesetting/index.md

@@ -21,17 +21,17 @@ In this example we will be using [KaTeX](https://katex.org/)
 {{ end }}
 ```
 
-- To enable KaTex globally set the parameter `math` to `true` in a project's configuration
-- To enable KaTex on a per page basis include the parameter `math: true` in content files
+- To enable KaTeX globally set the parameter `math` to `true` in a project's configuration
+- To enable KaTeX on a per page basis include the parameter `math: true` in content files
 
 **Note:** Use the online reference of [Supported TeX Functions](https://katex.org/docs/supported.html)
 
 {{< math.inline >}}
 {{ if or .Page.Params.math .Site.Params.math }}
 <!-- KaTeX -->
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/katex.min.css" integrity="sha384-zB1R0rpPzHqg7Kpt0Aljp8JPLqbXI3bhnPWROx27a9N0Ll6ZP/+DiW/UqRcLbRjq" crossorigin="anonymous">
-<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/katex.min.js" integrity="sha384-y23I5Q6l+B6vatafAwxRu/0oK/79VlbSz7Q9aiSZUvyWYIYsd+qj+o24G5ZU2zJz" crossorigin="anonymous"></script>
-<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/contrib/auto-render.min.js" integrity="sha384-kWPLUVMOks5AQFrykwIup5lo0m3iMkkHrD0uJ4H5cjeGihAutqP0yW0J6dpFiVkI" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css" integrity="sha384-n8MVd4RsNIU0tAv4ct0nTaAbDJwPJzDEaqSD1odI+WdtXRGWt2kTvGFasHpSy3SV" crossorigin="anonymous">
+<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.js" integrity="sha384-XjKyOOlGwcjNTAIQHIpgOno0Hl1YQqzUOEleOLALmuqehneUG+vnGctmUb0ZY0l8" crossorigin="anonymous"></script>
+<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/contrib/auto-render.min.js" integrity="sha384-+VBxd3r6XgURycqtZ117nYw44OOcIax56Z4dCRWbxyPt0Koah1uHoK0o4+/RRE05" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script>
 {{ end }}
 {{</ math.inline >}}
 

exampleSite/hugo.yaml

@@ -1,10 +1,17 @@
-baseurl: https://example.com
+baseurl: https://example.com/
 languageCode: en-us
 theme: hugo-theme-stack
-paginate: 5
 title: Example Site
 copyright: Example Person
 
+# Theme i18n support
+# Available values: ar, bn, ca, de, el, en, es, fr, hu, id, it, ja, ko, nl, pt-br, th, uk, zh-cn, zh-hk, zh-tw
+DefaultContentLanguage: en
+
+# Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
+# This will make .Summary and .WordCount behave correctly for CJK languages.
+hasCJKLanguage: false
+
 languages:
     en:
         languageName: English
@@ -26,19 +33,16 @@ languages:
         params:
             description: وصف تجريبي
 
-# Change it to your Disqus shortname before using
-disqusShortname: hugo-theme-stack
+services:
+    # Change it to your Disqus shortname before using
+    disqus:
+        shortname: "hugo-theme-stack"
+    # GA Tracking ID
+    googleAnalytics:
+        id:
 
-# GA Tracking ID
-googleAnalytics:
-
-# Theme i18n support
-# Available values: ar, bn, ca, de, el, en, es, fr, hu, id, it, ja, ko, nl, pt-br, th, uk, zh-cn, zh-hk, zh-tw
-DefaultContentLanguage: en
-
-# Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
-# This will make .Summary and .WordCount behave correctly for CJK languages.
-hasCJKLanguage: false
+pagination:
+    pagerSize: 3
 
 permalinks:
     post: /p/:slug/
@@ -91,6 +95,12 @@ params:
             issueTerm: pathname
             label:
 
+        beaudar:
+            repo:
+            issueTerm: pathname
+            label:
+            theme:
+
         remark42:
             host:
             site:
@@ -148,6 +158,7 @@ params:
             repo:
             clientID:
             clientSecret:
+            proxy:
 
         cusdis:
             host:
@@ -195,7 +206,7 @@ params:
             enabled: true
 
 ### Custom menu
-### See https://docs.stack.jimmycai.com/configuration/custom-menu.html
+### See https://stack.jimmycai.com/config/menu
 ### To remove about, archive and search page menu item, remove `menu` field from their FrontMatter
 menu:
     main: []
@@ -226,6 +237,18 @@ related:
 
 markup:
     goldmark:
+        extensions:
+            passthrough:
+                enable: true
+                delimiters:
+                    block:
+                        - - \[
+                          - \]
+                        - - $$
+                          - $$
+                    inline:
+                        - - \(
+                          - \)
         renderer:
             ## Set to true if you have HTML content inside Markdown
             unsafe: true

i18n/be.yaml

@@ -0,0 +1,72 @@
+toggleMenu:
+    other: Паказаць/схаваць меню
+
+darkMode:
+    other: Цёмны рэжым
+
+list:
+    page:
+        one: "{{ .Count }} старонка"
+        few: "{{ .Count }} старонкі"
+        many: "{{ .Count }} старонак"
+        other: "{{ .Count }} старонкі"
+
+    section:
+        other: Раздзел
+
+    subsection:
+        one: Падраздзел
+        few: Падраздзелы
+        many: Падраздзелы
+        other: Падраздзелы
+
+article:
+    back:
+        other: Назад
+
+    relatedContent:
+        other: Таксама рэкамендуем
+
+    lastUpdatedOn:
+        other: Абноўлена
+
+    tableOfContents: 
+        other: Змест
+
+    readingTime: 
+        other: "Час чытання: {{ .Count }} хв."
+
+notFound:
+    title:
+        other: Не знойдзена
+
+    subtitle:
+        other: Запытваемая старонка не існуе
+
+widget:
+    archives:
+        title:
+            other: Архівы
+        more:
+            other: Яшчэ
+
+    tagCloud:
+        title:
+            other: Тэгі
+
+search:
+    title:
+        other: Пошук
+
+    placeholder:
+        other: Увядзіце нешта...
+
+    resultTitle:
+        other: "Знайдзена #PAGES_COUNT старонак (за #TIME_SECONDS с.)"
+
+footer:
+    builtWith:
+        other: Створана пры дапамозе {{ .Generator }}
+
+    designedBy:
+        other: Тэма {{ .Theme }}, дызайн {{ .DesignedBy }}

i18n/bg.yaml

@@ -0,0 +1,73 @@
+toggleMenu:
+    other: Покажи Меню
+
+darkMode:
+    other: Тъмен Режим
+
+list:
+    page:
+        one: "{{ .Count }} страница"
+        other: "{{ .Count }} страници"
+
+    section:
+        other: Секция
+
+    subsection:
+        one: Подсекция
+        other: Подсекции
+
+article:
+    back:
+        other: Назад
+
+    tableOfContents:
+        other: Съдържание
+
+    relatedContent:
+        other: Свързано Съдържание
+
+    lastUpdatedOn:
+        other: Последна промяна на
+
+    readingTime:
+        one: "{{ .Count }} minute read"
+        other: "{{ .Count }} minute read"
+
+notFound:
+    title:
+        other: Не е намерено
+
+    subtitle:
+        other: Страницата която търсите не е открита
+
+widget:
+    archives:
+        title:
+            other: Архиви
+
+        more:
+            other: Повече
+
+    tagCloud:
+        title:
+            other: Тагове
+    categoriesCloud:
+        title:
+            other: Категории
+
+search:
+    title:
+        other: Търсене
+
+    placeholder:
+        other: Напишете нещо...
+
+    resultTitle:
+        other: "#PAGES_COUNT страници (#TIME_SECONDS секунди)"
+
+footer:
+    builtWith:
+        other: Създадено с {{ .Generator }}
+
+    designedBy:
+        other: Тема {{ .Theme }} създадена от {{ .DesignedBy }}

i18n/es.yaml

@@ -1,5 +1,5 @@
 toggleMenu:
-    other: Toggle Menu
+    other: Ocultar menú
 
 darkMode:
     other: Modo oscuro
@@ -27,11 +27,11 @@ article:
         other: Contenidos relacionados
 
     lastUpdatedOn:
-        other: Última vez actualizado
+        other: Última actualización
 
     readingTime:
-        one: "{{ .Count }} minuto a leer"
-        other: "{{ .Count }} minutos a leer"
+        one: "Tiempo de lectura {{ .Count }} minuto"
+        other: "Tiempo de lectura {{ .Count }} minutos"
 
 notFound:
     title:
@@ -60,7 +60,7 @@ search:
         other: Búsqueda
 
     placeholder:
-        other: Teclea algo...
+        other: Escribe algo...
 
     resultTitle:
         other: "#PAGES_COUNT páginas en (#TIME_SECONDS segundos)"

i18n/hi.yaml

@@ -0,0 +1,73 @@
+toggleMenu:
+  other: मेनू टॉगल करें
+
+darkMode:
+  other: डार्क मोड
+
+list:
+  page:
+    one: "{{ .Count }} पेज"
+    other: "{{ .Count }} पेज"
+
+  section:
+    other: अनुभाग
+
+  subsection:
+    one: उपधारा
+    other: उपखंड
+
+article:
+  back:
+    other: पीछे
+
+  tableOfContents:
+    other: विषयसूची
+
+  relatedContent:
+    other: संबंधित सामग्री
+
+  lastUpdatedOn:
+    other: अंतिम बार अपडेट किया गया
+
+  readingTime:
+    one: "{{ .Count }} मिनट पढ़ें"
+    other: "{{ .Count }} मिनट पढ़ें"
+
+notFound:
+  title:
+    other: 404 नहीं मिला।
+
+  subtitle:
+    other: यह पृष्ठ मौजूद नहीं है।
+
+widget:
+  archives:
+    title:
+      other: अभिलेखागार
+
+    more:
+      other: अधिक
+
+  tagCloud:
+    title:
+      other: टैग
+  categoriesCloud:
+    title:
+      other: श्रेणियाँ
+
+search:
+  title:
+    other: खोज
+
+  placeholder:
+    other: कुछ लिखें...
+
+  resultTitle:
+    other: "#PAGES_COUNT पेज (#TIME_SECONDS सेकंड)"
+
+footer:
+  builtWith:
+    other: निर्मित {{ .Generator }} के साथ
+
+  designedBy:
+    other: थीम {{ .Theme }} द्वारा डिज़ाइन किया गया {{ .DesignedBy }}

i18n/ja.yaml

@@ -4,6 +4,16 @@ toggleMenu:
 darkMode:
     other: ダークモード
 
+list:
+    page:
+        other: "{{ .Count }} ページ目"
+
+    section:
+        other: セクション
+
+    subsection:
+        other: サブセクション
+
 article:
     back:
         other: 前のページ
@@ -54,7 +64,7 @@ search:
 
 footer:
     builtWith:
-        other: Built with {{ .Generator }}
+        other: "{{ .Generator }} で構築されています。"
 
     designedBy:
         other: テーマ {{ .Theme }} は {{ .DesignedBy }} によって設計されています。

i18n/oc.yaml

@@ -0,0 +1,72 @@
+toggleMenu:
+    other: Alternar menú
+
+darkMode:
+    other: Mòde fosc
+
+list:
+    page:
+        one: "{{ .Count }} pagina"
+        other: "{{ .Count }} paginas"
+
+    section:
+        other: Seccion
+
+    subsection:
+        one: Josseccion
+        other: Josseccions
+
+article:
+    back:
+        other: Tornar
+
+    tableOfContents:
+        other: Taula de contengut
+
+    relatedContent:
+        other: Contenguts relacionats
+
+    lastUpdatedOn:
+        other: Darrièra actualizacion
+    readingTime:
+        one: "{{ .Count }} minuta de lectura"
+        other: "{{ .Count }} minutas de lectura"
+
+notFound:
+    title:
+        other: Non trobat
+
+    subtitle:
+        other: Aquesta pagina existís pas
+
+widget:
+    archives:
+        title:
+            other: Archiu
+
+        more:
+            other: Mai
+
+    tagCloud:
+        title:
+            other: Etiquetas
+    categoriesCloud:
+        title:
+            other: Categorias
+
+search:
+    title:
+        other: Cercar
+
+    placeholder:
+        other: Picatz quicòm...
+
+    resultTitle:
+        other: "#PAGES_COUNT paginas dins (#TIME_SECONDS segons)"
+
+footer:
+    builtWith:
+        other: Creat amb {{ .Generator }}
+
+    designedBy:
+        other: Tàma {{ .Theme }} concebut per {{ .DesignedBy }}

i18n/sk.yaml

@@ -0,0 +1,71 @@
+toggleMenu:
+    other: Skryť menu
+
+darkMode:
+    other: Tmavý režim
+
+list:
+    page:
+        one: "{{ .Count }} stránka"
+        other: "{{ .Count }} stránok"
+
+    section:
+        other: Kategórie
+
+    subsection:
+        one: Podkategória
+        other: Podkategórie
+
+article:
+    back:
+        other: Späť
+
+    tableOfContents:
+        other: Obsah
+
+    relatedContent:
+        other: Súvisiace
+
+    lastUpdatedOn:
+        other: Naposledy aktualizované
+
+    readingTime:
+        one: "{{ .Count }} minúta"
+        other: "{{ .Count }} minút"
+
+notFound:
+    title:
+        other: Nenájdené
+
+    subtitle:
+        other: Tato stránka neexistuje
+
+widget:
+    archives:
+        title:
+            other: Archívy
+        more:
+            other: Viac
+    tagCloud:
+        title:
+            other: Štítky
+    categoriesCloud:
+        title:
+            other: Kategórie
+
+search:
+    title:
+        other: Hladať
+
+    placeholder:
+        other: Zadajte niečo...
+
+    resultTitle:
+        other: "#PAGES_COUNT stránok (#TIME_SECONDS sekúnd)"
+
+footer:
+    builtWith:
+        other: Vytvorené pomocou {{ .Generator }}
+
+    designedBy:
+        other: Šablóna {{ .Theme }} od {{ .DesignedBy }}

i18n/zh-cn.yaml

@@ -4,6 +4,13 @@ toggleMenu:
 darkMode:
     other: 暗色模式
 
+list:
+    page: "{{ .Count }} 个页面"
+
+    section: 章节
+
+    subsection: 子章节
+
 article:
     back:
         other: 返回
@@ -54,7 +61,7 @@ search:
 
 footer:
     builtWith:
-        other: Built with {{ .Generator }}
+        other: 使用 {{ .Generator }} 构建
 
     designedBy:
         other: 主题 {{ .Theme }} 由 {{ .DesignedBy }} 设计

layouts/_default/_markup/render-heading.html

@@ -0,0 +1,6 @@
+<h{{ .Level }} id="{{ .Anchor }}">
+    {{- if site.Params.Article.HeadingAnchor -}}
+        <a href="#{{ .Anchor }}" class="header-anchor"></a>
+    {{- end -}}
+    {{ .Text | safeHTML }}
+</h{{ .Level }}>

layouts/_default/rss.xml

@@ -18,11 +18,11 @@
         <link>{{ .Permalink }}</link>
         <description>Recent content {{ if ne  .Title  .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}</description>
         <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }}
-        <language>{{.}}</language>{{end}}{{ with .Site.Author.email }}
-        <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }}
-        <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
+        <language>{{.}}</language>{{end}}{{ with .Site.Params.Author.email }}
+        <managingEditor>{{.}}{{ with $.Site.Params.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Params.Author.email }}
+        <webMaster>{{.}}{{ with $.Site.Params.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
         <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }}
-        <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
+        <lastBuildDate>{{ (index $pages.ByLastmod.Reverse 0).Lastmod.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
         {{- with .OutputFormats.Get "RSS" -}}
         {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
         {{- end -}}
@@ -35,7 +35,7 @@
         <title>{{ .Title }}</title>
         <link>{{ .Permalink }}</link>
         <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
-        {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}}
+        {{ with .Site.Params.Author.email }}<author>{{.}}{{ with $.Site.Params.Author.name }} ({{.}}){{end}}</author>{{end}}
         <guid>{{ .Permalink }}</guid>
         <description>
             {{- $image := partial "helper/image" (dict "Context" . "Type" "rss") -}}

layouts/partials/article/components/details.html

@@ -32,7 +32,7 @@
             <div>
                 {{ partial "helper/icon" "date" }}
                 <time class="article-time--published">
-                    {{- .Date.Format (or .Site.Params.dateFormat.published "Jan 02, 2006") -}}
+                    {{- .Date | time.Format (or .Site.Params.dateFormat.published "Jan 02, 2006") -}}
                 </time>
             </div>
         {{ end }}

layouts/partials/article/components/footer.html

@@ -12,7 +12,7 @@
     <section class="article-lastmod">
         {{ partial "helper/icon" "clock" }}
         <span>
-            {{ T "article.lastUpdatedOn" }} {{ .Lastmod.Format ( or .Site.Params.dateFormat.lastUpdated "Jan 02, 2006 15:04 MST" ) }}
+            {{ T "article.lastUpdatedOn" }} {{ .Lastmod | time.Format ( or .Site.Params.dateFormat.lastUpdated "Jan 02, 2006 15:04 MST" ) }}
         </span>
     </section>
     {{- end -}}

layouts/partials/article/components/links.html

@@ -16,8 +16,12 @@
                 </div>
         
                 {{ with $link.image }}
+                    {{ $permalink := . }}
+                    {{ with ($.Resources.GetMatch (printf "%s" (. | safeURL))) }}
+                        {{ $permalink = .RelPermalink }}
+                    {{ end }}
                     <div class="article-image">
-                        <img src="{{ . }}" loading="lazy">
+                        <img src="{{ $permalink }}" loading="lazy">
                     </div>
                 {{ end }}
             </a>

layouts/partials/article/components/math.html

@@ -1,7 +1,7 @@
 {{- partial "helper/external" (dict "Context" . "Namespace" "KaTeX") -}}
 <script>
     window.addEventListener("DOMContentLoaded", () => {
-        renderMathInElement(document.querySelector(`.article-content`), {
+        renderMathInElement(document.body, {
             delimiters: [
                 { left: "$$", right: "$$", display: true },
                 { left: "$", right: "$", display: false },

layouts/partials/comments/provider/beaudar.html

@@ -0,0 +1,46 @@
+<script
+  src="https://beaudar.lipk.org/client.js"
+  repo="{{ .Site.Params.comments.beaudar.repo }}"
+  issue-term="{{ .Site.Params.comments.beaudar.issueTerm }}"
+  {{ with .Site.Params.comments.beaudar.label }}
+  label="{{ . }}"
+  {{ end }}
+  theme="{{ .Site.Params.comments.beaudar.theme }}"
+  crossorigin="anonymous"
+  async
+></script>
+
+<style>
+  .beaudar {
+    max-width: unset;
+  }
+</style>
+
+<script>
+  let beaudarLoaded = false;
+
+  function setBeaudarTheme(theme) {
+    let beaudar = document.querySelector(".beaudar iframe");
+    if (beaudar) {
+      beaudar.contentWindow.postMessage(
+        {
+          type: "set-theme",
+          theme: `github-${theme}`,
+        },
+        "https://beaudar.lipk.org"
+      );
+    }
+  }
+
+  addEventListener("message", (event) => {
+    if (event.origin !== "https://beaudar.lipk.org") return;
+    /// Called when Beaudar is ready
+    beaudarLoaded = true;
+    setBeaudarTheme(document.documentElement.dataset.scheme);
+  });
+
+  window.addEventListener("onColorSchemeChange", (e) => {
+    if (!beaudarLoaded) return;
+    setBeaudarTheme(e.detail);
+  });
+</script>

layouts/partials/comments/provider/disqusjs.html

@@ -2,7 +2,7 @@
 {{- $disqusjs := .Site.Params.Comments.disqusjs -}}
 {{- if and (not $pc.Disable) (and $disqusjs.Shortname $disqusjs.ApiKey) -}}
 
-{{- $style := resources.Get "scss/partials/comments/disqusjs.scss" | resources.ToCSS | minify -}}
+{{- $style := resources.Get "scss/partials/comments/disqusjs.scss" | toCSS | minify -}}
 <link rel="stylesheet" href="{{ $style.RelPermalink }}">
 
 <div class="disqus-container">

layouts/partials/comments/provider/gitalk.html

@@ -15,6 +15,7 @@
         admin: ["{{- .admin -}}"],
         distractionFreeMode: false, // Facebook-like distraction free mode
         id: md5(location.pathname), // Max Location.pathname Legth:75  https://github.com/gitalk/gitalk/issues/102
+        proxy: {{- .proxy -}},
     });
     (function () {
         if (

layouts/partials/comments/provider/twikoo.html

@@ -1,4 +1,4 @@
-<script src="//cdn.jsdelivr.net/npm/twikoo@1.6.11/dist/twikoo.all.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/twikoo@1.6.39/dist/twikoo.all.min.js"></script>
 <div id="tcomment"></div>
 <style>
     .twikoo {
@@ -13,7 +13,9 @@
     }
     .twikoo .el-input-group__prepend,
     .twikoo .tk-action-icon,
+    .twikoo .tk-submit-action-icon,
     .twikoo .tk-time,
+    .twikoo .tk-comments-no,
     .twikoo .tk-comments-count {
         color: var(--twikoo-body-text-color);
     }
@@ -28,6 +30,9 @@
     .twikoo .el-button{
         color: var(--twikoo-body-text-color)!important;
     }
+    .twikoo .el-input__count {
+        color: var(--twikoo-body-text-color) !important;
+    }
     .OwO .OwO-body {
         background-color: var(--body-background) !important;
         color: var(--body-text-color) !important;

layouts/partials/data/description.html

@@ -14,4 +14,4 @@
     {{ $description = .Summary }}
 {{ end }}
 
-{{ return ($description | plainify)}}
+{{ return (replaceRE "\n" " " $description | plainify) }}

layouts/partials/footer/footer.html

@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.20.0" -}}
+{{- $ThemeVersion := "3.27.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

layouts/partials/head/head.html

@@ -2,10 +2,10 @@
 <meta name='viewport' content='width=device-width, initial-scale=1'>
 
 {{- $description := partialCached "data/description" . .RelPermalink -}}
-<meta name='description' content='{{ $description }}'>
+<meta name='description' {{ printf "content=%q" $description | safeHTMLAttr }}>
 {{ with .Params.Keywords }}<meta name="keywords" content="{{ delimit . ", " }}">{{ end }}
 
-{{- $title := partialCached "data/title" . .RelPermalink -}}
+{{- $title := partial "data/title" . -}}
 <title>{{ $title }}</title>
 
 <link rel='canonical' href='{{ .Permalink }}'>
@@ -19,7 +19,7 @@
 {{- end -}}
 
 {{ with .Site.Params.favicon }}
-    <link rel="shortcut icon" href="{{ . }}" />
+    <link rel="shortcut icon" href="{{ . | relURL }}" />
 {{ end }}
 
 {{- template "_internal/google_analytics.html" . -}}

layouts/partials/head/opengraph/provider/base.html

@@ -1,8 +1,8 @@
 {{- $title := partialCached "data/title" . .RelPermalink -}}
 {{- $description := partialCached "data/description" . .RelPermalink -}}
 
-<meta property='og:title' content='{{ $title }}'>
-<meta property='og:description' content='{{ $description }}'>
+<meta property='og:title' {{ printf "content=%q" $title | safeHTMLAttr }}>
+<meta property='og:description' {{ printf "content=%q" $description | safeHTMLAttr }}>
 <meta property='og:url' content='{{ .Permalink }}'>
 <meta property='og:site_name' content='{{ .Site.Title }}'>
 <meta property='og:type' content='
@@ -32,8 +32,8 @@
         <meta property='article:modified_time' content='{{ .Lastmod.Format "2006-01-02T15:04:05-07:00" | safeHTML }}'/>
     {{- end -}}
 {{- else -}}
-    {{- if not .Site.LastChange.IsZero -}}
-        <meta property='og:updated_time' content='{{ .Site.LastChange.Format " 2006-01-02T15:04:05-07:00 " | safeHTML }}'/>
+    {{- if not .Site.Lastmod.IsZero -}}
+        <meta property='og:updated_time' content='{{ .Site.Lastmod.Format " 2006-01-02T15:04:05-07:00 " | safeHTML }}'/>
     {{- end -}}
 {{- end -}}
 

layouts/partials/head/opengraph/provider/twitter.html

@@ -6,8 +6,8 @@
 {{- $title := partialCached "data/title" . .RelPermalink -}}
 {{- $description := partialCached "data/description" . .RelPermalink -}}
 
-<meta name="twitter:title" content="{{ $title }}">
-<meta name="twitter:description" content="{{ $description }}">
+<meta name="twitter:title" {{ printf "content=%q" $title | safeHTMLAttr }}>
+<meta name="twitter:description" {{ printf "content=%q" $description | safeHTMLAttr }}>
 
 {{- $image := partialCached "helper/image" (dict "Context" . "Type" "opengraph") .RelPermalink "opengraph" -}}
 {{- if $image.exists -}}

layouts/partials/head/style.html

@@ -1,3 +1,3 @@
 {{ $sass := resources.Get "scss/style.scss" }}
-{{ $style := $sass | resources.ToCSS | minify | resources.Fingerprint "sha256" }}
+{{ $style := $sass | toCSS | minify | resources.Fingerprint "sha256" }}
 <link rel="stylesheet" href="{{ $style.RelPermalink }}">

layouts/partials/sidebar/left.html

@@ -38,7 +38,7 @@
     </header>
 
     {{- with .Site.Menus.social -}}
-        <ol class="social-menu">
+        <ol class="menu-social">
             {{ range . }}
                 <li>
                     <a 
@@ -65,7 +65,7 @@
             <a href='{{ .URL }}' {{ if eq .Params.newTab true }}target="_blank"{{ end }}>
                 {{ $icon := default .Pre .Params.Icon }}
                 {{ if .Pre }}
-                    {{ warnf "Menu item [%s] is using [pre] field to set icon, please use [params.icon] instead.\nMore information: https://docs.stack.jimmycai.com/configuration/custom-menu.html" .URL }}
+                    {{ warnf "Menu item [%s] is using [pre] field to set icon, please use [params.icon] instead.\nMore information: https://stack.jimmycai.com/config/menu" .URL }}
                 {{ end }}
                 {{ with $icon }}
                     {{ partial "helper/icon" . }}
@@ -74,19 +74,21 @@
             </a>
         </li>
         {{ end }}
-
-        <div class="menu-bottom-section">
+        <li class="menu-bottom-section">
+            <ol class="menu">
                 {{- $currentLanguageCode := .Language.Lang -}}
+                {{ if ( compare.Gt .Site.Home.AllTranslations.Len 1 ) }}
                     {{ with .Site.Home.AllTranslations }}
                         <li id="i18n-switch">  
                             {{ partial "helper/icon" "language" }}
-                    <select name="language" onchange="window.location.href = this.selectedOptions[0].value">
+                            <select name="language" title="language" onchange="window.location.href = this.selectedOptions[0].value">
                                 {{ range . }}
                                     <option value="{{ .Permalink }}" {{ if eq .Language.Lang $currentLanguageCode }}selected{{ end }}>{{ .Language.LanguageName }}</option>
                                 {{ end }}
                             </select>
                         </li>
                     {{ end }}
+                {{ end }}
 
                 {{ if (default false .Site.Params.colorScheme.toggle) }}
                     <li id="dark-mode-toggle">
@@ -95,6 +97,7 @@
                         <span>{{ T "darkMode" }}</span>
                     </li>
                 {{ end }}
-        </div>
+            </ol>
+        </li>
     </ol>
 </aside>

layouts/partials/sidebar/right.html

@@ -4,7 +4,10 @@
     <aside class="sidebar right-sidebar sticky">
         {{ range $widget := . }}
             {{ if templates.Exists (printf "partials/widget/%s.html" .type) }}
-                {{ partial (printf "widget/%s" .type) (dict "Context" $context "Params" .params) }}
+                <!-- Ensure that the `params` is not nil -->
+                {{- $params := default dict .params -}}
+
+                {{ partial (printf "widget/%s" .type) (dict "Context" $context "Params" $params) }}
             {{ else }}
                 {{ warnf "Widget %s not found" .type }}
             {{ end }}

netlify.toml

@@ -2,7 +2,7 @@
     publish = "exampleSite/public"
 
 [build.environment]
-    HUGO_VERSION = "0.117.0"
+    HUGO_VERSION = "0.124.0"
     HUGO_THEME = "repo"
 
 [context.production]

theme.toml

@@ -20,7 +20,7 @@ features = [
     "search",
 ]
 
-min_version = "0.87.0"
+min_version = "0.123.0"
 
 [author]
 name = "Jimmy Cai"