chore: update compiled CSS file

feat(article): add support for custom taxonomy link

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

README.md

@@ -1,44 +1,56 @@
-![Stack](https://i.imgur.com/qj9onpz.jpg)
+![Stack](https://i.imgur.com/cCiHOGS.jpg)
 # Hugo Theme Stack
 
-Just another simple theme for Hugo
-
-[![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)
+> Card-style Hugo theme designed for bloggers.
 
 ## Demo
 
 [Example Site](https://theme-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)
+
 ## Documentation & more information
 
-[Documentation](https://www.notion.so/jimmycai/Hugo-Theme-Stack-511aec5b9ed845ce9b6e3ae0bf7fb6d4) | [中文文档](https://www.notion.so/jimmycai/Hugo-Stack-511aec5b9ed845ce9b6e3ae0bf7fb6d4)
+[Documentation](https://www.notion.so/jimmycai/Hugo-Theme-Stack-511aec5b9ed845ce9b6e3ae0bf7fb6d4) | [中文文档](https://www.notion.so/jimmycai/Hugo-Theme-Stack-511aec5b9ed845ce9b6e3ae0bf7fb6d4)
 
-## Features
+## Introduction
 
--  Full Vanilla JS, without jQuery
--  No CSS framework
--  PhotoSwipe integration
--  Responsive images
--  Lazy load images by default
--  Archive page
--  Dark mode
+Stack is a simple card-style Hugo theme designed for bloggers, some of its features are:
+
+- Responsive images support
+- Lazy load images
+- Dark mode
+- [PhotoSwipe](https://photoswipe.com/) integration
+- Archive page template
+- Full native JavaScript, no jQuery or any other frameworks are used
+- No CSS framework, keep it simple and minimal
+- External dependencies (like PhotoSwipe's library) are being loaded selectively, or asynchronously
+- Properly cropped thumbnails
+
+The only JavaScript library being used is [node-vibrant](https://github.com/Vibrant-Colors/node-vibrant) for generating colour schemes for articles.
+
+![Page Insight](https://i.imgur.com/0hUWmMh.png)
 
 ## Requirements
 
-- **Hugo extended >= 0.74**
+This theme uses SCSS and TypeScript. For that reason, it's necessary to use **Hugo ≥ 0.74.0**.
 
-It's built and tested on version 0.74, might not work correctly on older versions of Hugo.
+**Note**: You'll need Hugo Extended version to edit SCSS files
 
 ## Installation
 
 Clone / Download this repository to `theme` folder, and edit your site config following `exampleSite/config.toml`.
 
+Check [documentation](https://www.notion.so/jimmycai/Hugo-Theme-Stack-511aec5b9ed845ce9b6e3ae0bf7fb6d4) for more details.
+
 ## Copyright
 
 **Licensed under the GNU General Public License v3.0**
 
 Please do not remove the "*Theme Stack designed by Jimmy*" text and link.
 
+If you want to port this theme to another blogging platform, please let me know🙏.
+
 ## Thanks to
 
   - [Vibrant-Colors/node-vibrant](https://github.com/Vibrant-Colors/node-vibrant)

assets/css/highlight/dark.css

@@ -0,0 +1,390 @@
+/*
+*   Style: monokai
+*   https://xyproto.github.io/splash/docs/monokai.html
+*/
+
+:root {
+    --pre-text-color: #f8f8f2;
+    --pre-background-color: #272822;
+}
+
+/* Background */
+.chroma {
+    color: #f8f8f2;
+    background-color: #272822
+}
+
+/* Other */
+.chroma .x {}
+
+/* Error */
+.chroma .err {
+    color: #960050;
+    background-color: #1e0010
+}
+
+/* LineTableTD */
+.chroma .lntd {
+    vertical-align: top;
+    padding: 0;
+    margin: 0;
+    border: 0;
+}
+
+/* LineTable */
+.chroma .lntable {
+    border-spacing: 0;
+    padding: 0;
+    margin: 0;
+    border: 0;
+    width: auto;
+    overflow: auto;
+    display: block;
+}
+
+/* LineHighlight */
+.chroma .hl {
+    display: block;
+    width: 100%;
+    background-color: #ffffcc
+}
+
+/* LineNumbersTable */
+.chroma .lnt {
+    margin-right: 0.4em;
+    padding: 0 0.4em 0 0.4em;
+    color: #7f7f7f
+}
+
+/* LineNumbers */
+.chroma .ln {
+    margin-right: 0.4em;
+    padding: 0 0.4em 0 0.4em;
+    color: #7f7f7f
+}
+
+/* Keyword */
+.chroma .k {
+    color: #66d9ef
+}
+
+/* KeywordConstant */
+.chroma .kc {
+    color: #66d9ef
+}
+
+/* KeywordDeclaration */
+.chroma .kd {
+    color: #66d9ef
+}
+
+/* KeywordNamespace */
+.chroma .kn {
+    color: #f92672
+}
+
+/* KeywordPseudo */
+.chroma .kp {
+    color: #66d9ef
+}
+
+/* KeywordReserved */
+.chroma .kr {
+    color: #66d9ef
+}
+
+/* KeywordType */
+.chroma .kt {
+    color: #66d9ef
+}
+
+/* Name */
+.chroma .n {}
+
+/* NameAttribute */
+.chroma .na {
+    color: #a6e22e
+}
+
+/* NameBuiltin */
+.chroma .nb {}
+
+/* NameBuiltinPseudo */
+.chroma .bp {}
+
+/* NameClass */
+.chroma .nc {
+    color: #a6e22e
+}
+
+/* NameConstant */
+.chroma .no {
+    color: #66d9ef
+}
+
+/* NameDecorator */
+.chroma .nd {
+    color: #a6e22e
+}
+
+/* NameEntity */
+.chroma .ni {}
+
+/* NameException */
+.chroma .ne {
+    color: #a6e22e
+}
+
+/* NameFunction */
+.chroma .nf {
+    color: #a6e22e
+}
+
+/* NameFunctionMagic */
+.chroma .fm {}
+
+/* NameLabel */
+.chroma .nl {}
+
+/* NameNamespace */
+.chroma .nn {}
+
+/* NameOther */
+.chroma .nx {
+    color: #a6e22e
+}
+
+/* NameProperty */
+.chroma .py {}
+
+/* NameTag */
+.chroma .nt {
+    color: #f92672
+}
+
+/* NameVariable */
+.chroma .nv {}
+
+/* NameVariableClass */
+.chroma .vc {}
+
+/* NameVariableGlobal */
+.chroma .vg {}
+
+/* NameVariableInstance */
+.chroma .vi {}
+
+/* NameVariableMagic */
+.chroma .vm {}
+
+/* Literal */
+.chroma .l {
+    color: #ae81ff
+}
+
+/* LiteralDate */
+.chroma .ld {
+    color: #e6db74
+}
+
+/* LiteralString */
+.chroma .s {
+    color: #e6db74
+}
+
+/* LiteralStringAffix */
+.chroma .sa {
+    color: #e6db74
+}
+
+/* LiteralStringBacktick */
+.chroma .sb {
+    color: #e6db74
+}
+
+/* LiteralStringChar */
+.chroma .sc {
+    color: #e6db74
+}
+
+/* LiteralStringDelimiter */
+.chroma .dl {
+    color: #e6db74
+}
+
+/* LiteralStringDoc */
+.chroma .sd {
+    color: #e6db74
+}
+
+/* LiteralStringDouble */
+.chroma .s2 {
+    color: #e6db74
+}
+
+/* LiteralStringEscape */
+.chroma .se {
+    color: #ae81ff
+}
+
+/* LiteralStringHeredoc */
+.chroma .sh {
+    color: #e6db74
+}
+
+/* LiteralStringInterpol */
+.chroma .si {
+    color: #e6db74
+}
+
+/* LiteralStringOther */
+.chroma .sx {
+    color: #e6db74
+}
+
+/* LiteralStringRegex */
+.chroma .sr {
+    color: #e6db74
+}
+
+/* LiteralStringSingle */
+.chroma .s1 {
+    color: #e6db74
+}
+
+/* LiteralStringSymbol */
+.chroma .ss {
+    color: #e6db74
+}
+
+/* LiteralNumber */
+.chroma .m {
+    color: #ae81ff
+}
+
+/* LiteralNumberBin */
+.chroma .mb {
+    color: #ae81ff
+}
+
+/* LiteralNumberFloat */
+.chroma .mf {
+    color: #ae81ff
+}
+
+/* LiteralNumberHex */
+.chroma .mh {
+    color: #ae81ff
+}
+
+/* LiteralNumberInteger */
+.chroma .mi {
+    color: #ae81ff
+}
+
+/* LiteralNumberIntegerLong */
+.chroma .il {
+    color: #ae81ff
+}
+
+/* LiteralNumberOct */
+.chroma .mo {
+    color: #ae81ff
+}
+
+/* Operator */
+.chroma .o {
+    color: #f92672
+}
+
+/* OperatorWord */
+.chroma .ow {
+    color: #f92672
+}
+
+/* Punctuation */
+.chroma .p {}
+
+/* Comment */
+.chroma .c {
+    color: #75715e
+}
+
+/* CommentHashbang */
+.chroma .ch {
+    color: #75715e
+}
+
+/* CommentMultiline */
+.chroma .cm {
+    color: #75715e
+}
+
+/* CommentSingle */
+.chroma .c1 {
+    color: #75715e
+}
+
+/* CommentSpecial */
+.chroma .cs {
+    color: #75715e
+}
+
+/* CommentPreproc */
+.chroma .cp {
+    color: #75715e
+}
+
+/* CommentPreprocFile */
+.chroma .cpf {
+    color: #75715e
+}
+
+/* Generic */
+.chroma .g {}
+
+/* GenericDeleted */
+.chroma .gd {
+    color: #f92672
+}
+
+/* GenericEmph */
+.chroma .ge {
+    font-style: italic
+}
+
+/* GenericError */
+.chroma .gr {}
+
+/* GenericHeading */
+.chroma .gh {}
+
+/* GenericInserted */
+.chroma .gi {
+    color: #a6e22e
+}
+
+/* GenericOutput */
+.chroma .go {}
+
+/* GenericPrompt */
+.chroma .gp {}
+
+/* GenericStrong */
+.chroma .gs {
+    font-weight: bold
+}
+
+/* GenericSubheading */
+.chroma .gu {
+    color: #75715e
+}
+
+/* GenericTraceback */
+.chroma .gt {}
+
+/* GenericUnderline */
+.chroma .gl {}
+
+/* TextWhitespace */
+.chroma .w {}

assets/css/highlight/light.css

@@ -0,0 +1,411 @@
+/*
+*   Style: monokailight
+*   https://xyproto.github.io/splash/docs/monokailight.html
+*/
+:root {
+    --pre-text-color: #272822;
+    --pre-background-color: #fafafa;
+}
+
+/* Background */
+.chroma {
+    color: #272822;
+    background-color: #fafafa;
+}
+
+/* Other */
+.chroma .x {}
+
+/* Error */
+.chroma .err {
+    color: #960050;
+    background-color: #1e0010
+}
+
+/* LineTableTD */
+.chroma .lntd {
+    vertical-align: top;
+    padding: 0;
+    margin: 0;
+    border: 0;
+}
+
+/* LineTable */
+.chroma .lntable {
+    border-spacing: 0;
+    padding: 0;
+    margin: 0;
+    border: 0;
+    width: auto;
+    overflow: auto;
+    display: block;
+}
+
+/* LineHighlight */
+.chroma .hl {
+    display: block;
+    width: 100%;
+    background-color: #ffffcc
+}
+
+/* LineNumbersTable */
+.chroma .lnt {
+    margin-right: 0.4em;
+    padding: 0 0.4em 0 0.4em;
+    color: #7f7f7f
+}
+
+/* LineNumbers */
+.chroma .ln {
+    margin-right: 0.4em;
+    padding: 0 0.4em 0 0.4em;
+    color: #7f7f7f
+}
+
+/* Keyword */
+.chroma .k {
+    color: #00a8c8
+}
+
+/* KeywordConstant */
+.chroma .kc {
+    color: #00a8c8
+}
+
+/* KeywordDeclaration */
+.chroma .kd {
+    color: #00a8c8
+}
+
+/* KeywordNamespace */
+.chroma .kn {
+    color: #f92672
+}
+
+/* KeywordPseudo */
+.chroma .kp {
+    color: #00a8c8
+}
+
+/* KeywordReserved */
+.chroma .kr {
+    color: #00a8c8
+}
+
+/* KeywordType */
+.chroma .kt {
+    color: #00a8c8
+}
+
+/* Name */
+.chroma .n {
+    color: #111111
+}
+
+/* NameAttribute */
+.chroma .na {
+    color: #75af00
+}
+
+/* NameBuiltin */
+.chroma .nb {
+    color: #111111
+}
+
+/* NameBuiltinPseudo */
+.chroma .bp {
+    color: #111111
+}
+
+/* NameClass */
+.chroma .nc {
+    color: #75af00
+}
+
+/* NameConstant */
+.chroma .no {
+    color: #00a8c8
+}
+
+/* NameDecorator */
+.chroma .nd {
+    color: #75af00
+}
+
+/* NameEntity */
+.chroma .ni {
+    color: #111111
+}
+
+/* NameException */
+.chroma .ne {
+    color: #75af00
+}
+
+/* NameFunction */
+.chroma .nf {
+    color: #75af00
+}
+
+/* NameFunctionMagic */
+.chroma .fm {
+    color: #111111
+}
+
+/* NameLabel */
+.chroma .nl {
+    color: #111111
+}
+
+/* NameNamespace */
+.chroma .nn {
+    color: #111111
+}
+
+/* NameOther */
+.chroma .nx {
+    color: #75af00
+}
+
+/* NameProperty */
+.chroma .py {
+    color: #111111
+}
+
+/* NameTag */
+.chroma .nt {
+    color: #f92672
+}
+
+/* NameVariable */
+.chroma .nv {
+    color: #111111
+}
+
+/* NameVariableClass */
+.chroma .vc {
+    color: #111111
+}
+
+/* NameVariableGlobal */
+.chroma .vg {
+    color: #111111
+}
+
+/* NameVariableInstance */
+.chroma .vi {
+    color: #111111
+}
+
+/* NameVariableMagic */
+.chroma .vm {
+    color: #111111
+}
+
+/* Literal */
+.chroma .l {
+    color: #ae81ff
+}
+
+/* LiteralDate */
+.chroma .ld {
+    color: #d88200
+}
+
+/* LiteralString */
+.chroma .s {
+    color: #d88200
+}
+
+/* LiteralStringAffix */
+.chroma .sa {
+    color: #d88200
+}
+
+/* LiteralStringBacktick */
+.chroma .sb {
+    color: #d88200
+}
+
+/* LiteralStringChar */
+.chroma .sc {
+    color: #d88200
+}
+
+/* LiteralStringDelimiter */
+.chroma .dl {
+    color: #d88200
+}
+
+/* LiteralStringDoc */
+.chroma .sd {
+    color: #d88200
+}
+
+/* LiteralStringDouble */
+.chroma .s2 {
+    color: #d88200
+}
+
+/* LiteralStringEscape */
+.chroma .se {
+    color: #8045ff
+}
+
+/* LiteralStringHeredoc */
+.chroma .sh {
+    color: #d88200
+}
+
+/* LiteralStringInterpol */
+.chroma .si {
+    color: #d88200
+}
+
+/* LiteralStringOther */
+.chroma .sx {
+    color: #d88200
+}
+
+/* LiteralStringRegex */
+.chroma .sr {
+    color: #d88200
+}
+
+/* LiteralStringSingle */
+.chroma .s1 {
+    color: #d88200
+}
+
+/* LiteralStringSymbol */
+.chroma .ss {
+    color: #d88200
+}
+
+/* LiteralNumber */
+.chroma .m {
+    color: #ae81ff
+}
+
+/* LiteralNumberBin */
+.chroma .mb {
+    color: #ae81ff
+}
+
+/* LiteralNumberFloat */
+.chroma .mf {
+    color: #ae81ff
+}
+
+/* LiteralNumberHex */
+.chroma .mh {
+    color: #ae81ff
+}
+
+/* LiteralNumberInteger */
+.chroma .mi {
+    color: #ae81ff
+}
+
+/* LiteralNumberIntegerLong */
+.chroma .il {
+    color: #ae81ff
+}
+
+/* LiteralNumberOct */
+.chroma .mo {
+    color: #ae81ff
+}
+
+/* Operator */
+.chroma .o {
+    color: #f92672
+}
+
+/* OperatorWord */
+.chroma .ow {
+    color: #f92672
+}
+
+/* Punctuation */
+.chroma .p {
+    color: #111111
+}
+
+/* Comment */
+.chroma .c {
+    color: #75715e
+}
+
+/* CommentHashbang */
+.chroma .ch {
+    color: #75715e
+}
+
+/* CommentMultiline */
+.chroma .cm {
+    color: #75715e
+}
+
+/* CommentSingle */
+.chroma .c1 {
+    color: #75715e
+}
+
+/* CommentSpecial */
+.chroma .cs {
+    color: #75715e
+}
+
+/* CommentPreproc */
+.chroma .cp {
+    color: #75715e
+}
+
+/* CommentPreprocFile */
+.chroma .cpf {
+    color: #75715e
+}
+
+/* Generic */
+.chroma .g {}
+
+/* GenericDeleted */
+.chroma .gd {}
+
+/* GenericEmph */
+.chroma .ge {
+    font-style: italic
+}
+
+/* GenericError */
+.chroma .gr {}
+
+/* GenericHeading */
+.chroma .gh {}
+
+/* GenericInserted */
+.chroma .gi {}
+
+/* GenericOutput */
+.chroma .go {}
+
+/* GenericPrompt */
+.chroma .gp {}
+
+/* GenericStrong */
+.chroma .gs {
+    font-weight: bold
+}
+
+/* GenericSubheading */
+.chroma .gu {}
+
+/* GenericTraceback */
+.chroma .gt {}
+
+/* GenericUnderline */
+.chroma .gl {}
+
+/* TextWhitespace */
+.chroma .w {}

assets/scss/partials/layout/archives.scss

@@ -1,6 +1,6 @@
-.archive-group {
+.archives-group {
     margin-bottom: var(--section-separation);
-    .archive-date {
+    .archives-date {
         text-transform: uppercase;
         margin-bottom: 10px;
         font-size: 1.6rem;
@@ -12,7 +12,7 @@
     }
 }
 
-.template-archive {
+.template-archives {
     .category-list {
         margin-bottom: var(--section-separation);
         overflow-x: auto;

assets/scss/partials/menu.scss

@@ -122,6 +122,7 @@
 
 /* Menu style */
 .menu {
+    padding-left: 0;
     list-style: none;
     display: flex;
     flex-direction: column;

assets/scss/partials/widgets.scss

@@ -43,9 +43,9 @@
     }
 }
 
-/* Archive widget */
-.widget.archive {
-    .archive-year {
+/* Archives widget */
+.widget.archives {
+    .archives-year {
         margin-bottom: 10px;
         a {
             background-color: var(--card-background);

assets/scss/style.scss

@@ -18,7 +18,7 @@
 @import "partials/pagination.scss";
 @import "partials/sidebar.scss";
 @import "partials/base.scss";
-@import "partials/layout/archive.scss";
+@import "partials/layout/archives.scss";
 @import "partials/layout/article.scss";
 @import "partials/layout/taxonomy.scss";
 @import "partials/layout/404.scss";

exampleSite/config.toml

@@ -1,4 +1,4 @@
-baseurl = "https://theme-stack.jimmycai.com/"
+baseurl = "https://example.com"
 languageCode = "en-us"
 theme = "hugo-theme-stack"
 paginate = 5
@@ -29,11 +29,11 @@ DefaultContentLanguage = "en"                   # Theme i18n support
         # Only Disqus is available so far
         provider = "disqus"
     [params.widgets]
-        enabled = ['archive', 'tag-cloud']
-        [params.widgets.archive]
+        enabled = ['archives', 'tag-cloud']
+        [params.widgets.archives]
             limit = 5
-            ### Archive page relative URL
-            path = "archive"       
+            ### Archives page relative URL
+            path = "archives"       
         [params.widgets.tagCloud]
             limit = 10
     [params.opengraph]
@@ -64,15 +64,15 @@ DefaultContentLanguage = "en"                   # Theme i18n support
     [[menu.main]]
         identifier = "about-cn"
         name = "About"
-        url = "/about/"
+        url = "about"
         weight = -90
         pre = "user"
     [[menu.main]]
-        identifier = "archive"
-        name = "Archive"
-        url = "/archive/"
+        identifier = "archives"
+        name = "Archives"
+        url = "archives"
         weight = -70
-        pre = "archive"
+        pre = "archives"
 
 [related]
     includeNewer = true
@@ -86,3 +86,7 @@ DefaultContentLanguage = "en"                   # Theme i18n support
     [[related.indices]]
         name = "categories"
         weight = 200
+
+[markup]
+    [markup.highlight]
+        noClasses = false

exampleSite/content/page/archive.md

@@ -1,6 +0,0 @@
----
-title: "Archive"
-date: 2019-05-28
-layout: "archive"
-slug: "archive"
----

exampleSite/content/page/archives.md

@@ -0,0 +1,6 @@
+---
+title: "Archives"
+date: 2019-05-28
+layout: "archives"
+slug: "archives"
+---

exampleSite/plugins/netlify-plugin-hugo-cache-resources/README.md

@@ -0,0 +1,27 @@
+> Original Repo: https://github.com/cdeleeuwe/netlify-plugin-hugo-cache-resources
+> 
+# Netlify Build Plugin: Persist Hugo resources Between Builds
+
+Persist [Hugo](https://gohugo.io/) resources folder between Netlify builds for huge build speed improvements! ⚡️
+
+This plugin caches the `resources` folder after build. If you are processing many images, this would improve build duration significantly.
+
+Note: Restoring cache only comes from the production branch. So once cache is saved on the production branch, the next preview build would use the cache. For example, when pushing to the same preview build, the latest preview build will not get the cache from the previous preview build, but will get it from master.
+
+## Usage
+
+To install, add the following lines to your `netlify.toml` file:
+
+```toml
+[build]
+  publish = "public"
+
+[[plugins]]
+  package = "netlify-plugin-hugo-cache-resources"
+
+	[plugins.inputs]
+	# If it should show more verbose logs (optional, default = true)
+	debug = true
+```
+
+Note: The `[[plugins]]` line is required for each plugin, even if you have other plugins in your `netlify.toml` file already.

exampleSite/plugins/netlify-plugin-hugo-cache-resources/index.js

@@ -0,0 +1,39 @@
+const getResourcesDir = () => {
+  return 'exampleSite/resources';
+}
+
+const printList = (items) => {
+  console.log('---');
+  items.forEach((item, index) => {
+    console.log(`${index + 1}. ${item}`);
+  });
+}
+
+module.exports = {
+
+  async onPreBuild({ utils, inputs }) {
+    const path = getResourcesDir();
+    const success = await utils.cache.restore(path);
+
+    if (success) {
+      const cachedFiles = await utils.cache.list(path);
+      console.log(`Restored cached resources folder. Total files: ${cachedFiles.length}`);
+      if (inputs.debug) printList(cachedFiles);
+    } else {
+      console.log(`No cache found for resources folder`);
+    }
+  },
+
+  async onPostBuild({ utils, inputs }) {
+    const path = getResourcesDir();
+    const success = await utils.cache.save(path);
+
+    if (success) {
+      const cachedFiles = await utils.cache.list(path);
+      console.log(`Saved resources folder to cache. Total files: ${cachedFiles.length}`);
+      if (inputs.debug) printList(cachedFiles);
+    } else {
+      console.log(`No resources folder cached`);
+    }
+  }
+};

exampleSite/plugins/netlify-plugin-hugo-cache-resources/manifest.yml

@@ -0,0 +1,5 @@
+name: netlify-plugin-hugo-cache
+inputs:
+  - name: debug
+    description: Show more verbose logs
+    default: true

i18n/en.toml

@@ -7,10 +7,10 @@
 [lastUpdatedOn]
     other ="Last updated on {{ .Count }}"
 
-[widgetArchiveTitle]
-    other = "Archive"
+[widgetArchivesTitle]
+    other = "Archives"
 
-[widgetArchiveMore]
+[widgetArchivesMore]
     other = "More"
 
 [widgetTagCloudTitle]

i18n/zh-CN.toml

@@ -7,10 +7,10 @@
 [lastUpdatedOn]
     other ="最后更新于 {{ .Count }}"
 
-[widgetArchiveTitle]
+[widgetArchivesTitle]
     other = "归档"
 
-[widgetArchiveMore]
+[widgetArchivesMore]
     other = "更多"
 
 [widgetTagCloudTitle]

layouts/_default/archives.html

@@ -1,4 +1,4 @@
-{{ define "body-class" }}template-archive{{ end }}
+{{ define "body-class" }}template-archives{{ end }}
 {{ define "main" }}
     {{ $categories := ($.Site.GetPage "taxonomyTerm" "categories").Pages }}
     {{ if $categories }}
@@ -7,7 +7,7 @@
         <div class="category-list">
             <div class="article-list--tile">
                 {{ range $categories }}
-                    {{ partial "article-list/tile" (dict "context" . "size" "250x150") }}
+                    {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "taxonomy") }}
                 {{ end }}
             </div>
         </div>
@@ -20,8 +20,8 @@
 
     {{ range $filtered.GroupByDate "2006" }}
     {{ $id := lower (replace .Key " " "-") }}
-    <div class="archive-group" id="{{ $id }}">
-        <h3 class="archive-date"><a href="{{ $.Permalink }}#{{ $id }}">{{ .Key }}</a></h3>
+    <div class="archives-group" id="{{ $id }}">
+        <h3 class="archives-date"><a href="{{ $.Permalink }}#{{ $id }}">{{ .Key }}</a></h3>
         <div class="article-list--compact">
             {{ range .Pages }}
                 {{ partial "article-list/compact" . }}

layouts/_default/baseof.html

@@ -9,8 +9,6 @@
             </main>
             {{- block "right-sidebar" . -}}{{ end }}
         </div>
-        {{ partial "footer/script.html" . }}
-        {{ partial "footer/style.html" . }}
-        {{ partial "footer/custom.html" . }}
+        {{ partial "footer/include.html" . }}
     </body>
 </html>

layouts/_default/single.html

@@ -1,21 +1,12 @@
-{{ define "container-class" }}article-page with-toolbar{{ end }}
+{{ define "body-class" }}article-page keep-sidebar{{ end }}
 {{ define "main" }}
-    <div id="article-toolbar">
-        <a href="{{ .Site.BaseURL }}" class="back-home">
-            {{ (resources.Get "icons/back.svg").Content | safeHTML }}
-            <span>Back</span>
-        </a>
-    </div>
-
     {{ partial "article/article.html" . }}
 
-    {{ partial "article/components/related-contents" . }}
-
     {{ if or (not (isset .Params "comments")) (eq .Params.comments "true")}} 
         {{ partial "comments/include" . }}
     {{ end }}
 
     {{ partialCached "footer/footer" . }}
 
-    {{- partial "article/components/photoswipe.html" . -}}
+    {{ partialCached "article/components/photoswipe" . }}
 {{ end }}

layouts/_default/term.html

@@ -9,7 +9,7 @@
             {{ end }}
         </div>
 
-        {{ $image := partial "helper/image" (dict "Context" . "Type" "taxonomy") }}
+        {{- $image := partialCached "helper/image" (dict "Context" . "Type" "taxonomy") .RelPermalink "taxonomy" -}}
         {{ if $image.exists }}
             <div class="taxonomy-image">
                 {{ if $image.resource }}   

layouts/page/single.html

@@ -1,12 +0,0 @@
-{{ define "body-class" }}article-page keep-sidebar{{ end }}
-{{ define "main" }}
-    {{ partial "article/article.html" . }}
-
-    {{ if or (not (isset .Params "comments")) (eq .Params.comments "true")}} 
-        {{ partial "comments/include" . }}
-    {{ end }}
-
-    {{ partialCached "footer/footer" . }}
-
-    {{ partial "article/components/photoswipe" . }}
-{{ end }}

layouts/partials/article-list/compact.html

@@ -12,8 +12,7 @@
         </footer>
     </div>
 
-    {{ $image := partial "helper/image" (dict "Context" . "Type" "articleList") }}
-    
+    {{- $image := partialCached "helper/image" (dict "Context" . "Type" "articleList") .RelPermalink "articleList" -}}
     {{ if $image.exists }}
         <div class="article-image">
             {{ if $image.resource }}

layouts/partials/article-list/default.html

@@ -1,4 +1,4 @@
-{{ $image := partial "helper/image" (dict "Context" . "Type" "articleList") }}
+{{ $image := partialCached "helper/image" (dict "Context" . "Type" "articleList") .RelPermalink "articleList" }}
 <article class="{{ if $image.exists }}has-image{{ end }}">
     {{ if $image.exists }}
         <div class="article-image">
@@ -8,7 +8,7 @@
                     {{- $thumbnailRetina := $image.resource.Fill "1600x500" -}}
 
                     <img src="{{ $thumbnail.RelPermalink }}" 
-                        srcset="{{ $thumbnail.RelPermalink }} 1x, {{ $thumbnailRetina.RelPermalink }} 2x"
+                        srcset="{{ $thumbnail.RelPermalink }} 800w, {{ $thumbnailRetina.RelPermalink }} 1600w"
                         width="{{ $thumbnail.Width }}" height="{{ $thumbnail.Height }}" loading="lazy"
                         alt="Featured image of post {{ .Title }}" />
                 {{ else }}
@@ -18,5 +18,5 @@
         </div>
     {{ end }}
 
-    {{ partial "article/components/details" . }}
+    {{ partialCached "article/components/details" . .RelPermalink }}
 </article>

layouts/partials/article-list/tile.html

@@ -1,4 +1,4 @@
-{{ $image := partial "helper/image" (dict "Context" .context "Type" .Type) }}
+{{ $image := partialCached "helper/image" (dict "Context" .context "Type" .Type) .context.RelPermalink .Type }}
 <article class="{{ if $image.exists }}has-image{{ end }}">
     <a href="{{ .context.Permalink }}">
         

layouts/partials/article/components/details.html

@@ -1,16 +1,18 @@
-{{ $image := partial "helper/image" (dict "Context" .) }}
-{{ $context := . }}
+{{ $image := partialCached "helper/image" (dict "Context" . "Type" "article") .RelPermalink "article" }}
+{{- $context := . -}}
+{{- $categories := .Params.categories -}}
 <div class="article-details">
-    {{ with $categories := .Params.categories }}
+    {{ if $categories }}
     <header class="article-category">
-        {{ range $categories }}
+        {{ range $category := $categories }}
+            {{ $term := $.Site.GetPage (printf "/categories/%s" $category) }}
             {{ if and $image.exists $image.resource }}
                 {{- $imageRaw := $image.resource | resources.Fingerprint "md5"  -}}
                 {{- $20x := $imageRaw.Fill "20x20 smart"  -}}
-                <a href="/categories/{{ . | urlize }}" class="color-tag"
-                    data-image="{{ $20x.RelPermalink }}" data-key="{{ $context.Slug }}" data-hash="{{ $imageRaw.Data.Integrity }}">{{ . | humanize }}</a>
+                <a href="{{ $term.Permalink }}" class="color-tag"
+                    data-image="{{ $20x.RelPermalink }}" data-key="{{ $context.Slug }}" data-hash="{{ $imageRaw.Data.Integrity }}">{{ $term.Title | humanize }}</a>
             {{ else }}
-                <a href="/categories/{{ . | urlize }}">{{ . | humanize }}</a>
+                <a href="{{ $term.Permalink }}">{{ $term.Title | humanize }}</a>
             {{ end }}
         {{ end }}
     </header>

layouts/partials/article/components/footer.html

@@ -1,11 +1,5 @@
 <footer class="article-footer">
-    {{ with $tags := .Params.Tags }}
-    <section class="article-tags">
-        {{ range $tags }}
-        <a href="/tags/{{ . | urlize }}">{{ . | humanize }}</a>
-        {{ end }}
-    </section>
-    {{ end }}
+    {{ partial "article/components/tags" . }}
 
     {{ if and (.Site.Params.article.license.enabled) (not (eq .Params.license false)) }}
     <section class="article-copyright">

layouts/partials/article/components/header.html

@@ -1,6 +1,5 @@
 <header class="article-header">
-    {{ $image := partial "helper/image" (dict "Context" . "Type" "article") }}
-
+    {{- $image := partialCached "helper/image" (dict "Context" . "Type" "article") .RelPermalink "article" -}}
     {{ if $image.exists }}
         <div class="article-image">
             {{ if $image.resource }}
@@ -16,5 +15,5 @@
         </div>
     {{ end }}
 
-    {{ partial "article/components/details" . }}
+    {{ partialCached "article/components/details" . .RelPermalink }}
 </header>

layouts/partials/article/components/related-contents.html

@@ -5,7 +5,7 @@
         <div class="related-contents">
             <div class="flex article-list--tile">
                 {{ range . }}
-                    {{ partial "article-list/tile" (dict "context" . "size" "250x150") }}
+                    {{ partial "article-list/tile" (dict "context" . "size" "250x150" "Type" "articleList") }}
                 {{ end }}
             </div>
         </div>

layouts/partials/article/components/tags.html

@@ -0,0 +1,10 @@
+{{- $tags := .Params.Tags -}}
+{{ if $tags }}
+    <section class="article-tags">
+        {{ range $tag := $tags }}
+            {{ with $.Site.GetPage (printf "/tags/%s" $tag) }}
+                <a href="{{ .Permalink }}">{{ .Title | humanize }}</a>
+            {{ end }}
+        {{ end }}
+    </section>
+{{ end }}

layouts/partials/footer/components/highlight.html

@@ -0,0 +1,4 @@
+{{- $light := resources.Get "css/highlight/light.css" | minify -}}
+{{- $dark := resources.Get "css/highlight/dark.css" | minify -}}
+<link rel="stylesheet" href="{{ $light.RelPermalink }}" media="(prefers-color-scheme: light)">
+<link rel="stylesheet" href="{{ $dark.RelPermalink }}" media="(prefers-color-scheme: dark)">

layouts/partials/footer/components/script.html

@@ -1,7 +1,7 @@
 <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/vibrant.min.js"
     integrity="sha256-5NovOZc4iwiAWTYIFiIM7DxKUXKWvpVEuMEPLzcm5/g=" crossorigin="anonymous"></script>
 
-{{ $opts := dict "minify" hugo.IsProduction }}
-{{ $script := resources.Get "ts/main.ts" | js.Build $opts }}
+{{- $opts := dict "minify" hugo.IsProduction -}}
+{{- $script := resources.Get "ts/main.ts" | js.Build $opts -}}
 
 <script type="text/javascript" src="{{ $script.RelPermalink }}" defer></script>

layouts/partials/footer/footer.html

@@ -1,8 +1,8 @@
 <footer class="site-footer">
     <section class="copyright">&copy; {{ now.Format "2006" }} {{ .Site.Title }}</section>
     <section class="powerby">
-        Built with <a href="https://gohugo.io/" target="_blank">Hugo</a> <br />
-        Theme <b><a href="https://github.com/CaiJimmy/hugo-theme-stack" target="_blank">Stack</a></b> designed by
-        <a href="https://jimmycai.com" target="_blank">Jimmy</a>
+        Built with <a href="https://gohugo.io/" target="_blank" rel="noopener">Hugo</a> <br />
+        Theme <b><a href="https://github.com/CaiJimmy/hugo-theme-stack" target="_blank" rel="noopener">Stack</a></b> designed by
+        <a href="https://jimmycai.com" target="_blank" rel="noopener">Jimmy</a>
     </section>
 </footer>

layouts/partials/footer/include.html

@@ -0,0 +1,4 @@
+{{ partialCached "footer/components/script.html" . }}
+{{ partialCached "footer/components/custom-font.html" . }}
+{{ partialCached "footer/components/highlight.html" . }}
+{{ partial "footer/custom.html" . }}

layouts/partials/head/head.html

@@ -2,10 +2,10 @@
     <meta charset='utf-8'>
     <meta name='viewport' content='width=device-width, initial-scale=1'>
     
-    {{- $description := partial "data/description" . -}}
+    {{- $description := partialCached "data/description" . .RelPermalink -}}
     <meta name='description' content='{{ $description }}'>
 
-    {{- $title := partial "data/title" . -}}
+    {{- $title := partialCached "data/title" . .RelPermalink -}}
     <title>{{ $title }}</title>
     
     <link rel='canonical' href='{{ .Permalink }}'>

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

@@ -1,5 +1,5 @@
-{{- $title := partial "data/title" . -}}
-{{- $description := partial "data/description" . -}}
+{{- $title := partialCached "data/title" . .RelPermalink -}}
+{{- $description := partialCached "data/description" . .RelPermalink -}}
 
 <meta property='og:title' content='{{ $title }}'>
 <meta property='og:description' content='{{ $description }}'>
@@ -37,7 +37,7 @@
 	{{- end -}}
 {{- end -}}
 
-{{ $image := partial "helper/image" (dict "Context" . "Type" "opengraph") }}
+{{ $image := partialCached "helper/image" (dict "Context" . "Type" "opengraph") .RelPermalink "opengraph" }}
 {{- if $image.exists -}}
     <meta property='og:image' content='{{ absURL $image.permalink }}' />
 {{- end -}}

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

@@ -2,13 +2,13 @@
     <meta name="twitter:site" content="{{ . }}">
 {{- end -}}
 
-{{- $title := partial "data/title" . -}}
-{{- $description := partial "data/description" . -}}
+{{- $title := partialCached "data/title" . .RelPermalink -}}
+{{- $description := partialCached "data/description" . .RelPermalink -}}
 
 <meta name="twitter:title" content="{{ $title }}">
 <meta name="twitter:description" content="{{ $description }}">
 
-{{- $image := partial "helper/image" (dict "Context" . "Type" "opengraph") -}}
+{{- $image := partialCached "helper/image" (dict "Context" . "Type" "opengraph") .RelPermalink "opengraph" -}}
 {{- if $image.exists -}}
 	<meta name="twitter:card" content="{{ .Site.Params.opengraph.twitter.card }}">
 	<meta name="twitter:image" content='{{ absURL $image.permalink }}' />

layouts/partials/head/style.html

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

layouts/partials/helper/image.html

@@ -12,20 +12,14 @@
         {{ $result = merge $result (dict "permalink" $imageValue) }}
     {{ else }}
         {{ $pageResourceImage := .Context.Resources.GetMatch (printf "%s" ($imageValue | safeURL)) }}
-        {{ $siteResourceImage := resources.GetMatch (printf "%s" ($imageValue | safeURL)) }}
         
         {{ if $pageResourceImage }}
             <!-- If image is found under page bundle -->
             {{ $result = merge $result (dict "permalink" $pageResourceImage.RelPermalink) }}
             {{ $result = merge $result (dict "resource" $pageResourceImage) }}
-        {{ else if $siteResourceImage }}
-            <!-- Try search image under site's assets folder -->
-            {{ $result = merge $result (dict "permalink" $siteResourceImage.RelPermalink) }}
-            {{ $result = merge $result (dict "resource" $siteResourceImage) }}
         {{ else }}
-            <!-- Can not find the image -->
-            {{ errorf "Failed loading image: %q" $imageValue }}
-            {{ $result = merge $result (dict "exists" false) }}
+            <!-- Can not find the image under page bundle. Could be a relative linked image -->
+            {{ $result = merge $result (dict "permalink" $imageValue) }}
         {{ end }}
 
     {{ end }}

layouts/partials/sidebar/left.html

@@ -25,13 +25,13 @@
         <h2 class="site-description">{{ .Site.Params.sidebar.subtitle }}</h2>
     </header>
 
-    <nav class="menu" id="main-menu">
+    <ol class="menu" id="main-menu">
         {{ $currentPage := . }}
         {{ range .Site.Menus.main }}
         {{ $active := or (eq $currentPage.Title .Name) (or ($currentPage.HasMenuCurrent "main" .) ($currentPage.IsMenuCurrent "main" .)) }}
 
         <li {{ if $active }} class='current' {{ end }}>
-            <a href='{{ .URL }}'>
+            <a href='{{ .URL | absLangURL }}'>
                 {{ if .Pre }}
                     {{ (resources.Get (delimit (slice "icons/" .Pre ".svg") "")).Content | safeHTML }}
                 {{ end }}
@@ -39,5 +39,5 @@
             </a>
         </li>
         {{ end }}
-    </nav>
+    </ol>
 </aside>

layouts/partials/widget/archives.html

@@ -1,28 +1,28 @@
-<section class="widget archive">
+<section class="widget archives">
     <div class="widget-icon">
         {{ (resources.Get "icons/infinity.svg").Content | safeHTML }}
     </div>
-    <h1 class="widget-title">{{ T "widgetArchiveTitle" }}</h1>
+    <h1 class="widget-title">{{ T "widgetArchivesTitle" }}</h1>
 
     {{ $pages := where .Site.RegularPages "Type" "in" .Site.Params.mainSections }}
     {{ $notHidden := where .Site.RegularPages "Params.hidden" "!=" true }}
     {{ $filtered := ($pages | intersect $notHidden) }}
-    {{ $archive := $filtered.GroupByDate "2006" }}
+    {{ $archives := $filtered.GroupByDate "2006" }}
 
-    {{ range first .Site.Params.widgets.archive.limit ($archive) }}
+    {{ range first .Site.Params.widgets.archives.limit ($archives) }}
         {{ $id := lower (replace .Key " " "-") }}
-        <div class="archive-year">
-            <a href="{{ $.Site.BaseURL }}{{ $.Site.Params.widgets.archive.path }}#{{ $id }}">
+        <div class="archives-year">
+            <a href="{{ $.Site.Params.widgets.archives.path | relLangURL }}#{{ $id }}">
                 <span class="year">{{ .Key }}</span>
                 <span class="count">{{ len .Pages }}</span>
             </a> 
         </div>
     {{ end }}
 
-    {{ if gt (len $archive) .Site.Params.widgets.archive.limit }}
-        <div class="archive-year">
-            <a href="{{ $.Site.BaseURL }}/archive">
-                <span class="year">{{ T "widgetArchiveMore" }}</span>
+    {{ if gt (len $archives) .Site.Params.widgets.archives.limit }}
+        <div class="archives-year">
+            <a href="{{ $.Site.Params.widgets.archives.path | relLangURL }}">
+                <span class="year">{{ T "widgetArchivesMore" }}</span>
             </a> 
         </div>
     {{ end }}

layouts/partials/widget/tag-cloud.html

@@ -1,5 +1,4 @@
 {{ $tags := .Site.Taxonomies.tags.ByCount }}
-{{ $v2 := where $tags "Term" "not in" (slice "hugo" "tag" "rss") }}
 
 <section class="widget tagCloud">
     <div class="widget-icon">
@@ -8,10 +7,11 @@
     <h1 class="widget-title">{{ T "widgetTagCloudTitle" }}</h1>
 
     <div class="tagCloud-tags">
-        {{ range first .Site.Params.widgets.tagCloud.limit $v2 }}
-        <a href="{{ $.Site.BaseURL }}tags/{{ .Term | urlize }}/" class="font_size_{{ .Count }}">
-            {{ .Term | humanize }}
-        </a>
+        {{ range first .Site.Params.widgets.tagCloud.limit $tags }}
+            {{ $term := $.Site.GetPage (printf "/tags/%s" .Term) }}
+            <a href="{{ $term.Permalink }}" class="font_size_{{ .Count }}">
+                {{ $term.Title | humanize }}
+            </a>
         {{ end }}
     </div>
 </section>

layouts/post/single.html

@@ -0,0 +1,21 @@
+{{ define "container-class" }}article-page with-toolbar{{ end }}
+{{ define "main" }}
+    <div id="article-toolbar">
+        <a href="{{ .Site.BaseURL }}" class="back-home">
+            {{ (resources.Get "icons/back.svg").Content | safeHTML }}
+            <span>Back</span>
+        </a>
+    </div>
+
+    {{ partial "article/article.html" . }}
+
+    {{ partial "article/components/related-contents" . }}
+
+    {{ if or (not (isset .Params "comments")) (eq .Params.comments "true")}}
+        {{ partial "comments/include" . }}
+    {{ end }}
+
+    {{ partialCached "footer/footer" . }}
+
+    {{- partialCached "article/components/photoswipe.html" . -}}
+{{ end }}

netlify.toml

@@ -6,12 +6,15 @@
     HUGO_THEME = "repo"
 
 [context.production]
-    command = "cd exampleSite && hugo --gc --themesDir ../.."
+    command = "cd exampleSite && hugo --gc --themesDir ../.. -b ${URL}"
     [context.production.environment]
         HUGO_ENV = "production"
 
 [context.branch-deploy]
-    command = "cd exampleSite && hugo --gc --themesDir ../.. -b ${DEPLOY_PRIME_URL}/"
+    command = "cd exampleSite && hugo --gc --themesDir ../.. -b ${DEPLOY_PRIME_URL}"
 
 [context.deploy-preview]
-    command = "cd exampleSite && hugo --gc --themesDir ../.. -b ${DEPLOY_PRIME_URL}/"
+    command = "cd exampleSite && hugo --gc --themesDir ../.. -b ${DEPLOY_PRIME_URL}"
+
+[[plugins]]
+    package = "/exampleSite/plugins/netlify-plugin-hugo-cache-resources"

resources/_gen/assets/scss/scss/style.scss_b95b077eb505d5c0aff8055eaced30ad.json

@@ -0,0 +1 @@
+{"Target":"scss/style.min.css","MediaType":"text/css","Data":{}}

theme.toml

@@ -4,10 +4,22 @@
 name = "Stack"
 license = "GPL-3.0-only"
 licenselink = "https://github.com/CaiJimmy/hugo-theme-stack/blob/master/LICENSE"
-description = "Just another simple Hugo theme"
+description = "Card-style Hugo theme designed for bloggers"
 homepage = "https://blog.jimmycai.com/p/hugo-theme-stack"
-tags = []
-features = []
+tags = [
+    "blog", 
+    "responsive", 
+    "clean", 
+    "light", 
+    "dark", 
+    "personal"
+]
+features = [
+    "disqus",
+    "photoswipe",
+    "opengraph",
+    "widgets"
+]
 min_version = "0.74.0"
 
 [author]