From 5693c4bf7a197936dcf8267409b23aef462df029 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 3 Sep 2021 19:05:10 +0200
Subject: [PATCH 01/79] doc: add `markup.goldmark.renderer.unsafe` option in
 `config.yaml`

---
 exampleSite/config.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 37e9f97..9c17e9d 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -176,6 +176,10 @@ related:
           weight: 200
 
 markup:
+    goldmark:
+        renderer:
+            ## Set to true if you have HTML content inside Markdown
+            unsafe: false
     tableOfContents:
         endLevel: 4
         ordered: true

From 00c8616931ae16fa499bd07e3a93dd7f6028000f Mon Sep 17 00:00:00 2001
From: Christopher John Jackson <hello@cj-jackson.com>
Date: Fri, 17 Sep 2021 20:29:19 +0100
Subject: [PATCH 02/79] fix(article/comments): accept boolean `true` in
 `.Params.comments` (#352)

---
 layouts/_default/single.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/layouts/_default/single.html b/layouts/_default/single.html
index 040b547..902fa98 100644
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -17,7 +17,7 @@
 
     {{ partial "article/components/related-contents" . }}
      
-    {{ if or (not (isset .Params "comments")) (eq .Params.comments "true")}} 
+    {{ if not (eq .Params.comments false) }}
         {{ partial "comments/include" . }}
     {{ end }}
 
@@ -54,4 +54,4 @@
             </section>
         </aside>
     {{ end }}
-{{ end }}
\ No newline at end of file
+{{ end }}

From 66bd8a299798b53c78fa4b6b65c5c7256485a029 Mon Sep 17 00:00:00 2001
From: Cookiekira <42908926+Cookiekira@users.noreply.github.com>
Date: Sat, 18 Sep 2021 16:03:08 +0800
Subject: [PATCH 03/79] feat(comments): add Gitalk support (#351)

---
 exampleSite/config.yaml                       |  7 +++++
 .../partials/comments/provider/gitalk.html    | 30 +++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 layouts/partials/comments/provider/gitalk.html

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 9c17e9d..8139fa4 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -111,6 +111,13 @@ params:
             reactionsEnabled: 1
             emitMetadata: 0
 
+        gitalk:
+            owner: 
+            admin:  
+            repo: 
+            clientID: 
+            clientSecret: 
+
     widgets:
         enabled:
             - search
diff --git a/layouts/partials/comments/provider/gitalk.html b/layouts/partials/comments/provider/gitalk.html
new file mode 100644
index 0000000..95ca133
--- /dev/null
+++ b/layouts/partials/comments/provider/gitalk.html
@@ -0,0 +1,30 @@
+{{- with .Site.Params.comments.gitalk -}}
+<div id="gitalk-container"></div>
+<link
+    rel="stylesheet"
+    href="https://cdn.jsdelivr.net/npm/gitalk@1.7.2/dist/gitalk.css"
+/>
+<script src="https://cdn.jsdelivr.net/npm/gitalk@1.7.2/dist/gitalk.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/blueimp-md5@2.18.0/js/md5.min.js"></script>
+<script>
+    const gitalk = new Gitalk({
+        clientID: "{{- .clientID -}}",
+        clientSecret: "{{- .clientSecret -}}",
+        repo: "{{- .repo -}}",
+        owner: "{{- .owner -}}",
+        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
+    });
+    (function () {
+        if (
+            ["localhost", "127.0.0.1"].indexOf(window.location.hostname) != -1
+        ) {
+            document.getElementById("gitalk-container").innerHTML =
+                "Gitalk comments not available by default when the website is previewed locally.";
+            return;
+        }
+        gitalk.render("gitalk-container");
+    })();
+</script>
+{{ end }}

From 7845f5dfe73b60e725182bc83fb7800d921e100b Mon Sep 17 00:00:00 2001
From: QIN2DIM <62018067+QIN2DIM@users.noreply.github.com>
Date: Sat, 25 Sep 2021 02:22:58 +0800
Subject: [PATCH 04/79] feat(config): add `hasCJKLanguage` parameter (#360)

---
 exampleSite/config.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 8139fa4..7b89960 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -14,6 +14,10 @@ googleAnalytics:
 # Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl, it
 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
+
 permalinks:
     post: /p/:slug/
     page: /:slug/

From 57bfea833850e0565cf81d9a26c52359427151a2 Mon Sep 17 00:00:00 2001
From: zhixuan <59254886+zhixuan2333@users.noreply.github.com>
Date: Sat, 25 Sep 2021 03:32:53 +0900
Subject: [PATCH 05/79] fix(shortcodes): mixed content error with bilibili and
 tencent video (#365)

---
 exampleSite/content/post/rich-content/index.md | 4 ++++
 layouts/shortcodes/bilibili.html               | 2 +-
 layouts/shortcodes/tencent.html                | 2 +-
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/exampleSite/content/post/rich-content/index.md b/exampleSite/content/post/rich-content/index.md
index 407c539..af8a390 100644
--- a/exampleSite/content/post/rich-content/index.md
+++ b/exampleSite/content/post/rich-content/index.md
@@ -32,3 +32,7 @@ Hugo ships with several [Built-in Shortcodes](https://gohugo.io/content-manageme
 ## Vimeo Simple Shortcode
 
 {{< vimeo_simple 48912912 >}}
+
+## bilibilibi Shortcode
+
+{{< bilibili av498363026 >}}
diff --git a/layouts/shortcodes/bilibili.html b/layouts/shortcodes/bilibili.html
index 602406c..cb72e43 100644
--- a/layouts/shortcodes/bilibili.html
+++ b/layouts/shortcodes/bilibili.html
@@ -13,7 +13,7 @@
 {{ end }}
 
 <div class="video-wrapper">
-    <iframe src="//player.bilibili.com/player.html?{{ $basicQuery | safeURL }}&{{ $videoQuery | safeURL }}"
+    <iframe src="https://player.bilibili.com/player.html?{{ $basicQuery | safeURL }}&{{ $videoQuery | safeURL }}"
             scrolling="no"
             frameborder="no"
             framespacing="0"
diff --git a/layouts/shortcodes/tencent.html b/layouts/shortcodes/tencent.html
index baf5f3c..463dec5 100644
--- a/layouts/shortcodes/tencent.html
+++ b/layouts/shortcodes/tencent.html
@@ -1,6 +1,6 @@
 {{ $vid := .Get 0 }}
 <div class="video-wrapper">
-    <iframe src="http://v.qq.com/txp/iframe/player.html?vid={{ $vid }}&auto=0" 
+    <iframe src="https://v.qq.com/txp/iframe/player.html?vid={{ $vid }}&auto=0" 
             scrolling="no" 
             frameborder="no"
             framespacing="0" 

From d8c9468c685f38476b241f82130a6ae59e28ad05 Mon Sep 17 00:00:00 2001
From: WingLim <643089849@qq.com>
Date: Fri, 1 Oct 2021 22:38:37 +0800
Subject: [PATCH 06/79] feat(comments): add Cusdis support (#372)

* feat: add cusdis support

* docs: add cusdis example config
---
 exampleSite/config.yaml                       |  4 ++++
 .../partials/comments/provider/cusdis.html    | 24 +++++++++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 layouts/partials/comments/provider/cusdis.html

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 7b89960..dcf6c63 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -121,6 +121,10 @@ params:
             repo: 
             clientID: 
             clientSecret: 
+        
+        cusdis:
+            host: 
+            id: 
 
     widgets:
         enabled:
diff --git a/layouts/partials/comments/provider/cusdis.html b/layouts/partials/comments/provider/cusdis.html
new file mode 100644
index 0000000..71863f3
--- /dev/null
+++ b/layouts/partials/comments/provider/cusdis.html
@@ -0,0 +1,24 @@
+<div id="cusdis_thread"
+    {{ if .Site.Params.comments.cusdis.host }}
+    data-host="{{ .Site.Params.comments.cusdis.host }}"
+    {{ else }}
+    data-host="https://cusdis.com"
+    {{ end }}
+    data-app-id="{{ .Site.Params.comments.cusdis.id }}"
+    data-page-id="{{ .File.UniqueID }}"
+    data-page-url="{{ .Permalink }}"
+    data-page-title="{{ .Title }}"></div>
+<script async defer src="https://cusdis.com/js/cusdis.es.js"></script>
+
+<script>
+    function setCusdisTheme(theme) {
+        let cusdis = document.querySelector('#cusdis_thread iframe');
+        if (cusdis) {
+            window.CUSDIS.setTheme(theme)
+        }
+    }
+
+    window.addEventListener('onColorSchemeChange', (e) => {
+        setCusdisTheme(e.detail)
+    })
+</script>
\ No newline at end of file

From 9859ea3f8bc35bcb4fa687f49ec521865f104f05 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 16 Oct 2021 09:53:44 +0200
Subject: [PATCH 07/79] feat: add theme config.yaml (#393)

Add Hugo version requirement
---
 config.yaml | 4 ++++
 theme.toml  | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)
 create mode 100644 config.yaml

diff --git a/config.yaml b/config.yaml
new file mode 100644
index 0000000..a192dac
--- /dev/null
+++ b/config.yaml
@@ -0,0 +1,4 @@
+module:
+    hugoVersion:
+        extended: true
+        min: "0.87.0"
diff --git a/theme.toml b/theme.toml
index 2b9b841..a1a3d74 100644
--- a/theme.toml
+++ b/theme.toml
@@ -20,7 +20,7 @@ features = [
     "search",
 ]
 
-min_version = "0.78.0"
+min_version = "0.87.0"
 
 [author]
 name = "Jimmy Cai"

From b3088be62dce87c2f6663700a2689ee308ce729b Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 16 Oct 2021 10:14:06 +0200
Subject: [PATCH 08/79] feat: add default parameters to config.yaml (#394)

This will avoid those ugly errors caused by forgetting to copy exampleSite/config.yaml to the site folder
---
 config.yaml | 143 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 143 insertions(+)

diff --git a/config.yaml b/config.yaml
index a192dac..0e5283c 100644
--- a/config.yaml
+++ b/config.yaml
@@ -2,3 +2,146 @@ module:
     hugoVersion:
         extended: true
         min: "0.87.0"
+
+params:
+    mainSections:
+        - post
+    featuredImageField: image
+    rssFullContent: true
+    favicon:
+
+    footer:
+        since:
+        customText:
+
+    dateFormat:
+        published: Jan 02, 2006
+        lastUpdated: Jan 02, 2006 15:04 MST
+
+    sidebar:
+        emoji:
+        subtitle:
+        avatar:
+            enabled: true
+            local: true
+            src: img/avatar.png
+
+    article:
+        math: false
+        toc: true
+        readingTime: true
+        license:
+            enabled: false
+            default: Licensed under CC BY-NC-SA 4.0
+
+    comments:
+        enabled: false
+        provider: disqus
+
+        disqusjs:
+            shortname:
+            apiUrl:
+            apiKey:
+            admin:
+            adminLabel:
+
+        utterances:
+            repo:
+            issueTerm: pathname
+            label:
+
+        remark42:
+            host:
+            site:
+            locale:
+
+        vssue:
+            platform:
+            owner:
+            repo:
+            clientId:
+            clientSecret:
+            autoCreateIssue: false
+
+        # Waline client configuration see: https://waline.js.org/en/reference/client.html
+        waline:
+            serverURL:
+            lang:
+            visitor:
+            avatar:
+            emoji:
+                - https://cdn.jsdelivr.net/gh/walinejs/emojis/weibo
+            requiredMeta:
+                - name
+                - email
+                - url
+            placeholder:
+            locale:
+                admin: Admin
+
+        twikoo:
+            envId:
+            region:
+            path:
+            lang:
+
+        giscus:
+            repo:
+            repoID:
+            category:
+            categoryID:
+            mapping:
+            lightTheme:
+            darkTheme:
+            reactionsEnabled: 1
+            emitMetadata: 0
+
+        gitalk:
+            owner:
+            admin:
+            repo:
+            clientID:
+            clientSecret:
+
+        cusdis:
+            host:
+            id:
+
+    widgets:
+        enabled:
+            - search
+            - archives
+            - tag-cloud
+
+        archives:
+            limit: 5
+
+        tagCloud:
+            limit: 10
+
+    opengraph:
+        twitter:
+            # Your Twitter username
+            site:
+
+            # Available values: summary, summary_large_image
+            card: summary_large_image
+
+    defaultImage:
+        opengraph:
+            enabled: false
+            local: false
+            src:
+
+    colorScheme:
+        # Display toggle
+        toggle: true
+
+        # Available values: auto, light, dark
+        default: auto
+
+    imageProcessing:
+        cover:
+            enabled: true
+        content:
+            enabled: true

From d04b3a8771386c9988be00adda53f0bf542cf269 Mon Sep 17 00:00:00 2001
From: MikDal002 <mikdal_opensource@outlook.com>
Date: Sat, 16 Oct 2021 10:56:55 +0200
Subject: [PATCH 09/79] fix: appropriate back button and menu links for
 multi-language site (#386)

---
 layouts/_default/single.html       | 2 +-
 layouts/partials/sidebar/left.html | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/layouts/_default/single.html b/layouts/_default/single.html
index 902fa98..8b21c52 100644
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -29,7 +29,7 @@
 {{ define "left-sidebar" }}
     {{ if (.Scratch.Get "hasTOC") }}
         <div id="article-toolbar">
-            <a href="{{ .Site.BaseURL }}" class="back-home">
+            <a href="{{ .Site.BaseURL | relLangURL }}" class="back-home">
                 {{ (resources.Get "icons/back.svg").Content | safeHTML }}
                 <span>{{ T "article.back" }}</span>
             </a>
diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index c14092f..53a6655 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -29,7 +29,7 @@
             </figure>
             {{ end }}
         {{ end }}
-        <h1 class="site-name"><a href="{{ .Site.BaseURL }}">{{ .Site.Title }}</a></h1>
+        <h1 class="site-name"><a href="{{ .Site.BaseURL | relLangURL }}">{{ .Site.Title }}</a></h1>
         <h2 class="site-description">{{ .Site.Params.sidebar.subtitle }}</h2>
     </header>
 
@@ -39,7 +39,7 @@
         {{ $active := or (eq $currentPage.Title .Name) (or ($currentPage.HasMenuCurrent "main" .) ($currentPage.IsMenuCurrent "main" .)) }}
 
         <li {{ if $active }} class='current' {{ end }}>
-            <a href='{{ .URL }}' {{ if eq .Params.newTab true }}target="_blank"{{ end }}>
+            <a href='{{ .URL | relLangURL }}' {{ if eq .Params.newTab true }}target="_blank"{{ end }}>
                 {{ if .Pre }}
                     {{ partial "helper/icon" .Pre }}
                 {{ end }}

From 30467ae65ca0cccf5c42dee24db3561674fee3ef Mon Sep 17 00:00:00 2001
From: Daniel Pessoa <cobalto_@msn.com>
Date: Sat, 16 Oct 2021 06:10:25 -0300
Subject: [PATCH 10/79] feat(i18n): add missing pt-BR translations (#384)

---
 i18n/pt-BR.yaml | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/i18n/pt-BR.yaml b/i18n/pt-BR.yaml
index 8240755..ffdbe41 100644
--- a/i18n/pt-BR.yaml
+++ b/i18n/pt-BR.yaml
@@ -17,11 +17,22 @@ list:
         other: Subseções
 
 article:
+    back:
+        other: Voltar
+
+    tableOfContents:
+        other: Índice
+
     relatedContents:
-        other: Conteúdos Relacionados
+        other: Conteúdo relacionado
+
     lastUpdatedOn:
         other: Última atualização em
 
+    readingTime:
+        one: "{{ .Count }} minuto de leitura"
+        other: "{{ .Count }} minutos de leitura"
+
 notFound:
     title:
         other: Não Encontrado

From 913a4e8898a794fb646f8832170dcd4742f7a254 Mon Sep 17 00:00:00 2001
From: Ar-ruk Kachen <goodgod.th@gmail.com>
Date: Sun, 17 Oct 2021 17:34:19 +0700
Subject: [PATCH 11/79] feat(i18n): Thai language (#396)

---
 exampleSite/config.yaml |  2 +-
 i18n/th.yaml            | 70 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 71 insertions(+), 1 deletion(-)
 create mode 100644 i18n/th.yaml

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index dcf6c63..3064ca4 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -11,7 +11,7 @@ disqusShortname: hugo-theme-stack
 googleAnalytics:
 
 # Theme i18n support
-# Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl, it
+# Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl, it, th
 DefaultContentLanguage: en
 
 # Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
diff --git a/i18n/th.yaml b/i18n/th.yaml
new file mode 100644
index 0000000..b2ae1cd
--- /dev/null
+++ b/i18n/th.yaml
@@ -0,0 +1,70 @@
+toggleMenu:
+    other: สลับเมนู
+
+darkMode:
+    other: ธีมมืด
+
+list:
+    page:
+        one: "{{ .Count }} หน้า"
+        other: "{{ .Count }} หน้า"
+
+    section:
+        other: หมวดหมู่
+
+    subsection:
+        one: หมวดหมู่ย่อย
+        other: หมวดหมู่ย่อยอื่นๆ
+
+article:
+    back:
+        other: กลับไป
+
+    tableOfContents:
+        other: สารบัญ
+
+    relatedContents:
+        other: เนื้อหาคล้ายคลึงกัน
+
+    lastUpdatedOn:
+        other: อัปเดตล่าสุดเมื่อ
+
+    readingTime:
+        one: "น่าจะใช้เวลา {{ .Count }} นาทีในการอ่าน"
+        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 pages (#TIME_SECONDS seconds)"
+
+footer:
+    builtWith:
+        other: ถูกสร้างด้วย {{ .Generator }}
+
+    designedBy:
+        other: ธีม {{ .Theme }} ออกแบบโดย {{ .DesignedBy }}

From ca9dcc870d9421524acb68f8b0d7e94ed6b24c2a Mon Sep 17 00:00:00 2001
From: Christos Manios <maniopaido@gmail.com>
Date: Fri, 22 Oct 2021 17:12:44 +0300
Subject: [PATCH 12/79] feat(i18n): add Greek translation (#378)

---
 exampleSite/config.yaml |  2 +-
 i18n/el.yaml            | 70 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 71 insertions(+), 1 deletion(-)
 create mode 100644 i18n/el.yaml

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 3064ca4..a285296 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -11,7 +11,7 @@ disqusShortname: hugo-theme-stack
 googleAnalytics:
 
 # Theme i18n support
-# Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl, it, th
+# Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl, it, th, el
 DefaultContentLanguage: en
 
 # Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
diff --git a/i18n/el.yaml b/i18n/el.yaml
new file mode 100644
index 0000000..38d867f
--- /dev/null
+++ b/i18n/el.yaml
@@ -0,0 +1,70 @@
+toggleMenu:
+    other: Εναλλαγή Μενού
+
+darkMode:
+    other: Σκοτεινό θέμα
+
+list:
+    page:
+        one: "{{ .Count }} σελιδα"
+        other: "{{ .Count }} σελιδες"
+
+    section:
+        other: Ενότητα
+
+    subsection:
+        one: Υποενότητα
+        other: Υποενότητες
+
+article:
+    back:
+        other: Πισω
+
+    tableOfContents:
+        other: Πινακας περιεχομενων
+
+    relatedContents:
+        other: Σχετικο περιεχομενο
+
+    lastUpdatedOn:
+        other: Τελευταια τροποποιηση στις
+
+    readingTime:
+        one: "{{ .Count }} λεπτό ανάγνωσης"
+        ### Seems that there's no need to add 's' even if it's plural in English
+        other: "{{ .Count }} λεπτά ανάγνωσης"
+
+notFound:
+    title:
+        other: Δε βρέθηκε
+    subtitle:
+        other: Η σελίδα δε βρέθηκε.
+
+widget:
+    archives:
+        title:
+            other: Αρχειο
+
+        more:
+            other: Περισσότερα
+
+    tagCloud:
+        title:
+            other: Tags
+
+search:
+    title:
+        other: Αναζήτηση
+
+    placeholder:
+        other: Πληκτρολογήστε κάτι...
+
+    resultTitle:
+        other: "#PAGES_COUNT σελιδες (#TIME_SECONDS δευτερολεπτα)"
+
+footer:
+    builtWith:
+        other: Δημιουργήθηκε με τη χρήση {{ .Generator }}
+
+    designedBy:
+        other: Το θέμα {{ .Theme }} σχεδιάστηκε από το {{ .DesignedBy }}

From a822411a030663c8acaf399c349b7462da467d92 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 23 Oct 2021 06:51:56 +0000
Subject: [PATCH 13/79] chore: add Github Codespace config

---
 .devcontainer/Dockerfile        | 31 +++++++++++++++++++++++
 .devcontainer/devcontainer.json | 45 +++++++++++++++++++++++++++++++++
 .gitignore                      |  3 +++
 debug.sh                        |  1 +
 4 files changed, 80 insertions(+)
 create mode 100644 .devcontainer/Dockerfile
 create mode 100644 .devcontainer/devcontainer.json
 create mode 100644 .gitignore
 create mode 100755 debug.sh

diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
new file mode 100644
index 0000000..b601136
--- /dev/null
+++ b/.devcontainer/Dockerfile
@@ -0,0 +1,31 @@
+# Update the NODE_VERSION arg in docker-compose.yml to pick a Node version: 10, 12, 14
+ARG NODE_VERSION=14
+FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-${NODE_VERSION}
+
+# VARIANT can be either 'hugo' for the standard version or 'hugo_extended' for the extended version.
+ARG VARIANT=hugo
+# VERSION can be either 'latest' or a specific version number
+ARG VERSION=latest
+
+# Download Hugo
+RUN apt-get update && apt-get install -y ca-certificates openssl git curl && \
+    rm -rf /var/lib/apt/lists/* && \
+    case ${VERSION} in \
+    latest) \
+    export VERSION=$(curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4)}') ;;\
+    esac && \
+    echo ${VERSION} && \
+    wget -O ${VERSION}.tar.gz https://github.com/gohugoio/hugo/releases/download/v${VERSION}/${VARIANT}_${VERSION}_Linux-64bit.tar.gz && \
+    tar xf ${VERSION}.tar.gz && \
+    mv hugo /usr/bin/hugo
+
+# Hugo dev server port
+EXPOSE 1313
+
+# [Optional] Uncomment this section to install additional OS packages you may want.
+#
+# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+#     && apt-get -y install --no-install-recommends <your-package-list-here>
+
+# [Optional] Uncomment if you want to install more global node packages
+# RUN sudo -u node npm install -g <your-package-list-here>
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 0000000..4bf8a19
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,45 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.202.3/containers/hugo
+{
+	"name": "Hugo (Community)",
+	"build": {
+		"dockerfile": "Dockerfile",
+		"args": {
+			// Update VARIANT to pick hugo variant.
+			// Example variants: hugo, hugo_extended
+			// Rebuild the container if it already exists to update.
+			"VARIANT": "hugo_extended",
+			// Update VERSION to pick a specific hugo version.
+			// Example versions: latest, 0.73.0, 0,71.1
+			// Rebuild the container if it already exists to update.
+			"VERSION": "latest",
+			// Update NODE_VERSION to pick the Node.js version: 12, 14
+			"NODE_VERSION": "14",
+		}
+	},
+
+	// Set *default* container specific settings.json values on container create.
+	"settings": {
+		"html.format.templating": true,
+	},
+	
+	// Add the IDs of extensions you want installed when the container is created.
+	"extensions": [
+		"bungcip.better-toml",
+		"davidanson.vscode-markdownlint"
+	],
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [
+		1313
+	],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "uname -a",
+
+	// Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
+	"remoteUser": "node",
+	"features": {
+		"golang": "latest"
+	}
+}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9ebefdf
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+public
+resources
+assets/jsconfig.json
\ No newline at end of file
diff --git a/debug.sh b/debug.sh
new file mode 100755
index 0000000..4d1312e
--- /dev/null
+++ b/debug.sh
@@ -0,0 +1 @@
+cd exampleSite && hugo server --gc --themesDir=../..
\ No newline at end of file

From 7c59ac77137a9bbf2d9b4430aeca7006fb044da0 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 23 Oct 2021 09:18:44 +0200
Subject: [PATCH 14/79] refactor(menu): use .Params.icon to configure menu item
 icon (#400)

---
 exampleSite/config.yaml              | 2 +-
 exampleSite/content/page/about.md    | 3 ++-
 exampleSite/content/page/archives.md | 3 ++-
 exampleSite/content/page/search.md   | 3 ++-
 layouts/partials/sidebar/left.html   | 6 +++++-
 5 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index a285296..d5cf58d 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -174,10 +174,10 @@ menu:
           name: Home
           url: /
           weight: -100
-          pre: home
           params:
               ### For demonstration purpose, the home link will be open in a new tab
               newTab: true
+              icon: home
 
 related:
     includeNewer: true
diff --git a/exampleSite/content/page/about.md b/exampleSite/content/page/about.md
index 79898de..494cb46 100644
--- a/exampleSite/content/page/about.md
+++ b/exampleSite/content/page/about.md
@@ -11,7 +11,8 @@ lastmod: '2020-10-09'
 menu:
     main: 
         weight: -90
-        pre: user
+        params:
+            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.
diff --git a/exampleSite/content/page/archives.md b/exampleSite/content/page/archives.md
index 027dfc6..2862deb 100644
--- a/exampleSite/content/page/archives.md
+++ b/exampleSite/content/page/archives.md
@@ -6,5 +6,6 @@ slug: "archives"
 menu:
     main:
         weight: -70
-        pre: archives
+        params: 
+            icon: archives
 ---
diff --git a/exampleSite/content/page/search.md b/exampleSite/content/page/search.md
index f54cdb5..b2a5943 100644
--- a/exampleSite/content/page/search.md
+++ b/exampleSite/content/page/search.md
@@ -8,5 +8,6 @@ outputs:
 menu:
     main:
         weight: -60
-        pre: search
+        params: 
+            icon: search
 ---
\ No newline at end of file
diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index 53a6655..9d4dd3e 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -40,8 +40,12 @@
 
         <li {{ if $active }} class='current' {{ end }}>
             <a href='{{ .URL | relLangURL }}' {{ if eq .Params.newTab true }}target="_blank"{{ end }}>
+                {{ $icon := default .Pre .Params.Icon }}
                 {{ if .Pre }}
-                    {{ partial "helper/icon" .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 }}
+                {{ end }}
+                {{ with $icon }}
+                    {{ partial "helper/icon" . }}
                 {{ end }}
                 <span>{{- .Name -}}</span>
             </a>

From 661e59b85d6761905da906018a26120a0b45ef5e Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 23 Oct 2021 11:58:55 +0200
Subject: [PATCH 15/79] feat: social menu (#401)

---
 assets/icons/brand-github.svg      |  6 ++++++
 assets/icons/brand-twitter.svg     |  6 ++++++
 assets/scss/partials/menu.scss     | 15 +++++++++++++++
 exampleSite/config.yaml            | 13 +++++++++++++
 layouts/partials/sidebar/left.html | 20 ++++++++++++++++++++
 5 files changed, 60 insertions(+)
 create mode 100644 assets/icons/brand-github.svg
 create mode 100644 assets/icons/brand-twitter.svg

diff --git a/assets/icons/brand-github.svg b/assets/icons/brand-github.svg
new file mode 100644
index 0000000..1fe7e0b
--- /dev/null
+++ b/assets/icons/brand-github.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <path d="M9 19c-4.3 1.4 -4.3 -2.5 -6 -3m12 5v-3.5c0 -1 .1 -1.4 -.5 -2c2.8 -.3 5.5 -1.4 5.5 -6a4.6 4.6 0 0 0 -1.3 -3.2a4.2 4.2 0 0 0 -.1 -3.2s-1.1 -.3 -3.5 1.3a12.3 12.3 0 0 0 -6.2 0c-2.4 -1.6 -3.5 -1.3 -3.5 -1.3a4.2 4.2 0 0 0 -.1 3.2a4.6 4.6 0 0 0 -1.3 3.2c0 4.6 2.7 5.7 5.5 6c-.6 .6 -.6 1.2 -.5 2v3.5" />
+</svg>
+
+
diff --git a/assets/icons/brand-twitter.svg b/assets/icons/brand-twitter.svg
new file mode 100644
index 0000000..17ab1b1
--- /dev/null
+++ b/assets/icons/brand-twitter.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-twitter" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <path d="M22 4.01c-1 .49 -1.98 .689 -3 .99c-1.121 -1.265 -2.783 -1.335 -4.38 -.737s-2.643 2.06 -2.62 3.737v1c-3.245 .083 -6.135 -1.395 -8 -4c0 0 -4.182 7.433 4 11c-1.872 1.247 -3.739 2.088 -6 2c3.308 1.803 6.913 2.423 10.034 1.517c3.58 -1.04 6.522 -3.723 7.651 -7.742a13.84 13.84 0 0 0 .497 -3.753c-.002 -.249 1.51 -2.772 1.818 -4.013z" />
+</svg>
+
+
diff --git a/assets/scss/partials/menu.scss b/assets/scss/partials/menu.scss
index 2c7ad74..1d612d1 100644
--- a/assets/scss/partials/menu.scss
+++ b/assets/scss/partials/menu.scss
@@ -201,3 +201,18 @@
         }
     }
 }
+
+.social-menu {
+    list-style: none;
+    padding: 0%;
+    display: flex;
+    flex-direction: row;
+    gap: 10px;
+
+    svg {
+        width: 24px;
+        height: 24px;
+        stroke: var(--body-text-color);
+        stroke-width: 1.33;
+    }
+}
diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index d5cf58d..db3a8a9 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -178,6 +178,19 @@ menu:
               ### For demonstration purpose, the home link will be open in a new tab
               newTab: true
               icon: home
+    
+    social:
+        - identifier: github
+          name: GitHub
+          url: https://github.com/CaiJimmy/hugo-theme-stack
+          params:
+            icon: brand-github
+            
+        - identifier: twitter
+          name: Twitter
+          url: https://twitter.com
+          params:
+            icon: brand-twitter
 
 related:
     includeNewer: true
diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index 9d4dd3e..108c029 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -29,8 +29,28 @@
             </figure>
             {{ end }}
         {{ end }}
+        
         <h1 class="site-name"><a href="{{ .Site.BaseURL | relLangURL }}">{{ .Site.Title }}</a></h1>
         <h2 class="site-description">{{ .Site.Params.sidebar.subtitle }}</h2>
+
+        {{- with .Site.Menus.social -}}
+            <ol class="social-menu">
+                {{ range . }}
+                    <li>
+                        <a 
+                            href='{{ .URL | relLangURL }}'
+                            {{ if eq (default true .Params.newTab) true }}target="_blank"{{ end }}
+                            {{ with .Name }}title="{{ . }}"{{ end }}
+                        >
+                            {{ $icon := default "link" .Params.Icon }}
+                            {{ with $icon }}
+                                {{ partial "helper/icon" . }}
+                            {{ end }}
+                        </a>
+                    </li>
+                {{ end }}
+            </ol>
+        {{- end -}}
     </header>
 
     <ol class="menu" id="main-menu">

From 44fc94f0085c5ca1fd1c6a8725b99448610d1fa6 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 23 Oct 2021 10:00:42 +0000
Subject: [PATCH 16/79] release: 3.4.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index 9174dd1..a78947e 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.2.0" -}}
+{{- $ThemeVersion := "3.4.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From c43f9d1ea8abfa083a40d84b7dc0c0c95fa85e9c Mon Sep 17 00:00:00 2001
From: zhixuan <59254886+zhixuan2333@users.noreply.github.com>
Date: Sat, 30 Oct 2021 00:20:36 +0900
Subject: [PATCH 17/79] fix(menu/social): Delete `relLangURL` (#406)

---
 layouts/partials/sidebar/left.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index 108c029..db05480 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -38,7 +38,7 @@
                 {{ range . }}
                     <li>
                         <a 
-                            href='{{ .URL | relLangURL }}'
+                            href='{{ .URL }}'
                             {{ if eq (default true .Params.newTab) true }}target="_blank"{{ end }}
                             {{ with .Name }}title="{{ . }}"{{ end }}
                         >

From ea74aecadb331ce492620ab247d6eba7f3f99cc1 Mon Sep 17 00:00:00 2001
From: TonyPepeBear <41405045+TonyPepeBear@users.noreply.github.com>
Date: Sun, 31 Oct 2021 03:18:02 +0800
Subject: [PATCH 18/79] feat(i18n): add zh-TW (#402)

---
 exampleSite/config.yaml |  2 +-
 i18n/zh-TW.yaml         | 49 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 i18n/zh-TW.yaml

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index db3a8a9..6b3069f 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -11,7 +11,7 @@ disqusShortname: hugo-theme-stack
 googleAnalytics:
 
 # Theme i18n support
-# Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl, it, th, el
+# Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el
 DefaultContentLanguage: en
 
 # Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
diff --git a/i18n/zh-TW.yaml b/i18n/zh-TW.yaml
new file mode 100644
index 0000000..871d937
--- /dev/null
+++ b/i18n/zh-TW.yaml
@@ -0,0 +1,49 @@
+toggleMenu:
+    other: 切換選單
+
+darkMode:
+    other: 夜晚模式
+
+article:
+    back:
+        other: 返回
+
+    tableOfContents:
+        other: 目錄
+
+    relatedContents:
+        other: 相關文章
+
+    lastUpdatedOn:
+        other: 最後更新
+
+    readingTime:
+        other: "閱讀時間: {{ .Count }} 分鐘"
+
+notFound:
+    title:
+        other: 404 錯誤
+    subtitle:
+        other: 頁面不存在
+
+widget:
+    archives:
+        title:
+            other: 紀錄
+
+        more:
+            other: 更多
+
+    tagCloud:
+        title:
+            other: 標籤雲
+
+search:
+    title:
+        other: 搜尋
+
+    placeholder:
+        other: 輸入關鍵字...
+
+    resultTitle:
+        other: "#PAGES_COUNT 個結果 （用時 #TIME_SECONDS 秒）"

From a7d316365cd95247d16fa0b82f22ac121b3f7184 Mon Sep 17 00:00:00 2001
From: volodymyrmarkiv <vov4uk21@gmail.com>
Date: Sat, 30 Oct 2021 22:22:08 +0300
Subject: [PATCH 19/79] feat(i18n): add Ukrainian translation (#404)

---
 exampleSite/config.yaml |  2 +-
 i18n/uk.yaml            | 71 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 72 insertions(+), 1 deletion(-)
 create mode 100644 i18n/uk.yaml

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 6b3069f..28958ae 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -11,7 +11,7 @@ disqusShortname: hugo-theme-stack
 googleAnalytics:
 
 # Theme i18n support
-# Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el
+# Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el, uk
 DefaultContentLanguage: en
 
 # Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
diff --git a/i18n/uk.yaml b/i18n/uk.yaml
new file mode 100644
index 0000000..966e141
--- /dev/null
+++ b/i18n/uk.yaml
@@ -0,0 +1,71 @@
+toggleMenu:
+    other: Показати меню
+
+darkMode:
+    other: Темна тема
+
+list:
+    page:
+        one: "{{ .Count }} сторінка"
+        few: "{{ .Count }} сторінки"
+        other: "{{ .Count }} сторінок"
+
+    section:
+        other: Секція
+
+    subsection:
+        one: Підсекція
+        other: Підсекції
+
+article:
+    back:
+        other: Назад
+
+    tableOfContents:
+        other: Зміст
+
+    relatedContents:
+        other: Схожі матеріали
+
+    lastUpdatedOn:
+        other: Востаннє оновлено
+
+    readingTime:
+        one: "Час читання: {{ .Count }} хв"
+        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 }}

From 25581cc44637909a75aacdf33f896192f0569689 Mon Sep 17 00:00:00 2001
From: Hue <19755727+HueLiu@users.noreply.github.com>
Date: Sun, 31 Oct 2021 17:15:57 +0800
Subject: [PATCH 20/79] fix(comments/cusdis): use the correct script for the
 self-hosted version (#403)

* Modify the Self-hosting js source path

* refactor(comments/cusdis): avoid multiple if statement

Co-authored-by: Jimmy Cai <github@jimmycai.com>
---
 layouts/partials/comments/provider/cusdis.html | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/layouts/partials/comments/provider/cusdis.html b/layouts/partials/comments/provider/cusdis.html
index 71863f3..a89746c 100644
--- a/layouts/partials/comments/provider/cusdis.html
+++ b/layouts/partials/comments/provider/cusdis.html
@@ -1,14 +1,11 @@
+{{- $host := default "https://cusdis.com" .Site.Params.comments.cusdis.host -}}
 <div id="cusdis_thread"
-    {{ if .Site.Params.comments.cusdis.host }}
-    data-host="{{ .Site.Params.comments.cusdis.host }}"
-    {{ else }}
-    data-host="https://cusdis.com"
-    {{ end }}
+    data-host="{{ $host }}"
     data-app-id="{{ .Site.Params.comments.cusdis.id }}"
     data-page-id="{{ .File.UniqueID }}"
     data-page-url="{{ .Permalink }}"
     data-page-title="{{ .Title }}"></div>
-<script async defer src="https://cusdis.com/js/cusdis.es.js"></script>
+<script async defer src="{{ $host }}/js/cusdis.es.js"></script>
 
 <script>
     function setCusdisTheme(theme) {
@@ -21,4 +18,4 @@
     window.addEventListener('onColorSchemeChange', (e) => {
         setCusdisTheme(e.detail)
     })
-</script>
\ No newline at end of file
+</script>

From 72a5e956eefa9d84d46504ec65e7f417e295c13e Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 31 Oct 2021 10:17:45 +0100
Subject: [PATCH 21/79] release: 3.5.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index a78947e..ba38464 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.4.0" -}}
+{{- $ThemeVersion := "3.5.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From 497643b3633e91580d2f407469c0034ad385339e Mon Sep 17 00:00:00 2001
From: zhixuan <59254886+zhixuan2333@users.noreply.github.com>
Date: Sun, 5 Dec 2021 05:05:53 +0900
Subject: [PATCH 22/79] feat: add alt message for archive & related contents
 images (#411)

---
 exampleSite/.gitignore                     | 7 +++++--
 layouts/partials/article-list/compact.html | 1 +
 layouts/partials/article-list/tile.html    | 5 +++--
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/exampleSite/.gitignore b/exampleSite/.gitignore
index ca4d540..6db5459 100644
--- a/exampleSite/.gitignore
+++ b/exampleSite/.gitignore
@@ -22,6 +22,9 @@ _testmain.go
 *.exe
 *.test
 
-/public
-/themes
+public
+themes
+resources
+
+assets/jsconfig.json
 .DS_Store
diff --git a/layouts/partials/article-list/compact.html b/layouts/partials/article-list/compact.html
index 0f5a216..376512a 100644
--- a/layouts/partials/article-list/compact.html
+++ b/layouts/partials/article-list/compact.html
@@ -29,6 +29,7 @@
                     <img src="{{ $Permalink }}" 
                         width="{{ $Width }}"
                         height="{{ $Height }}" 
+                        alt="{{ .Title }}"
                         loading="lazy">
                 {{ else }}
                     <img src="{{ $image.permalink }}" loading="lazy" alt="Featured image of post {{ .Title }}" />
diff --git a/layouts/partials/article-list/tile.html b/layouts/partials/article-list/tile.html
index 0fbf812..4ec5d57 100644
--- a/layouts/partials/article-list/tile.html
+++ b/layouts/partials/article-list/tile.html
@@ -20,8 +20,9 @@
                     <img src="{{ $Permalink }}" 
                         width="{{ $Width }}" 
                         height="{{ $Height }}" 
-                        loading="lazy" 
-                        data-key="{{ .context.Slug }}" 
+                        loading="lazy"
+                        alt="Featured image of post {{ .context.Title }}"
+                        {{ with .context.Slug }}data-key="{{ . }}" {{ end }}
                         data-hash="{{ $imageRaw.Data.Integrity }}">
                 {{ else }}
                     <img src="{{ $image.permalink }}" loading="lazy" data-key="{{ .context.Slug }}" data-hash="{{ $image.permalink }}"/>

From 195b8d8076dde6ae6caa5832557d5e084ae3ef90 Mon Sep 17 00:00:00 2001
From: Paul-Henri Zimmerlin <paulhenri.zimmerlin@gmail.com>
Date: Sat, 4 Dec 2021 21:10:42 +0100
Subject: [PATCH 23/79] fix(i18n/fr): add missing translations for reading time
 (#416)

---
 i18n/fr.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/i18n/fr.yaml b/i18n/fr.yaml
index 9217ea3..ac2e51a 100644
--- a/i18n/fr.yaml
+++ b/i18n/fr.yaml
@@ -29,6 +29,10 @@ article:
     lastUpdatedOn:
         other: Dernière mise à jour le
 
+    readingTime:
+        one: "{{ .Count }} minute de lecture"
+        other: "{{ .Count }} minutes de lecture"
+
 notFound:
     title:
         other: Page non trouvée

From 359e4b34c1f96beeda472cddb54cea98522b2c14 Mon Sep 17 00:00:00 2001
From: HAHWUL <hahwul@gmail.com>
Date: Sun, 5 Dec 2021 05:16:22 +0900
Subject: [PATCH 24/79] Update i18n(ko) (#418)

Add dark mode, list-section, list-subsction, article-back, article-tableOfContents, article-readingTime
---
 i18n/ko.yaml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/i18n/ko.yaml b/i18n/ko.yaml
index d9916cd..b2202e6 100644
--- a/i18n/ko.yaml
+++ b/i18n/ko.yaml
@@ -1,15 +1,42 @@
 toggleMenu:
     other: 메뉴 여닫기
 
+darkMode:
+    other: 다크 모드
+
+list:
+    page:
+        one: "{{ .Count }} 페이지"
+        other: "{{ .Count }} 페이지"
+
+    section:
+        other: 섹션
+
+    subsection:
+        one: 서브섹션
+        other: 서브섹션
+
 article:
+    back:
+        other: 뒤로가기
+
+    tableOfContents:
+        other: 목차
+        
     relatedContents:
         other: 관련 글
+        
     lastUpdatedOn:
         other: "마지막 수정: "
+        
+    readingTime:
+        one: "{{ .Count }} 분 정도"
+        other: "{{ .Count }} 분 정도"
 
 notFound:
     title:
         other: 찾을 수 없음
+        
     subtitle:
         other: 페이지를 찾을 수 없습니다.
 
@@ -19,6 +46,7 @@ widget:
             other: 보관함
         more:
             other: 더보기
+            
     tagCloud:
         title:
             other: 태그
@@ -26,8 +54,10 @@ widget:
 search:
     title:
         other: 검색
+        
     placeholder:
         other: 검색어를 입력하세요...
+        
     resultTitle:
         other: "#PAGES_COUNT 페이지 (#TIME_SECONDS 초)"
 

From 4e2c8e74be959cbaba3247349d2f4235c05ccaa2 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Tue, 28 Dec 2021 10:48:22 +0100
Subject: [PATCH 25/79] fix: add missing diff syntax highlight (#445)

closes: https://github.com/CaiJimmy/hugo-theme-stack/issues/434
---
 assets/scss/partials/highlight/light.scss     | 183 +++++++++---------
 .../content/post/markdown-syntax/index.md     |  10 +
 2 files changed, 103 insertions(+), 90 deletions(-)

diff --git a/assets/scss/partials/highlight/light.scss b/assets/scss/partials/highlight/light.scss
index 9ddcff9..1798218 100644
--- a/assets/scss/partials/highlight/light.scss
+++ b/assets/scss/partials/highlight/light.scss
@@ -10,7 +10,8 @@
 }
 
 /* Other */
-.chroma .x {}
+.chroma .x {
+}
 
 /* Error */
 .chroma .err {
@@ -40,367 +41,369 @@
 .chroma .hl {
     display: block;
     width: 100%;
-    background-color: #ffffcc
+    background-color: #ffffcc;
 }
 
 /* LineNumbersTable */
 .chroma .lnt {
     margin-right: 0.4em;
     padding: 0 0.4em 0 0.4em;
-    color: #7f7f7f
+    color: #7f7f7f;
 }
 
 /* LineNumbers */
 .chroma .ln {
     margin-right: 0.4em;
     padding: 0 0.4em 0 0.4em;
-    color: #7f7f7f
+    color: #7f7f7f;
 }
 
 /* Keyword */
 .chroma .k {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* KeywordConstant */
 .chroma .kc {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* KeywordDeclaration */
 .chroma .kd {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* KeywordNamespace */
 .chroma .kn {
-    color: #f92672
+    color: #f92672;
 }
 
 /* KeywordPseudo */
 .chroma .kp {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* KeywordReserved */
 .chroma .kr {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* KeywordType */
 .chroma .kt {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* Name */
 .chroma .n {
-    color: #111111
+    color: #111111;
 }
 
 /* NameAttribute */
 .chroma .na {
-    color: #75af00
+    color: #75af00;
 }
 
 /* NameBuiltin */
 .chroma .nb {
-    color: #111111
+    color: #111111;
 }
 
 /* NameBuiltinPseudo */
 .chroma .bp {
-    color: #111111
+    color: #111111;
 }
 
 /* NameClass */
 .chroma .nc {
-    color: #75af00
+    color: #75af00;
 }
 
 /* NameConstant */
 .chroma .no {
-    color: #00a8c8
+    color: #00a8c8;
 }
 
 /* NameDecorator */
 .chroma .nd {
-    color: #75af00
+    color: #75af00;
 }
 
 /* NameEntity */
 .chroma .ni {
-    color: #111111
+    color: #111111;
 }
 
 /* NameException */
 .chroma .ne {
-    color: #75af00
+    color: #75af00;
 }
 
 /* NameFunction */
 .chroma .nf {
-    color: #75af00
+    color: #75af00;
 }
 
 /* NameFunctionMagic */
 .chroma .fm {
-    color: #111111
+    color: #111111;
 }
 
 /* NameLabel */
 .chroma .nl {
-    color: #111111
+    color: #111111;
 }
 
 /* NameNamespace */
 .chroma .nn {
-    color: #111111
+    color: #111111;
 }
 
 /* NameOther */
 .chroma .nx {
-    color: #75af00
+    color: #75af00;
 }
 
 /* NameProperty */
 .chroma .py {
-    color: #111111
+    color: #111111;
 }
 
 /* NameTag */
 .chroma .nt {
-    color: #f92672
+    color: #f92672;
 }
 
 /* NameVariable */
 .chroma .nv {
-    color: #111111
+    color: #111111;
 }
 
 /* NameVariableClass */
 .chroma .vc {
-    color: #111111
+    color: #111111;
 }
 
 /* NameVariableGlobal */
 .chroma .vg {
-    color: #111111
+    color: #111111;
 }
 
 /* NameVariableInstance */
 .chroma .vi {
-    color: #111111
+    color: #111111;
 }
 
 /* NameVariableMagic */
 .chroma .vm {
-    color: #111111
+    color: #111111;
 }
 
 /* Literal */
 .chroma .l {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralDate */
 .chroma .ld {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralString */
 .chroma .s {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringAffix */
 .chroma .sa {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringBacktick */
 .chroma .sb {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringChar */
 .chroma .sc {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringDelimiter */
 .chroma .dl {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringDoc */
 .chroma .sd {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringDouble */
 .chroma .s2 {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringEscape */
 .chroma .se {
-    color: #8045ff
+    color: #8045ff;
 }
 
 /* LiteralStringHeredoc */
 .chroma .sh {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringInterpol */
 .chroma .si {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringOther */
 .chroma .sx {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringRegex */
 .chroma .sr {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringSingle */
 .chroma .s1 {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralStringSymbol */
 .chroma .ss {
-    color: #d88200
+    color: #d88200;
 }
 
 /* LiteralNumber */
 .chroma .m {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralNumberBin */
 .chroma .mb {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralNumberFloat */
 .chroma .mf {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralNumberHex */
 .chroma .mh {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralNumberInteger */
 .chroma .mi {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralNumberIntegerLong */
 .chroma .il {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* LiteralNumberOct */
 .chroma .mo {
-    color: #ae81ff
+    color: #ae81ff;
 }
 
 /* Operator */
 .chroma .o {
-    color: #f92672
+    color: #f92672;
 }
 
 /* OperatorWord */
 .chroma .ow {
-    color: #f92672
+    color: #f92672;
 }
 
 /* Punctuation */
 .chroma .p {
-    color: #111111
+    color: #111111;
 }
 
 /* Comment */
 .chroma .c {
-    color: #75715e
+    color: #75715e;
 }
 
 /* CommentHashbang */
 .chroma .ch {
-    color: #75715e
+    color: #75715e;
 }
 
 /* CommentMultiline */
 .chroma .cm {
-    color: #75715e
+    color: #75715e;
 }
 
 /* CommentSingle */
 .chroma .c1 {
-    color: #75715e
+    color: #75715e;
 }
 
 /* CommentSpecial */
 .chroma .cs {
-    color: #75715e
+    color: #75715e;
 }
 
 /* CommentPreproc */
 .chroma .cp {
-    color: #75715e
+    color: #75715e;
 }
 
 /* CommentPreprocFile */
 .chroma .cpf {
-    color: #75715e
+    color: #75715e;
 }
 
 /* Generic */
-.chroma .g {}
-
+.chroma .g {
+}
 /* GenericDeleted */
-.chroma .gd {}
-
+.chroma .gd {
+    color: #f92672;
+}
 /* GenericEmph */
 .chroma .ge {
-    font-style: italic
+    font-style: italic;
 }
-
 /* GenericError */
-.chroma .gr {}
-
+.chroma .gr {
+}
 /* GenericHeading */
-.chroma .gh {}
-
+.chroma .gh {
+}
 /* GenericInserted */
-.chroma .gi {}
-
+.chroma .gi {
+    color: #7ca727;
+}
 /* GenericOutput */
-.chroma .go {}
-
+.chroma .go {
+}
 /* GenericPrompt */
-.chroma .gp {}
-
+.chroma .gp {
+}
 /* GenericStrong */
 .chroma .gs {
-    font-weight: bold
+    font-weight: bold;
 }
-
 /* GenericSubheading */
-.chroma .gu {}
-
+.chroma .gu {
+    color: #75715e;
+}
 /* GenericTraceback */
-.chroma .gt {}
-
+.chroma .gt {
+}
 /* GenericUnderline */
-.chroma .gl {}
-
+.chroma .gl {
+}
 /* TextWhitespace */
-.chroma .w {}
\ No newline at end of file
+.chroma .w {
+}
diff --git a/exampleSite/content/post/markdown-syntax/index.md b/exampleSite/content/post/markdown-syntax/index.md
index 8c53bc2..85fdcff 100644
--- a/exampleSite/content/post/markdown-syntax/index.md
+++ b/exampleSite/content/post/markdown-syntax/index.md
@@ -113,6 +113,16 @@ Tables aren't part of the core Markdown spec, but Hugo supports supports them ou
 </html>
 {{< /highlight >}}
 
+#### Diff code block
+
+```diff
+[dependencies.bevy]
+git = "https://github.com/bevyengine/bevy"
+rev = "11f52b8c72fc3a568e8bb4a4cd1f3eb025ac2e13"
+- features = ["dynamic"]
++ features = ["jpeg", "dynamic"]
+```
+
 ## List Types
 
 #### Ordered List

From 455e23f22b796c900568d1b772e5af68ede95604 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Tue, 28 Dec 2021 11:28:20 +0100
Subject: [PATCH 26/79] feat: page links (#446)

---
 exampleSite/content/page/links/index.md       |  37 ++++++++++++++++++
 .../content/page/links/ts-logo-128.jpg        | Bin 0 -> 2071 bytes
 layouts/_default/single.html                  |   4 ++
 .../partials/article/components/links.html    |  26 ++++++++++++
 4 files changed, 67 insertions(+)
 create mode 100644 exampleSite/content/page/links/index.md
 create mode 100644 exampleSite/content/page/links/ts-logo-128.jpg
 create mode 100644 layouts/partials/article/components/links.html

diff --git a/exampleSite/content/page/links/index.md b/exampleSite/content/page/links/index.md
new file mode 100644
index 0000000..9e29bf3
--- /dev/null
+++ b/exampleSite/content/page/links/index.md
@@ -0,0 +1,37 @@
+---
+title: Links
+links:
+  - title: GitHub
+    description: GitHub is the world's largest software development platform.
+    website: https://github.com
+    image: https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png
+  - title: TypeScript
+    description: TypeScript is a typed superset of JavaScript that compiles to plain JavaScript.
+    website: https://www.typescriptlang.org
+    image: ts-logo-128.jpg
+menu:
+    main: 
+        weight: -50
+        params:
+            icon: link
+
+comments: false
+---
+
+To use this feature, add `links` section to frontmatter.
+
+This page's frontmatter:
+
+```yaml
+links:
+  - title: GitHub
+    description: GitHub is the world's largest software development platform.
+    website: https://github.com
+    image: https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png
+  - title: TypeScript
+    description: TypeScript is a typed superset of JavaScript that compiles to plain JavaScript.
+    website: https://www.typescriptlang.org
+    image: ts-logo-128.jpg
+```
+
+`image` field accepts both local and external images.
\ No newline at end of file
diff --git a/exampleSite/content/page/links/ts-logo-128.jpg b/exampleSite/content/page/links/ts-logo-128.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..85e33236069a2534315630db8bfef9e02166c3e1
GIT binary patch
literal 2071
zcmbuAX;2eL7RNgW;U1De7(pO`1XcoqLc+?S5N=_D5)K845RRZC9sz<f$`BQS3|F`u
zK@gW?2tnmCI>@0A!~=uGfH)i?XDNc9AgE|I&g@jp?$>><KXi3h|LeV9)xV!?NHz|T
zUhX^H0R#d7M4mu449)>1c_=F>tEecef2a1Hx+V&VL}}`2Y0Fd3Y$JA~e3_Y87~_pC
zOkBy9mSk5S=N-;Ip#cG*iN_N!UFwJYzXGyOfKmb}AO!|70#FnLhJwgMz*=4=1i-%4
z`d26-U~mN`C<H+N>lgq92n>#Z%6<oGF!?1ChLpcpvK2onQcn5yR#DN8VDfGA_aKjc
zdE3b8tqR-|SrrKPwq}Y*^vM|h^ziIym6D$8rJssN@|W*MosxlTjV4!IN+h<wN-~)@
z(MulWmhYK;$wKTgu{lHIEqnb)2KJ}&q<5M?tHpJU*W1AhXAfQAk6kEkzg&LWvLxX_
z@zA>@gNgYU+m`&8bRuXkSD_mn^_&U4-(Y{(TRLyRdNn!n&-crh3op1n6qz%!a$;D!
z^7ZsSHJ!V6A;^N+Kfji`-2A)%lRXui6R;0cM&CQ$?;%IzfdmkkymeI-HN`($gFxkk
z00O0mL~qs9`W|OQqWH(<Nic?6tjNy3jCc;7U_<i@KhEMc_D{HkMV+l^Xp&=7l2e8_
zf-L=-I#QPl+z_WB{nVGn)5)M}Up{C?nZl2zFJq_e=)JZ6<4xqWN#mQOdQ}={Jg>~P
z<VfPa*)1(|Z}!Etys%Au78*WWI{2~IqUE#p$ihuABjMSQa5kYmPW4)Qw_p#g!kwF8
zwLiPk^vRGq-*tlGP|mD=^19Gv$+I??a;I)__x73I$eHqb)%SakN^|!_<VU?66R0I&
zM-S@Q*OsG2)%q)XyJPLtYS1BBrfrJ8=S@ZWKQZ4;uV4IC1`@w=Uqor%=e6Cy^4KkV
z;scF0_pAxv2fwgR4ciRI+MFMD@<MO%a=HV|Z(LC(2A`pk^Nwj_4*3SA*L44*zp?r*
z#YrodGOgW#-8B8>UI%W>$iGN}P8;!ZFV}Jsj$Ra(&6PyXua@$BpX&!N#&&GTFaB~r
zcQg?(b{rp5KCa~^d?Suu4SD`RqlFZ5GG@c%nF8uHYs1^O^&{4<ZEG6rf1E^&V-8ds
zuGH8(dgQ!u%5!HIiCD0v`ZUAzUe3Vw$qzsK*IE%-14Q@ihn1C^I4O2`^$*mw$KDl3
z$ujV6@k4y{gY}uQ%HK4x=NL~1_Q!O`O$-$A&CR!(6?_zY9^^kEHaD`R0r1mCCp_0Z
zQXX{Z@Z)1=I==2V5N9seR@V9tPJ1{Qj?sLo2y+POzQ<I7Fn5@9^J7rZ%OBfp)8R-b
zT&B{Eq{+@-Qag5ehP$^xCM=txhm!2YR_|2woVot_b*T2gt7eT8kQ7{&yY%*45a*0u
z+~H=2X9+7;U9aD{YUSU_4cV0~X^otDXl$#*GN!<wGn;Ma@PVIA)|plPH;ZN9<B1>b
ztQ*)wE55lj9M6Q;Y;IngbbXnwC#3nOYVir1^px;W>kwv?MSEA~*@i2smIhR`b(D^X
z>u<9@X=YIC^FLZ6NAnv#c{q}*Y5b;JQXBe?LPEsa5MA{aCMS;fj9$^5g{haacT090
z0?>yvT3!_rY{*N1#Jr%p1(&1m-m?Z(P46=XudWQY(mPpRAFBHrtMENfx-^apUxi8>
z`#x_Dty^U#5C8sI<8GC%U2sxc*LK~N0aJB^?$AgWnoZ7GcKhX_D+|%*a|~NkFF5kE
zM;G@|&qBqGgF2p(Q2f)PT~*zjLv6Ey0FKMTIqPNWqF<Rqkugc1A-$?tfK66>a?0VN
zx*Ox!=r%)T!q>9~en;h2w?F}?-0KR8FopkoVsfhkI7-2At1pL#L~CKJNDW2|77p*^
zeC7{FLm_fU%VPs<C07ZTne&obGg2w3F-v73#E4e$9C!J;b<0E>acs_}`e63NAu5gS
zD1>HLw|1_arVh9{&v;hEwG|kMUoT>6fW_4GQXscoSO2WU%+K#-GOvD{Nu3E-CnNVT
z9xRqe6tXc<4&B65h|?VyV87n6;1i08o@cDPSqV%7b>Ly#%U-r7+A?5LI4jH@FJ!a^
zw054L{SaZ_bEIP7n|AUbRuu5&E!^u>&R)1KJ=pxTZ@uGT-P^a8(5s!}5zxBu16O%_
z!!DIIE8&nVdqR`2@KNi@h*eU0%@zMJ2#4mLXPF>Hc~F}jrP&FX(q<2{4Skxz41i8l
zk>lI^4IdPSfGhqrPX5GaxK#nEMe^mKjd%^3I4dV-28;FwJ^6rf1cbbuAMfHOG@iRf
zz}z+>j}w)}w^Wm}=0X%Y+*kPX^}nH9$<X}h&I++NmJ))gIM9B+YIj~s77TS;lvLa>
zo!`+Gk}vYU_(>4W6GiiB3j5s%4Is@WL;pZpR+GYB_P@N*J4K}*92yf>1=qquUl($7
zDR;PO2QtqIM*IlY)nQhp>bp?fK%bH~CnMj!-4i0}7zlRG_q_jNsyMd9WJi!z&geeM
zB7U)`$AL<}-{><PFG<IZyHB;0kyUb1uvdQQeG`;Tkl0t8;H8r+7d)mk4&}W*iBOyU
N?ko}Hf$Os8{{}vaa_0a5

literal 0
HcmV?d00001

diff --git a/layouts/_default/single.html b/layouts/_default/single.html
index 8b21c52..8ce42e9 100644
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -15,6 +15,10 @@
 {{ define "main" }}
     {{ partial "article/article.html" . }}
 
+    {{ if .Params.links }}
+        {{ partial "article/components/links" . }}
+    {{ end }}
+
     {{ partial "article/components/related-contents" . }}
      
     {{ if not (eq .Params.comments false) }}
diff --git a/layouts/partials/article/components/links.html b/layouts/partials/article/components/links.html
new file mode 100644
index 0000000..118dbb3
--- /dev/null
+++ b/layouts/partials/article/components/links.html
@@ -0,0 +1,26 @@
+<div class="article-list--compact links">
+    {{ range $i, $link := .Params.links }}
+        <article>
+            <a href="{{ $link.website }}" target="_blank" rel="noopener">
+                <div class="article-details">
+                    <h2 class="article-title">
+                        {{- $link.title -}}
+                    </h2>
+                    <footer class="article-time">
+                        {{ with $link.description }}
+                            {{ . }}
+                        {{ else }}
+                            {{ $link.website }}
+                        {{ end }}
+                    </footer>
+                </div>
+        
+                {{ with $link.image }}
+                    <div class="article-image">
+                        <img src="{{ . }}" loading="lazy">
+                    </div>
+                {{ end }}
+            </a>
+        </article>
+    {{ end }}
+</div>
\ No newline at end of file

From a669b60cdd22b6ed29b6acd766389f11d8e57911 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Tue, 28 Dec 2021 10:33:48 +0000
Subject: [PATCH 27/79] chore(exampleSite): make default pages use page bundle
 feature

To avoid confusions
---
 exampleSite/content/page/{about.md => about/index.md}       | 0
 exampleSite/content/page/{archives.md => archives/index.md} | 0
 exampleSite/content/page/{search.md => search/index.md}     | 0
 3 files changed, 0 insertions(+), 0 deletions(-)
 rename exampleSite/content/page/{about.md => about/index.md} (100%)
 rename exampleSite/content/page/{archives.md => archives/index.md} (100%)
 rename exampleSite/content/page/{search.md => search/index.md} (100%)

diff --git a/exampleSite/content/page/about.md b/exampleSite/content/page/about/index.md
similarity index 100%
rename from exampleSite/content/page/about.md
rename to exampleSite/content/page/about/index.md
diff --git a/exampleSite/content/page/archives.md b/exampleSite/content/page/archives/index.md
similarity index 100%
rename from exampleSite/content/page/archives.md
rename to exampleSite/content/page/archives/index.md
diff --git a/exampleSite/content/page/search.md b/exampleSite/content/page/search/index.md
similarity index 100%
rename from exampleSite/content/page/search.md
rename to exampleSite/content/page/search/index.md

From dde6a10cabb21ccdb707e90e7c0a9938a118aaa7 Mon Sep 17 00:00:00 2001
From: Nathan Harkenrider <824186+NateHark@users.noreply.github.com>
Date: Tue, 28 Dec 2021 14:28:33 -0800
Subject: [PATCH 28/79] feat: implement cache busting for CSS (#444)

---
 layouts/partials/head/style.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/head/style.html b/layouts/partials/head/style.html
index 431e212..ee6b017 100644
--- a/layouts/partials/head/style.html
+++ b/layouts/partials/head/style.html
@@ -1,3 +1,3 @@
 {{ $sass := resources.Get "scss/style.scss" }}
-{{ $style := $sass | resources.ToCSS | minify }}
+{{ $style := $sass | resources.ToCSS | minify | resources.Fingerprint "sha256" }}
 <link rel="stylesheet" href="{{ $style.RelPermalink }}">
\ No newline at end of file

From d1656215684b042ea341e2ba93933722956630b5 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Wed, 29 Dec 2021 00:32:08 +0100
Subject: [PATCH 29/79] release: 3.6.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index ba38464..a2baf19 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.5.0" -}}
+{{- $ThemeVersion := "3.6.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From 86cbc1b682c999f62708bb3aea82615e862c7f95 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Mon, 3 Jan 2022 14:15:05 +0100
Subject: [PATCH 30/79] fix(README): demo site link

closes #449
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ddacf82..6ac9e91 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 
 ## Demo
 
-[Example Site](https://theme-stack.jimmycai.com/)
+[Example Site](https://demo.stack.jimmycai.com/)
 
 [![Netlify Status](https://api.netlify.com/api/v1/badges/a2d2807a-a905-4bcb-97da-8da8d847da3d/deploy-status)](https://app.netlify.com/sites/hugo-theme-stack/deploys)
 
@@ -77,4 +77,4 @@ Some references that I took while building this theme:
 | Project | Licence|
 | ------- | ------|
 | [artchen/hexo-theme-element](https://github.com/artchen/hexo-theme-element) | [MIT](https://github.com/artchen/hexo-theme-element/blob/master/LICENSE) |
-| [MunifTanjim/minimo](https://github.com/MunifTanjim/minimo) | [MIT](https://github.com/MunifTanjim/minimo/blob/master/LICENSE) |
\ No newline at end of file
+| [MunifTanjim/minimo](https://github.com/MunifTanjim/minimo) | [MIT](https://github.com/MunifTanjim/minimo/blob/master/LICENSE) |

From 4764a92df3f929f98741e59cee79fe90add523d3 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Tue, 18 Jan 2022 23:19:30 +0100
Subject: [PATCH 31/79] refactor(search): avoid issue with one character
 keyword (#447)

* refactor(search): avoid issue with one character keyword

closes https://github.com/CaiJimmy/hugo-theme-stack/issues/184

* Remove keyword sorts

* fix typo: secion -> section

* fix(search): avoid matching html entity

* Use | operator to concatenate keywords

Idea from https://github.com/CaiJimmy/hugo-theme-stack/pull/436

* Add missing `matchCount`

* Limit preview length

* Don't add ellipsis to title

* add comment to `processMatches`

* Initialize DOMParser only once

* Remove marker function

* Deal with blank search

* Use const keyword for constant arrays
---
 assets/jsconfig.json |   2 +
 assets/ts/search.tsx | 174 +++++++++++++++++++++++++++++--------------
 2 files changed, 120 insertions(+), 56 deletions(-)

diff --git a/assets/jsconfig.json b/assets/jsconfig.json
index 9321136..040177a 100644
--- a/assets/jsconfig.json
+++ b/assets/jsconfig.json
@@ -6,5 +6,7 @@
                 "*"
             ]
         },
+        "lib": ["es2020", "dom"],
+        "jsx": "preserve"
     }
 }
\ No newline at end of file
diff --git a/assets/ts/search.tsx b/assets/ts/search.tsx
index 8e4eb6f..68db7b3 100644
--- a/assets/ts/search.tsx
+++ b/assets/ts/search.tsx
@@ -8,6 +8,11 @@ interface pageData {
     matchCount: number
 }
 
+interface match {
+    start: number,
+    end: number
+}
+
 /**
  * Escape HTML tags as HTML entities
  * Edited from:
@@ -53,79 +58,131 @@ class Search {
         this.bindSearchForm();
     }
 
-    private async searchKeywords(keywords: string[]) {
-        const rawData = await this.getData();
-        let results: pageData[] = [];
-
-        /// Sort keywords by their length
-        keywords.sort((a, b) => {
-            return b.length - a.length
+    /**
+     * Processes search matches
+     * @param str original text
+     * @param matches array of matches
+     * @param ellipsis whether to add ellipsis to the end of each match
+     * @param charLimit max length of preview string
+     * @param offset how many characters before and after the match to include in preview
+     * @returns preview string
+     */
+    private static processMatches(str: string, matches: match[], ellipsis: boolean = true, charLimit = 140, offset = 20): string {
+        matches.sort((a, b) => {
+            return a.start - b.start;
         });
 
+        let i = 0,
+            lastIndex = 0,
+            charCount = 0;
+
+        const resultArray: string[] = [];
+
+        while (i < matches.length) {
+            const item = matches[i];
+
+            /// item.start >= lastIndex (equal only for the first iteration)
+            /// because of the while loop that comes after, iterating over variable j
+
+            if (ellipsis && item.start - offset > lastIndex) {
+                resultArray.push(`${replaceHTMLEnt(str.substring(lastIndex, lastIndex + offset))} [...] `);
+                resultArray.push(`${replaceHTMLEnt(str.substring(item.start - offset, item.start))}`);
+                charCount += offset * 2;
+            }
+            else {
+                /// If the match is too close to the end of last match, don't add ellipsis
+                resultArray.push(replaceHTMLEnt(str.substring(lastIndex, item.start)));
+                charCount += item.start - lastIndex;
+            }
+
+            let j = i + 1,
+                end = item.end;
+
+            /// Include as many matches as possible
+            /// [item.start, end] is the range of the match
+            while (j < matches.length && matches[j].start <= end) {
+                end = Math.max(matches[j].end, end);
+                ++j;
+            }
+
+            resultArray.push(`<mark>${replaceHTMLEnt(str.substring(item.start, end))}</mark>`);
+            charCount += end - item.start;
+
+            i = j;
+            lastIndex = end;
+
+            if (ellipsis && charCount > charLimit) break;
+        }
+
+        /// Add the rest of the string
+        if (lastIndex < str.length) {
+            let end = str.length;
+            if (ellipsis) end = Math.min(end, lastIndex + offset);
+
+            resultArray.push(`${replaceHTMLEnt(str.substring(lastIndex, end))}`);
+
+            if (ellipsis && end != str.length) {
+                resultArray.push(` [...]`);
+            }
+        }
+
+        return resultArray.join('');
+    }
+
+    private async searchKeywords(keywords: string[]) {
+        const rawData = await this.getData();
+        const results: pageData[] = [];
+
+        const regex = new RegExp(keywords.filter((v, index, arr) => {
+            arr[index] = escapeRegExp(v);
+            return v.trim() !== '';
+        }).join('|'), 'gi');
+
         for (const item of rawData) {
+            const titleMatches: match[] = [],
+                contentMatches: match[] = [];
+
             let result = {
                 ...item,
                 preview: '',
                 matchCount: 0
             }
 
-            let matched = false;
-
-            for (const keyword of keywords) {
-                if (keyword === '') continue;
-
-                const regex = new RegExp(escapeRegExp(replaceHTMLEnt(keyword)), 'gi');
-
-                const contentMatch = regex.exec(result.content);
-                regex.lastIndex = 0;            /// Reset regex
-
-                const titleMatch = regex.exec(result.title);
-                regex.lastIndex = 0;            /// Reset regex
-
-                if (titleMatch) {
-                    result.title = result.title.replace(regex, Search.marker);
-                }
-
-                if (titleMatch || contentMatch) {
-                    matched = true;
-                    ++result.matchCount;
-
-                    let start = 0,
-                        end = 100;
-
-                    if (contentMatch) {
-                        start = contentMatch.index - 20;
-                        end = contentMatch.index + 80
-
-                        if (start < 0) start = 0;
-                    }
-
-                    if (result.preview.indexOf(keyword) !== -1) {
-                        result.preview = result.preview.replace(regex, Search.marker);
-                    }
-                    else {
-                        if (start !== 0) result.preview += `[...] `;
-                        result.preview += `${result.content.slice(start, end).replace(regex, Search.marker)} `;
-                    }
-                }
+            const contentMatchAll = item.content.matchAll(regex);
+            for (const match of Array.from(contentMatchAll)) {
+                contentMatches.push({
+                    start: match.index,
+                    end: match.index + match[0].length
+                });
             }
 
-            if (matched) {
-                result.preview += '[...]';
-                results.push(result);
+            const titleMatchAll = item.title.matchAll(regex);
+            for (const match of Array.from(titleMatchAll)) {
+                titleMatches.push({
+                    start: match.index,
+                    end: match.index + match[0].length
+                });
             }
+
+            if (titleMatches.length > 0) result.title = Search.processMatches(result.title, titleMatches, false);
+            if (contentMatches.length > 0) {
+                result.preview = Search.processMatches(result.content, contentMatches);
+            }
+            else {
+                /// If there are no matches in the content, use the first 140 characters as preview
+                result.preview = replaceHTMLEnt(result.content.substring(0, 140));
+            }
+
+            result.matchCount = titleMatches.length + contentMatches.length;
+            if (result.matchCount > 0) results.push(result);
         }
 
-        /** Result with more matches appears first */
+        /// Result with more matches appears first
         return results.sort((a, b) => {
             return b.matchCount - a.matchCount;
         });
     }
 
-    public static marker(match) {
-        return '<mark>' + match + '</mark>';
-    }
-
     private async doSearch(keywords: string[]) {
         const startTime = performance.now();
 
@@ -150,6 +207,11 @@ class Search {
             /// Not fetched yet
             const jsonURL = this.form.dataset.json;
             this.data = await fetch(jsonURL).then(res => res.json());
+            const parser = new DOMParser();
+
+            for (const item of this.data) {
+                item.content = parser.parseFromString(item.content, 'text/html').body.innerText;
+            }
         }
 
         return this.data;
@@ -160,7 +222,7 @@ class Search {
 
         const eventHandler = (e) => {
             e.preventDefault();
-            const keywords = this.input.value;
+            const keywords = this.input.value.trim();
 
             Search.updateQueryString(keywords, true);
 
@@ -225,7 +287,7 @@ class Search {
             <a href={item.permalink}>
                 <div class="article-details">
                     <h2 class="article-title" dangerouslySetInnerHTML={{ __html: item.title }}></h2>
-                    <secion class="article-preview" dangerouslySetInnerHTML={{ __html: item.preview }}></secion>
+                    <section class="article-preview" dangerouslySetInnerHTML={{ __html: item.preview }}></section>
                 </div>
                 {item.image &&
                     <div class="article-image">

From ca260db07e396fba61955e0262930fad3daa64cd Mon Sep 17 00:00:00 2001
From: zhixuan <59254886+zhixuan2333@users.noreply.github.com>
Date: Wed, 19 Jan 2022 09:12:29 +0900
Subject: [PATCH 32/79] fix(shortcode): conflict with gist shortcode (#455)

---
 assets/ts/main.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/assets/ts/main.ts b/assets/ts/main.ts
index d79c127..625bbbc 100644
--- a/assets/ts/main.ts
+++ b/assets/ts/main.ts
@@ -58,7 +58,7 @@ let Stack = {
         /**
          * Add copy button to code block
         */
-        const codeBlocks = document.querySelectorAll('.article-content .highlight');
+        const codeBlocks = document.querySelectorAll('.article-content > div.highlight');
         const copyText = `Copy`,
             copiedText = `Copied!`;
         codeBlocks.forEach(codeBlock => {

From eebaea81e82557663a8a0832d59d07ff531f4664 Mon Sep 17 00:00:00 2001
From: tanmx <tanmingxiao@gmail.com>
Date: Wed, 19 Jan 2022 22:22:51 +0800
Subject: [PATCH 33/79] feat(comment): update twikoo version to 1.4.15 (#464)

---
 layouts/partials/comments/provider/twikoo.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/comments/provider/twikoo.html b/layouts/partials/comments/provider/twikoo.html
index 4dbf976..30c7033 100644
--- a/layouts/partials/comments/provider/twikoo.html
+++ b/layouts/partials/comments/provider/twikoo.html
@@ -1,4 +1,4 @@
-<script src="//cdn.jsdelivr.net/npm/twikoo@1.4.3/dist/twikoo.all.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/twikoo@1.4.15/dist/twikoo.all.min.js"></script>
 <div id="tcomment"></div>
 <style>
     .twikoo {

From bfd1eb84003cd1e364ca3fb288250247a46cf633 Mon Sep 17 00:00:00 2001
From: chenlianghong <clh021@gmail.com>
Date: Wed, 19 Jan 2022 23:35:15 +0800
Subject: [PATCH 34/79] feat: add custom.ts (#461)

* feat: add custom.ts

* Load custom.ts only if it exists

This change avoids loading an empty .js file

Co-authored-by: Jimmy Cai <github@jimmycai.com>
---
 layouts/partials/footer/components/script.html | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/layouts/partials/footer/components/script.html b/layouts/partials/footer/components/script.html
index 83522ff..4cb350c 100644
--- a/layouts/partials/footer/components/script.html
+++ b/layouts/partials/footer/components/script.html
@@ -3,4 +3,10 @@
 {{- $opts := dict "minify" hugo.IsProduction -}}
 {{- $script := resources.Get "ts/main.ts" | js.Build $opts -}}
 
-<script type="text/javascript" src="{{ $script.RelPermalink }}" defer></script>
\ No newline at end of file
+<script type="text/javascript" src="{{ $script.RelPermalink }}" defer></script>
+
+{{- with resources.Get "ts/custom.ts" -}}
+    {{/* Place your custom script in HUGO_SITE_FOLDER/assets/ts/custom.ts */}}
+    {{- $customScript := . | js.Build $opts -}}
+    <script type="text/javascript" src="{{ $customScript.RelPermalink }}" defer></script>
+{{- end -}}
\ No newline at end of file

From fe661c8c3826140c3b006b66abdd581a745e604c Mon Sep 17 00:00:00 2001
From: Andreas Deininger <andreas@deininger.net>
Date: Thu, 20 Jan 2022 11:16:28 +0100
Subject: [PATCH 35/79] feat: turn stack theme into a hugo module (#460)

* Turn stack theme into a hugo module
---
 README.md | 5 ++++-
 go.mod    | 3 +++
 2 files changed, 7 insertions(+), 1 deletion(-)
 create mode 100644 go.mod

diff --git a/README.md b/README.md
index 6ac9e91..0e6caa2 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,10 @@ It's necessary to use **Hugo Extended ≥ 0.87.0**.
 
 ## Installation
 
-Clone / Download this repository to `theme` folder, and edit your site config following `exampleSite/config.yaml`.
+* Route 1: Clone / Download this repository to `theme` folder
+* Route 2: Turn your site into a hugo module and add this theme as a module dependency
+
+ Edit your site config following `exampleSite/config.yaml`.
 
 *Note: Remove `config.toml` if there is one in the site folder.*
 
diff --git a/go.mod b/go.mod
new file mode 100644
index 0000000..1cf4674
--- /dev/null
+++ b/go.mod
@@ -0,0 +1,3 @@
+module github.com/CaiJimmy/hugo-theme-stack
+
+go 1.12

From 3b98d3ba051f64c52ba6a21125b2016a61e6edc3 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 20 Jan 2022 11:38:16 +0100
Subject: [PATCH 36/79] feat(sidebar): link avatar to homepage (#465)

closes https://github.com/CaiJimmy/hugo-theme-stack/issues/399
---
 layouts/partials/sidebar/left.html | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index db05480..4442dfe 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -9,6 +9,7 @@
         {{ with .Site.Params.sidebar.avatar }}
             {{ if (default true .enabled) }}
             <figure class="site-avatar">
+                <a href="{{ .Site.BaseURL | relLangURL }}">
                 {{ if not .local }}
                     <img src="{{ .src }}" width="300" height="300" class="site-logo" loading="lazy" alt="Avatar">
                 {{ else }}
@@ -22,7 +23,7 @@
                         {{ errorf "Failed loading avatar from %q" . }}
                     {{ end }}
                 {{ end }}
-
+                </a>
                 {{ with $.Site.Params.sidebar.emoji }}
                     <span class="emoji">{{ . }}</span>
                 {{ end }}

From 0af9d23e4989ed7ada10e6990802ccd9a28d8797 Mon Sep 17 00:00:00 2001
From: zhixuan <59254886+zhixuan2333@users.noreply.github.com>
Date: Thu, 20 Jan 2022 20:09:25 +0900
Subject: [PATCH 37/79] feat(article): add scroll for table (#428)

* feat: table can't scroll & delete scrollbar style for Chromium

* Undo some line breaks

* Add a table with overflow to exampleSite
---
 assets/scss/partials/base.scss                    | 14 --------------
 assets/scss/partials/layout/article.scss          | 12 ++++++++++--
 assets/scss/variables.scss                        |  1 +
 exampleSite/content/post/markdown-syntax/index.md |  4 ++++
 layouts/partials/article/components/content.html  |  4 +++-
 5 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/assets/scss/partials/base.scss b/assets/scss/partials/base.scss
index ab3bf42..f02dcbd 100644
--- a/assets/scss/partials/base.scss
+++ b/assets/scss/partials/base.scss
@@ -23,17 +23,3 @@ body {
     scrollbar-color: var(--scrollbar-thumb) transparent;
 }
 /**/
-
-/* scrollbar styles for Chromium */
-::-webkit-scrollbar {
-    height: auto;
-}
-
-::-webkit-scrollbar-thumb {
-    background-color: var(--scrollbar-thumb);
-}
-
-::-webkit-scrollbar-track {
-    background-color: transparent;
-}
-/**/
diff --git a/assets/scss/partials/layout/article.scss b/assets/scss/partials/layout/article.scss
index 7059853..b421cfc 100644
--- a/assets/scss/partials/layout/article.scss
+++ b/assets/scss/partials/layout/article.scss
@@ -71,7 +71,8 @@
                 text-transform: unset;
             }
 
-            .article-copyright, .article-lastmod {
+            .article-copyright,
+            .article-lastmod {
                 a {
                     color: var(--body-text-color);
                 }
@@ -359,6 +360,12 @@
         }
     }
 
+    .table-wrapper {
+        padding: 0 var(--card-padding);
+        overflow-x: auto;
+        display: block;
+    }
+
     table {
         width: 100%;
         border-collapse: collapse;
@@ -407,9 +414,10 @@
     /// Negative margins
     blockquote,
     figure,
-    .gallery,
     pre,
+    .gallery,
     .video-wrapper,
+    .table-wrapper,
     .s_video_simple {
         margin-left: calc((var(--card-padding)) * -1);
         margin-right: calc((var(--card-padding)) * -1);
diff --git a/assets/scss/variables.scss b/assets/scss/variables.scss
index c75eb5c..8e371d6 100644
--- a/assets/scss/variables.scss
+++ b/assets/scss/variables.scss
@@ -8,6 +8,7 @@ $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
 }
 
 [data-scheme="dark"] {
+    color-scheme: dark;
     --pre-text-color: #f8f8f2;
     --pre-background-color: #272822;
     @import "partials/highlight/dark.scss";
diff --git a/exampleSite/content/post/markdown-syntax/index.md b/exampleSite/content/post/markdown-syntax/index.md
index 85fdcff..be381a0 100644
--- a/exampleSite/content/post/markdown-syntax/index.md
+++ b/exampleSite/content/post/markdown-syntax/index.md
@@ -69,6 +69,10 @@ Tables aren't part of the core Markdown spec, but Hugo supports supports them ou
 | --------  | -------- | ------ |
 | *italics* | **bold** | `code` |
 
+| A                                                        | B                                                                                                             | C                                                                                                                                    | D                                                 | E                                                          | F                                                                    |
+|----------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|------------------------------------------------------------|----------------------------------------------------------------------|
+| Lorem ipsum dolor sit amet, consectetur adipiscing elit. | Phasellus ultricies, sapien non euismod aliquam, dui ligula tincidunt odio, at accumsan nulla sapien eget ex. | Proin eleifend dictum ipsum, non euismod ipsum pulvinar et. Vivamus sollicitudin, quam in pulvinar aliquam, metus elit pretium purus | Proin sit amet velit nec enim imperdiet vehicula. | Ut bibendum vestibulum quam, eu egestas turpis gravida nec | Sed scelerisque nec turpis vel viverra. Vivamus vitae pretium sapien |
+
 ## Code Blocks
 
 #### Code block with backticks
diff --git a/layouts/partials/article/components/content.html b/layouts/partials/article/components/content.html
index fc0f8f6..61e536c 100644
--- a/layouts/partials/article/components/content.html
+++ b/layouts/partials/article/components/content.html
@@ -1,3 +1,5 @@
 <section class="article-content">
-    {{ .Content }}
+    <!-- Refer to https://discourse.gohugo.io/t/responsive-tables-in-markdown/10639/5 -->
+    {{ $wrappedTable := printf "<div class=\"table-wrapper\">${1}</div>" }}
+    {{ .Content | replaceRE "(<table>(?:.|\n)+?</table>)" $wrappedTable | safeHTML }}
 </section>

From 9e0885468167bf1ad831436df328542b6e7f57f7 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 20 Jan 2022 11:12:16 +0000
Subject: [PATCH 38/79] release: 3.7.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index a2baf19..d367b25 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.6.0" -}}
+{{- $ThemeVersion := "3.7.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From 2b40a32d4785ab3c3d12a09ea8a136b1522deabe Mon Sep 17 00:00:00 2001
From: Zoroark <utybodev@gmail.com>
Date: Sat, 22 Jan 2022 10:35:08 +0100
Subject: [PATCH 39/79] feat(article): Scrollspy for the table of contents
 (#425)

* Add first try at scrollspy (broken right now)

* Scrollspy actually works now

* Fix VS Code errors by setting JS version

* Recompute offsets when window size changes

* Improve list compatibility for toc active selection

Support up to 6 levels of indentation, properly support <ol>

* Remove debug string

* Add more docs in smoothAnchors

* Use a map to match ids to navigation elements
---
 .gitignore                               |   3 +-
 assets/scss/partials/base.scss           |   1 -
 assets/scss/partials/layout/article.scss |  41 ++++++-
 assets/ts/main.ts                        |   4 +
 assets/ts/scrollspy.ts                   | 131 +++++++++++++++++++++++
 assets/ts/smoothAnchors.ts               |  34 ++++++
 6 files changed, 209 insertions(+), 5 deletions(-)
 create mode 100644 assets/ts/scrollspy.ts
 create mode 100644 assets/ts/smoothAnchors.ts

diff --git a/.gitignore b/.gitignore
index 9ebefdf..9ff142d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 public
 resources
-assets/jsconfig.json
\ No newline at end of file
+assets/jsconfig.json
+.hugo_build.lock
\ No newline at end of file
diff --git a/assets/scss/partials/base.scss b/assets/scss/partials/base.scss
index f02dcbd..408629e 100644
--- a/assets/scss/partials/base.scss
+++ b/assets/scss/partials/base.scss
@@ -1,7 +1,6 @@
 html {
     font-size: 62.5%;
     overflow-y: scroll;
-    scroll-behavior: smooth;
 }
 
 * {
diff --git a/assets/scss/partials/layout/article.scss b/assets/scss/partials/layout/article.scss
index b421cfc..78ed81c 100644
--- a/assets/scss/partials/layout/article.scss
+++ b/assets/scss/partials/layout/article.scss
@@ -123,7 +123,6 @@
 }
 
 .article-page.has-toc {
-    scroll-behavior: smooth;
 
     .left-sidebar {
         display: none;
@@ -194,6 +193,10 @@
     color: var(--card-text-color-main);
     overflow: hidden;
 
+    ::-webkit-scrollbar-thumb {
+        background-color: var(--card-separator-color);
+    }
+
     #TableOfContents {
         overflow-x: auto;
         max-height: 75vh;
@@ -208,7 +211,7 @@
             list-style-type: none;
             counter-reset: item;
 
-            li:before {
+            li a::before {
                 counter-increment: item;
                 content: counters(item, ".") ". ";
                 font-weight: bold;
@@ -221,7 +224,7 @@
         }
 
         li {
-            margin: 15px 20px;
+            margin: 15px 0 15px 20px;
             padding: 5px;
 
             & > ol,
@@ -235,6 +238,38 @@
                 }
             }
         }
+        li.active-class > a {
+            border-left: var(--heading-border-size) solid var(--accent-color);
+            font-weight: bold;
+        }
+
+        ul li.active-class > a {
+            display: block;
+        }
+
+        @function repeat($str, $n) {
+            $result: "";
+            @for $_ from 0 to $n {
+                $result: $result + $str;
+            }
+            @return $result;
+        }
+
+        // Support up to 6 levels of indentation for lists in ToCs
+        @for $i from 0 to 5 {
+            & > ul #{repeat("> li > ul", $i)} > li.active-class > a {
+                $n: 25 + $i * 35;
+                margin-left: calc(-#{$n}px - 1em);
+                padding-left: calc(#{$n}px + 1em - var(--heading-border-size));
+            }
+
+            & > ol #{repeat("> li > ol", $i)} > li.active-class > a {
+                $n: 9 + $i * 35;
+                margin-left: calc(-#{$n}px - 1em);
+                padding-left: calc(#{$n}px + 1em - var(--heading-border-size));
+                display: block;
+            }
+        }
     }
 }
 
diff --git a/assets/ts/main.ts b/assets/ts/main.ts
index 625bbbc..20de18c 100644
--- a/assets/ts/main.ts
+++ b/assets/ts/main.ts
@@ -10,6 +10,8 @@ import { getColor } from 'ts/color';
 import menu from 'ts/menu';
 import createElement from 'ts/createElement';
 import StackColorScheme from 'ts/colorScheme';
+import { setupScrollspy } from 'ts/scrollspy';
+import { setupSmoothAnchors } from "ts/smoothAnchors";
 
 let Stack = {
     init: () => {
@@ -21,6 +23,8 @@ let Stack = {
         const articleContent = document.querySelector('.article-content') as HTMLElement;
         if (articleContent) {
             new StackGallery(articleContent);
+            setupSmoothAnchors();
+            setupScrollspy();
         }
 
         /**
diff --git a/assets/ts/scrollspy.ts b/assets/ts/scrollspy.ts
new file mode 100644
index 0000000..8a14085
--- /dev/null
+++ b/assets/ts/scrollspy.ts
@@ -0,0 +1,131 @@
+// Implements a scroll spy system for the ToC, displaying the current section with an indicator and scrolling to it when needed.
+
+// Inspired from https://gomakethings.com/debouncing-your-javascript-events/
+function debounced(func: Function) {
+    let timeout;
+    return () => {
+        if (timeout) {
+            window.cancelAnimationFrame(timeout);
+        }
+
+        timeout = window.requestAnimationFrame(() => func());
+    }
+}
+
+const headersQuery = ".article-content h1[id], .article-content h2[id], .article-content h3[id], .article-content h4[id], .article-content h5[id], .article-content h6[id]";
+const tocQuery = "#TableOfContents";
+const navigationQuery = "#TableOfContents li";
+const activeClass = "active-class";
+
+function scrollToTocElement(tocElement: HTMLElement, scrollableNavigation: HTMLElement) {
+    let textHeight = tocElement.querySelector("a").offsetHeight;
+    let scrollTop = tocElement.offsetTop - scrollableNavigation.offsetHeight / 2 + textHeight / 2 - scrollableNavigation.offsetTop;
+    if (scrollTop < 0) {
+        scrollTop = 0;
+    }
+    scrollableNavigation.scrollTo({ top: scrollTop, behavior: "smooth" });
+}
+
+type IdToElementMap = { [key: string]: HTMLElement };
+
+function buildIdToNavigationElementMap(navigation: NodeListOf<Element>): IdToElementMap {
+    const sectionLinkRef: IdToElementMap = {};
+    navigation.forEach((navigationElement: HTMLElement) => {
+        const link = navigationElement.querySelector("a");
+        const href = link.getAttribute("href");
+        if (href.startsWith("#")) {
+            sectionLinkRef[href.slice(1)] = navigationElement;
+        }
+    });
+
+    return sectionLinkRef;
+}
+
+function computeOffsets(headers: NodeListOf<Element>) {
+    let sectionsOffsets = [];
+    headers.forEach((header: HTMLElement) => { sectionsOffsets.push({ id: header.id, offset: header.offsetTop }) });
+    sectionsOffsets.sort((a, b) => a.offset - b.offset);
+    return sectionsOffsets;
+}
+
+function setupScrollspy() {
+    let headers = document.querySelectorAll(headersQuery);
+    if (!headers) {
+        console.warn("No header matched query", headers);
+        return;
+    }
+
+    let scrollableNavigation = document.querySelector(tocQuery) as HTMLElement | undefined;
+    if (!scrollableNavigation) {
+        console.warn("No toc matched query", tocQuery);
+        return;
+    }
+
+    let navigation = document.querySelectorAll(navigationQuery);
+    if (!navigation) {
+        console.warn("No navigation matched query", navigationQuery);
+        return;
+    }
+
+    let sectionsOffsets = computeOffsets(headers);
+
+    // We need to avoid scrolling when the user is actively interacting with the ToC. Otherwise, if the user clicks on a link in the ToC,
+    // we would scroll their view, which is not optimal usability-wise.
+    let tocHovered: boolean = false;
+    scrollableNavigation.addEventListener("mouseenter", debounced(() => tocHovered = true));
+    scrollableNavigation.addEventListener("mouseleave", debounced(() => tocHovered = false));
+
+    let activeSectionLink: Element;
+
+    let idToNavigationElement: IdToElementMap = buildIdToNavigationElementMap(navigation);
+
+    function scrollHandler() {
+        let scrollPosition = document.documentElement.scrollTop || document.body.scrollTop;
+
+        let newActiveSection: HTMLElement | undefined;
+
+        // Find the section that is currently active.
+        // It is possible for no section to be active, so newActiveSection may be undefined.
+        sectionsOffsets.forEach((section) => {
+            if (scrollPosition >= section.offset - 20) {
+                newActiveSection = document.getElementById(section.id);
+            }
+        });
+
+        // Find the link for the active section. Once again, there are a few edge cases:
+        // - No active section = no link => undefined
+        // - No active section but the link does not exist in toc (e.g. because it is outside of the applicable ToC levels) => undefined
+        let newActiveSectionLink: HTMLElement | undefined
+        if (newActiveSection) {
+            newActiveSectionLink = idToNavigationElement[newActiveSection.id];
+        }
+
+        if (newActiveSection && !newActiveSectionLink) {
+            // The active section does not have a link in the ToC, so we can't scroll to it.
+            console.debug("No link found for section", newActiveSection);
+        } else if (newActiveSectionLink !== activeSectionLink) {
+            if (activeSectionLink)
+                activeSectionLink.classList.remove(activeClass);
+            if (newActiveSectionLink) {
+                newActiveSectionLink.classList.add(activeClass);
+                if (!tocHovered) {
+                    // Scroll so that newActiveSectionLink is in the middle of scrollableNavigation, except when it's from a manual click (hence the tocHovered check)
+                    scrollToTocElement(newActiveSectionLink, scrollableNavigation);
+                }
+            }
+            activeSectionLink = newActiveSectionLink;
+        }
+    }
+
+    window.addEventListener("scroll", debounced(scrollHandler));
+    
+    // Resizing may cause the offset values to change: recompute them.
+    function resizeHandler() {
+        sectionsOffsets = computeOffsets(headers);
+        scrollHandler();
+    }
+
+    window.addEventListener("resize", debounced(resizeHandler));
+}
+
+export { setupScrollspy };
\ No newline at end of file
diff --git a/assets/ts/smoothAnchors.ts b/assets/ts/smoothAnchors.ts
new file mode 100644
index 0000000..0718bf5
--- /dev/null
+++ b/assets/ts/smoothAnchors.ts
@@ -0,0 +1,34 @@
+// Implements smooth scrolling when clicking on an anchor link.
+// This is required instead of using modern CSS because Chromium does not currently support scrolling
+// one element with scrollTo while another element is scrolled because of a click on a link. This would
+// thus not work with the ToC scrollspy and e.g. footnotes.
+
+// Here are additional links about this issue:
+// - https://stackoverflow.com/questions/49318497/google-chrome-simultaneously-smooth-scrollintoview-with-more-elements-doesn
+// - https://stackoverflow.com/questions/57214373/scrollintoview-using-smooth-function-on-multiple-elements-in-chrome
+// - https://bugs.chromium.org/p/chromium/issues/detail?id=833617
+// - https://bugs.chromium.org/p/chromium/issues/detail?id=1043933
+// - https://bugs.chromium.org/p/chromium/issues/detail?id=1121151
+
+const anchorLinksQuery = "a[href]";
+
+function setupSmoothAnchors() {
+    document.querySelectorAll(anchorLinksQuery).forEach(aElement => {
+        let href = aElement.getAttribute("href");
+        if (!href.startsWith("#")) {
+            return;
+        }
+        aElement.addEventListener("click", clickEvent => {
+            clickEvent.preventDefault();
+
+            let targetId = aElement.getAttribute("href").substring(1);
+            // The replace done on ':' is here for footnotes, as this character would otherwise interfere when used as a CSS selector.
+            let target = document.querySelector(`#${targetId.replace(":", "\\:")}`) as HTMLElement;
+
+            window.history.pushState({}, "", aElement.getAttribute("href"));
+            scrollTo({ top: target.offsetTop, behavior: "smooth" });
+        });
+    });
+}
+
+export { setupSmoothAnchors };
\ No newline at end of file

From 7dc5def2175fbd5021f0109af25202fbb7567757 Mon Sep 17 00:00:00 2001
From: Marcel <MTRNord@users.noreply.github.com>
Date: Sun, 23 Jan 2022 13:10:00 +0100
Subject: [PATCH 40/79] feat(comments): add https://cactus.chat support (#298)

* feat: Add https://cactus.chat as comments provider

* Add cactus comments config fields to exampleSite

* Add cactus css and js to external.yaml and move custom cactus css to html

* Remove unneeded cactus comments css

* Load external dependencies for cactus comments in the comments provider

* Use safeJS instead of safeHTML
---
 data/external.yaml                            |  9 ++++++
 exampleSite/config.yaml                       |  7 ++++-
 .../partials/comments/provider/cactus.html    | 29 +++++++++++++++++++
 3 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 layouts/partials/comments/provider/cactus.html

diff --git a/data/external.yaml b/data/external.yaml
index 427c8aa..4b2713f 100644
--- a/data/external.yaml
+++ b/data/external.yaml
@@ -36,3 +36,12 @@ KaTeX:
       integrity: sha384-vZTG03m+2yp6N6BNi5iM4rW4oIwk5DfcNdFfxkk9ZWpDriOkXX8voJBFrAO7MpVl
       type: script
       defer: true
+
+Cactus:
+    - src: https://latest.cactus.chat/cactus.js
+      integrity:
+      type: script
+      defer: false
+    - src: https://latest.cactus.chat/style.css
+      integrity:
+      type: style
\ No newline at end of file
diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 28958ae..a67b4aa 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -104,6 +104,12 @@ params:
             path:
             lang:
 
+        # See https://cactus.chat/docs/reference/web-client/#configuration for description of the various options
+        cactus:
+            defaultHomeserverUrl: "https://matrix.cactus.chat:8448"
+            serverName: "cactus.chat"
+            siteName: "" # You must insert a unique identifier here matching the one you registered (See https://cactus.chat/docs/getting-started/quick-start/#register-your-site)
+            
         giscus:
             repo:
             repoID:
@@ -125,7 +131,6 @@ params:
         cusdis:
             host: 
             id: 
-
     widgets:
         enabled:
             - search
diff --git a/layouts/partials/comments/provider/cactus.html b/layouts/partials/comments/provider/cactus.html
new file mode 100644
index 0000000..8224c8b
--- /dev/null
+++ b/layouts/partials/comments/provider/cactus.html
@@ -0,0 +1,29 @@
+{{- with .Site.Params.comments.cactus -}}
+{{- partial "helper/external" (dict "Context" . "Namespace" "Cactus") -}}
+
+<style>
+    .cactus-editor-textarea {
+        color: var(--body-text-color);
+    }
+
+    .cactus-comment-header {
+        color: var(--card-text-color-main);
+    }
+
+    .cactus-message-text > p {
+        color: var(--body-text-color);
+    }
+</style>
+
+<div id="comment-section"></div>
+
+<script>
+    initComments({
+        node: document.getElementById("comment-section"),
+        defaultHomeserverUrl: "{{ .defaultHomeserverUrl | safeJS }}",
+        serverName: "{{ .serverName }}",
+        siteName: "{{ .siteName }}",
+        commentSectionId: "{{ $.File.UniqueID }}"
+    })
+</script>
+{{- end -}}

From 6474b9dfd8a5164a191b8aa8f33900e79a2ef0c6 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 23 Jan 2022 12:59:21 +0000
Subject: [PATCH 41/79] fix(comments): fix cactus comments

closes https://github.com/CaiJimmy/hugo-theme-stack/issues/470
---
 data/external.yaml                             | 3 +--
 layouts/partials/comments/provider/cactus.html | 2 +-
 layouts/partials/helper/external.html          | 2 +-
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/data/external.yaml b/data/external.yaml
index 4b2713f..fd2b665 100644
--- a/data/external.yaml
+++ b/data/external.yaml
@@ -41,7 +41,6 @@ Cactus:
     - src: https://latest.cactus.chat/cactus.js
       integrity:
       type: script
-      defer: false
     - src: https://latest.cactus.chat/style.css
       integrity:
-      type: style
\ No newline at end of file
+      type: style
diff --git a/layouts/partials/comments/provider/cactus.html b/layouts/partials/comments/provider/cactus.html
index 8224c8b..ae172d3 100644
--- a/layouts/partials/comments/provider/cactus.html
+++ b/layouts/partials/comments/provider/cactus.html
@@ -1,5 +1,5 @@
 {{- with .Site.Params.comments.cactus -}}
-{{- partial "helper/external" (dict "Context" . "Namespace" "Cactus") -}}
+{{- partial "helper/external" (dict "Context" $ "Namespace" "Cactus") -}}
 
 <style>
     .cactus-editor-textarea {
diff --git a/layouts/partials/helper/external.html b/layouts/partials/helper/external.html
index e1505d4..88d9525 100644
--- a/layouts/partials/helper/external.html
+++ b/layouts/partials/helper/external.html
@@ -8,7 +8,7 @@
                 integrity="{{ . }}"
                 {{- end -}}
                 crossorigin="anonymous"
-                defer="{{ default false .defer }}"
+                {{ if .defer }}defer{{ end }}
                 >
             </script>
         {{- else if eq .type "style" -}}

From 67d5156507acdf66cc132d3a1d59f2bb92486c8f Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 30 Jan 2022 10:57:16 +0100
Subject: [PATCH 42/79] fix: disqus dark mode (#478)

* fix: disqus dark mode

* remove color-scheme

add custom chrome scrollbar style (removed in https://github.com/CaiJimmy/hugo-theme-stack/pull/428)
---
 assets/scss/partials/base.scss | 14 ++++++++++++++
 assets/scss/variables.scss     |  3 +--
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/assets/scss/partials/base.scss b/assets/scss/partials/base.scss
index 408629e..e7aefe6 100644
--- a/assets/scss/partials/base.scss
+++ b/assets/scss/partials/base.scss
@@ -22,3 +22,17 @@ body {
     scrollbar-color: var(--scrollbar-thumb) transparent;
 }
 /**/
+
+/* scrollbar styles for Chromium */
+::-webkit-scrollbar {
+    height: auto;
+}
+
+::-webkit-scrollbar-thumb {
+    background-color: var(--scrollbar-thumb);
+}
+
+::-webkit-scrollbar-track {
+    background-color: transparent;
+}
+/**/
diff --git a/assets/scss/variables.scss b/assets/scss/variables.scss
index 8e371d6..323f2b7 100644
--- a/assets/scss/variables.scss
+++ b/assets/scss/variables.scss
@@ -8,7 +8,6 @@ $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
 }
 
 [data-scheme="dark"] {
-    color-scheme: dark;
     --pre-text-color: #f8f8f2;
     --pre-background-color: #272822;
     @import "partials/highlight/dark.scss";
@@ -46,7 +45,7 @@ $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
         --accent-color-darker: #bdc3c7;
         --accent-color-text: #000;
         --body-text-color: rgba(255, 255, 255, 0.7);
-        --scrollbar-thumb: #424242;
+        --scrollbar-thumb: hsl(0, 0%, 40%);
         --scrollbar-track: var(--body-background);
     }
 }

From 88beecd1017829346863d5d3f1f8fabe38843a30 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Feb 2022 19:58:10 +0100
Subject: [PATCH 43/79] fix: hyperlinked image (#485)

* fix: hyperlinked image

closes https://github.com/CaiJimmy/hugo-theme-stack/issues/410

* feat: add support to inline images

* Remove unused code

* Remove data-alt-html
---
 assets/ts/gallery.ts                          | 52 +++++++++++++++++++
 .../content/post/markdown-syntax/index.md     |  4 ++
 layouts/_default/_markup/render-image.html    | 27 ++++------
 3 files changed, 67 insertions(+), 16 deletions(-)

diff --git a/assets/ts/gallery.ts b/assets/ts/gallery.ts
index 5de13a2..ec7c02d 100644
--- a/assets/ts/gallery.ts
+++ b/assets/ts/gallery.ts
@@ -57,6 +57,58 @@ class StackGallery {
     }
 
     public static createGallery(container: HTMLElement) {
+        /// The process of wrapping image with figure tag is done using JavaScript instead of only Hugo markdown render hook
+        /// because it can not detect whether image is being wrapped by a link or not
+        /// and it lead to a invalid HTML construction (<a><figure><img></figure></a>)
+
+        const images = container.querySelectorAll('img');
+        for (const img of Array.from(images)) {
+            /// Images are wrapped with figure tag if the paragraph has only images without texts
+            /// This is done to allow inline images within paragraphs
+            const paragraph = img.closest('p');
+
+            if (paragraph.textContent.trim() == '') {
+                /// Once we insert figcaption, this check no longer works
+                /// So we add a class to paragraph to mark it
+                paragraph.classList.add('no-text');
+            }
+
+            let isNewLineImage = paragraph.classList.contains('no-text');
+            if (!isNewLineImage) continue;
+
+            const hasLink = img.parentElement.tagName == 'A';
+
+            let el: HTMLElement = img;
+            /// Wrap image with figure tag, with flex-grow and flex-basis values extracted from img's data attributes
+            const figure = document.createElement('figure');
+            figure.style.setProperty('flex-grow', img.getAttribute('data-flex-grow') || '1');
+            figure.style.setProperty('flex-basis', img.getAttribute('data-flex-basis') || '0');
+            if (hasLink) {
+                /// Wrap <a> if it exists
+                el = img.parentElement;
+            }
+            el.parentElement.insertBefore(figure, el);
+            figure.appendChild(el);
+
+            /// Add figcaption if it exists
+            if (img.hasAttribute('alt')) {
+                const figcaption = document.createElement('figcaption');
+                figcaption.innerText = img.getAttribute('alt');
+                figure.appendChild(figcaption);
+            }
+
+            /// Wrap img tag with <a> tag if image was not wrapped by <a> tag
+            if (!hasLink) {
+                figure.className = 'gallery-image';
+
+                const a = document.createElement('a');
+                a.href = img.src;
+                a.setAttribute('target', '_blank');
+                img.parentNode.insertBefore(a, img);
+                a.appendChild(img);
+            }
+        }
+
         const figuresEl = container.querySelectorAll('figure.gallery-image');
 
         let currentGallery = [];
diff --git a/exampleSite/content/post/markdown-syntax/index.md b/exampleSite/content/post/markdown-syntax/index.md
index be381a0..0254cca 100644
--- a/exampleSite/content/post/markdown-syntax/index.md
+++ b/exampleSite/content/post/markdown-syntax/index.md
@@ -162,3 +162,7 @@ X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
 Press <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd></kbd> to end the session.
 
 Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.
+
+## Hyperlinked image
+
+[![Google](https://www.google.com/images/branding/googlelogo/1x/googlelogo_light_color_272x92dp.png)](https://google.com)
\ No newline at end of file
diff --git a/layouts/_default/_markup/render-image.html b/layouts/_default/_markup/render-image.html
index 0325458..0ed5584 100644
--- a/layouts/_default/_markup/render-image.html
+++ b/layouts/_default/_markup/render-image.html
@@ -25,22 +25,17 @@
 	{{- end -}}
 {{- end -}}
 
-<figure 
+<img src="{{ $Permalink }}"
+	{{ with $Width }}width="{{ . }}"{{ end }}
+	{{ with $Height }}height="{{ . }}"{{ end }}
+	{{ with $Srcset }}srcset="{{ . }}"{{ end }}
+	loading="lazy"
+	{{ with $alt }}
+		alt="{{ . }}"
+	{{ end }}
 	{{ if $galleryImage }}
 		class="gallery-image" 
-		style="
-			flex-grow: {{ div (mul $image.Width 100) $image.Height }}; 
-			flex-basis: {{ div (mul $image.Width 240) $image.Height }}px"
-	{{ end }}>
-	<a href="{{ $Permalink }}" {{ if $galleryImage }}data-size="{{ $image.Width }}x{{ $image.Height }}"{{ end }}>
-		<img src="{{ $Permalink }}"
-			{{ with $Width }}width="{{ . }}"{{ end }}
-			{{ with $Height }}height="{{ . }}"{{ end }}
-			{{ with $Srcset }}srcset="{{ . }}"{{ end }}
-			loading="lazy"
-			{{ with $alt }}alt="{{ . }}"{{ end }}>
-	</a>
-	{{ with $alt }}
-	<figcaption>{{ . | markdownify }}</figcaption>
+		data-flex-grow="{{ div (mul $image.Width 100) $image.Height }}"
+		data-flex-basis="{{ div (mul $image.Width 240) $image.Height }}px"
 	{{ end }}
-</figure>
\ No newline at end of file
+>
\ No newline at end of file

From d75dbe2b6e7ec92f83a5b3866d6e809173be5da3 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Feb 2022 20:32:37 +0100
Subject: [PATCH 44/79] fix: copy code button does not work when line number is
 enabled (#487)

* fix: copy code button does not work when line number is enabled

* fix pre style

* Add gist shortcode to exampleSite
---
 assets/scss/partials/layout/article.scss      | 63 +++++++++++--------
 assets/ts/main.ts                             | 13 ++--
 exampleSite/config.yaml                       | 32 ++++++----
 .../content/post/rich-content/index.md        |  4 ++
 4 files changed, 66 insertions(+), 46 deletions(-)

diff --git a/assets/scss/partials/layout/article.scss b/assets/scss/partials/layout/article.scss
index 78ed81c..af5f7bb 100644
--- a/assets/scss/partials/layout/article.scss
+++ b/assets/scss/partials/layout/article.scss
@@ -123,7 +123,6 @@
 }
 
 .article-page.has-toc {
-
     .left-sidebar {
         display: none;
     }
@@ -395,6 +394,41 @@
         }
     }
 
+    .highlight {
+        background-color: var(--pre-background-color);
+        padding: var(--card-padding);
+        position: relative;
+
+        &:hover {
+            .copyCodeButton {
+                opacity: 1;
+            }
+        }
+
+        pre {
+            margin: initial;
+            padding: 0;
+            margin: 0;
+            width: auto;
+        }
+    }
+
+    .copyCodeButton {
+        position: absolute;
+        top: calc(var(--card-padding));
+        right: calc(var(--card-padding));
+        background: var(--card-background);
+        border: none;
+        box-shadow: var(--shadow-l2);
+        border-radius: var(--tag-border-radius);
+        padding: 8px 16px;
+        color: var(--card-text-color-main);
+        cursor: pointer;
+        font-size: 14px;
+        opacity: 0;
+        transition: opacity 0.3s ease;
+    }
+
     .table-wrapper {
         padding: 0 var(--card-padding);
         overflow-x: auto;
@@ -449,6 +483,7 @@
     /// Negative margins
     blockquote,
     figure,
+    .highlight,
     pre,
     .gallery,
     .video-wrapper,
@@ -458,30 +493,4 @@
         margin-right: calc((var(--card-padding)) * -1);
         width: calc(100% + var(--card-padding) * 2);
     }
-
-    .highlight {
-        position: relative;
-
-        &:hover {
-            .copyCodeButton {
-                opacity: 1;
-            }
-        }
-    }
-
-    .copyCodeButton {
-        position: absolute;
-        top: calc(var(--card-padding));
-        right: 0;
-        background: var(--card-background);
-        border: none;
-        box-shadow: var(--shadow-l2);
-        border-radius: var(--tag-border-radius);
-        padding: 8px 16px;
-        color: var(--card-text-color-main);
-        cursor: pointer;
-        font-size: 14px;
-        opacity: 0;
-        transition: opacity 0.3s ease;
-    }
 }
diff --git a/assets/ts/main.ts b/assets/ts/main.ts
index 20de18c..f3160ae 100644
--- a/assets/ts/main.ts
+++ b/assets/ts/main.ts
@@ -62,20 +62,21 @@ let Stack = {
         /**
          * Add copy button to code block
         */
-        const codeBlocks = document.querySelectorAll('.article-content > div.highlight');
+        const highlights = document.querySelectorAll('.article-content div.highlight');
         const copyText = `Copy`,
             copiedText = `Copied!`;
-        codeBlocks.forEach(codeBlock => {
+
+        highlights.forEach(highlight => {
             const copyButton = document.createElement('button');
             copyButton.innerHTML = copyText;
             copyButton.classList.add('copyCodeButton');
-            codeBlock.appendChild(copyButton);
+            highlight.appendChild(copyButton);
 
-            const pre = codeBlock.getElementsByTagName('pre');
-            const code = pre[0].textContent;
+            const codeBlock = highlight.querySelector('code[data-lang]');
+            if (!codeBlock) return;
 
             copyButton.addEventListener('click', () => {
-                navigator.clipboard.writeText(code)
+                navigator.clipboard.writeText(codeBlock.textContent)
                     .then(() => {
                         copyButton.textContent = copiedText;
 
diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index a67b4aa..d449fc9 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -109,7 +109,7 @@ params:
             defaultHomeserverUrl: "https://matrix.cactus.chat:8448"
             serverName: "cactus.chat"
             siteName: "" # You must insert a unique identifier here matching the one you registered (See https://cactus.chat/docs/getting-started/quick-start/#register-your-site)
-            
+
         giscus:
             repo:
             repoID:
@@ -122,15 +122,15 @@ params:
             emitMetadata: 0
 
         gitalk:
-            owner: 
-            admin:  
-            repo: 
-            clientID: 
-            clientSecret: 
-        
+            owner:
+            admin:
+            repo:
+            clientID:
+            clientSecret:
+
         cusdis:
-            host: 
-            id: 
+            host:
+            id:
     widgets:
         enabled:
             - search
@@ -183,19 +183,19 @@ menu:
               ### For demonstration purpose, the home link will be open in a new tab
               newTab: true
               icon: home
-    
+
     social:
         - identifier: github
           name: GitHub
           url: https://github.com/CaiJimmy/hugo-theme-stack
           params:
-            icon: brand-github
-            
+              icon: brand-github
+
         - identifier: twitter
           name: Twitter
           url: https://twitter.com
           params:
-            icon: brand-twitter
+              icon: brand-twitter
 
 related:
     includeNewer: true
@@ -219,3 +219,9 @@ markup:
         startLevel: 2
     highlight:
         noClasses: false
+        codeFences: true
+        guessSyntax: true
+        lineNoStart: 1
+        lineNos: true
+        lineNumbersInTable: true
+        tabWidth: 4
diff --git a/exampleSite/content/post/rich-content/index.md b/exampleSite/content/post/rich-content/index.md
index af8a390..f2b45db 100644
--- a/exampleSite/content/post/rich-content/index.md
+++ b/exampleSite/content/post/rich-content/index.md
@@ -36,3 +36,7 @@ Hugo ships with several [Built-in Shortcodes](https://gohugo.io/content-manageme
 ## bilibilibi Shortcode
 
 {{< bilibili av498363026 >}}
+
+## Gist Shortcode
+
+{{< gist spf13 7896402 >}}
\ No newline at end of file

From 9f36a956ca3f6f34bad58f73c159ea2e0e3daee0 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Feb 2022 19:36:10 +0000
Subject: [PATCH 45/79] release: 3.8.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index d367b25..072465c 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.7.0" -}}
+{{- $ThemeVersion := "3.8.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From ce57ea915e1f6f67e985259c52d6de07ec19e0dd Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Feb 2022 20:48:44 +0100
Subject: [PATCH 46/79] chore: add /v3 to go.mod

---
 go.mod | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/go.mod b/go.mod
index 1cf4674..776617e 100644
--- a/go.mod
+++ b/go.mod
@@ -1,3 +1,3 @@
-module github.com/CaiJimmy/hugo-theme-stack
+module github.com/CaiJimmy/hugo-theme-stack/v3
 
 go 1.12

From 4b0dbb4630c8a050c7b4e4cad51ab4a6efb29685 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 11 Feb 2022 20:36:52 +0000
Subject: [PATCH 47/79] fix(article): code block background style in light
 theme

closes https://github.com/CaiJimmy/hugo-theme-stack/issues/489, https://github.com/CaiJimmy/hugo-theme-stack/issues/492
---
 assets/scss/variables.scss | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/assets/scss/variables.scss b/assets/scss/variables.scss
index 323f2b7..f7d45b4 100644
--- a/assets/scss/variables.scss
+++ b/assets/scss/variables.scss
@@ -1,18 +1,6 @@
 $defaultTagBackgrounds: #8ea885, #df7988, #0177b8, #ffb900, #6b69d6;
 $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
 
-[data-scheme="light"] {
-    --pre-text-color: #272822;
-    --pre-background-color: #fafafa;
-    @import "partials/highlight/light.scss";
-}
-
-[data-scheme="dark"] {
-    --pre-text-color: #f8f8f2;
-    --pre-background-color: #272822;
-    @import "partials/highlight/dark.scss";
-}
-
 /*
 *   Global style
 */
@@ -159,3 +147,15 @@ $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
     --shadow-l4: 0px 24px 32px rgba(0, 0, 0, 0.04), 0px 16px 24px rgba(0, 0, 0, 0.04), 0px 4px 8px rgba(0, 0, 0, 0.04),
         0px 0px 1px rgba(0, 0, 0, 0.04);
 }
+
+[data-scheme="light"] {
+    --pre-text-color: #272822;
+    --pre-background-color: #fafafa;
+    @import "partials/highlight/light.scss";
+}
+
+[data-scheme="dark"] {
+    --pre-text-color: #f8f8f2;
+    --pre-background-color: #272822;
+    @import "partials/highlight/dark.scss";
+}

From 0fbbc12949c8d59ea5ddcfb463d2c48140bfb490 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 12 Feb 2022 13:23:38 +0000
Subject: [PATCH 48/79] fix: check if paragraph exists before accessing it's
 textContent

closes https://github.com/CaiJimmy/hugo-theme-stack/issues/490
---
 assets/ts/gallery.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/assets/ts/gallery.ts b/assets/ts/gallery.ts
index ec7c02d..218658d 100644
--- a/assets/ts/gallery.ts
+++ b/assets/ts/gallery.ts
@@ -67,6 +67,8 @@ class StackGallery {
             /// This is done to allow inline images within paragraphs
             const paragraph = img.closest('p');
 
+            if (!paragraph || !container.contains(paragraph)) continue;
+
             if (paragraph.textContent.trim() == '') {
                 /// Once we insert figcaption, this check no longer works
                 /// So we add a class to paragraph to mark it

From 4d552a9df58f20acd460a8df35d18eb935de8d21 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 26 Feb 2022 23:45:25 +0100
Subject: [PATCH 49/79] feat: article page widget support (#488)

* feat: article page widget support

* refactor: get rid of article toolbar

Same 3 column layout for article page and homepage

* add missing space
---
 assets/scss/partials/layout/article.scss | 61 ------------------------
 assets/scss/partials/sidebar.scss        |  2 +-
 config.yaml                              | 12 +----
 exampleSite/config.yaml                  | 20 ++++----
 layouts/_default/baseof.html             |  3 +-
 layouts/_default/list.html               |  2 +-
 layouts/_default/single.html             | 59 +++++++++--------------
 layouts/index.html                       |  2 +-
 layouts/partials/sidebar/right.html      | 13 +++--
 layouts/partials/widget/archives.html    | 12 +++--
 layouts/partials/widget/search.html      |  2 +-
 layouts/partials/widget/tag-cloud.html   |  4 +-
 layouts/partials/widget/toc.html         | 12 +++++
 13 files changed, 71 insertions(+), 133 deletions(-)
 create mode 100644 layouts/partials/widget/toc.html

diff --git a/assets/scss/partials/layout/article.scss b/assets/scss/partials/layout/article.scss
index af5f7bb..92e1167 100644
--- a/assets/scss/partials/layout/article.scss
+++ b/assets/scss/partials/layout/article.scss
@@ -122,67 +122,6 @@
     }
 }
 
-.article-page.has-toc {
-    .left-sidebar {
-        display: none;
-    }
-
-    .right-sidebar {
-        width: 100%;
-        padding: 0;
-        display: none;
-
-        @include respond(xl) {
-            display: block;
-            top: var(--main-top-padding);
-        }
-    }
-
-    #article-toolbar {
-        display: block;
-
-        @include respond(md) {
-            padding: 0;
-        }
-
-        @include respond(xl) {
-            margin-top: 0;
-            position: sticky;
-            top: var(--main-top-padding);
-            flex-shrink: 1;
-
-            a {
-                background: transparent;
-                box-shadow: none;
-                border: 1px solid var(--body-text-color);
-                width: 100%;
-                margin-right: 0;
-
-                svg {
-                    flex-shrink: 0;
-                }
-            }
-        }
-    }
-
-    .main-container {
-        align-items: start;
-        flex-direction: column;
-
-        @include respond(xl) {
-            flex-direction: row;
-        }
-    }
-
-    .main {
-        padding-top: 0;
-
-        @include respond(xl) {
-            padding-top: var(--main-top-padding);
-        }
-    }
-}
-
 .widget--toc {
     background-color: var(--card-background);
     border-radius: var(--card-border-radius);
diff --git a/assets/scss/partials/sidebar.scss b/assets/scss/partials/sidebar.scss
index 462729d..c861f6e 100644
--- a/assets/scss/partials/sidebar.scss
+++ b/assets/scss/partials/sidebar.scss
@@ -37,7 +37,7 @@
 }
 
 .right-sidebar {
-    flex-shrink: 0;
+    width: 100%;
     display: none;
 
     &.sticky {
diff --git a/config.yaml b/config.yaml
index 0e5283c..d0e37f8 100644
--- a/config.yaml
+++ b/config.yaml
@@ -108,16 +108,8 @@ params:
             id:
 
     widgets:
-        enabled:
-            - search
-            - archives
-            - tag-cloud
-
-        archives:
-            limit: 5
-
-        tagCloud:
-            limit: 10
+        homepage: []
+        page: []
 
     opengraph:
         twitter:
diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index d449fc9..7ff0505 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -132,16 +132,16 @@ params:
             host:
             id:
     widgets:
-        enabled:
-            - search
-            - archives
-            - tag-cloud
-
-        archives:
-            limit: 5
-
-        tagCloud:
-            limit: 10
+        homepage:
+            - type: search
+            - type: archives
+              params:
+                  limit: 5
+            - type: tag-cloud
+              params:
+                  limit: 10
+        page:
+            - type: toc
 
     opengraph:
         twitter:
diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html
index 8a5ff95..db1903e 100644
--- a/layouts/_default/baseof.html
+++ b/layouts/_default/baseof.html
@@ -6,7 +6,8 @@
     </head>
     <body class="{{ block `body-class` . }}{{ end }}">
         {{- partial "head/colorScheme" . -}}
-        <div class="container main-container flex {{ block `container-class` . }}on-phone--column {{ if .Site.Params.widgets.enabled }}extended{{ else }}compact{{ end }}{{ end }}">
+        {{- $hasWidget := default (gt (len .Site.Params.widgets.homepage) 0) (.Scratch.Get "hasWidget") -}}
+        <div class="container main-container flex on-phone--column {{ if $hasWidget }}extended{{ else }}compact{{ end }}">
             {{- block "left-sidebar" . -}}
                 {{ partial "sidebar/left.html" . }}
             {{- end -}}
diff --git a/layouts/_default/list.html b/layouts/_default/list.html
index 90e5b66..49a5c12 100644
--- a/layouts/_default/list.html
+++ b/layouts/_default/list.html
@@ -77,5 +77,5 @@
 {{ end }}
 
 {{ define "right-sidebar" }}
-    {{ partialCached "sidebar/right.html" . }}
+    {{ partial "sidebar/right.html" (dict "Context" . "Scope" "homepage") }}
 {{ end }}
\ No newline at end of file
diff --git a/layouts/_default/single.html b/layouts/_default/single.html
index 8ce42e9..c70df20 100644
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -1,15 +1,26 @@
 {{ define "body-class" }}
-    {{ $TOCEnabled := default (default false .Site.Params.article.toc) .Params.toc }}
-    {{- .Scratch.Set "hasTOC" (and (ge (len .TableOfContents) 100) $TOCEnabled) -}}
-    article-page {{ if (.Scratch.Get "hasTOC") }}has-toc{{ end }}
-{{ end }}
+    article-page
+    {{/* 
+        Enable the right sidebar if
+            - Widget different from 'TOC' is enabled
+            - TOC is enabled and not empty
+    */}}
+    {{- $HasWidgetNotTOC := false -}}
+    {{- $TOCWidgetEnabled := false -}}
+    {{- range .Site.Params.widgets.page -}}
+        {{- if ne .type "toc" -}}
+            {{ $HasWidgetNotTOC = true -}}
+        {{- else -}}
+            {{ $TOCWidgetEnabled = true -}}
+        {{- end -}}
+    {{- end -}}
 
-{{ define "container-class" }}
-    {{ if (.Scratch.Get "hasTOC") }}
-        extended
-    {{ else }}
-        on-phone--column {{ if .Site.Params.widgets.enabled }}extended{{ else }}compact{{ end }}
-    {{ end }}
+    {{- $TOCManuallyDisabled := eq .Params.toc false -}}
+    {{- $TOCEnabled := and (not $TOCManuallyDisabled) $TOCWidgetEnabled -}}
+    {{- $hasTOC := ge (len .TableOfContents) 100 -}}
+    {{- .Scratch.Set "TOCEnabled" (and $TOCEnabled $hasTOC) -}}
+    
+    {{- .Scratch.Set "hasWidget" (or $HasWidgetNotTOC (and $TOCEnabled $hasTOC)) -}}
 {{ end }}
 
 {{ define "main" }}
@@ -30,32 +41,6 @@
     {{ partialCached "article/components/photoswipe" . }}
 {{ end }}
 
-{{ define "left-sidebar" }}
-    {{ if (.Scratch.Get "hasTOC") }}
-        <div id="article-toolbar">
-            <a href="{{ .Site.BaseURL | relLangURL }}" class="back-home">
-                {{ (resources.Get "icons/back.svg").Content | safeHTML }}
-                <span>{{ T "article.back" }}</span>
-            </a>
-        </div>
-    {{ else }}
-        {{ partial "sidebar/left.html" . }}
-    {{ end }}
-{{ end }}
-
 {{ define "right-sidebar" }}
-    {{ if (.Scratch.Get "hasTOC") }}
-        <aside class="sidebar right-sidebar sticky">
-            <section class="widget archives">
-                <div class="widget-icon">
-                    {{ partial "helper/icon" "hash" }}
-                </div>
-                <h2 class="widget-title section-title">{{ T "article.tableOfContents" }}</h2>
-                
-                <div class="widget--toc">
-                    {{ .TableOfContents }}
-                </div>
-            </section>
-        </aside>
-    {{ end }}
+    {{ if .Scratch.Get "hasWidget" }}{{ partial "sidebar/right.html" (dict "Context" . "Scope" "page") }}{{ end}}
 {{ end }}
diff --git a/layouts/index.html b/layouts/index.html
index 576faef..0cd0b88 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -15,5 +15,5 @@
 {{ end }}
 
 {{ define "right-sidebar" }}
-    {{ partial "sidebar/right.html" . }}
+    {{ partial "sidebar/right.html" (dict "Context" . "Scope" "homepage") }}
 {{ end }}
\ No newline at end of file
diff --git a/layouts/partials/sidebar/right.html b/layouts/partials/sidebar/right.html
index 24763bb..d2a6ae8 100644
--- a/layouts/partials/sidebar/right.html
+++ b/layouts/partials/sidebar/right.html
@@ -1,8 +1,13 @@
-{{ if .Site.Params.widgets.enabled }}
-    {{ $context := . }}
+{{- $scope := default "homepage" .Scope -}}
+{{- $context := .Context -}}
+{{- with (index .Context.Site.Params.widgets $scope) -}}
     <aside class="sidebar right-sidebar sticky">
-        {{ range $widget := .Site.Params.widgets.enabled }}
-            {{ partial (printf "widget/%s" $widget) $context }}
+        {{ range $widget := . }}
+            {{ if templates.Exists (printf "partials/widget/%s.html" .type) }}
+                {{ partial (printf "widget/%s" .type) (dict "Context" $context "Params" .params) }}
+            {{ else }}
+                {{ warnf "Widget %s not found" .type }}
+            {{ end }}
         {{ end }}
     </aside>
 {{ end }}
\ No newline at end of file
diff --git a/layouts/partials/widget/archives.html b/layouts/partials/widget/archives.html
index 4a92a30..1f2abc5 100644
--- a/layouts/partials/widget/archives.html
+++ b/layouts/partials/widget/archives.html
@@ -1,4 +1,6 @@
-{{- $query := first 1 (where .Site.Pages "Layout" "==" "archives") -}}
+{{- $query := first 1 (where .Context.Site.Pages "Layout" "==" "archives") -}}
+{{- $context := .Context -}}
+{{- $limit := default 5 .Params.limit -}}
 {{- if $query -}}
     {{- $archivesPage := index $query 0 -}}
     <section class="widget archives">
@@ -7,17 +9,17 @@
         </div>
         <h2 class="widget-title section-title">{{ T "widget.archives.title" }}</h2>
 
-        {{ $pages := where .Site.RegularPages "Type" "in" .Site.Params.mainSections }}
-        {{ $notHidden := where .Site.RegularPages "Params.hidden" "!=" true }}
+        {{ $pages := where $context.Site.RegularPages "Type" "in" $context.Site.Params.mainSections }}
+        {{ $notHidden := where $context.Site.RegularPages "Params.hidden" "!=" true }}
         {{ $filtered := ($pages | intersect $notHidden) }}
         {{ $archives := $filtered.GroupByDate "2006" }}
         
         <div class="widget-archive--list">
-            {{ range $index, $item := first (add .Site.Params.widgets.archives.limit 1) ($archives) }}
+            {{ range $index, $item := first (add $limit 1) ($archives) }}
                 {{- $id := lower (replace $item.Key " " "-") -}}
                 <div class="archives-year">
                     <a href="{{ $archivesPage.RelPermalink }}#{{ $id }}">
-                        {{ if eq $index $.Site.Params.widgets.archives.limit }}
+                        {{ if eq $index $limit }}
                             <span class="year">{{ T "widget.archives.more" }}</span>
                         {{ else }}
                             <span class="year">{{ .Key }}</span>
diff --git a/layouts/partials/widget/search.html b/layouts/partials/widget/search.html
index 833f740..7b0fc73 100644
--- a/layouts/partials/widget/search.html
+++ b/layouts/partials/widget/search.html
@@ -1,4 +1,4 @@
-{{- $query := first 1 (where .Site.Pages "Layout" "==" "search") -}}
+{{- $query := first 1 (where .Context.Site.Pages "Layout" "==" "search") -}}
 {{- if $query -}}
     {{- $searchPage := index $query 0 -}}
     <form action="{{ $searchPage.RelPermalink }}" class="search-form widget" {{ with .OutputFormats.Get "json" -}}data-json="{{ .Permalink }}" {{- end }}>
diff --git a/layouts/partials/widget/tag-cloud.html b/layouts/partials/widget/tag-cloud.html
index 99b8e59..e64e5e2 100644
--- a/layouts/partials/widget/tag-cloud.html
+++ b/layouts/partials/widget/tag-cloud.html
@@ -1,3 +1,5 @@
+{{- $context := .Context -}}
+{{- $limit := default 10 .Params.limit -}}
 <section class="widget tagCloud">
     <div class="widget-icon">
         {{ partial "helper/icon" "tag" }}
@@ -5,7 +7,7 @@
     <h2 class="widget-title section-title">{{ T "widget.tagCloud.title" }}</h2>
 
     <div class="tagCloud-tags">
-        {{ range first .Site.Params.widgets.tagCloud.limit .Site.Taxonomies.tags.ByCount }}
+        {{ range first $limit $context.Site.Taxonomies.tags.ByCount }}
             <a href="{{ .Page.RelPermalink }}" class="font_size_{{ .Count }}">
                 {{ .Page.Title }}
             </a>
diff --git a/layouts/partials/widget/toc.html b/layouts/partials/widget/toc.html
new file mode 100644
index 0000000..e311de3
--- /dev/null
+++ b/layouts/partials/widget/toc.html
@@ -0,0 +1,12 @@
+{{ if (.Context.Scratch.Get "TOCEnabled") }}
+    <section class="widget archives">
+        <div class="widget-icon">
+            {{ partial "helper/icon" "hash" }}
+        </div>
+        <h2 class="widget-title section-title">{{ T "article.tableOfContents" }}</h2>
+        
+        <div class="widget--toc">
+            {{ .Context.TableOfContents }}
+        </div>
+    </section>
+{{ end }}
\ No newline at end of file

From 26fb06951b880cbafd9d408637c300eb19dfceab Mon Sep 17 00:00:00 2001
From: JesseJeson <55904993+JesseJeson@users.noreply.github.com>
Date: Sun, 27 Feb 2022 06:49:26 +0800
Subject: [PATCH 50/79] chore: update twikoo version to 1.4.18 (#496)

---
 layouts/partials/comments/provider/twikoo.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/comments/provider/twikoo.html b/layouts/partials/comments/provider/twikoo.html
index 30c7033..7dd3e50 100644
--- a/layouts/partials/comments/provider/twikoo.html
+++ b/layouts/partials/comments/provider/twikoo.html
@@ -1,4 +1,4 @@
-<script src="//cdn.jsdelivr.net/npm/twikoo@1.4.15/dist/twikoo.all.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/twikoo@1.4.18/dist/twikoo.all.min.js"></script>
 <div id="tcomment"></div>
 <style>
     .twikoo {

From b3b8fa73ef5f82bed55e12221526fbeddc03374f Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 27 Feb 2022 09:48:57 +0100
Subject: [PATCH 51/79] feat(article): add link to translated content (#511)

---
 assets/icons/language.svg                        | 10 ++++++++++
 assets/scss/partials/article.scss                |  9 ++++++---
 exampleSite/config.yaml                          | 10 ++++++++++
 exampleSite/content/page/about/index.cn.md       |  5 +++++
 layouts/partials/article/components/details.html | 11 +++++++++++
 5 files changed, 42 insertions(+), 3 deletions(-)
 create mode 100644 assets/icons/language.svg
 create mode 100644 exampleSite/content/page/about/index.cn.md

diff --git a/assets/icons/language.svg b/assets/icons/language.svg
new file mode 100644
index 0000000..66ede1c
--- /dev/null
+++ b/assets/icons/language.svg
@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-language" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <path d="M4 5h7" />
+  <path d="M9 3v2c0 4.418 -2.239 8 -5 8" />
+  <path d="M5 9c-.003 2.144 2.952 3.908 6.7 4" />
+  <path d="M12 20l4 -9l4 9" />
+  <path d="M19.1 18h-6.2" />
+</svg>
+
+
diff --git a/assets/scss/partials/article.scss b/assets/scss/partials/article.scss
index 459c22f..0d3efba 100644
--- a/assets/scss/partials/article.scss
+++ b/assets/scss/partials/article.scss
@@ -91,7 +91,8 @@
     }
 }
 
-.article-time {
+.article-time,
+.article-translations {
     display: flex;
     align-items: center;
     color: var(--card-text-color-tertiary);
@@ -101,19 +102,21 @@
 
     svg {
         vertical-align: middle;
-        margin-right: 15px;
         width: 20px;
         height: 20px;
         stroke-width: 1.33;
     }
 
-    time {
+    time,
+    a {
         font-size: 1.4rem;
+        color: var(--card-text-color-tertiary);
     }
 
     & > div {
         display: inline-flex;
         align-items: center;
+        gap: 15px;
     }
 }
 
diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index 7ff0505..b2fe1d3 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -4,6 +4,16 @@ theme: hugo-theme-stack
 paginate: 5
 title: Example Site
 
+languages:
+    en:
+        languageName: English
+        title: Example Site
+        weight: 1
+    cn:
+        languageName: 中文
+        title: 演示站点
+        weight: 2
+
 # Change it to your Disqus shortname before using
 disqusShortname: hugo-theme-stack
 
diff --git a/exampleSite/content/page/about/index.cn.md b/exampleSite/content/page/about/index.cn.md
new file mode 100644
index 0000000..060c006
--- /dev/null
+++ b/exampleSite/content/page/about/index.cn.md
@@ -0,0 +1,5 @@
+---
+title: 关于
+---
+
+This is a test page for i18n support.
\ No newline at end of file
diff --git a/layouts/partials/article/components/details.html b/layouts/partials/article/components/details.html
index 64d6c6e..2ec1241 100644
--- a/layouts/partials/article/components/details.html
+++ b/layouts/partials/article/components/details.html
@@ -42,4 +42,15 @@
         {{ end }}
     </footer>
     {{ end }}
+
+    {{ if .IsTranslated }}
+        <footer class="article-translations">
+            {{ partial "helper/icon" "language" }}
+            <div>
+                {{ range .Translations }}
+                    <a href="{{ .Permalink }}" class="link">{{ .Language.LanguageName }}</a>
+                {{ end }}
+            </div>
+        </footer>
+    {{ end }}
 </div>
\ No newline at end of file

From 2712887c7c81b7dd0309910859b1d46252f82677 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 27 Feb 2022 10:51:02 +0100
Subject: [PATCH 52/79] feat: multilingual site switch (#512)

* feat: multilingual site switch

* fix menu item margin

switch to flexbox gap
---
 assets/scss/partials/menu.scss     | 27 +++++++++++++++++----------
 assets/scss/partials/sidebar.scss  | 17 +++++++++++++++++
 layouts/partials/sidebar/left.html | 28 +++++++++++++++++++++-------
 3 files changed, 55 insertions(+), 17 deletions(-)

diff --git a/assets/scss/partials/menu.scss b/assets/scss/partials/menu.scss
index 1d612d1..257eedb 100644
--- a/assets/scss/partials/menu.scss
+++ b/assets/scss/partials/menu.scss
@@ -125,7 +125,6 @@
 .menu {
     padding-left: 0;
     list-style: none;
-    display: flex;
     flex-direction: column;
     overflow-y: auto;
     flex-grow: 1;
@@ -138,8 +137,17 @@
 
     margin: 0 -15px;
 
+    &,
+    .menu-bottom-section {
+        gap: 15px;
+        @include respond(xl) {
+            margin-top: 30px;
+            gap: 20px;
+        }
+    }
+
     &.show {
-        display: block;
+        display: flex;
     }
 
     @include respond(md) {
@@ -161,14 +169,6 @@
         vertical-align: middle;
         padding: 10px 30px;
 
-        &:not(:last-of-type) {
-            margin-bottom: 15px;
-
-            @include respond(xl) {
-                margin-bottom: 20px;
-            }
-        }
-
         @include respond(md) {
             width: 100%;
             padding: 10px 0;
@@ -200,6 +200,13 @@
             }
         }
     }
+
+    .menu-bottom-section {
+        margin-top: auto;
+        display: flex;
+        flex-direction: column;
+        width: 100%;
+    }
 }
 
 .social-menu {
diff --git a/assets/scss/partials/sidebar.scss b/assets/scss/partials/sidebar.scss
index c861f6e..4d320a8 100644
--- a/assets/scss/partials/sidebar.scss
+++ b/assets/scss/partials/sidebar.scss
@@ -158,3 +158,20 @@
         display: none;
     }
 }
+
+#i18n-switch {
+    color: var(--body-text-color);
+    display: inline-flex;
+    align-content: center;
+
+    select {
+        border: 0;
+        background-color: transparent;
+        color: var(--body-text-color);
+
+        option {
+            color: var(--card-text-color-main);
+            background-color: var(--card-background);
+        }
+    }
+}
diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index 4442dfe..35d1c11 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -73,12 +73,26 @@
         </li>
         {{ end }}
 
-        {{ if (default false .Site.Params.colorScheme.toggle) }}
-            <li id="dark-mode-toggle">
-                {{ partial "helper/icon" "toggle-left" }}
-                {{ partial "helper/icon" "toggle-right" }}
-                <span>{{ T "darkMode" }}</span>
-            </li>
-        {{ end }}
+        <div class="menu-bottom-section">
+            {{- $currentLanguageCode := .Language.Lang -}}
+            {{ with .Site.Home.AllTranslations }}
+                <li id="i18n-switch">  
+                    {{ partial "helper/icon" "language" }}
+                    <select name="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 }}
+            
+            {{ if (default false .Site.Params.colorScheme.toggle) }}
+                <li id="dark-mode-toggle">
+                    {{ partial "helper/icon" "toggle-left" }}
+                    {{ partial "helper/icon" "toggle-right" }}
+                    <span>{{ T "darkMode" }}</span>
+                </li>
+            {{ end }}
+        </div>
     </ol>
 </aside>

From 98923b1dd7cabd2679a9d992f5a2c41aed647b48 Mon Sep 17 00:00:00 2001
From: Allen Guan <me@nella17.tw>
Date: Thu, 3 Mar 2022 04:24:56 +0800
Subject: [PATCH 53/79] fix(RSS): hidden post visible on feed (#514)

---
 layouts/{ => _default}/rss.xml | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename layouts/{ => _default}/rss.xml (100%)

diff --git a/layouts/rss.xml b/layouts/_default/rss.xml
similarity index 100%
rename from layouts/rss.xml
rename to layouts/_default/rss.xml

From 24cd07589b9dff17a8eb120a9ea21be2b3db68e8 Mon Sep 17 00:00:00 2001
From: zhixuan <jinzhixuan666@gmail.com>
Date: Thu, 3 Mar 2022 05:31:44 +0900
Subject: [PATCH 54/79] feat(comments): add lang option for giscus (#498)

---
 config.yaml                                   |  1 +
 .../partials/comments/provider/giscus.html    | 34 +++++++++----------
 2 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/config.yaml b/config.yaml
index d0e37f8..c55a911 100644
--- a/config.yaml
+++ b/config.yaml
@@ -95,6 +95,7 @@ params:
             darkTheme:
             reactionsEnabled: 1
             emitMetadata: 0
+            lang:
 
         gitalk:
             owner:
diff --git a/layouts/partials/comments/provider/giscus.html b/layouts/partials/comments/provider/giscus.html
index f36ead9..abe345f 100644
--- a/layouts/partials/comments/provider/giscus.html
+++ b/layouts/partials/comments/provider/giscus.html
@@ -9,41 +9,41 @@
     data-reactions-enabled="{{- default 1 .reactionsEnabled -}}"
     data-emit-metadata="{{- default 0 .emitMetadata -}}"
     data-theme="{{- default `light` .lightTheme -}}"
+    data-lang="{{- default `en` .lang -}}"
     crossorigin="anonymous"
     async
 ></script>
 <script>
     function setGiscusTheme(theme) {
-        let giscus = document.querySelector('iframe.giscus-frame');
+        let giscus = document.querySelector("iframe.giscus-frame");
         if (giscus) {
             giscus.contentWindow.postMessage(
-                { 
+                {
                     giscus: {
-                        setConfig: { 
-                            theme: theme 
-                        }
-                    }
+                        setConfig: {
+                            theme: theme,
+                        },
+                    },
                 },
                 "https://giscus.app"
             );
-        };
-    };
+        }
+    }
 
-    (function(){
-        addEventListener('message', (e) => {
-            if (event.origin !== 'https://giscus.app') return;
-            handler()
+    (function () {
+        addEventListener("message", (e) => {
+            if (event.origin !== "https://giscus.app") return;
+            handler();
         });
-        window.addEventListener('onColorSchemeChange', handler);
+        window.addEventListener("onColorSchemeChange", handler);
 
         function handler() {
             if (document.documentElement.dataset.scheme === "light") {
                 setGiscusTheme('{{- default "light" .lightTheme -}}');
             } else {
                 setGiscusTheme('{{- default "dark_dimmed" .darkTheme -}}');
-            };
-        };
-    }());
+            }
+        }
+    })();
 </script>
 {{- end -}}
-

From 9dbc0a4f38b7afc81925cd15006287deb2e6ca41 Mon Sep 17 00:00:00 2001
From: Allen Guan <me@nella17.tw>
Date: Thu, 3 Mar 2022 12:38:47 +0800
Subject: [PATCH 55/79] fix(RSS): page context selection

---
 layouts/_default/rss.xml | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/layouts/_default/rss.xml b/layouts/_default/rss.xml
index 178f997..4934bd0 100644
--- a/layouts/_default/rss.xml
+++ b/layouts/_default/rss.xml
@@ -1,5 +1,13 @@
-{{- $pages := where .Site.RegularPages "Type" "in" .Site.Params.mainSections -}}
-{{- $notHidden := where .Site.RegularPages "Params.hidden" "!=" true -}}
+{{- $pctx := . -}}
+{{- if .IsHome -}}{{ $pctx = .Site }}{{- end -}}
+{{- $pages := slice -}}
+{{- if or $.IsHome $.IsSection -}}
+{{- $pages = $pctx.RegularPages -}}
+{{- else -}}
+{{- $pages = $pctx.Pages -}}
+{{- end -}}
+{{- $pages := where $pages "Type" "in" .Site.Params.mainSections -}}
+{{- $notHidden := where $pages "Params.hidden" "!=" true -}}
 {{- $filtered := ($pages | intersect $notHidden) -}}
 {{- $limit := .Site.Config.Services.RSS.Limit -}}
 {{- if ge $limit 1 -}}

From adf27aebf276f33301d2b8add199be1ceeafc30c Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 3 Mar 2022 07:31:03 +0100
Subject: [PATCH 56/79] Revert "fix(RSS): hidden post visible on feed (#514)"
 (#517)

---
 layouts/{_default => }/rss.xml | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename layouts/{_default => }/rss.xml (100%)

diff --git a/layouts/_default/rss.xml b/layouts/rss.xml
similarity index 100%
rename from layouts/_default/rss.xml
rename to layouts/rss.xml

From 04cdbcfedfe3f200013e05aecbb96dc3313424b3 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 3 Mar 2022 23:11:19 +0100
Subject: [PATCH 57/79] refactor: Use flexbox gap (#520)

---
 assets/scss/grid.scss                         | 33 +++----
 assets/scss/partials/article.scss             | 16 +---
 assets/scss/partials/footer.scss              |  1 -
 assets/scss/partials/layout/archives.scss     |  3 -
 assets/scss/partials/layout/article.scss      | 15 +--
 assets/scss/partials/layout/list.scss         | 12 +--
 assets/scss/partials/layout/search.scss       |  1 -
 assets/scss/partials/menu.scss                | 22 ++---
 assets/scss/partials/pagination.scss          |  1 -
 assets/scss/partials/sidebar.scss             | 40 ++++----
 assets/scss/partials/widgets.scss             |  7 +-
 assets/scss/style.scss                        |  1 -
 assets/scss/variables.scss                    | 10 +-
 layouts/_default/archives.html                | 24 ++---
 layouts/_default/list.html                    | 94 ++++++++++---------
 layouts/page/search.html                      |  6 +-
 .../article/components/related-contents.html  | 20 ++--
 layouts/partials/sidebar/left.html            |  8 +-
 18 files changed, 143 insertions(+), 171 deletions(-)
 delete mode 100644 assets/scss/partials/layout/archives.scss

diff --git a/assets/scss/grid.scss b/assets/scss/grid.scss
index a0eddca..84967ef 100644
--- a/assets/scss/grid.scss
+++ b/assets/scss/grid.scss
@@ -11,7 +11,7 @@
 
         /// Display right sidebar when min-width: lg
         @include respond(lg) {
-            display: block;
+            display: flex;
         }
     }
 
@@ -67,24 +67,6 @@
         }
     }
 
-    &.align-items--flex-start {
-        align-items: flex-start;
-    }
-
-    .grow {
-        flex-grow: 1;
-    }
-
-    .do-not-shrink {
-        flex-shrink: 0;
-    }
-
-    .do-not-overflow {
-        min-width: 0;
-        flex-shrink: 1;
-        max-width: 100%;
-    }
-
     .full-width {
         width: 100%;
     }
@@ -94,15 +76,22 @@ main.main {
     min-width: 0;
     max-width: 100%;
     flex-grow: 1;
-    padding-top: var(--main-top-padding);
+    display: flex;
+    flex-direction: column;
+    gap: var(--section-separation);
+
+    @include respond(md) {
+        padding-top: var(--main-top-padding);
+    }
 }
 
 .main-container {
     min-height: 100vh;
     align-items: flex-start;
     padding: 0 15px;
-    column-gap: var(--section-separation);
-
+    gap: var(--section-separation);
+    padding-top: var(--main-top-padding);
+    
     @include respond(md) {
         padding: 0 20px;
     }
diff --git a/assets/scss/partials/article.scss b/assets/scss/partials/article.scss
index 0d3efba..c9444d4 100644
--- a/assets/scss/partials/article.scss
+++ b/assets/scss/partials/article.scss
@@ -2,6 +2,7 @@
 .article-list {
     display: flex;
     flex-direction: column;
+    gap: var(--section-separation);
 
     article {
         display: flex;
@@ -17,10 +18,6 @@
             box-shadow: var(--shadow-l2);
         }
 
-        &:not(:last-of-type) {
-            margin-bottom: var(--section-separation);
-        }
-
         .article-image {
             img {
                 width: 100%;
@@ -122,6 +119,9 @@
 
 .article-category,
 .article-tags {
+    display: flex;
+    gap: 10px;
+
     a {
         color: var(--accent-color-text);
         background-color: var(--accent-color);
@@ -129,8 +129,6 @@
         border-radius: var(--tag-border-radius);
         display: inline-block;
         font-size: 1.4rem;
-        margin-right: 10px;
-        margin-bottom: 10px;
         transition: background-color 0.5s ease;
 
         &:hover {
@@ -151,15 +149,12 @@
         --image-size: 60px;
     }
 
-    & + .pagination {
-        margin-top: var(--section-separation);
-    }
-
     article {
         & > a {
             display: flex;
             align-items: center;
             padding: var(--small-card-padding);
+            gap: 15px;
         }
 
         &:not(:last-of-type) {
@@ -169,7 +164,6 @@
         .article-details {
             flex-grow: 1;
             padding: 0;
-            padding-right: 15px;
             min-height: var(--image-size);
         }
 
diff --git a/assets/scss/partials/footer.scss b/assets/scss/partials/footer.scss
index 1c60dc7..ccb7394 100644
--- a/assets/scss/partials/footer.scss
+++ b/assets/scss/partials/footer.scss
@@ -2,7 +2,6 @@ footer.site-footer {
     padding: 20px 0 var(--section-separation) 0;
     font-size: 1.4rem;
     line-height: 1.75;
-    margin-top: var(--section-separation);
 
     &:before {
         content: "";
diff --git a/assets/scss/partials/layout/archives.scss b/assets/scss/partials/layout/archives.scss
deleted file mode 100644
index 34e5f62..0000000
--- a/assets/scss/partials/layout/archives.scss
+++ /dev/null
@@ -1,3 +0,0 @@
-.archives-group {
-    margin-bottom: var(--section-separation);
-}
\ No newline at end of file
diff --git a/assets/scss/partials/layout/article.scss b/assets/scss/partials/layout/article.scss
index 92e1167..ef35ba9 100644
--- a/assets/scss/partials/layout/article.scss
+++ b/assets/scss/partials/layout/article.scss
@@ -13,10 +13,6 @@
         box-shadow: var(--shadow-l1);
         overflow: hidden;
 
-        &.main-article {
-            margin-bottom: var(--section-separation);
-        }
-
         .article-header {
             .article-image {
                 img {
@@ -57,11 +53,11 @@
                 display: flex;
                 align-items: center;
                 font-size: 1.4rem;
+                gap: 15px;
 
                 svg {
                     width: 20px;
                     height: 20px;
-                    margin-right: 15px;
                     stroke-width: 1.33;
                 }
             }
@@ -211,10 +207,6 @@
     }
 }
 
-.related-contents--wrapper {
-    margin-bottom: var(--section-separation);
-}
-
 .related-contents {
     overflow-x: auto;
     padding-bottom: 15px;
@@ -305,13 +297,10 @@
         flex-direction: row;
         justify-content: center;
         margin: 1.5em 0;
+        gap: 10px;
 
         figure {
             margin: 0;
-
-            & + figure {
-                margin-left: 10px;
-            }
         }
     }
 
diff --git a/assets/scss/partials/layout/list.scss b/assets/scss/partials/layout/list.scss
index 1a0e346..d7815ca 100644
--- a/assets/scss/partials/layout/list.scss
+++ b/assets/scss/partials/layout/list.scss
@@ -3,21 +3,16 @@
     background-color: var(--card-background);
     padding: var(--small-card-padding);
     box-shadow: var(--shadow-l1);
-    margin-bottom: var(--section-separation);
     display: flex;
     align-items: center;
+    gap: 20px;
 
     --separation: 15px;
 
     .section-term {
         font-size: 2.2rem;
         margin: 0;
-        margin-top: calc(var(--separation) / 2);
         color: var(--card-text-color-main);
-
-        & + .section-description {
-            margin-top: var(--separation);
-        }
     }
 
     .section-description {
@@ -29,7 +24,9 @@
 
     .section-details {
         flex-grow: 1;
-        margin-right: 20px;
+        display: flex;
+        flex-direction: column;
+        gap: 8px;
     }
 
     .section-image {
@@ -49,7 +46,6 @@
 }
 
 .subsection-list {
-    margin-bottom: var(--section-separation);
     overflow-x: auto;
 
     .article-list--tile {
diff --git a/assets/scss/partials/layout/search.scss b/assets/scss/partials/layout/search.scss
index b390a7b..f2cc7be 100644
--- a/assets/scss/partials/layout/search.scss
+++ b/assets/scss/partials/layout/search.scss
@@ -1,5 +1,4 @@
 .search-form {
-    margin-bottom: var(--section-separation);
     position: relative;
     --button-size: 80px;
 
diff --git a/assets/scss/partials/menu.scss b/assets/scss/partials/menu.scss
index 257eedb..16adb80 100644
--- a/assets/scss/partials/menu.scss
+++ b/assets/scss/partials/menu.scss
@@ -101,11 +101,16 @@
     background: none;
     border: none;
     position: absolute;
-    right: 30px;
-    top: 30px;
+    right: 0;
+    top: 0;
     z-index: 2;
     cursor: pointer;
 
+    [dir="rtl"] & {
+        left: 0;
+        right: auto;
+    }
+
     @include respond(md) {
         display: none;
     }
@@ -135,13 +140,12 @@
     box-shadow: var(--shadow-l1);
     display: none;
 
-    margin: 0 -15px;
+    margin: 0 calc(var(--container-padding) * -1);
 
     &,
     .menu-bottom-section {
         gap: 15px;
         @include respond(xl) {
-            margin-top: 30px;
             gap: 20px;
         }
     }
@@ -157,11 +161,6 @@
         padding: 0;
         box-shadow: none;
         margin: 0;
-        margin-top: var(--sidebar-element-separation);
-    }
-
-    @include respond(xl) {
-        margin-top: 30px;
     }
 
     li {
@@ -176,7 +175,6 @@
 
         svg {
             stroke-width: 1.33;
-            margin-right: 40px;
 
             width: 20px;
             height: 20px;
@@ -187,6 +185,7 @@
             display: inline-flex;
             align-items: center;
             color: var(--body-text-color);
+            gap: var(--menu-icon-separation);
         }
 
         span {
@@ -211,7 +210,8 @@
 
 .social-menu {
     list-style: none;
-    padding: 0%;
+    padding: 0;
+    margin: 0;
     display: flex;
     flex-direction: row;
     gap: 10px;
diff --git a/assets/scss/partials/pagination.scss b/assets/scss/partials/pagination.scss
index a6c6882..ca46780 100644
--- a/assets/scss/partials/pagination.scss
+++ b/assets/scss/partials/pagination.scss
@@ -5,7 +5,6 @@
     border-radius: var(--card-border-radius);
     overflow: hidden;
     flex-wrap: wrap;
-    margin: var(--section-separation) 0;
 
     .page-link {
         padding: 16px 32px;
diff --git a/assets/scss/partials/sidebar.scss b/assets/scss/partials/sidebar.scss
index 4d320a8..09bcc33 100644
--- a/assets/scss/partials/sidebar.scss
+++ b/assets/scss/partials/sidebar.scss
@@ -11,11 +11,13 @@
     flex-direction: column;
     flex-shrink: 0;
     align-self: stretch;
+    gap: var(--sidebar-element-separation);
 
     width: 100%;
-    padding: 30px 0 15px 0;
     max-width: none;
 
+    position: relative;
+
     --sidebar-avatar-size: 120px;
     --sidebar-element-separation: 20px;
 
@@ -39,6 +41,8 @@
 .right-sidebar {
     width: 100%;
     display: none;
+    flex-direction: column;
+    gap: var(--widget-separation);
 
     &.sticky {
         top: 0;
@@ -49,11 +53,12 @@
     }
 }
 
-.site-info {
+.sidebar header {
     z-index: 1;
     transition: box-shadow 0.5s ease;
-
-    padding: 15px;
+    display: flex;
+    flex-direction: column;
+    gap: var(--sidebar-element-separation);
 
     @include respond(md) {
         padding: 0;
@@ -65,8 +70,6 @@
         width: var(--sidebar-avatar-size);
         height: var(--sidebar-avatar-size);
 
-        margin-bottom: var(--sidebar-element-separation);
-
         .site-logo {
             width: 100%;
             height: 100%;
@@ -95,6 +98,12 @@
         }
     }
 
+    .site-meta {
+        display: flex;
+        flex-direction: column;
+        gap: 10px;
+    }
+
     .site-name {
         color: var(--accent-color);
         margin: 0;
@@ -108,7 +117,7 @@
     .site-description {
         color: var(--body-text-color);
         font-weight: normal;
-        margin: 10px 0;
+        margin: 0;
         font-size: 1.6rem;
 
         @include respond(2xl) {
@@ -117,21 +126,6 @@
     }
 }
 
-.sidebar {
-    .widget {
-        margin-bottom: var(--section-separation);
-
-        &:not(:last-of-type):after {
-            content: "";
-            width: 100px;
-            height: 2px;
-            background-color: var(--body-text-color);
-            display: block;
-            margin-top: var(--section-separation);
-        }
-    }
-}
-
 [data-scheme="dark"] {
     #dark-mode-toggle {
         color: var(--accent-color);
@@ -153,6 +147,7 @@
     display: flex;
     align-items: center;
     cursor: pointer;
+    gap: var(--menu-icon-separation);
 
     .icon-tabler-toggle-right {
         display: none;
@@ -163,6 +158,7 @@
     color: var(--body-text-color);
     display: inline-flex;
     align-content: center;
+    gap: var(--menu-icon-separation);
 
     select {
         border: 0;
diff --git a/assets/scss/partials/widgets.scss b/assets/scss/partials/widgets.scss
index 33a02dd..42cfcc2 100644
--- a/assets/scss/partials/widgets.scss
+++ b/assets/scss/partials/widgets.scss
@@ -1,4 +1,7 @@
 .widget {
+    display: flex;
+    flex-direction: column;
+
     .widget-icon {
         svg {
             width: 32px;
@@ -14,16 +17,14 @@
     .tagCloud-tags {
         display: flex;
         flex-wrap: wrap;
+        gap: 10px;
 
         a {
             background: var(--card-background);
             box-shadow: var(--shadow-l1);
             border-radius: var(--tag-border-radius);
             padding: 8px 20px;
-
             color: var(--card-text-color-main);
-            margin-bottom: 10px;
-            margin-right: 5px;
             font-size: 1.4rem;
             transition: box-shadow 0.3s ease;
 
diff --git a/assets/scss/style.scss b/assets/scss/style.scss
index 2f5aac9..43e95a5 100644
--- a/assets/scss/style.scss
+++ b/assets/scss/style.scss
@@ -19,7 +19,6 @@
 @import "partials/pagination.scss";
 @import "partials/sidebar.scss";
 @import "partials/base.scss";
-@import "partials/layout/archives.scss";
 @import "partials/layout/article.scss";
 @import "partials/layout/list.scss";
 @import "partials/layout/404.scss";
diff --git a/assets/scss/variables.scss b/assets/scss/variables.scss
index f7d45b4..afddb80 100644
--- a/assets/scss/variables.scss
+++ b/assets/scss/variables.scss
@@ -5,9 +5,7 @@ $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
 *   Global style
 */
 :root {
-    @include respond(md) {
-        --main-top-padding: 35px;
-    }
+    --main-top-padding: 35px;
 
     @include respond(xl) {
         --main-top-padding: 50px;
@@ -159,3 +157,9 @@ $defaultTagColors: #fff, #fff, #fff, #fff, #fff;
     --pre-background-color: #272822;
     @import "partials/highlight/dark.scss";
 }
+
+:root {
+    --menu-icon-separation: 40px;
+    --container-padding: 15px;
+    --widget-separation: var(--section-separation);
+}
diff --git a/layouts/_default/archives.html b/layouts/_default/archives.html
index 321aa6d..5d5243c 100644
--- a/layouts/_default/archives.html
+++ b/layouts/_default/archives.html
@@ -1,17 +1,19 @@
 {{ define "body-class" }}template-archives{{ end }}
 {{ define "main" }}
-    {{- $taxonomy := $.Site.GetPage "taxonomyTerm" "categories" -}}
-    {{- $terms := $taxonomy.Pages -}}
-    {{ if $terms }}
-    <h2 class="section-title">{{ $taxonomy.Title }}</h2>
-    <div class="subsection-list">
-        <div class="article-list--tile">
-            {{ range $terms }}
-                {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "taxonomy") }}
-            {{ end }}
+    <header>
+        {{- $taxonomy := $.Site.GetPage "taxonomyTerm" "categories" -}}
+        {{- $terms := $taxonomy.Pages -}}
+        {{ if $terms }}
+        <h2 class="section-title">{{ $taxonomy.Title }}</h2>
+        <div class="subsection-list">
+            <div class="article-list--tile">
+                {{ range $terms }}
+                    {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "taxonomy") }}
+                {{ end }}
+            </div>
         </div>
-    </div>
-    {{ end }}
+        {{ end }}
+    </header>
 
     {{ $pages := where .Site.RegularPages "Type" "in" .Site.Params.mainSections }}
     {{ $notHidden := where .Site.RegularPages "Params.hidden" "!=" true }}
diff --git a/layouts/_default/list.html b/layouts/_default/list.html
index 49a5c12..9bc618d 100644
--- a/layouts/_default/list.html
+++ b/layouts/_default/list.html
@@ -1,46 +1,48 @@
 {{ define "main" }}
-    <h3 class="section-title">
-        {{ if eq .Parent (.GetPage "/") }}
-            {{ T "list.section" }}
-        {{ else }}
-            {{ .Parent.Title }}
-        {{ end }}
-    </h3>
-
-    <div class="section-card">
-        <div class="section-details">
-            <h3 class="section-count">{{ T "list.page" (len .Pages) }}</h3>
-            <h1 class="section-term">{{ .Title }}</h1>
-            {{ with .Params.description }}
-                <h2 class="section-description">{{ . }}</h2>
+    <header>
+        <h3 class="section-title">
+            {{ if eq .Parent (.GetPage "/") }}
+                {{ T "list.section" }}
+            {{ else }}
+                {{ .Parent.Title }}
             {{ end }}
-        </div>
+        </h3>
 
-        {{- $image := partialCached "helper/image" (dict "Context" . "Type" "section") .RelPermalink "section" -}}
-        {{ if $image.exists }}
-            <div class="section-image">
-                {{ if $image.resource }}
-                    {{- $Permalink := $image.resource.RelPermalink -}}
-                    {{- $Width := $image.resource.Width -}}
-                    {{- $Height := $image.resource.Height -}}
-
-                    {{- if (default true .Page.Site.Params.imageProcessing.cover.enabled) -}}
-                        {{- $thumbnail := $image.resource.Fill "120x120" -}}
-                        {{- $Permalink = $thumbnail.RelPermalink -}}
-                        {{- $Width = $thumbnail.Width -}}
-                        {{- $Height = $thumbnail.Height -}}
-                    {{- end -}}
-                    
-                    <img src="{{ $Permalink }}" 
-                        width="{{ $Width }}"
-                        height="{{ $Height }}" 
-                        loading="lazy">
-                {{ else }}
-                    <img src="{{ $image.permalink }}" loading="lazy" />
+        <div class="section-card">
+            <div class="section-details">
+                <h3 class="section-count">{{ T "list.page" (len .Pages) }}</h3>
+                <h1 class="section-term">{{ .Title }}</h1>
+                {{ with .Params.description }}
+                    <h2 class="section-description">{{ . }}</h2>
                 {{ end }}
             </div>
-        {{ end }}
-    </div>
+    
+            {{- $image := partialCached "helper/image" (dict "Context" . "Type" "section") .RelPermalink "section" -}}
+            {{ if $image.exists }}
+                <div class="section-image">
+                    {{ if $image.resource }}
+                        {{- $Permalink := $image.resource.RelPermalink -}}
+                        {{- $Width := $image.resource.Width -}}
+                        {{- $Height := $image.resource.Height -}}
+    
+                        {{- if (default true .Page.Site.Params.imageProcessing.cover.enabled) -}}
+                            {{- $thumbnail := $image.resource.Fill "120x120" -}}
+                            {{- $Permalink = $thumbnail.RelPermalink -}}
+                            {{- $Width = $thumbnail.Width -}}
+                            {{- $Height = $thumbnail.Height -}}
+                        {{- end -}}
+                        
+                        <img src="{{ $Permalink }}" 
+                            width="{{ $Width }}"
+                            height="{{ $Height }}" 
+                            loading="lazy">
+                    {{ else }}
+                        <img src="{{ $image.permalink }}" loading="lazy" />
+                    {{ end }}
+                </div>
+            {{ end }}
+        </div>
+    </header>
 
     {{- $subsections := .Sections -}}
     {{- $pages := .Pages | complement $subsections -}}
@@ -53,14 +55,16 @@
     {{- end -}}
 
     {{- with $subsections -}}
-        <h2 class="section-title">{{ T "list.subsection" (len $subsections) }}</h2>
-        <div class="subsection-list">
-            <div class="article-list--tile">
-                {{ range . }}
-                    {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "section") }}
-                {{ end }}
+        <aside>
+            <h2 class="section-title">{{ T "list.subsection" (len $subsections) }}</h2>
+            <div class="subsection-list">
+                <div class="article-list--tile">
+                    {{ range . }}
+                        {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "section") }}
+                    {{ end }}
+                </div>
             </div>
-        </div>
+        </aside>
     {{- end -}}
     
     {{/* List only pages that are not a subsection */}}
diff --git a/layouts/page/search.html b/layouts/page/search.html
index 935b384..7c424a6 100644
--- a/layouts/page/search.html
+++ b/layouts/page/search.html
@@ -16,8 +16,10 @@
     </button>
 </form>
 
-<h3 class="search-result--title section-title"></h3>
-<div class="search-result--list article-list--compact"></div>
+<div class="search-result">
+    <h3 class="search-result--title section-title"></h3>
+    <div class="search-result--list article-list--compact"></div>
+</div>
 
 <script>
     window.searchResultTitleTemplate = "{{ T `search.resultTitle` }}"
diff --git a/layouts/partials/article/components/related-contents.html b/layouts/partials/article/components/related-contents.html
index 810b8e9..29cfff6 100644
--- a/layouts/partials/article/components/related-contents.html
+++ b/layouts/partials/article/components/related-contents.html
@@ -1,13 +1,13 @@
+{{ $related := (where (.Site.RegularPages.Related .) "Params.hidden" "!=" true) | first 5 }}
+{{ with $related }}
 <aside class="related-contents--wrapper">
-    {{ $related := (where (.Site.RegularPages.Related .) "Params.hidden" "!=" true) | first 5 }}
-    {{ with $related }}
-        <h2 class="section-title">{{ T "article.relatedContents" }}</h2>
-        <div class="related-contents">
-            <div class="flex article-list--tile">
-                {{ range . }}
-                    {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "articleList") }}
-                {{ end }}
-            </div>
+    <h2 class="section-title">{{ T "article.relatedContents" }}</h2>
+    <div class="related-contents">
+        <div class="flex article-list--tile">
+            {{ range . }}
+                {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "articleList") }}
+            {{ end }}
         </div>
-    {{ end }}
+    </div>
 </aside>
+{{ end }}
\ No newline at end of file
diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index 35d1c11..44d5307 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -5,7 +5,7 @@
         </span>
     </button>
 
-    <header class="site-info">
+    <header>
         {{ with .Site.Params.sidebar.avatar }}
             {{ if (default true .enabled) }}
             <figure class="site-avatar">
@@ -31,8 +31,10 @@
             {{ end }}
         {{ end }}
         
-        <h1 class="site-name"><a href="{{ .Site.BaseURL | relLangURL }}">{{ .Site.Title }}</a></h1>
-        <h2 class="site-description">{{ .Site.Params.sidebar.subtitle }}</h2>
+        <div class="site-meta">
+            <h1 class="site-name"><a href="{{ .Site.BaseURL | relLangURL }}">{{ .Site.Title }}</a></h1>
+            <h2 class="site-description">{{ .Site.Params.sidebar.subtitle }}</h2>
+        </div>
 
         {{- with .Site.Menus.social -}}
             <ol class="social-menu">

From 8abaa444c1d6d6a1ea9f5019f76d8dbd6f30948a Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 3 Mar 2022 22:36:17 +0000
Subject: [PATCH 58/79] refactor: add flexbox gap to .article-details

---
 assets/scss/partials/article.scss             | 18 +++++++-------
 .../partials/article/components/details.html  | 24 ++++++++++---------
 2 files changed, 22 insertions(+), 20 deletions(-)

diff --git a/assets/scss/partials/article.scss b/assets/scss/partials/article.scss
index c9444d4..2ea1fe2 100644
--- a/assets/scss/partials/article.scss
+++ b/assets/scss/partials/article.scss
@@ -49,13 +49,13 @@
     display: flex;
     flex-direction: column;
     justify-content: center;
-
     padding: var(--card-padding);
+    gap: 15px;
 }
 
 .article-title {
     font-weight: 600;
-    margin: 10px 0;
+    margin: 0;
     color: var(--card-text-color-main);
     font-size: 2.2rem;
 
@@ -70,31 +70,31 @@
             color: var(--card-text-color-main);
         }
     }
-
-    & + .article-subtitle {
-        margin-top: 0;
-    }
 }
 
 .article-subtitle {
     font-weight: normal;
     color: var(--card-text-color-secondary);
-    margin: 5px 0;
     line-height: 1.5;
-
+    margin: 0;
     font-size: 1.75rem;
     @include respond(xl) {
         font-size: 2rem;
     }
 }
 
+.article-title-wrapper {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
 .article-time,
 .article-translations {
     display: flex;
     align-items: center;
     color: var(--card-text-color-tertiary);
     gap: 15px;
-    margin-top: 10px;
     flex-wrap: wrap;
 
     svg {
diff --git a/layouts/partials/article/components/details.html b/layouts/partials/article/components/details.html
index 2ec1241..4cd26e3 100644
--- a/layouts/partials/article/components/details.html
+++ b/layouts/partials/article/components/details.html
@@ -9,17 +9,19 @@
     </header>
     {{ end }}
 
-    <h2 class="article-title">
-        <a href="{{ .RelPermalink }}">
-            {{- .Title -}}
-        </a>
-    </h2>
-
-    {{ with .Params.description }}
-    <h3 class="article-subtitle">
-        {{ . }}
-    </h3>
-    {{ end }}
+    <div class="article-title-wrapper">
+        <h2 class="article-title">
+            <a href="{{ .RelPermalink }}">
+                {{- .Title -}}
+            </a>
+        </h2>
+    
+        {{ with .Params.description }}
+        <h3 class="article-subtitle">
+            {{ . }}
+        </h3>
+        {{ end }}
+    </div>
 
     {{ if or (not .Date.IsZero) (.Site.Params.article.readingTime) }}
     <footer class="article-time">

From d806226ec8d1f7eb0a0596609bfcc143785f7f55 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 3 Mar 2022 22:39:04 +0000
Subject: [PATCH 59/79] fix: article-details gap

---
 assets/scss/partials/article.scss | 1 +
 1 file changed, 1 insertion(+)

diff --git a/assets/scss/partials/article.scss b/assets/scss/partials/article.scss
index 2ea1fe2..f085ff0 100644
--- a/assets/scss/partials/article.scss
+++ b/assets/scss/partials/article.scss
@@ -165,6 +165,7 @@
             flex-grow: 1;
             padding: 0;
             min-height: var(--image-size);
+            gap: 10px;
         }
 
         .article-title {

From e22664be13a89b7e0401c3652340569316bb417e Mon Sep 17 00:00:00 2001
From: Felix Niederwanger <felix.niederwanger@suse.com>
Date: Thu, 3 Mar 2022 23:47:10 +0100
Subject: [PATCH 60/79] feat(widget): add category widget (#475)

* Add category widget

Adds the ability to add a category to the widgets.

* Adapt to new widget scheme

Co-authored-by: Jimmy Cai <github@jimmycai.com>
---
 assets/icons/categories.svg             |  9 +++++++++
 i18n/en.yaml                            |  3 +++
 layouts/partials/widget/categories.html | 16 ++++++++++++++++
 3 files changed, 28 insertions(+)
 create mode 100644 assets/icons/categories.svg
 create mode 100644 layouts/partials/widget/categories.html

diff --git a/assets/icons/categories.svg b/assets/icons/categories.svg
new file mode 100644
index 0000000..e00ab1d
--- /dev/null
+++ b/assets/icons/categories.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-hash" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke="none" d="M0 0h24v24H0z"/>
+  <line x1="5" y1="9" x2="19" y2="9" />
+  <line x1="5" y1="15" x2="19" y2="15" />
+  <line x1="11" y1="4" x2="7" y2="20" />
+  <line x1="17" y1="4" x2="13" y2="20" />
+</svg>
+
+
diff --git a/i18n/en.yaml b/i18n/en.yaml
index 0197d89..3d0ed03 100644
--- a/i18n/en.yaml
+++ b/i18n/en.yaml
@@ -51,6 +51,9 @@ widget:
     tagCloud:
         title:
             other: Tags
+    categoriesCloud:
+        title:
+            other: Categories
 
 search:
     title:
diff --git a/layouts/partials/widget/categories.html b/layouts/partials/widget/categories.html
new file mode 100644
index 0000000..10c8a35
--- /dev/null
+++ b/layouts/partials/widget/categories.html
@@ -0,0 +1,16 @@
+{{- $context := .Context -}}
+{{- $limit := default 10 .Params.limit -}}
+<section class="widget tagCloud">
+    <div class="widget-icon">
+        {{ partial "helper/icon" "categories" }}
+    </div>
+    <h2 class="widget-title section-title">{{ T "widget.categoriesCloud.title" }}</h2>
+
+    <div class="tagCloud-tags">
+        {{ range first $limit $context.Site.Taxonomies.categories.ByCount }}
+            <a href="{{ .Page.RelPermalink }}" class="font_size_{{ .Count }}">
+                {{ .Page.Title }}
+            </a>
+        {{ end }}
+    </div>
+</section>

From 86ad00cf8cbbc6b212d68afcedf28cda8b552690 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Thu, 3 Mar 2022 22:48:26 +0000
Subject: [PATCH 61/79] doc: add categories widget to exampleSite

---
 exampleSite/config.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index b2fe1d3..cfad0a0 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -147,6 +147,9 @@ params:
             - type: archives
               params:
                   limit: 5
+            - type: categories
+              params:
+                  limit: 10
             - type: tag-cloud
               params:
                   limit: 10

From 0d0375a7fcf82023be80a7370d789083c1250f60 Mon Sep 17 00:00:00 2001
From: FarisZR <35614734+fariszr@users.noreply.github.com>
Date: Fri, 4 Mar 2022 02:25:34 +0300
Subject: [PATCH 62/79] feat: add RTL Support and update demo site to Show
 Arabic/RTL content (#519)

* add LanguageDirection variable

* add .direction-rtl and .direction-ltr clases

* margin -right > margin-inline-end

* keep Codeblocks LTR

* switch to logical properties

* left -> inset-inline-start

* Add Arabic/RTL placeholder text

* Add arabic language

* remove space

* use Html Dir instead of class

* Move codeblock code to layout/article.css and fix 4 spaces codeblocks

* remove unused clases
---
 assets/scss/partials/base.scss                |  2 +-
 assets/scss/partials/layout/article.scss      | 18 +++++++----
 assets/scss/partials/layout/search.scss       |  5 +--
 exampleSite/config.yaml                       |  7 +++-
 .../content/post/placeholder-text/index.ar.md | 32 +++++++++++++++++++
 layouts/_default/baseof.html                  |  2 +-
 6 files changed, 55 insertions(+), 11 deletions(-)
 create mode 100644 exampleSite/content/post/placeholder-text/index.ar.md

diff --git a/assets/scss/partials/base.scss b/assets/scss/partials/base.scss
index e7aefe6..efb4b8f 100644
--- a/assets/scss/partials/base.scss
+++ b/assets/scss/partials/base.scss
@@ -35,4 +35,4 @@ body {
 ::-webkit-scrollbar-track {
     background-color: transparent;
 }
-/**/
+/**/
\ No newline at end of file
diff --git a/assets/scss/partials/layout/article.scss b/assets/scss/partials/layout/article.scss
index ef35ba9..36f326a 100644
--- a/assets/scss/partials/layout/article.scss
+++ b/assets/scss/partials/layout/article.scss
@@ -252,9 +252,9 @@
     h4,
     h5,
     h6 {
-        margin-left: calc((var(--card-padding)) * -1);
-        padding-left: calc(var(--card-padding) - var(--heading-border-size));
-        border-left: var(--heading-border-size) solid var(--accent-color);
+        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);
     }
 
     figure {
@@ -269,7 +269,7 @@
     blockquote {
         position: relative;
         margin: 1.5em 0;
-        border-left: var(--blockquote-border-size) solid var(--card-separator-color);
+        border-inline-start: var(--blockquote-border-size) solid var(--card-separator-color);
         padding: 15px calc(var(--card-padding) - var(--blockquote-border-size));
         background-color: var(--blockquote-background-color);
     }
@@ -313,7 +313,10 @@
         line-height: 1.428571429;
         word-break: break-all;
         padding: var(--card-padding);
-
+        //  keep Codeblocks LTR
+        [dir="rtl"] & {
+            direction: ltr;
+        }
         code {
             color: unset;
             border: none;
@@ -332,7 +335,10 @@
                 opacity: 1;
             }
         }
-
+        // keep Codeblocks LTR
+        [dir="rtl"] & {
+            direction: ltr;
+        }
         pre {
             margin: initial;
             padding: 0;
diff --git a/assets/scss/partials/layout/search.scss b/assets/scss/partials/layout/search.scss
index f2cc7be..89cdcef 100644
--- a/assets/scss/partials/layout/search.scss
+++ b/assets/scss/partials/layout/search.scss
@@ -24,7 +24,7 @@
     label {
         position: absolute;
         top: 15px;
-        left: 20px;
+        inset-inline-start: 20px;
         font-size: 1.4rem;
         color: var(--card-text-color-tertiary);
     }
@@ -51,7 +51,7 @@
 
     button {
         position: absolute;
-        right: 0;
+        inset-inline-end: 0;
         top: 0;
         height: 100%;
         width: var(--button-size);
@@ -78,4 +78,5 @@
             height: 20px;
         }
     }
+
 }
\ No newline at end of file
diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index cfad0a0..ea1cf07 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -13,6 +13,11 @@ languages:
         languageName: 中文
         title: 演示站点
         weight: 2
+    ar:
+        languageName: عربي
+        languagedirection: rtl
+        title: موقع تجريبي
+        weight: 3
 
 # Change it to your Disqus shortname before using
 disqusShortname: hugo-theme-stack
@@ -21,7 +26,7 @@ disqusShortname: hugo-theme-stack
 googleAnalytics:
 
 # Theme i18n support
-# Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el, uk
+# Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el, uk, ar
 DefaultContentLanguage: en
 
 # Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
diff --git a/exampleSite/content/post/placeholder-text/index.ar.md b/exampleSite/content/post/placeholder-text/index.ar.md
new file mode 100644
index 0000000..b0328f4
--- /dev/null
+++ b/exampleSite/content/post/placeholder-text/index.ar.md
@@ -0,0 +1,32 @@
++++
+author = "Hugo Authors"
+title = "مثال نص"
+date = "2019-03-09"
+description = "هذا النص هو مثال لنص يمكن أن يستبدل في نفس المساحة"
+categories = [
+    "تجربة",
+    "تجربة مع فراغات"
+]
+tags = [
+    "ماركداون",
+    "نص",
+    "وسم مع فراغات"
+]
+image = "matt-le-SJSpo9hQf7s-unsplash.jpg"
++++
+## فقرة 1
+
+هذا النص هو مثال لنص يمكن أن يستبدل في نفس المساحة، لقد تم توليد هذا النص من [مولد النص العربى](https://colorslab.com/textgator/)، حيث يمكنك أن تولد مثل هذا النص أو العديد من النصوص الأخرى إضافة إلى زيادة عدد الحروف التى يولدها التطبيق.
+إذا كنت تحتاج إلى عدد أكبر من الفقرات يتيح لك مولد النص العربى زيادة عدد الفقرات كما تريد، النص لن يبدو مقسما ولا يحوي أخطاء لغوية، مولد النص العربى مفيد لمصممي المواقع على وجه الخصوص، حيث يحتاج العميل فى كثير من الأحيان أن يطلع على صورة حقيقية لتصميم الموقع.
+ومن هنا وجب على المصمم أن يضع نصوصا مؤقتة على التصميم ليظهر للعميل الشكل كاملاً،دور مولد النص العربى أن يوفر على المصمم عناء البحث عن نص بديل لا علاقة له بالموضوع الذى يتحدث عنه التصميم فيظهر بشكل لا يليق.
+هذا النص يمكن أن يتم تركيبه على أي تصميم دون مشكلة فلن يبدو وكأنه نص منسوخ، غير منظم، غير منسق، أو حتى غير مفهوم. لأنه مازال نصاً بديلاً ومؤقتاً.
+
+## فقرة 2
+
+هذا النص هو مثال لنص يمكن أن يستبدل في نفس المساحة، لقد تم توليد هذا النص من [مولد النص العربى](https://colorslab.com/textgator/)، حيث يمكنك أن تولد مثل هذا النص أو العديد من النصوص الأخرى إضافة إلى زيادة عدد الحروف التى يولدها التطبيق.
+إذا كنت تحتاج إلى عدد أكبر من الفقرات يتيح لك مولد النص العربى زيادة عدد الفقرات كما تريد، النص لن يبدو مقسما ولا يحوي أخطاء لغوية، مولد النص العربى مفيد لمصممي المواقع على وجه الخصوص، حيث يحتاج العميل فى كثير من الأحيان أن يطلع على صورة حقيقية لتصميم الموقع.
+ومن هنا وجب على المصمم أن يضع نصوصا مؤقتة على التصميم ليظهر للعميل الشكل كاملاً،دور مولد النص العربى أن يوفر على المصمم عناء البحث عن نص بديل لا علاقة له بالموضوع الذى يتحدث عنه التصميم فيظهر بشكل لا يليق.
+هذا النص يمكن أن يتم تركيبه على أي تصميم دون مشكلة فلن يبدو وكأنه نص منسوخ، غير منظم، غير منسق، أو حتى غير مفهوم. لأنه مازال نصاً بديلاً ومؤقتاً.
+
+## تجربة RTL
+كلمة 1 Text كلمة 2
diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html
index db1903e..98cc815 100644
--- a/layouts/_default/baseof.html
+++ b/layouts/_default/baseof.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="{{ .Site.LanguageCode }}">
+<html lang="{{ .Site.LanguageCode }}" dir="{{ default `ltr` .Language.LanguageDirection }}">
     <head>
         {{- partial "head/head.html" . -}}
         {{- block "head" . -}}{{ end }}

From 47c19a0fbc73084b95e9951c07ef9ddea8f1bcc8 Mon Sep 17 00:00:00 2001
From: FarisZR <35614734+fariszr@users.noreply.github.com>
Date: Fri, 4 Mar 2022 02:28:17 +0300
Subject: [PATCH 63/79] feat(i18n): add Arabic translation (#157)

---
 i18n/ar.yaml | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 i18n/ar.yaml

diff --git a/i18n/ar.yaml b/i18n/ar.yaml
new file mode 100644
index 0000000..dab3c74
--- /dev/null
+++ b/i18n/ar.yaml
@@ -0,0 +1,70 @@
+toggleMenu:
+    other: اخفي القائمة
+
+darkMode:
+    other: الوضع الداكن
+
+list:
+    page:
+        one: "{{ .Count }} صفحه"
+        other: "{{ .Count }} صفحات"
+
+    section:
+        other: قسم
+
+    subsection:
+        one: قسم فرعي
+        other: اقسام فرعية
+
+article:
+    back:
+        other: خلف
+
+    tableOfContents:
+        other: جدول المحتويات
+
+    relatedContents:
+        other: محتوى مشابهه
+        
+    lastUpdatedOn:
+        other: التعديل الاخير
+
+    readingTime:
+        one: "قرائة {{ .Count }} دقيقة"
+        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 }}"

From dbf4c2e58f6f501f933fc4e7c7d95d7a37676040 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 4 Mar 2022 09:39:27 +0100
Subject: [PATCH 64/79] chore: add Github link to funding.yml

---
 .github/FUNDING.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
index a222d4e..95f0c18 100644
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -1 +1,2 @@
-ko_fi: jimmycai
\ No newline at end of file
+ko_fi: jimmycai
+github: CaiJimmy

From c4e864a08d5405a6ea4ae9590833af612d65d430 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 4 Mar 2022 08:41:47 +0000
Subject: [PATCH 65/79] doc(exampleSite): move chinese-test post to /cn

---
 exampleSite/content/post/chinese-test/{index.md => index.cn.md} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename exampleSite/content/post/chinese-test/{index.md => index.cn.md} (100%)

diff --git a/exampleSite/content/post/chinese-test/index.md b/exampleSite/content/post/chinese-test/index.cn.md
similarity index 100%
rename from exampleSite/content/post/chinese-test/index.md
rename to exampleSite/content/post/chinese-test/index.cn.md

From 15d2040f7e4aaf9db8e4459137d146bb42b39bb6 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 4 Mar 2022 08:46:27 +0000
Subject: [PATCH 66/79] chore(exampleSite): fix home menu item highlight

---
 exampleSite/content/_index.cn.md | 8 ++++++++
 exampleSite/content/_index.md    | 8 ++++++++
 2 files changed, 16 insertions(+)
 create mode 100644 exampleSite/content/_index.cn.md
 create mode 100644 exampleSite/content/_index.md

diff --git a/exampleSite/content/_index.cn.md b/exampleSite/content/_index.cn.md
new file mode 100644
index 0000000..e4b59a8
--- /dev/null
+++ b/exampleSite/content/_index.cn.md
@@ -0,0 +1,8 @@
+---
+menu:
+    main:
+        name: 主页
+        weight: -100
+        params:
+            icon: home
+---
\ No newline at end of file
diff --git a/exampleSite/content/_index.md b/exampleSite/content/_index.md
new file mode 100644
index 0000000..530dfe8
--- /dev/null
+++ b/exampleSite/content/_index.md
@@ -0,0 +1,8 @@
+---
+menu:
+    main:
+        name: Home
+        weight: -100
+        params:
+            icon: home
+---
\ No newline at end of file

From c122e5e9a1cd4f71e069dc1d05d036a1b030db09 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 4 Mar 2022 08:47:51 +0000
Subject: [PATCH 67/79] chore(exampleSite): remove extra home menu item

---
 exampleSite/config.yaml | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/exampleSite/config.yaml b/exampleSite/config.yaml
index ea1cf07..84585b4 100644
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -192,15 +192,7 @@ params:
 ### See https://docs.stack.jimmycai.com/configuration/custom-menu.html
 ### To remove about, archive and search page menu item, remove `menu` field from their FrontMatter
 menu:
-    main:
-        - identifier: home
-          name: Home
-          url: /
-          weight: -100
-          params:
-              ### For demonstration purpose, the home link will be open in a new tab
-              newTab: true
-              icon: home
+    main: []
 
     social:
         - identifier: github

From 985af924e7643d663a179198f55349e153536e43 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 4 Mar 2022 10:24:21 +0100
Subject: [PATCH 68/79] feat: new left sidebar layout (#524)

* feat: more compact menu style

* add compact option to sidebar

* fix mobile menu style
---
 assets/scss/partials/menu.scss     | 16 ++++----
 assets/scss/partials/sidebar.scss  | 63 +++++++++++++++++++++---------
 config.yaml                        |  1 +
 layouts/partials/sidebar/left.html | 40 +++++++++----------
 4 files changed, 74 insertions(+), 46 deletions(-)

diff --git a/assets/scss/partials/menu.scss b/assets/scss/partials/menu.scss
index 16adb80..4f29c9f 100644
--- a/assets/scss/partials/menu.scss
+++ b/assets/scss/partials/menu.scss
@@ -134,19 +134,22 @@
     overflow-y: auto;
     flex-grow: 1;
     font-size: 1.4rem;
-
     background-color: var(--card-background);
-    padding: 15px 0;
+
     box-shadow: var(--shadow-l1);
     display: none;
-
     margin: 0 calc(var(--container-padding) * -1);
 
+    padding: 30px 30px;
+    @include respond(xl) {
+        padding: 15px 0;
+    }
+
     &,
     .menu-bottom-section {
-        gap: 15px;
+        gap: 30px;
         @include respond(xl) {
-            gap: 20px;
+            gap: 25px;
         }
     }
 
@@ -166,11 +169,10 @@
     li {
         position: relative;
         vertical-align: middle;
-        padding: 10px 30px;
+        padding: 0;
 
         @include respond(md) {
             width: 100%;
-            padding: 10px 0;
         }
 
         svg {
diff --git a/assets/scss/partials/sidebar.scss b/assets/scss/partials/sidebar.scss
index 09bcc33..95310ca 100644
--- a/assets/scss/partials/sidebar.scss
+++ b/assets/scss/partials/sidebar.scss
@@ -12,14 +12,14 @@
     flex-shrink: 0;
     align-self: stretch;
     gap: var(--sidebar-element-separation);
-
-    width: 100%;
     max-width: none;
-
+    width: 100%;
     position: relative;
 
-    --sidebar-avatar-size: 120px;
+    --sidebar-avatar-size: 100px;
     --sidebar-element-separation: 20px;
+    --emoji-size: 40px;
+    --emoji-font-size: 20px;
 
     @include respond(md) {
         width: auto;
@@ -29,13 +29,42 @@
     }
 
     @include respond(2xl) {
-        --sidebar-avatar-size: 140px;
+        --sidebar-avatar-size: 120px;
         --sidebar-element-separation: 25px;
+        --emoji-size: 40px;
     }
 
     &.sticky {
         top: 0;
     }
+
+    &.compact {
+        --sidebar-avatar-size: 80px;
+        --emoji-size: 30px;
+        --emoji-font-size: 15px;
+
+        header {
+            @include respond(lg) {
+                flex-direction: row;
+            }
+
+            .site-meta {
+                gap: 5px;
+            }
+
+            .site-name {
+                font-size: 1.4rem;
+
+                @include respond(2xl) {
+                    font-size: 1.75rem;
+                }
+            }
+
+            .site-description {
+                font-size: 1.4rem;
+            }
+        }
+    }
 }
 
 .right-sidebar {
@@ -69,6 +98,7 @@
         margin: 0;
         width: var(--sidebar-avatar-size);
         height: var(--sidebar-avatar-size);
+        flex-shrink: 0;
 
         .site-logo {
             width: 100%;
@@ -79,22 +109,16 @@
 
         .emoji {
             position: absolute;
-            width: 40px;
-            height: 40px;
-            line-height: 40px;
+            width: var(--emoji-size);
+            height: var(--emoji-size);
+            line-height: var(--emoji-size);
             border-radius: 100%;
             bottom: 0;
             right: 0;
             text-align: center;
-            font-size: 20px;
+            font-size: var(--emoji-font-size);
             background-color: var(--card-background);
             box-shadow: var(--shadow-l2);
-
-            @include respond(2xl) {
-                width: 50px;
-                height: 50px;
-                line-height: 50px;
-            }
         }
     }
 
@@ -102,15 +126,16 @@
         display: flex;
         flex-direction: column;
         gap: 10px;
+        justify-content: center;
     }
 
     .site-name {
         color: var(--accent-color);
         margin: 0;
-        font-size: 1.8rem;
+        font-size: 1.6rem;
 
         @include respond(2xl) {
-            font-size: 2rem;
+            font-size: 1.8rem;
         }
     }
 
@@ -118,10 +143,10 @@
         color: var(--body-text-color);
         font-weight: normal;
         margin: 0;
-        font-size: 1.6rem;
+        font-size: 1.4rem;
 
         @include respond(2xl) {
-            font-size: 1.8rem;
+            font-size: 1.6rem;
         }
     }
 }
diff --git a/config.yaml b/config.yaml
index c55a911..93367bb 100644
--- a/config.yaml
+++ b/config.yaml
@@ -19,6 +19,7 @@ params:
         lastUpdated: Jan 02, 2006 15:04 MST
 
     sidebar:
+        compact: false
         emoji:
         subtitle:
         avatar:
diff --git a/layouts/partials/sidebar/left.html b/layouts/partials/sidebar/left.html
index 44d5307..f255389 100644
--- a/layouts/partials/sidebar/left.html
+++ b/layouts/partials/sidebar/left.html
@@ -1,4 +1,4 @@
-<aside class="sidebar left-sidebar sticky">
+<aside class="sidebar left-sidebar sticky {{ if .Site.Params.sidebar.compact }}compact{{ end }}">
     <button class="hamburger hamburger--spin" type="button" id="toggle-menu" aria-label="{{ T `toggleMenu` }}">
         <span class="hamburger-box">
             <span class="hamburger-inner"></span>
@@ -35,27 +35,27 @@
             <h1 class="site-name"><a href="{{ .Site.BaseURL | relLangURL }}">{{ .Site.Title }}</a></h1>
             <h2 class="site-description">{{ .Site.Params.sidebar.subtitle }}</h2>
         </div>
-
-        {{- with .Site.Menus.social -}}
-            <ol class="social-menu">
-                {{ range . }}
-                    <li>
-                        <a 
-                            href='{{ .URL }}'
-                            {{ if eq (default true .Params.newTab) true }}target="_blank"{{ end }}
-                            {{ with .Name }}title="{{ . }}"{{ end }}
-                        >
-                            {{ $icon := default "link" .Params.Icon }}
-                            {{ with $icon }}
-                                {{ partial "helper/icon" . }}
-                            {{ end }}
-                        </a>
-                    </li>
-                {{ end }}
-            </ol>
-        {{- end -}}
     </header>
 
+    {{- with .Site.Menus.social -}}
+        <ol class="social-menu">
+            {{ range . }}
+                <li>
+                    <a 
+                        href='{{ .URL }}'
+                        {{ if eq (default true .Params.newTab) true }}target="_blank"{{ end }}
+                        {{ with .Name }}title="{{ . }}"{{ end }}
+                    >
+                        {{ $icon := default "link" .Params.Icon }}
+                        {{ with $icon }}
+                            {{ partial "helper/icon" . }}
+                        {{ end }}
+                    </a>
+                </li>
+            {{ end }}
+        </ol>
+    {{- end -}}
+
     <ol class="menu" id="main-menu">
         {{ $currentPage := . }}
         {{ range .Site.Menus.main }}

From 6f60f4f552ecc70e613089f47a8a5e5e1d932941 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Fri, 4 Mar 2022 10:31:57 +0100
Subject: [PATCH 69/79] fix: disable external image lightbox (#525)

---
 assets/ts/gallery.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/assets/ts/gallery.ts b/assets/ts/gallery.ts
index 218658d..9840f1e 100644
--- a/assets/ts/gallery.ts
+++ b/assets/ts/gallery.ts
@@ -61,7 +61,7 @@ class StackGallery {
         /// because it can not detect whether image is being wrapped by a link or not
         /// and it lead to a invalid HTML construction (<a><figure><img></figure></a>)
 
-        const images = container.querySelectorAll('img');
+        const images = container.querySelectorAll('img.gallery-image');
         for (const img of Array.from(images)) {
             /// Images are wrapped with figure tag if the paragraph has only images without texts
             /// This is done to allow inline images within paragraphs

From 5449f786ac52048800e5e47504b540498217d7fc Mon Sep 17 00:00:00 2001
From: Jimmy Cai <hi@jimmycai.com>
Date: Fri, 4 Mar 2022 10:40:41 +0100
Subject: [PATCH 70/79] release: 3.9.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index 072465c..86222eb 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.8.0" -}}
+{{- $ThemeVersion := "3.9.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From d455336d579da37139ef4efe3f9060871a62b94d Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 5 Mar 2022 18:11:48 +0100
Subject: [PATCH 71/79] fix: remove section filter in rss.xml

---
 layouts/_default/rss.xml | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/layouts/_default/rss.xml b/layouts/_default/rss.xml
index 4934bd0..e9f3f1a 100644
--- a/layouts/_default/rss.xml
+++ b/layouts/_default/rss.xml
@@ -6,12 +6,10 @@
 {{- else -}}
 {{- $pages = $pctx.Pages -}}
 {{- end -}}
-{{- $pages := where $pages "Type" "in" .Site.Params.mainSections -}}
-{{- $notHidden := where $pages "Params.hidden" "!=" true -}}
-{{- $filtered := ($pages | intersect $notHidden) -}}
+{{- $pages := where $pages "Params.hidden" "!=" true -}}
 {{- $limit := .Site.Config.Services.RSS.Limit -}}
 {{- if ge $limit 1 -}}
-{{- $filtered = $filtered | first $limit -}}
+{{- $pages = $pages | first $limit -}}
 {{- end -}}
 {{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
@@ -28,7 +26,7 @@
         {{- with .OutputFormats.Get "RSS" -}}
         {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
         {{- end -}}
-        {{ range $filtered }}
+        {{ range $pages }}
         {{- $content := safeHTML (.Summary | html) -}}
         {{- if .Site.Params.rssFullContent -}}
             {{- $content = safeHTML (.Content | html) -}}

From 863e6d411608c13bea4206892497931da78a1554 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 5 Mar 2022 17:14:24 +0000
Subject: [PATCH 72/79] Resolve merge conflict

---
 layouts/{ => _default}/rss.xml | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename layouts/{ => _default}/rss.xml (100%)

diff --git a/layouts/rss.xml b/layouts/_default/rss.xml
similarity index 100%
rename from layouts/rss.xml
rename to layouts/_default/rss.xml

From 76925213a31cba81874eed8052ad168f7227895f Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 5 Mar 2022 17:22:11 +0000
Subject: [PATCH 73/79] chore: update go.mod

Trying to figure out what's wrong
---
 go.mod | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/go.mod b/go.mod
index 776617e..6a8a679 100644
--- a/go.mod
+++ b/go.mod
@@ -1,3 +1,3 @@
-module github.com/CaiJimmy/hugo-theme-stack/v3
+module github.com/CaiJimmy/hugo-theme-stack
 
-go 1.12
+go 1.17

From 07da61b1f298dece36951ba5b635ac6fdcb57e52 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 5 Mar 2022 17:25:02 +0000
Subject: [PATCH 74/79] chore: delete go.mod

---
 go.mod | 3 ---
 1 file changed, 3 deletions(-)
 delete mode 100644 go.mod

diff --git a/go.mod b/go.mod
deleted file mode 100644
index 6a8a679..0000000
--- a/go.mod
+++ /dev/null
@@ -1,3 +0,0 @@
-module github.com/CaiJimmy/hugo-theme-stack
-
-go 1.17

From 8f5164b5b90c0a83f58b98c5d04355401e312cbe Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sat, 5 Mar 2022 17:35:18 +0000
Subject: [PATCH 75/79] chore: add go.mod again

---
 go.mod | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 go.mod

diff --git a/go.mod b/go.mod
new file mode 100644
index 0000000..63df635
--- /dev/null
+++ b/go.mod
@@ -0,0 +1,3 @@
+module github.com/CaiJimmy/hugo-theme-stack/v3
+
+go 1.17

From 07e1b856b02abcb544afefc425e464a2fa9e9d03 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Mar 2022 10:58:02 +0100
Subject: [PATCH 76/79] feat: same container width on all pages (#534)

---
 layouts/_default/baseof.html | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html
index 98cc815..081277b 100644
--- a/layouts/_default/baseof.html
+++ b/layouts/_default/baseof.html
@@ -6,7 +6,14 @@
     </head>
     <body class="{{ block `body-class` . }}{{ end }}">
         {{- partial "head/colorScheme" . -}}
-        {{- $hasWidget := default (gt (len .Site.Params.widgets.homepage) 0) (.Scratch.Get "hasWidget") -}}
+
+        {{/* The container is wider when there's any activated widget */}}
+        {{- $hasWidget := false -}}
+        {{- range .Site.Params.widgets -}}
+            {{- if gt (len .) 0 -}}
+                {{- $hasWidget = true -}}
+            {{- end -}}
+        {{- end -}}
         <div class="container main-container flex on-phone--column {{ if $hasWidget }}extended{{ else }}compact{{ end }}">
             {{- block "left-sidebar" . -}}
                 {{ partial "sidebar/left.html" . }}

From de9756291bf82b67ffc2e53ba01c02adc8db120a Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Mar 2022 10:58:31 +0100
Subject: [PATCH 77/79] release: 3.10.0

---
 layouts/partials/footer/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/layouts/partials/footer/footer.html b/layouts/partials/footer/footer.html
index 86222eb..b9ab61a 100644
--- a/layouts/partials/footer/footer.html
+++ b/layouts/partials/footer/footer.html
@@ -1,4 +1,4 @@
-{{- $ThemeVersion := "3.9.0" -}}
+{{- $ThemeVersion := "3.10.0" -}}
 <footer class="site-footer">
     <section class="copyright">
         &copy; 

From 7a5dccdfd35205f74d880a9ee397b64f02d54857 Mon Sep 17 00:00:00 2001
From: Jimmy Cai <github@jimmycai.com>
Date: Sun, 6 Mar 2022 11:17:03 +0100
Subject: [PATCH 78/79] doc: add quickstart template

---
 README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/README.md b/README.md
index 0e6caa2..1c59619 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,10 @@
 
 > Card-style Hugo theme designed for bloggers.
 
+## Quickstart
+
+Use this template: [CaiJimmy/hugo-theme-stack-starter](https://github.com/CaiJimmy/hugo-theme-stack-starter)
+
 ## Demo
 
 [Example Site](https://demo.stack.jimmycai.com/)
@@ -28,6 +32,7 @@ Stack is a simple card-style Hugo theme designed for bloggers, some of its featu
 - Properly cropped thumbnails
 - Subsection support
 - Table of contents
+- Multilingual mode and RTL support
 
 ## Requirements
 

From 0167edcbf287aac3e39decd2e31ad86ea8baf448 Mon Sep 17 00:00:00 2001
From: zhixuan <jinzhixuan666@gmail.com>
Date: Tue, 8 Mar 2022 05:33:04 +0900
Subject: [PATCH 79/79] feat(i18n): add missing ja & zh-CN translations (#538)

---
 i18n/ja.yaml    | 11 +++++++++++
 i18n/zh-CN.yaml | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/i18n/ja.yaml b/i18n/ja.yaml
index 3f9978d..ec70d18 100644
--- a/i18n/ja.yaml
+++ b/i18n/ja.yaml
@@ -38,6 +38,10 @@ widget:
         title:
             other: タグ
 
+    categoriesCloud:
+        title:
+            other: カテゴリ
+
 search:
     title:
         other: 検索
@@ -47,3 +51,10 @@ search:
 
     resultTitle:
         other: "#PAGES_COUNT 件 （#TIME_SECONDS 秒）"
+
+footer:
+    builtWith:
+        other: Built with {{ .Generator }}
+
+    designedBy:
+        other: テーマ {{ .Theme }} は {{ .DesignedBy }} によって設計されています。
diff --git a/i18n/zh-CN.yaml b/i18n/zh-CN.yaml
index 0f08310..3579945 100644
--- a/i18n/zh-CN.yaml
+++ b/i18n/zh-CN.yaml
@@ -38,6 +38,10 @@ widget:
         title:
             other: 标签云
 
+    categoriesCloud:
+        title:
+            other: 分类
+
 search:
     title:
         other: 搜索
@@ -47,3 +51,10 @@ search:
 
     resultTitle:
         other: "#PAGES_COUNT 个结果 （用时 #TIME_SECONDS 秒）"
+
+footer:
+    builtWith:
+        other: Built with {{ .Generator }}
+
+    designedBy:
+        other: 主题 {{ .Theme }} 由 {{ .DesignedBy }} 设计