Merge branch 'master' into production

- Jekyll 4.3.0 introduced `webrick` for Ruby 3.x
- Jekyll's dependency `nokogiri` does not yet support Ruby 3.2. See: https://github.com/sparklemotion/nokogiri/issues/2740/

.commitlintrc.json

@@ -0,0 +1,8 @@
+{
+  "rules": {
+    "body-max-line-length": [
+      0,
+      "always"
+    ]
+  }
+}

.editorconfig

@@ -2,10 +2,13 @@ root = true
 
 [*]
 charset = utf-8
-# 2 space indentation
 indent_style = space
 indent_size = 2
 trim_trailing_whitespace = true
 # Unix-style newlines with a newline ending every file
 end_of_line = lf
 insert_final_newline = true
+
+
+[*.js]
+indent_size = 4

.github/CODE_OF_CONDUCT.md

@@ -70,4 +70,4 @@ available at <https://www.contributor-covenant.org/version/1/4/code-of-conduct.h
 For answers to common questions about this code of conduct, see
 <https://www.contributor-covenant.org/faq>
 
-[homepage]: https://www.contributor-covenant.org
+[homepage]: https://www.contributor-covenant.org

.github/CONTRIBUTING.md

@@ -1,16 +1,66 @@
 # How to Contribute
 
-I want to thank you for sparing a time to improve this project! Here are some guidelines for contributing：
+We'd like to thank you for sparing time to improve this project! Here are some guidelines for contributing：
 
-To ensure that the blog design is not confused, this project does not accept suggestions for design changes, such as color scheme, fonts, typography, etc. If your request is about an enhancement, it is recommended to first submit a [`Feature Request`](https://github.com/cotes2020/jekyll-theme-chirpy/issues/new?labels=enhancement&template=feature_request.md) issue to discuss whether your idea fits the project. 
+To ensure that the blog design is not confused, this project does not accept suggestions for design changes, such as color scheme, fonts, typography, etc. If your request is about an enhancement, it is recommended to first submit a [_Feature Request_](https://github.com/cotes2020/jekyll-theme-chirpy/issues/new?labels=enhancement&template=feature_request.md) issue to discuss whether your idea fits the project.
+
+## Basic Process
 
 Generally, contribute to the project by:
 
 1. Fork this project on GitHub and clone it locally.
-2. Create a new branch from `master` and give it a descriptive name (e.g., `my-new-feature`, `fix-a-bug`).
-3. After completing the development, commit and push to remote.
-4. Submit a new pull request.
+2. Create a new branch from the default branch and give it a descriptive name (format: `feature/<add-new-feat>` / `fix/<fix-a-bug>`).
+3. After completing the development, submit a new _Pull Request_. Note that the commit message must follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/), otherwise it will fail the PR check.
+
+## Modifying JavaScript
+
+If your contribution involves JavaScript modification, please read the following sections.
+
+### Inline Scripts
+
+If you need to add comments to the inline JavaScript (the code between the HTML tags `<script>` and `</script>`), please use `/* */` instead of two slashes `//`. Because the HTML will be compressed by [jekyll-compress-html](https://github.com/penibelst/jekyll-compress-html) during deployment, but it cannot handle the `//` properly, which will disrupt the structure of the compressed HTML.
+
+### External Scripts
+
+If you need to add/change/delete the JavaScript in the directory `_javascript/`, setting up [`Node.js`](https://nodejs.org/) and [`npx`](https://www.npmjs.com/package/npx) is a requirement. And then install the development dependencies:
+
+```console
+$ npm i
+```
+
+During JavaScript development, real-time debugging can be performed through the following commands:
+
+Firstly, start a Jekyll server:
+
+```console
+$ bash tools/run
+```
+
+And then open a new terminal tab and run:
+
+```console
+# Type 'Ctrl + C' to stop
+$ npx gulp dev
+```
+
+After debugging, run the command `npx gulp` (without any argument) will automatically output the compressed files to the directory `assets/js/dist/`.
+
+## Verify the commit messages
+
+If you want to make sure your commits pass the CI check, you can refer to the following steps.
+
+Install `commitlint` & `husky`:
+
+```console
+$ npm i -g @commitlint/{cli,config-conventional} husky
+```
+
+And then enable `husky`:
+
+```console
+$ husky install
+```
 
 ---
 
-:tada: Your volunteering will make the open source world more beautiful, thanks again! :tada:
+:tada: Your volunteering will make the open-source world more beautiful, thanks again! :tada:

.github/FUNDING.yml

@@ -1,3 +1,2 @@
-custom:
-  - https://www.buymeacoffee.com/coteschung
-  - https://cotes.gitee.io/alipay-wechat-donation
+ko_fi: coteschung
+custom: https://sponsor.cotes.page

.github/ISSUE_TEMPLATE/bug_report.md

@@ -6,12 +6,15 @@ about: Create a report to help us improve
 <!-- NOTE: Please maintain all sections, otherwise the issue will be automatically closed :) -->
 
 ## Checklist
-<!-- Please complete the following list of tasks, and then check it by change the "[ ]" to "[x]" -->
-- [ ] I have read the [tutorials](https://chirpy.cotes.info/categories/tutorial/) and know the correct effect of the functional design.
-- [ ] There are no similar reports on existing issues (including closed ones).
-- [ ] I found the bug on the latest code of `master` branch.
+
+<!-- Please complete the following list of tasks, and then check it by changing the "[ ]" to "[x]" -->
+
+- [ ] I have read the [tutorials](https://cotes2020.github.io/chirpy-demo/categories/tutorial/) and know the correct effect of the functional design.
+- [ ] There are no similar reports on [existing issues](https://github.com/cotes2020/jekyll-theme-chirpy/issues?q=is%3Aissue) (including closed ones).
+- [ ] I found the bug on the latest code of the `master` branch.
 
 ## Describe the bug
+
 <!-- A clear and concise description of what the bug is. -->
 
 ### To Reproduce
@@ -25,26 +28,32 @@ Steps to reproduce the behavior:
 -->
 
 ### Expected behavior
+
 <!-- A clear and concise description of what you expected to happen. -->
 
 ### Screenshots
+
 <!-- If applicable, add screenshots to help explain your problem. -->
 
-### Software
-<!-- Please complete the following information -->
-- Ruby version: <!-- by running: `ruby -v` -->
-- Gem version: <!-- by running: `gem -v`-->
-- Bundler version: <!-- by running: `bundle -v`-->
-- Jekyll version: <!-- by running: `bundle list | grep " jekyll "` -->
-- Theme version: <!-- by running: `gem list | grep jekyll-theme-chirpy` -->
+### Environment
+
+| Command                           | Version |
+|-----------------------------------|---------|
+| `ruby -v`                         |         |
+| `gem -v`                          |         |
+| `bundle -v`                       |         |
+| `bundle exec jekyll -v`           |         |
+| `bundle info jekyll-theme-chirpy` |         |
 
 ### Desktop
+
 <!-- If necessary, uncomment and fill in the following list:
 - OS: [e.g. macOS 10.15.6]
 - Browser: [e.g. Chrome 85.0.4183.83 (64-bit)]
 -->
 
 ### Smartphone
+
 <!-- If necessary, uncomment and fill in the following list:
 - Device: [e.g. iPhone 6]
 - OS: [e.g. iOS 13.6.1]
@@ -52,4 +61,5 @@ Steps to reproduce the behavior:
 -->
 
 ### Additional context
+
 <!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -7,24 +7,29 @@ labels: enhancement
 <!-- NOTE: Please maintain all sections, otherwise the issue will be automatically closed :) -->
 
 ## Checklist
-<!-- Please complete the following list of tasks, and then check it by change the "[ ]" to "[x]" -->
+
+<!-- Please complete the following list of tasks, and then check it by changing the "[ ]" to "[x]" -->
 - [ ] I have read the [contributing guidelines](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/.github/CONTRIBUTING.md).
-- [ ] There are no similar request on existing issues (including closed ones).
+- [ ] There is no similar request on [existing issues](https://github.com/cotes2020/jekyll-theme-chirpy/issues?q=is%3Aissue) (including closed ones).
 - [ ] I have read the [project progress](https://github.com/cotes2020/jekyll-theme-chirpy/projects) and know the current progress of the project.
 - [ ] I was in the `master` branch of the latest code.
 
 
 ## 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. -->

.github/ISSUE_TEMPLATE/question.md

@@ -1,6 +1,6 @@
 ---
 name: Question
-about: Ask what ever you want
+about: Ask whatever you want
 labels: question
 ---
 
@@ -8,12 +8,13 @@ labels: question
 
 ## Checklist
 
-<!-- Please complete the following list of tasks, and then check it by change the "[ ]" to "[x]" -->
+<!-- Please complete the following list of tasks, and then check it by changing the "[ ]" to "[x]" -->
 
-- [ ] I have read the [tutorials](https://chirpy.cotes.info/categories/tutorial/) and know the correct effect of the functional design.
-- [ ] There are no similar question on existing issues (including closed ones).
-- [ ] I searched the Internet for related problems, but still couldn't solve it.
-- [ ] My question is based on the latest code of `master` branch.
+- [ ] I have read the [newlest tutorials](https://cotes2020.github.io/chirpy-demo/categories/tutorial/) and know the correct effect of the functional design.
+- [ ] There is no similar question on [existing issues](https://github.com/cotes2020/jekyll-theme-chirpy/issues?q=is%3Aissue) (including closed ones).
+- [ ] I have tried to find the answer on [Jekyll Forum](https://talk.jekyllrb.com/) and [StackOverflow](https://stackoverflow.com/questions/tagged/jekyll).
+- [ ] My question is based on the latest code of the `master` branch.
 
 ## Description
+
 <!-- Please describe your question in detail. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,6 @@
 ## Description
 
-<!-- 
+<!--
 Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
 
 e.g. Fixes #(issue)
@@ -8,7 +8,7 @@ e.g. Fixes #(issue)
 
 ## Type of change
 
-<!-- 
+<!--
 Please select the desired item checkbox and change it to "[x]", then delete options that are not relevant.
 -->
 - [ ] Bug fix (non-breaking change which fixes an issue)
@@ -18,27 +18,25 @@ Please select the desired item checkbox and change it to "[x]", then delete opti
 
 ## How has this been tested
 
-<!-- 
+<!--
 Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration
 -->
 
-- [ ] I have run `bash ./tools/deploy.sh --dry-run` (at the root of the project) locally and passed
+- [ ] I have run `bash ./tools/test` (at the root of the project) locally and passed
 - [ ] I have tested this feature in the browser
 
 ### Test Configuration
 
 - Browser type & version:
 - Operating system:
-- Bundler version:
-- Ruby version:
-- Jekyll version:
+- Ruby version: <!-- by running: `ruby -v` -->
+- Bundler version: <!-- by running: `bundle -v`-->
+- Jekyll version: <!-- by running: `bundle list | grep " jekyll "` -->
 
 ### Checklist
+
 <!-- Select checkboxes by change the "[ ]" to "[x]" -->
-- [ ] My code follows the [Google style guidelines](https://google.github.io/styleguide/)
-- [ ] I have performed a self-review of my own code
-- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have performed a self-review of my code
+- [ ] I have commented on my code, particularly in hard-to-understand areas
 - [ ] I have made corresponding changes to the documentation
 - [ ] My changes generate no new warnings
-- [ ] I have added tests that prove my fix is effective or that my feature works
-- [ ] Any dependent changes have been merged and published in downstream modules

.github/workflows/cd.yml

@@ -0,0 +1,14 @@
+name: CD
+on:
+  push:
+    branches: [production, docs]
+
+jobs:
+  launch:
+    runs-on: ubuntu-latest
+    steps:
+      - run: |
+          curl -X POST -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.GH_PAT }}" \
+            https://api.github.com/repos/${{ secrets.BUILDER }}/dispatches \
+            -d '{"event_type":"deploy", "client_payload":{"branch": "${{ github.ref_name }}"}}'

.github/workflows/ci.yml

@@ -1,16 +1,13 @@
-name: 'Continuous Integration'
+name: 'CI'
 on:
   push:
     branches-ignore:
       - 'production'
-    tags-ignore:
-      - '*'
+      - 'docs'
     paths-ignore:
       - '.github/**'
       - '!.github/workflows/ci.yml'
-      - '.travis.yml'
       - '.gitignore'
-      - 'docs/**'
       - 'README.md'
       - 'LICENSE'
   pull_request:
@@ -18,23 +15,24 @@ on:
       - '**'
 
 jobs:
-  ci:
-    runs-on: ${{ matrix.os }}
+  build:
+    runs-on: ubuntu-latest
+
     strategy:
       matrix:
-        os: [ubuntu-latest, macos-latest]
+        ruby: ['2.7', '3.0', '3.1']
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           fetch-depth: 0  # for posts's lastmod
 
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
+          ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
 
       - name: Test Site
-        run: bash tools/deploy.sh --dry-run
+        run: bash tools/test

.github/workflows/commitlint.yml

@@ -0,0 +1,11 @@
+name: Lint Commit Messages
+on: pull_request
+
+jobs:
+  commitlint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - uses: wagoid/commitlint-github-action@v4

.github/workflows/pages-deploy.yml.hook

@@ -1,29 +1,71 @@
-name: 'Automatic build'
+name: "Build and Deploy"
 on:
   push:
     branches:
+      - main
       - master
     paths-ignore:
       - .gitignore
       - README.md
       - LICENSE
 
-jobs:
-  continuous-delivery:
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
 
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
     runs-on: ubuntu-latest
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
-          fetch-depth: 0  # for posts's lastmod
+          fetch-depth: 0
+          # submodules: true
+          # If using the 'assets' git submodule from Chirpy Starter, uncomment above
+          # (See: https://github.com/cotes2020/chirpy-starter/tree/main/assets)
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v1
 
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
+          ruby-version: '3.1' # reads from a '.ruby-version' or '.tools-version' file if 'ruby-version' is omitted
           bundler-cache: true
 
-      - name: Deploy
-        run: bash tools/deploy.sh
+      - name: Build site
+        run: bundle exec jekyll b -d "_site${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: "production"
+
+      - name: Test site
+        run: |
+          bundle exec htmlproofer _site --disable-external --check-html --allow_hash_href
+
+      - name: Upload site artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: "_site${{ steps.pages.outputs.base_path }}"
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

.github/workflows/style-lint.yml

@@ -0,0 +1,25 @@
+name: 'Style Lint'
+
+on:
+  push:
+    branches-ignore:
+      - 'production'
+      - 'docs'
+    paths:
+      - '_sass/**/*.scss'
+  pull_request:
+    paths:
+      - '_sass/**/*.scss'
+
+jobs:
+  stylelint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Node
+        uses: actions/setup-node@v3
+      - run: npm i
+      - run: npm test

.gitignore

@@ -3,7 +3,10 @@
 !.git*
 !.editorconfig
 !.nojekyll
-!.travis.yml
+!.husky
+!.commitlintrc.json
+!.versionrc.json
+!.stylelintrc.json
 
 # bundler cache
 _site

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "assets/lib"]
+	path = assets/lib
+	url = https://github.com/cotes2020/chirpy-static-assets.git

.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no -- commitlint -x $(npm root -g)/@commitlint/config-conventional --edit

.stylelintrc.json

@@ -0,0 +1,16 @@
+{
+  "extends": "stylelint-config-standard-scss",
+  "rules": {
+    "no-descending-specificity": null,
+    "shorthand-property-no-redundant-values": null,
+    "at-rule-no-vendor-prefix": null,
+    "property-no-vendor-prefix": null,
+    "selector-no-vendor-prefix": null,
+    "value-no-vendor-prefix": null,
+    "color-function-notation": "legacy",
+    "alpha-value-notation": "number",
+    "selector-not-notation": "simple",
+    "color-hex-length": "long",
+    "declaration-block-single-line-max-declarations": 3
+  }
+}

.travis.yml

@@ -1,47 +0,0 @@
-os: linux
-dist: bionic
-
-language: minimal
-
-if: tag =~ /^v(\d)+(\.(\d)+){2}$/
-
-jobs:
-  include:
-    - name: Deploy
-      language: ruby
-      rvm: 2.7.0
-      addons:
-        apt:
-          packages:
-            # required to avoid SSL error (for htmlproofer)
-            - libcurl4-openssl-dev
-      cache:
-        directories:
-          - $TRAVIS_BUILD_DIR/vendor/bundle
-      before_install:
-        # match the Gemfile.lock, travis' bundler is 2.1.2
-        - gem install bundler:2.2.4
-        - bundle config path 'vendor/bundle'
-      install:
-        # overriding to drop the travis `--development` flag
-        - bundle install --jobs=3 --retry=3
-      script:
-        - eval "$BUILD_CMD"
-      git:
-        depth: false # for posts' lastmod
-
-    - name: Flush Starter
-      script: eval "$FLUSH_STARTER"
-
-before_script:
-  - git -C "$HOME" clone "$BUILDER_REPO" --depth=1 -q
-
-notifications:
-  email:
-    recipients:
-      - secure: "fFLqX7uOzFA8RE2AUFlU1mmxMw+rdV6DnODJ/1Gl+3ecNtrv5LeH3c5a4a5ShQqYTrx9BPfD40VRN7UB+lzOdXiWLI9yDGRPPxGG26/WfrKpdQPZilc8zAOEeDnLAJeGZLsUvgmNb3KCXW6S8NPqqh34CfWcTIzjCARhRgO33wcs8X5wP5cugtNqO5Ew/pUcfWcmiuXNX0GNT6l+nL5A7yN+IO5mRHqSRmlfYd5EHhGMTIL4La+Cd1CNv1m4Dl0Ah2cDeJwi5wLnVbqAgunLhAYmDtxIOCVYMTBrP37UiNe/7QeFelyJfODsmMg1mx3WCykbXydC753WVoAlTg6nNoeeI9fmK+/tuLK+sx/KnYfTVGBXQYq39DyV/2o/IfCzEAKImlzFKGD8R13+ddu4B5UML+cby5KBvhTKIGaC5tKoe39z/31UPpy11/EHMCof2BUOzIgu5Hsv4OSNJlw3oRE31oOPn8xP4e7uWR8bRUhAgzN0Cn0ht+UfpemfGAXrp0M3IXQdc9L4azEFqxRhivMTLK/P6INay7IM+DJ30Ht2dWylGw/sxcRTqyNm3YomJQnXIO4xeqTSLulWr80FFHTys3JEDJYrcKvJmpwLFEAOZtwKsZ6ZShrOIA4LE5fgQtakH3ZLJG9a7jVSlMcNIfaSKgjdDQOe6CoRQL7KouA="
-    on_success: never
-
-env:
-  global:
-    - NOKOGIRI_USE_SYSTEM_LIBRARIES=true # speeds up installation of html-proofer

.versionrc.json

@@ -0,0 +1,20 @@
+{
+  "skip": {
+    "commit": true,
+    "tag": true
+  },
+  "types": [
+    {
+      "type": "feat",
+      "section": "Features"
+    },
+    {
+      "type": "fix",
+      "section": "Bug Fixes"
+    },
+    {
+      "type": "perf",
+      "section": "Improvements"
+    }
+  ]
+}

CHANGELOG.md

@@ -0,0 +1,132 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## [5.4.0](https://github.com/cotes2020/jekyll-theme-chirpy/compare/v5.3.2...v5.4.0) (2022-12-27)
+
+
+### Features
+
+* add `rel="me"` to Mastodon sidebar contact links for verification ([#807](https://github.com/cotes2020/jekyll-theme-chirpy/issues/807)) ([d2190c7](https://github.com/cotes2020/jekyll-theme-chirpy/commit/d2190c726f61c8c9732b88b4aecf699dc8bc7deb))
+* add embed video support ([ed6dc53](https://github.com/cotes2020/jekyll-theme-chirpy/commit/ed6dc539eff7003a3765bcd8c31ae5e91a863d65))
+* add shimmer background when image loads ([ab16fdc](https://github.com/cotes2020/jekyll-theme-chirpy/commit/ab16fdc7fc26811130b98a1773beb62bff6182e8))
+* set preview image ratio to 1.91 : 1 ([4b6ccbc](https://github.com/cotes2020/jekyll-theme-chirpy/commit/4b6ccbcbccce27b9fcb035812efefe4eb69301cf))
+* support dark and light mode images ([#481](https://github.com/cotes2020/jekyll-theme-chirpy/issues/481)) ([9306c7b](https://github.com/cotes2020/jekyll-theme-chirpy/commit/9306c7b39ecf9d9146bc1a25eebedc38eb2c3dd6))
+* support LQIP for images ([bffaf63](https://github.com/cotes2020/jekyll-theme-chirpy/commit/bffaf6374f265cec96ef743d42b46fbec3b59797))
+
+
+### Bug Fixes
+
+* `hreflang` tag attribute of feed misses `site.alt_lang` ([7651d28](https://github.com/cotes2020/jekyll-theme-chirpy/commit/7651d2851b4bb7d8f0d068b62c036c89a1089bbc))
+* `og:image` will be incorrect if the image uses a cross-domain URL ([8de1abd](https://github.com/cotes2020/jekyll-theme-chirpy/commit/8de1abda6be3633982392178731431b0ddb1b52b))
+* refactoring error when the image URL contains parameters ([ec98f07](https://github.com/cotes2020/jekyll-theme-chirpy/commit/ec98f07aca0b80a9c07fbcdc8e0d7d66dba98ed2))
+* spaces in post title are encoded when sharing ([7efd2f8](https://github.com/cotes2020/jekyll-theme-chirpy/commit/7efd2f8aa2ea1c3aeb7d740bf9a018881c26fe65))
+
+
+### Improvements
+
+* **cdn:** optimize cache policy for static assets ([7fb0ee0](https://github.com/cotes2020/jekyll-theme-chirpy/commit/7fb0ee0bedb63eee3f90a49c6d7fb8b5d78c9830))
+
+## [5.3.2](https://github.com/cotes2020/jekyll-theme-chirpy/compare/v5.3.1...v5.3.2) (2022-11-22)
+
+
+### Bug Fixes
+
+* `mermaid` occasionally fails to initialize ([#536](https://github.com/cotes2020/jekyll-theme-chirpy/issues/536)) ([48f14e3](https://github.com/cotes2020/jekyll-theme-chirpy/commit/48f14e39ac81bbfb3b9913ea3ee789d775b2d1ae))
+* **comment:** disqus doesn't follow theme mode switching ([b0d5956](https://github.com/cotes2020/jekyll-theme-chirpy/commit/b0d5956f5a0ed894984d6b1754efeba04d8bc966))
+* restore full-text search ([#741](https://github.com/cotes2020/jekyll-theme-chirpy/issues/741)) ([6774e0e](https://github.com/cotes2020/jekyll-theme-chirpy/commit/6774e0e1fb37cf467b14be481347412713763f05))
+* the image URL in the SEO-related tags is incomplete ([#754](https://github.com/cotes2020/jekyll-theme-chirpy/issues/754)) ([f6e9a3f](https://github.com/cotes2020/jekyll-theme-chirpy/commit/f6e9a3fccf7ab34db71f8aefaf86fdcc05861076))
+
+## [5.3.1](https://github.com/cotes2020/jekyll-theme-chirpy/compare/v5.3.0...v5.3.1) (2022-10-25)
+
+
+### Bug Fixes
+
+* 404 page missing title in tablet/desktop view ([5511b28](https://github.com/cotes2020/jekyll-theme-chirpy/commit/5511b2883fd5a395fddfb642588d00c122f18da7))
+* prompt content overflows horizontally ([#705](https://github.com/cotes2020/jekyll-theme-chirpy/issues/705)) ([fb13e32](https://github.com/cotes2020/jekyll-theme-chirpy/commit/fb13e3219b5eca0d2e4f86a1ecabfab75240369f))
+* **tools:** multiple configuration files will fail the test ([80cb0b3](https://github.com/cotes2020/jekyll-theme-chirpy/commit/80cb0b371754e96772a7907877a8ce196398ba3d))
+
+
+### Improvements
+
+* **layout:** improve the min-height of main content ([#674](https://github.com/cotes2020/jekyll-theme-chirpy/issues/674)) ([49bb93c](https://github.com/cotes2020/jekyll-theme-chirpy/commit/49bb93cc0c89ad9cfaad5edcf9cb28c3d5134575))
+* modify checkbox icon with `Liquid` ([1fd665b](https://github.com/cotes2020/jekyll-theme-chirpy/commit/1fd665bf4990c26ae23635c511c5abc9640184d1))
+* optimize the extra padding in lists ([#703](https://github.com/cotes2020/jekyll-theme-chirpy/issues/703)) ([39da11e](https://github.com/cotes2020/jekyll-theme-chirpy/commit/39da11e3f3685f49321757576d2b87a48bf25db5)), closes [#702](https://github.com/cotes2020/jekyll-theme-chirpy/issues/702)
+* **posts:** improve core block bottom padding ([d2fb98b](https://github.com/cotes2020/jekyll-theme-chirpy/commit/d2fb98b3e57f2f6c3fc3816551cd0721731adf40))
+* truncate post content for search results ([647eea8](https://github.com/cotes2020/jekyll-theme-chirpy/commit/647eea8dbd716f9d3cb8330c3139fa753903f51d))
+* **typography:** optimize the line height of post content ([eac3f9b](https://github.com/cotes2020/jekyll-theme-chirpy/commit/eac3f9b434ca77e3dc64eea9cedea7b93e7b306b))
+
+### Others
+
+* **giscus:** add `reactions-enabled` option ([#712](https://github.com/cotes2020/jekyll-theme-chirpy/issues/712)) ([70662a0](https://github.com/cotes2020/jekyll-theme-chirpy/commit/70662a0365e6b9378602dc0a57462ddad5aebcf5))
+* **locale:** restore options for changing date format ([#716](https://github.com/cotes2020/jekyll-theme-chirpy/issues/716)) ([f904e8c](https://github.com/cotes2020/jekyll-theme-chirpy/commit/f904e8cd48c343cc31e25859d9d50bfe2c056f41))
+* remove site config option `prefer_datetime_locale` ([6852ceb](https://github.com/cotes2020/jekyll-theme-chirpy/commit/6852ceb280927ff4e753a3e1131f2b396d9807d0))
+
+## [5.3.0](https://github.com/cotes2020/jekyll-theme-chirpy/compare/v5.2.1...v5.3.0) (2022-09-23)
+
+
+### Features
+
+* add multiple authors to a post ([#677](https://github.com/cotes2020/jekyll-theme-chirpy/issues/677)) ([f1d9e99](https://github.com/cotes2020/jekyll-theme-chirpy/commit/f1d9e99bc02d3cd0a6b0cd1beac545f0cc7a24f8)), closes [#675](https://github.com/cotes2020/jekyll-theme-chirpy/issues/675)
+* **i18n:** add Bulgarian support  ([#612](https://github.com/cotes2020/jekyll-theme-chirpy/issues/612)) ([2fed338](https://github.com/cotes2020/jekyll-theme-chirpy/commit/2fed338ce6d078bf528c9717201fbc475f88cd22))
+* **i18n:** add German locale file ([#663](https://github.com/cotes2020/jekyll-theme-chirpy/issues/663)) ([940b281](https://github.com/cotes2020/jekyll-theme-chirpy/commit/940b2810e95065e30600ae8d5e4612e7183da60e))
+* **i18n:** add Hungarian locale file ([#597](https://github.com/cotes2020/jekyll-theme-chirpy/issues/597), [#598](https://github.com/cotes2020/jekyll-theme-chirpy/issues/598)) ([b032977](https://github.com/cotes2020/jekyll-theme-chirpy/commit/b0329775fc24d0323e5cc04cda46ece8b4531802))
+* **i18n:** add Turkish language ([#631](https://github.com/cotes2020/jekyll-theme-chirpy/issues/631)) ([ad137fa](https://github.com/cotes2020/jekyll-theme-chirpy/commit/ad137fa2945b1870b9c1dd5e9212a5f4af7c3580))
+
+
+### Bug Fixes
+
+* add missing color to linkedin icon for share list ([#683](https://github.com/cotes2020/jekyll-theme-chirpy/issues/683)) ([0dcd39d](https://github.com/cotes2020/jekyll-theme-chirpy/commit/0dcd39d491c9c49e4acf7f75f83fe6e1d1839e37))
+* code contains spaces in headings ([#644](https://github.com/cotes2020/jekyll-theme-chirpy/issues/644)) ([3fa1bf3](https://github.com/cotes2020/jekyll-theme-chirpy/commit/3fa1bf305451f645a7f3aa93863b076463c8f165))
+* correct spelling of `panel` ([#686](https://github.com/cotes2020/jekyll-theme-chirpy/issues/686)) ([b288587](https://github.com/cotes2020/jekyll-theme-chirpy/commit/b288587c1c3d113a1c52c2d25fb46cddda348961))
+* correct the i18n for tab titles ([0c5b697](https://github.com/cotes2020/jekyll-theme-chirpy/commit/0c5b697fd3b283b6a5c926742b61ed49d8688c18))
+* the `code` doesn't wrap inside the prompt ([#626](https://github.com/cotes2020/jekyll-theme-chirpy/issues/626)) ([378b65a](https://github.com/cotes2020/jekyll-theme-chirpy/commit/378b65a0617787813519dde74d6f741f255eff3d))
+
+## [5.2.1](https://github.com/cotes2020/jekyll-theme-chirpy/compare/v5.2.0...v5.2.1) (2022-06-17)
+
+
+### Bug Fixes
+
+* exclude CHANGELOG from output ([971fe03](https://github.com/cotes2020/jekyll-theme-chirpy/commit/971fe03ec329ae49e7d60fe3af6101cfbd1acd6c))
+* **PWA:** sometimes update notification is not triggered ([96af729](https://github.com/cotes2020/jekyll-theme-chirpy/commit/96af7291ea5b2c5ed6372e7b6f7725e67c69f1ba))
+
+## [5.2.0](https://github.com/cotes2020/jekyll-theme-chirpy/compare/v5.1.0...v5.2.0) (2022-06-09)
+
+
+### Features
+
+* add es-ES support to locales ([#533](https://github.com/cotes2020/jekyll-theme-chirpy/issues/533)) ([efe75ad](https://github.com/cotes2020/jekyll-theme-chirpy/commit/efe75adf2784956afb7a0b67f6634b146d9cb03b))
+* add fr-FR support to locales ([#582](https://github.com/cotes2020/jekyll-theme-chirpy/issues/582)) ([94e8144](https://github.com/cotes2020/jekyll-theme-chirpy/commit/94e81447afa457b1a6b7e8f487c47502803556d7))
+* add Vietnamese locale ([#517](https://github.com/cotes2020/jekyll-theme-chirpy/issues/517)) ([171463d](https://github.com/cotes2020/jekyll-theme-chirpy/commit/171463d76da9b7bc25dd327b8f0a868ea79e388b))
+* add pt-BR support to locales ([c2c503f](https://github.com/cotes2020/jekyll-theme-chirpy/commit/c2c503f63336884282b6bda4ec0703d6ae76771b))
+* add option to turn off PWA ([#527](https://github.com/cotes2020/jekyll-theme-chirpy/issues/527)) ([106c981](https://github.com/cotes2020/jekyll-theme-chirpy/commit/106c981bac71e7434204a77e1f0c9c61d6eb1509))
+* **PWA:** add Service Worker update notification ([d127183](https://github.com/cotes2020/jekyll-theme-chirpy/commit/d127183b9774f6321e409acdb66bf8a85d8814be))
+* support showing description of preview image ([2bd6efa](https://github.com/cotes2020/jekyll-theme-chirpy/commit/2bd6efa95a174ac44e30a3af1e57e6f40d6e0e3a))
+
+
+### Bug Fixes
+
+* alt is not a valid attribute for 'a' tag ([58928db](https://github.com/cotes2020/jekyll-theme-chirpy/commit/58928dbc9068db4e4cda4371eeae1865920dce6a))
+* assets URL is missing `baseurl` in self-hosted mode ([#591](https://github.com/cotes2020/jekyll-theme-chirpy/issues/591)) ([54124d5](https://github.com/cotes2020/jekyll-theme-chirpy/commit/54124d5134995fce52e4c2fc0a5d4d1743d6264d))
+* correct the `twitter:creator` of Twitter summary card ([96a16c8](https://github.com/cotes2020/jekyll-theme-chirpy/commit/96a16c868ede51e7dfa412de63ffa1e5a49add7f))
+* correctly URL encode share links ([4c1c8d8](https://github.com/cotes2020/jekyll-theme-chirpy/commit/4c1c8d8b0eacecbbaa2d522bbdd6430f350ff760)), closes [#496](https://github.com/cotes2020/jekyll-theme-chirpy/issues/496)
+* follow paginate_path config for pagination ([6900d9f](https://github.com/cotes2020/jekyll-theme-chirpy/commit/6900d9f2bc9380cbda4babf611c6eeff345291af))
+* force checkout of `gh-pages` branch ([#544](https://github.com/cotes2020/jekyll-theme-chirpy/issues/544)) ([5402523](https://github.com/cotes2020/jekyll-theme-chirpy/commit/5402523ae52a3740bcc15df0b226b2612644945d))
+* horizontal scroll for long equations ([#545](https://github.com/cotes2020/jekyll-theme-chirpy/issues/545)) ([30787fc](https://github.com/cotes2020/jekyll-theme-chirpy/commit/30787fc4cf151e955bb7afc26dfd859f1a06fce6))
+* p is not allowed in span ([4f590e2](https://github.com/cotes2020/jekyll-theme-chirpy/commit/4f590e2bba0639751771211bc0d357828ae70404))
+* remove whitespace from avatar URL ([#537](https://github.com/cotes2020/jekyll-theme-chirpy/issues/537)) ([0542b51](https://github.com/cotes2020/jekyll-theme-chirpy/commit/0542b5149c8287dca60e37f46ee36f31b43455e4))
+* resume the preview image SEO tag ([#529](https://github.com/cotes2020/jekyll-theme-chirpy/issues/529)) ([b8d1bcd](https://github.com/cotes2020/jekyll-theme-chirpy/commit/b8d1bcd3dea0abd1afef7ef154a4501fbb18938d))
+* script code should be in head or body, not in between ([2103191](https://github.com/cotes2020/jekyll-theme-chirpy/commit/2103191b2faf714a8e4418c7c347a1f942b51af8))
+* spurious header closing tags ([59e9557](https://github.com/cotes2020/jekyll-theme-chirpy/commit/59e955745f02f9b57c65af70b0979cd4a98bf53f))
+* table bypass refactoring when it contains IAL ([#519](https://github.com/cotes2020/jekyll-theme-chirpy/issues/519)) ([5d85ccb](https://github.com/cotes2020/jekyll-theme-chirpy/commit/5d85ccb9943aac88dbbefebe1c2234cdcbae5c53))
+* **theme mode:** `SCSS` syntax error ([#588](https://github.com/cotes2020/jekyll-theme-chirpy/issues/588)) ([76a1b6a](https://github.com/cotes2020/jekyll-theme-chirpy/commit/76a1b6a068c369138422dcd18ba08ec8cc3749a6))
+* use `jsonify` to generate valid json ([#521](https://github.com/cotes2020/jekyll-theme-chirpy/issues/521)) ([dd9d5a7](https://github.com/cotes2020/jekyll-theme-chirpy/commit/dd9d5a7207b746342d07176d8969dc4f2c380bf2))
+* when the `site.img_cdn` is set to the local path, the preview-image path loses the `baseurl` ([9cefe58](https://github.com/cotes2020/jekyll-theme-chirpy/commit/9cefe58993d9ea3a3a28424e7ffd8e0911567c5c))
+
+
+### Improvements
+
+* avoid post pageviews from shifting while loading ([135a16f](https://github.com/cotes2020/jekyll-theme-chirpy/commit/135a16f13ee783d9308669ff9a824847a73c951c))
+* avoid the layout shift for post datetime ([6d35f5f](https://github.com/cotes2020/jekyll-theme-chirpy/commit/6d35f5f8da044cfad071628bb53776de03efaae4))
+* **categories:** support singular and plural forms of locale ([#595](https://github.com/cotes2020/jekyll-theme-chirpy/issues/595)) ([35cadf9](https://github.com/cotes2020/jekyll-theme-chirpy/commit/35cadf969dd0161ee62503e242c545f006f7072b))
+* improve the responsive design for ultrawide screens ([#540](https://github.com/cotes2020/jekyll-theme-chirpy/issues/540)) ([5d6e8c5](https://github.com/cotes2020/jekyll-theme-chirpy/commit/5d6e8c5ef6aa71b4d2600c5305f6e8ba540557f7))

Gemfile

@@ -17,6 +17,3 @@ end
 
 # Performance-booster for watching directories on Windows
 gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?
-
-# Jekyll <= 4.2.0 compatibility with Ruby 3.0
-gem "webrick", "~> 1.7"

README.md

@@ -1,124 +1,67 @@
-<div align="right">
-
-  EN /
-  [中文(简体)](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/docs/README.zh-CN.md)
-
-</div>
-
 <div align="center">
 
   # Chirpy Jekyll Theme
 
+  A minimal, responsive, and powerful Jekyll theme for presenting professional writing.
+
   [![Gem Version](https://img.shields.io/gem/v/jekyll-theme-chirpy?color=brightgreen)](https://rubygems.org/gems/jekyll-theme-chirpy)
-  [![Build Status](https://github.com/cotes2020/jekyll-theme-chirpy/workflows/build/badge.svg?branch=master&event=push)](https://github.com/cotes2020/jekyll-theme-chirpy/actions?query=branch%3Amaster+event%3Apush)
-  [![Codacy Badge](https://api.codacy.com/project/badge/Grade/8220b926db514f13afc3f02b7f884f4b)](https://app.codacy.com/manual/cotes2020/jekyll-theme-chirpy?utm_source=github.com&utm_medium=referral&utm_content=cotes2020/jekyll-theme-chirpy&utm_campaign=Badge_Grade_Dashboard)
+  [![CI](https://github.com/cotes2020/jekyll-theme-chirpy/actions/workflows/ci.yml/badge.svg)](https://github.com/cotes2020/jekyll-theme-chirpy/actions/workflows/ci.yml)
+  [![Codacy Badge](https://app.codacy.com/project/badge/Grade/4e556876a3c54d5e8f2d2857c4f43894)](https://www.codacy.com/gh/cotes2020/jekyll-theme-chirpy/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=cotes2020/jekyll-theme-chirpy&amp;utm_campaign=Badge_Grade)
   [![GitHub license](https://img.shields.io/github/license/cotes2020/jekyll-theme-chirpy.svg)](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE)
   [![996.icu](https://img.shields.io/badge/link-996.icu-%23FF4D5B.svg)](https://996.icu)
 
-  A minimal, responsive, and powerful Jekyll theme for presenting professional writing.
+  [**Live Demo →**](https://cotes2020.github.io/chirpy-demo)
 
-  **[Live Demo →](https://chirpy.cotes.info)**
-
-  [![Devices Mockup](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images@0a003683c0c3ca549d12c309f9b3e03ea20981e5/commons/devices-mockup.png)](https://chirpy.cotes.info)
+  [![Devices Mockup](https://chirpy-img.netlify.app/commons/devices-mockup.png)](https://cotes2020.github.io/chirpy-demo)
 
 </div>
 
 ## Features
 
-- Localized Layout
-- Configurable Theme Mode
+- Dark/Light Theme Mode
+- Localized UI language
 - Pinned Posts
 - Hierarchical Categories
-- Last Modified Date for Posts
+- Trending Tags
 - Table of Contents
-- Automatically Recommend Related Posts
+- Last Modified Date of Posts
 - Syntax Highlighting
 - Mathematical Expressions
 - Mermaid Diagram & Flowchart
+- Dark/Light Mode Images
+- Embed Videos
+- Disqus/Utterances/Giscus Comments
 - Search
 - Atom Feeds
-- Disqus Comments
 - Google Analytics
-- GA Pageviews Reporting (Advanced)
+- Page Views Reporting
 - SEO & Performance Optimization
 
-## Prerequisites
+## Quick Start
 
-Follow the instructions in the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of `Ruby`, `RubyGems`, `Jekyll` and `Bundler`.
+Before starting, please follow the instructions in the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of `Ruby`, `RubyGems`, `Jekyll`, and `Bundler`. In addition, [Git](https://git-scm.com/) is also required to be installed.
 
-## Installation
+### Step 1. Creating a New Site
 
-### Creating a New Site
+Create a new repository from the [**Chirpy Starter**](https://github.com/cotes2020/chirpy-starter/generate) and name it `<GH_USERNAME>.github.io`, where `GH_USERNAME` represents your GitHub username.
 
-There are two ways to create a new repository for this theme:
+### Step 2. Installing Dependencies
 
-- **[Using the Chirpy Starter](#option-1-using-the-chirpy-starter)** - Easy to upgrade, isolates irrelevant project files so you can focus on writing.
-
-- **[Forking on GitHub](#option-2-forking-on-github)** - Convenient for custom development, but difficult to upgrade. Unless you are familiar with Jekyll and are determined to tweak or contribute to this project, this approach is not recommended.
-
-#### Option 1. Using the Chirpy Starter
-
-Create a new repository from the [**Chirpy Starter**][use-starter] and name it `<GH_USERNAME>.github.io`, where `GH_USERNAME` represents your GitHub username.
-
-#### Option 2. Forking on GitHub
-
-[Fork **Chirpy**](https://github.com/cotes2020/jekyll-theme-chirpy/fork) on GitHub and rename it to `<GH_USERNAME>.github.io`. Please note that the default branch code is in development.  If you want the site to be stable, please switch to the [latest tag](https://github.com/cotes2020/jekyll-theme-chirpy/tags) and start writing.
-
-And then execute:
-
-```console
-$ bash tools/init.sh
-```
-
-> **Note**: If you don't want to deploy your site on GitHub Pages, append option `--no-gh` at the end of the above command.
-
-The above command will:
-
-1. Removes some files or directories from your repository:
-    - `.travis.yml`
-    - files under `_posts`
-    - folder `docs`
-
-2. If the option `--no-gh` is provided, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing the extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in the folder `.github`.
-
-3. Removes item `Gemfile.lock` from `.gitignore`.
-
-4. Creates a new commit to save the changes automatically.
-
-### Installing Dependencies
-
-Before running for the first time, go the root directory of your site, and install dependencies as follows:
+Before running for the first time, go to the root directory of your site, and install dependencies as follows:
 
 ```console
 $ bundle
 ```
 
-## Usage
+### Step 3. Running Local Server
 
-### Configuration
-
-Update the variables of `_config.yml` as needed. Some of them are typical options:
-
-- `url`
-- `avatar`
-- `timezone`
-- `lang`
-
-### Customing Stylesheet
-
-If you need to customize stylesheet, copy the theme's `assets/css/style.scss` to the same path on your Jekyll site, and then add the custom style at the end of the style file.
-
-Starting from [`v4.1.0`][chirpy-4.1.0], if you want to overwrite the SASS variables defined in `_sass/addon/variables.scss`, create a new file `_sass/variables-hook.scss` and assign new values to the target variable in it.
-
-### Running Local Server
-
-You may want to preview the site contents before publishing, so just run it by:
+Run the following command in the root directory of the site:
 
 ```console
 $ bundle exec jekyll s
 ```
 
-Or run the site on Docker with the following command:
+Or run with Docker:
 
 ```console
 $ docker run -it --rm \
@@ -127,106 +70,29 @@ $ docker run -it --rm \
     jekyll serve
 ```
 
-After a while, the local service will be published at _<http://127.0.0.1:4000>_.
-
-### Deployment
-
-Before the deployment begins, checkout the file `_config.yml` and make sure the `url` is configured correctly. Furthermore, if you prefer the [**project site**](https://help.github.com/en/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites) and don't use a custom domain, or you want to visit your website with a base URL on a web server other than **GitHub Pages**, remember to change the `baseurl` to your project name that starting with a slash, e.g, `/project-name`.
-
-Now you can choose ONE of the following methods to deploy your Jekyll site.
-
-#### Deploy by Using Github Actions
-
-For security reasons, GitHub Pages build runs on `safe` mode, which restricts us from using plugins to generate additional page files. Therefore, we can use **GitHub Actions** to build the site, store the built site files on a new branch, and use that branch as the source of the GitHub Pages service.
-
-Quickly check the files needed for GitHub Actions build:
-
-- Ensure your Jekyll site has the file `.github/workflows/pages-deploy.yml`. Otherwise, create a new one and fill in the contents of the [sample file][workflow], and the value of the `on.push.branches` should be the same as your repo's default branch name.
-
-- Ensure your Jekyll site has file `tools/deploy.sh`. Otherwise, copy it from here to your Jekyll site.
-
-- Furthermore, if you have committed `Gemfile.lock` to the repo, and your runtime system is not Linux, don't forget to update the platform list in the lockfile:
-
-  ```console
-  $ bundle lock --add-platform x86_64-linux
-  ```
-
-After the above steps, rename your repository to `<GH_USERNAME>.github.io` on GitHub.
-
-Now publish your Jekyll site by:
-
-1. Push any commit to remote to trigger the GitHub Actions workflow. Once the build is complete and successful, a new remote branch named `gh-pages` will appear to store the built site files.
-
-2. Browse to your repository on GitHub. Select the tab _Settings_, then click _Pages_ in the left navigation bar, and then in the section **Source** of _GitHub Pages_, select the `/(root)` directory of branch `gh-pages` as the [publishing source][pages-src]. Remember to click <kbd>Save</kbd> before leaving.
-
-    ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images@0a003683c0c3ca549d12c309f9b3e03ea20981e5/posts/20190809/gh-pages-sources.png)
-
-3. Visit your website at the address indicated by GitHub.
-
-#### Manually Build and Deploy
-
-On self-hosted servers, you cannot enjoy the convenience of **GitHub Actions**. Therefore, you should build the site on your local machine and then upload the site files to the server.
-
-Go to the root of the source project, and build your site as follows:
-
-```console
-$ JEKYLL_ENV=production bundle exec jekyll b
-```
-
-Or build the site on Docker:
-
-```console
-$ docker run -it --rm \
-    --env JEKYLL_ENV=production \
-    --volume="$PWD:/srv/jekyll" \
-    jekyll/jekyll \
-    jekyll build
-```
-
-Unless you specified the output path, the generated site files will be placed in folder `_site` of the project's root directory. Now you should upload those files to the target server.
-
-### Upgrading
-
-It depends on how you use the theme:
-
-- If you are using the theme gem (there will be `gem "jekyll-theme-chirpy"` in the `Gemfile`), editing the `Gemfile` and update the version number of the them gem, for example:
-    ```diff
-    - gem "jekyll-theme-chirpy", "~> 3.2", ">= 3.2.1"
-    + gem "jekyll-theme-chirpy", "~> 3.3", ">= 3.3.0"
-    ```
-
-    And then execute the following command:
-
-    ```console
-    $ bundle update jekyll-theme-chirpy
-    ```
-
-    As the version upgrades, the critical files (for details, see the [Startup Template][starter]) and configuration options will change. Please refer to the [Upgrade Guide](https://github.com/cotes2020/jekyll-theme-chirpy/wiki/Upgrade-Guide) to keep your repo's files in sync with the latest version of the theme.
-
-- If you forked from the source project (there will be `gemspec` in the `Gemfile` of your site), then merge the [latest upstream tags][latest-tag] into your Jekyll site to complete the upgrade.
-The merge is likely to conflict with your local modifications. Please be patient and careful to resolve these conflicts.
+After a while, navigate to the site at <http://localhost:4000>.
 
 ## Documentation
 
-For more details and a better reading experience, please check out the [tutorials on the demo site](https://chirpy.cotes.info/categories/tutorial/). In the meanwhile, a copy of the tutorial is also available on the [Wiki](https://github.com/cotes2020/jekyll-theme-chirpy/wiki). Please note that the tutorials on the demo website or Wiki are based on the latest release, and the features of `master` branch usually ahead of the documentation.
+For more details on usage, please refer to the tutorial on the [demo website](https://cotes2020.github.io/chirpy-demo/) / [wiki](https://github.com/cotes2020/jekyll-theme-chirpy/wiki). Note that the tutorial is based on the [latest release](https://github.com/cotes2020/jekyll-theme-chirpy/releases/latest), and the features of the default branch are usually ahead of the documentation.
 
 ## Contributing
 
-The old saying, "Two heads are better than one." Consequently, welcome to report bugs, improve code quality or submit a new feature. For more information, see [contributing guidelines](.github/CONTRIBUTING.md).
+Welcome to report bugs, improve code quality or submit a new feature. For more information, see [contributing guidelines](.github/CONTRIBUTING.md).
 
 ## Credits
 
-This theme is mainly built with [Jekyll](https://jekyllrb.com/) ecosystem, [Bootstrap](https://getbootstrap.com/), [Font Awesome](https://fontawesome.com/) and some other wonderful tools (their copyright information can be found in the relevant files). The avatar and favicon design comes from [Clipart Max](https://www.clipartmax.com/middle/m2i8b1m2K9Z5m2K9_ant-clipart-childrens-ant-cute/).
+This theme is mainly built with [Jekyll](https://jekyllrb.com/) ecosystem, [Bootstrap](https://getbootstrap.com/), [Font Awesome](https://fontawesome.com/) and some other wonderful tools (their copyright information can be found in the relevant files). The avatar and favicon design come from [Clipart Max](https://www.clipartmax.com/middle/m2i8b1m2K9Z5m2K9_ant-clipart-childrens-ant-cute/).
 
 :tada: Thanks to all the volunteers who contributed to this project, their GitHub IDs are on [this list](https://github.com/cotes2020/jekyll-theme-chirpy/graphs/contributors). Also, I won't forget those guys who submitted the issues or unmerged PR because they reported bugs, shared ideas, or inspired me to write more readable documentation.
 
-Last but not least, thank [JetBrains][jb] for providing the open source license.
+Last but not least, thank [JetBrains][jb] for providing the OSS development license.
 
 ## Sponsoring
 
 If you like this theme or find it helpful, please consider sponsoring me, because it will encourage and help me better maintain the project, I will be very grateful!
 
-[![Buy Me a Coffee](https://img.shields.io/badge/-Buy%20Me%20a%20Coffee-ff813f?logo=buy-me-a-coffee&logoColor=white)](https://www.buymeacoffee.com/coteschung)
+[![Ko-fi](https://img.shields.io/badge/-Buy%20Me%20a%20Coffee-ff5f5f?logo=ko-fi&logoColor=white)](https://ko-fi.com/coteschung)
 [![Wechat Pay](https://img.shields.io/badge/-Tip%20Me%20on%20WeChat-brightgreen?logo=wechat&logoColor=white)][cn-donation]
 [![Alipay](https://img.shields.io/badge/-Tip%20Me%20on%20Alipay-blue?logo=alipay&logoColor=white)][cn-donation]
 
@@ -234,14 +100,7 @@ If you like this theme or find it helpful, please consider sponsoring me, becaus
 
 This work is published under [MIT](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE) License.
 
-[starter]: https://github.com/cotes2020/chirpy-starter
-[use-starter]: https://github.com/cotes2020/chirpy-starter/generate
-[workflow]: https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/.github/workflows/pages-deploy.yml.hook
-[chirpy-4.1.0]: https://github.com/cotes2020/jekyll-theme-chirpy/releases/tag/v4.1.0
-[pages-src]: https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site
-[latest-tag]: https://github.com/cotes2020/jekyll-theme-chirpy/tags
-
 <!-- ReadMe links -->
 
 [jb]: https://www.jetbrains.com/?from=jekyll-theme-chirpy
-[cn-donation]: https://cotes.gitee.io/alipay-wechat-donation/
+[cn-donation]: https://sponsor.cotes.page/

_config.yml

@@ -12,6 +12,7 @@ baseurl: ''
 # otherwise, the layout language will use the default value of 'en'.
 lang: en
 
+
 # Change to your timezone › http://www.timezoneconverter.com/cgi-bin/findzone/findzone
 timezone: Asia/Shanghai
 
@@ -23,9 +24,7 @@ title: Chirpy                          # the main title
 tagline: A text-focused Jekyll theme   # it will display as the sub-title
 
 description: >-                        # used by seo meta and the atom feed
-  A minimal, portfolio, sidebar,
-  bootstrap Jekyll theme with responsive web design
-  and focuses on text presentation.
+  A minimal, responsive, and powerful Jekyll theme for presenting professional writing.
 
 # fill in the protocol & hostname for your site, e.g., 'https://username.github.io'
 url: ''
@@ -40,7 +39,7 @@ social:
   # Change to your full name.
   # It will be displayed as the default author of the posts and the copyright owner in the Footer
   name: your_full_name
-  email: example@doamin.com             # change to your email address
+  email: example@domain.com             # change to your email address
   links:
     # The first element serves as the copyright owner's link
     - https://twitter.com/username      # change to your twitter homepage
@@ -49,13 +48,13 @@ social:
     # - https://www.facebook.com/username
     # - https://www.linkedin.com/in/username
 
-google_site_verification: google_meta_tag_verification # change to your verification string
+google_site_verification:               # fill in to your verification string
 
 # ↑ --------------------------
-
+# The end of `jekyll-seo-tag` settings
 
 google_analytics:
-  id: ''              # fill in your Google Analytics ID
+  id:                 # fill in your Google Analytics ID
   # Google Analytics pageviews report settings
   pv:
     proxy_endpoint:   # fill in the Google Analytics superProxy endpoint of Google App Engine
@@ -79,7 +78,7 @@ theme_mode:   # [light|dark]
 # will be added to all image (site avatar & posts' images) paths starting with '/'
 #
 # e.g. 'https://cdn.com'
-img_cdn: 'https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images@0a003683c0c3ca549d12c309f9b3e03ea20981e5'
+img_cdn: 'https://chirpy-img.netlify.app'
 
 # the avatar on sidebar, support local or CORS resources
 avatar: '/commons/avatar.jpg'
@@ -87,9 +86,36 @@ avatar: '/commons/avatar.jpg'
 # boolean type, the global switch for ToC in posts.
 toc: true
 
-disqus:
-  comments: false  # boolean type, the global switch for posts comments.
-  shortname: ''    # Fill with your Disqus shortname. › https://help.disqus.com/en/articles/1717111-what-s-a-shortname
+comments:
+  active:         # The global switch for posts comments, e.g., 'disqus'.  Keep it empty means disable
+  # The active options are as follows:
+  disqus:
+    shortname:    # fill with the Disqus shortname. › https://help.disqus.com/en/articles/1717111-what-s-a-shortname
+  # utterances settings › https://utteranc.es/
+  utterances:
+    repo:         # <gh-username>/<repo>
+    issue_term:   # < url | pathname | title | ...>
+  # Giscus options › https://giscus.app
+  giscus:
+    repo:              # <gh-username>/<repo>
+    repo_id:
+    category:
+    category_id:
+    mapping:           # optional, default to 'pathname'
+    input_position:    # optional, default to 'bottom'
+    lang:              # optional, default to the value of `site.lang`
+    reactions_enabled: # optional, default to the value of `1`
+
+# Self-hosted static assets, optional › https://github.com/cotes2020/chirpy-static-assets
+assets:
+  self_host:
+    enabled:      # boolean, keep empty means false
+    # specify the Jekyll environment, empty means both
+    # only works if `assets.self_host.enabled` is 'true'
+    env:          # [development|production]
+
+pwa:
+  enabled: true   # the option for PWA feature
 
 paginate: 10
 
@@ -111,10 +137,8 @@ collections:
     output: true
     sort_by: order
 
-
 defaults:
-  -
-    scope:
+  - scope:
       path: ''          # An empty string here means all files in the project
       type: posts
     values:
@@ -124,19 +148,24 @@ defaults:
       # DO NOT modify the following parameter unless you are confident enough
       # to update the code of all other post links in this project.
       permalink: /posts/:title/
-  -
-    scope:
+  - scope:
       path: _drafts
     values:
       comments: false
-  -
-    scope:
+  - scope:
       path: ''
       type: tabs             # see `site.collections`
     values:
       layout: page
       permalink: /:title/
-      dynamic_title: true    # Hide title in mobile screens.
+  - scope:
+      path: assets/img/favicons
+    values:
+      swcache: true
+  - scope:
+      path: assets/js/dist
+    values:
+      swcache: true
 
 sass:
   style: compressed
@@ -154,12 +183,12 @@ exclude:
   - '*.gem'
   - '*.gemspec'
   - tools
-  - docs
   - README.md
+  - CHANGELOG.md
   - LICENSE
   - gulpfile.js
   - node_modules
-  - '*.json'
+  - package*.json
 
 jekyll-archives:
   enabled: [categories, tags]

_data/assets/cross_origin.yml

@@ -0,0 +1,62 @@
+# CDNs
+
+cdns:
+  # Google Fonts
+  - url: https://fonts.googleapis.com
+  - url: https://fonts.gstatic.com
+    args: crossorigin
+  - url: https://fonts.googleapis.com
+  # jsDelivr CDN
+  - url: https://cdn.jsdelivr.net
+
+# fonts
+
+webfonts: https://fonts.googleapis.com/css2?family=Lato&family=Source+Sans+Pro:wght@400;600;700;900&display=swap
+
+# Libraries
+
+jquery:
+  js: https://cdn.jsdelivr.net/npm/jquery@3.6.1/dist/jquery.min.js
+
+bootstrap:
+  css: https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/css/bootstrap.min.css
+  js: https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/js/bootstrap.bundle.min.js
+
+bootstrap-toc:
+  css: https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@1.0.1/dist/bootstrap-toc.min.css
+  js: https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@1.0.1/dist/bootstrap-toc.min.js
+
+fontawesome:
+  css: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6.2.1/css/all.min.css
+
+search:
+  js: https://cdn.jsdelivr.net/npm/simple-jekyll-search@1.10.0/dest/simple-jekyll-search.min.js
+
+mermaid:
+  js: https://cdn.jsdelivr.net/npm/mermaid@9.2.2/dist/mermaid.min.js
+
+dayjs:
+  js:
+    common: https://cdn.jsdelivr.net/npm/dayjs@1.11.6/dayjs.min.js
+    locale: https://cdn.jsdelivr.net/npm/dayjs@1.11.6/locale/:LOCALE.min.js
+    relativeTime: https://cdn.jsdelivr.net/npm/dayjs@1.11.6/plugin/relativeTime.min.js
+    localizedFormat: https://cdn.jsdelivr.net/npm/dayjs@1.11.6/plugin/localizedFormat.min.js
+
+countup:
+  js: https://cdn.jsdelivr.net/npm/countup.js@1.9.3/dist/countUp.min.js
+
+magnific-popup:
+  css: https://cdn.jsdelivr.net/npm/magnific-popup@1.1.0/dist/magnific-popup.min.css
+  js: https://cdn.jsdelivr.net/npm/magnific-popup@1.1.0/dist/jquery.magnific-popup.min.js
+
+lazysizes:
+  js: https://cdn.jsdelivr.net/npm/lazysizes@5.3.2/lazysizes.min.js
+
+clipboard:
+  js: https://cdn.jsdelivr.net/npm/clipboard@2.0.11/dist/clipboard.min.js
+
+polyfill:
+  js: https://polyfill.io/v3/polyfill.min.js?features=es6
+
+mathjax:
+  js: https://cdn.jsdelivr.net/npm/mathjax@3.2.2/es5/tex-chtml.js

_data/assets/self_host.yml

@@ -0,0 +1,51 @@
+# fonts
+
+webfonts: /assets/lib/fonts/main.css
+
+# Libraries
+
+jquery:
+  js: /assets/lib/jquery-3.6.0/jquery.min.js
+
+bootstrap:
+  css: /assets/lib/bootstrap-4.6.1/bootstrap.min.css
+  js: /assets/lib/bootstrap-4.6.1/bootstrap.bundle.min.js
+
+bootstrap-toc:
+  css: /assets/lib/bootstrap-toc-1.0.1/bootstrap-toc.min.css
+  js: /assets/lib/bootstrap-toc-1.0.1/bootstrap-toc.min.js
+
+fontawesome:
+  css: /assets/lib/fontawesome-free-6.2.1/css/all.min.css
+
+search:
+  js: /assets/lib/simple-jekyll-search-1.10.0/simple-jekyll-search.min.js
+
+mermaid:
+  js: /assets/lib/mermaid-9.1.7/mermaid.min.js
+
+dayjs:
+  js:
+    common: /assets/lib/dayjs-1.10.7/dayjs.min.js
+    locale: /assets/lib/dayjs-1.10.7/locale/en.min.js
+    relativeTime: /assets/lib/dayjs-1.10.7/plugin/relativeTime.min.js
+    localizedFormat: /assets/lib/dayjs-1.10.7/plugin/localizedFormat.min.js
+
+countup:
+  js: /assets/lib/countup.js-1.9.3/countUp.min.js
+
+magnific-popup:
+  css: /assets/lib/magnific-popup-1.1.0/magnific-popup.css
+  js: /assets/lib/magnific-popup-1.1.0/jquery.magnific-popup.min.js
+
+lazysizes:
+  js: /assets/lib/lazysizes-5.3.2/lazysizes.min.js
+
+clipboard:
+  js: /assets/lib/clipboard-2.0.9/clipboard.min.js
+
+polyfill:
+  js: /assets/lib/polyfill-v3-es6/polyfill.min.js
+
+mathjax:
+  js: /assets/lib/mathjax-3.2.0/tex-chtml.js

_data/authors.yml

@@ -0,0 +1,17 @@
+## Template › https://github.com/jekyll/jekyll-seo-tag/blob/master/docs/advanced-usage.md#setting-author-url
+# -------------------------------------
+# {author_id}:
+#   name: {full name}
+#   twitter: {twitter_of_author}
+#   url: {homepage_of_author}
+# -------------------------------------
+
+cotes:
+  name: Cotes Chung
+  twitter: cotes2020
+  url: https://github.com/cotes2020/
+
+sille_bille:
+  name: Dinesh Prasanth Moluguwan Krishnamoorthy
+  twitter: dinesh_MKD
+  url: https://github.com/SilleBille/

_data/contact.yml

@@ -19,7 +19,7 @@
 # -
 #   type: mastodon
 #   icon: 'fab fa-mastodon'   # icons powered by <https://fontawesome.com/>
-#   url:  ''                  # Fill with your mastodon account page
+#   url:  ''                  # Fill with your Mastodon account page, rel="me" will be applied for verification
 # -
 #   type: linkedin
 #   icon: 'fab fa-linkedin'   # icons powered by <https://fontawesome.com/>

_data/locales/bg-BG.yml

@@ -0,0 +1,83 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Публикация
+  category: Категория
+  tag: Таг
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Начало
+  categories: Категории
+  tags: Тагове
+  archives: Архив
+  about: За мен
+
+# the text displayed in the search bar & search results
+search:
+  hint: търси
+  cancel: Отмени
+  no_results: Упс! Не са намерени резултати.
+
+panel:
+  lastmod: Наскоро обновени
+  trending_tags: Популярни тагове
+  toc: Съдържание
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Тази публикация е лицензирана под :LICENSE_NAME от автора.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Някои права запазени.
+  verbose: >-
+    Освен ако не е посочено друго, публикациите в блога на този сайт са лицензирани
+    под лиценза Creative Commons Attribution 4.0 (CC BY 4.0) от автора.
+
+meta: Създадено чрез :PLATFORM и :THEME тема.
+
+not_found:
+  statment: Съжалявам, но на този URL адрес няма налично съдържание.
+
+notification:
+  update_found: Налична е нова версия на съдържанието.
+  update: Обнови
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Автор
+  posted: Публикувана
+  updated: Обновена
+  words: думи
+  pageview_measure: преглеждания
+  read_time:
+    unit: мин
+    prompt: четиво
+  relate_posts: Още за четене
+  share: Споделете
+  button:
+    next: По-нови
+    previous: По-стари
+    copy_code:
+      succeed: Копирано!
+    share_link:
+      title: Копирай линк
+      succeed: Линкът е копиран успешно!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Прикрепенa
+
+# categories page
+categories:
+  category_measure:
+    singular: категория
+    plural: категории
+  post_measure:
+    singular: публикация
+    plural: публикации

_data/locales/de-DE.yml

@@ -0,0 +1,82 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Eintrag
+  category: Kategorie
+  tag: Tag
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Startseite
+  categories: Kategorien
+  tags: Tags
+  archives: Archiv
+  about: Über
+
+# the text displayed in the search bar & search results
+search:
+  hint: Suche
+  cancel: Abbrechen
+  no_results: Ups! Keine Einträge gefunden.
+
+panel:
+  lastmod: Kürzlich aktualisiert
+  trending_tags: Beliebte Tags
+  toc: Inhalt
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Dieser Eintrag ist vom Autor unter :LICENSE_NAME lizensiert.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Einige Rechte vorbehalten.
+  verbose: >-
+    Alle Einträge auf dieser Seite stehen, soweit nicht anders angegeben, unter der Lizenz Creative Commons Attribution 4.0 (CC BY 4.0).
+
+meta: Powered by :PLATFORM with :THEME theme.
+
+not_found:
+  statment: Entschuldigung, dieser Link verweist auf keine vorhandene Ressource.
+
+notification:
+  update_found: Eine neue Version ist verfügbar.
+  update: Neue Version
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Von
+  posted: Veröffentlicht
+  updated: Aktualisiert
+  words: Wörter
+  pageview_measure: Aufrufe
+  read_time:
+    unit: Minuten
+    prompt: lesen
+  relate_posts: Weiterlesen
+  share: Teilen
+  button:
+    next: Nächster Eintrag
+    previous: Eintrag vorher
+    copy_code:
+      succeed: Kopiert!
+    share_link:
+      title: Link kopieren
+      succeed: Link erfolgreich kopiert!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Angepinnt
+
+# categories page
+categories:
+  category_measure:
+    singular: Kategorie
+    plural: Kategorien
+  post_measure:
+    singular: Eintrag
+    plural: Einträge

_data/locales/en.yml

@@ -20,21 +20,13 @@ tabs:
 search:
   hint: search
   cancel: Cancel
-  no_results: Oops! No result founds.
+  no_results: Oops! No results found.
 
 panel:
-  lastmod: Recent Update
+  lastmod: Recently Updated
   trending_tags: Trending Tags
   toc: Contents
 
-#  The liquid date format › http://strftime.net/
-date_format:
-  tooltip: '%a, %b %e, %Y, %l:%M %p %z'
-  post:
-    long: '%b %e, %Y'
-    short: '%b %e'
-    archive_month: '%b'
-
 copyright:
   # Shown at the bottom of the post
   license:
@@ -48,24 +40,21 @@ copyright:
     Except where otherwise noted, the blog posts on this site are licensed
     under the Creative Commons Attribution 4.0 International (CC BY 4.0) License by the author.
 
-meta: Powered by :PLATFORM with :THEME theme.
+meta: Using the :PLATFORM theme :THEME.
 
 not_found:
   statment: Sorry, we've misplaced that URL or it's pointing to something that doesn't exist.
-  hint_template: :HEAD_BAK to try finding it again, or search for it on the :ARCHIVES_PAGE.
-  head_back: Head back Home
-  archives_page: Archives page
+
+notification:
+  update_found: A new version of content is available.
+  update: Update
 
 # ----- Posts related labels -----
 
 post:
-  published: 'on'
+  written_by: By
+  posted: Posted
   updated: Updated
-  timeago:
-    day: days ago
-    hour: hours ago
-    minute: minutes ago
-    just_now: just now
   words: words
   pageview_measure: views
   read_time:
@@ -84,7 +73,21 @@ post:
   # pinned prompt of posts list on homepage
   pin_prompt: Pinned
 
+# Date time format.
+# See: <http://strftime.net/>, <https://day.js.org/docs/en/display/format>
+df:
+  post:
+    strftime: '%b %e, %Y'
+    dayjs: 'll'
+  archives:
+    strftime: '%b'
+    dayjs: 'MMM'
+
 # categories page
 categories:
-  category_measure: categories
-  post_measure: posts
+  category_measure:
+    singular: category
+    plural: categories
+  post_measure:
+    singular: post
+    plural: posts

_data/locales/es-ES.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Entrada
+  category: Categoría
+  tag: Etiqueta
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Inicio
+  categories: Categorías
+  tags: Etiquetas
+  archives: Archivo
+  about: Acerca de
+
+# the text displayed in the search bar & search results
+search:
+  hint: Buscar
+  cancel: Cancelar
+  no_results: ¡Oops! No se encuentran resultados.
+
+panel:
+  lastmod: Actualizado recientemente
+  trending_tags: Etiquetas populares
+  toc: Contenido
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Esta entrada está licenciada bajo :LICENSE_NAME por el autor.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Algunos derechos reservados.
+  verbose: >-
+    Salvo que se indique explícitamente, las entradas de este blog están licenciadas
+    bajo la Creative Commons Attribution 4.0 International (CC BY 4.0) License por el autor.
+
+meta: Hecho con :PLATFORM usando el tema :THEME.
+
+not_found:
+  statment: Lo sentimos, hemos perdido esa URL o apunta a algo que no existe.
+
+notification:
+  update_found: Hay una nueva versión de contenido disponible.
+  update: Actualizar
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Por
+  posted: Publicado
+  updated: Actualizado
+  words: palabras
+  pageview_measure: visitas
+  read_time:
+    unit: min
+    prompt: ' de lectura'
+  relate_posts: Lecturas adicionales
+  share: Compartir
+  button:
+    next: Nuevo
+    previous: Anterior
+    copy_code:
+      succeed: ¡Copiado!
+    share_link:
+      title: Copiar enlace
+      succeed: ¡Enlace copiado!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Fijado
+
+# categories page
+categories:
+  category_measure: categorias
+  post_measure: entradas

_data/locales/fr-FR.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Post
+  category: Catégorie
+  tag: Tag
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Accueil
+  categories: Catégories
+  tags: Tags
+  archives: Archives
+  about: A propos de
+
+# the text displayed in the search bar & search results
+search:
+  hint: recherche
+  cancel: Annuler
+  no_results: Oups ! Aucun résultat trouvé.
+
+panel:
+  lastmod: Récemment mis à jour
+  trending_tags: Tags tendance
+  toc: Contenu
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Cet article est sous licence :LICENSE_NAME par l'auteur.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Certains droits réservés.
+  verbose: >-
+    Sauf mention contraire, les articles de ce site sont publiés sous licence
+    sous la licence Creative Commons Attribution 4.0 International (CC BY 4.0) par l'auteur.
+
+meta: Propulsé par :PLATFORM avec le thème :THEME
+
+not_found:
+  statment: Désolé, nous avons égaré cette URL ou elle pointe vers quelque chose qui n'existe pas.
+
+notification:
+  update_found: Une nouvelle version du contenu est disponible.
+  update: Mise à jour
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Par
+  posted: Posté
+  updated: Mis à jour
+  words: mots
+  pageview_measure: vues
+  read_time:
+    unit: min
+    prompt: lire
+  relate_posts: Autres lectures
+  share: Partager
+  button:
+    next: Plus récent
+    previous: Plus ancien
+    copy_code:
+      succeed: Copié !
+    share_link:
+      title: Copier le lien
+      succeed: Lien copié avec succès !
+  # pinned prompt of posts list on homepage
+  pin_prompt: Épinglé
+
+# categories page
+categories:
+  category_measure: catégories
+  post_measure: posts

_data/locales/hu-HU.yml

@@ -0,0 +1,81 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Bejegyzés
+  category: Kategória
+  tag: Címke
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Kezdőlap
+  categories: Kategóriák
+  tags: Címkék
+  archives: Archívum
+  about: Rólam
+
+# the text displayed in the search bar & search results
+search:
+  hint: keresés
+  cancel: Mégse
+  no_results: Oops! Nincs találat a keresésre.
+
+panel:
+  lastmod: Legutóbb frissítve
+  trending_tags: Népszerű Címkék
+  toc: Tartalom
+  links: Blog linkek
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: A bejegyzés :LICENSE_NAME licenccel rendelkezik.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Néhány jog fenntartva.
+  verbose: >-
+   Az oldalon található tartalmak
+   Creative Commons Attribution 4.0 International (CC BY 4.0) licenccel rendelkeznek,
+   hacsak másképp nincs jelezve.
+
+meta: Készítve :PLATFORM motorral :THEME témával.
+
+not_found:
+  statment: Sajnáljuk, az URL-t rosszul helyeztük el, vagy valami nem létezőre mutat.
+
+notification:
+  update_found: Elérhető a tartalom új verziója.
+  update: Frissítés
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Szerző
+  posted: Létrehozva
+  updated: Frissítve
+  words: szó
+  pageview_measure: látogató
+  read_time:
+    unit: perc
+    prompt: elolvasni
+  relate_posts: További olvasnivaló
+  share: Megosztás
+  button:
+    next: Újabb
+    previous: Régebbi
+    copy_code:
+      succeed: Másolva!
+    share_link:
+      title: Link másolása
+      succeed: Link sikeresen másolva!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Kitűzve
+
+# categories page
+categories:
+  category_measure: kategória
+  post_measure: bejegyzés

_data/locales/id-ID.yml

@@ -27,14 +27,6 @@ panel:
   trending_tags: Tagar Terpopuler
   toc: Konten
 
-#  The liquid date format › http://strftime.net/
-date_format:
-  tooltip: "%a, %e %b, %Y, %l:%M %p"
-  post:
-    long: "%e %b, %Y"
-    short: "%e %b"
-    archive_month: "%b"
-
 copyright:
   # Shown at the bottom of the post
   license:
@@ -52,20 +44,17 @@ meta: Didukung oleh :PLATFORM dengan tema :THEME.
 
 not_found:
   statment: Maaf, kami gagal menemukan URL itu atau memang mengarah ke sesuatu yang tidak ada.
-  hint_template: :HEAD_BAK untuk mencoba mencari kembali, atau cari di :ARCHIVES_PAGE.
-  head_back: Kembali ke Beranda
-  archives_page: Halaman Arsip
+
+notification:
+  update_found: Versi konten baru tersedia.
+  update: Perbarui
 
 # ----- Posts related labels -----
 
 post:
-  published: "pada"
+  written_by: Oleh
+  posted: Diterbitkan
   updated: Diperbarui
-  timeago:
-    day: hari yang lalu
-    hour: jam yang lalu
-    minute: menit yang lalu
-    just_now: baru saja
   words: kata
   pageview_measure: dilihat
   read_time:

_data/locales/ko-KR.yml

@@ -0,0 +1,86 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: 포스트
+  category: 카테고리
+  tag: 태그
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: 홈
+  categories: 카테고리
+  tags: 태그
+  archives: 아카이브
+  about: 정보
+
+# the text displayed in the search bar & search results
+search:
+  hint: 검색
+  cancel: 취소
+  no_results: 검색 결과가 없습니다.
+
+panel:
+  lastmod: 최근 업데이트
+  trending_tags: 인기 태그
+  toc: 바로가기
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: 이 기사는 저작권자의 :LICENSE_NAME 라이센스를 따릅니다.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: 일부 권리 보유
+  verbose: >-
+    명시되지 않는 한 이 사이트의 블로그 게시물은 작성자의
+    Creative Commons Attribution 4.0 International(CC BY 4.0) 라이선스에 따라 사용이 허가되었습니다.
+
+meta: Powered by :PLATFORM with :THEME theme.
+
+not_found:
+  statment: 해당 URL은 존재하지 않습니다.
+
+notification:
+  update_found: 새 버전의 콘텐츠를 사용할 수 있습니다.
+  update: 업데이트
+
+# ----- Posts related labels -----
+
+post:
+  written_by: By
+  posted: 게시
+  updated: 업데이트
+  words: 단어
+  pageview_measure: 조회
+  read_time:
+    unit: 분
+    prompt: 읽는 시간
+  relate_posts: 관련된 글
+  share: 공유하기
+  button:
+    next: 다음 글
+    previous: 이전 글
+    copy_code:
+      succeed: 복사되었습니다!
+    share_link:
+      title: 링크 복사하기
+      succeed: 링크가 복사되었습니다!
+  # pinned prompt of posts list on homepage
+  pin_prompt: 핀
+
+# Date time format.
+# See: <http://strftime.net/>, <https://day.js.org/docs/en/display/format>
+df:
+  post:
+    strftime: '%Y/%m/%d'
+    dayjs: 'YYYY/MM/DD'
+
+# categories page
+categories:
+  category_measure: 카테고리
+  post_measure: 포스트

_data/locales/my-MM.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: ပို့စ်
+  category: ကဏ္ဍ
+  tag: နာမ(တက်ဂ်)
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: အဓိကစာမျက်နှာ
+  categories: ကဏ္ဍများ
+  tags: နာမ(တက်ဂ်)များ
+  archives: မှတ်တမ်း​တိုက်
+  about: အကြောင်းအရာ
+
+# the text displayed in the search bar & search results
+search:
+  hint: ရှာဖွေမည်
+  cancel: ဖျက်သိမ်းမည်
+  no_results: အိုး! ဘာမှမရှိပါ
+
+panel:
+  lastmod: မကြာသေးမီကမွမ်းမံထားသည်
+  trending_tags: ခေတ်စားနေသည့်တက်ဂ်များ
+  toc: အကြောင်းအရာများ
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: ဤပို့စ်သည်စာရေးသူ၏ :LICENSE_NAME လိုင်စင်ရထားသည်။
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: မူပိုင်ခွင့်အချို့ကို လက်ဝယ်ထားသည်။
+  verbose: >-
+    အခြားမှတ်သားထားချက်များမှလွဲ၍ ဤဆိုက်ရှိ ဘလော့ဂ်ပို့စ်များသည် စာရေးသူ၏
+    Creative Commons Attribution 4.0 International (CC BY 4.0) အောက်တွင် လိုင်စင်ရထားပါသည်။
+
+meta: Powered by :PLATFORM with :THEME theme.
+
+not_found:
+  statment: ဝမ်းနည်းပါသည်၊ ကျွန်ုပ်တို့သည် အဆိုပါ URL ကို မှားယွင်းစွာ နေရာချထားခြင်း သို့မဟုတ် ၎င်းသည် မရှိသောအရာကို ညွှန်ပြနေပါသည်။
+
+notification:
+  update_found: အကြောင်းအရာဗားရှင်းအသစ်ကို ရနိုင်ပါပြီ။
+  update: အပ်ဒိတ်
+
+# ----- Posts related labels -----
+
+post:
+  written_by: ကရေးသားခဲ့သည်။
+  posted: တင်ထားခဲ့သည်။
+  updated: မွမ်းမံထားခဲ့သည်။
+  words: စကားလုံးများ
+  pageview_measure: အမြင်များ
+  read_time:
+    unit: မိနစ်
+    prompt: ဖတ်ပါမည်
+  relate_posts: နောက်ထပ်ဖတ်ရန်
+  share: မျှဝေရန်
+  button:
+    next: အသစ်များ
+    previous: အဟောင်းများ
+    copy_code:
+      succeed: ကူးယူလိုက်ပြီ။
+    share_link:
+      title: လင့်ခ်ကို ကူးယူရန်
+      succeed: လင့်ခ်ကို ကူးယူလိုက်ပြီ။
+  # pinned prompt of posts list on homepage
+  pin_prompt: ချိတ်ထားသည်။
+
+# categories page
+categories:
+  category_measure: ကဏ္ဍများ
+  post_measure: ပို့စ်များ

_data/locales/pt-BR.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Post
+  category: Categoria
+  tag: Tag
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Home
+  categories: Categorias
+  tags: Tags
+  archives: Arquivos
+  about: Sobre
+
+# the text displayed in the search bar & search results
+search:
+  hint: Buscar
+  cancel: Cancelar
+  no_results: Oops! Nenhum resultado encontrado.
+
+panel:
+  lastmod: Atualizados recentemente
+  trending_tags: Trending Tags
+  toc: Conteúdo
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Esta postagem está licenciada sob :LICENSE_NAME pelo autor.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Alguns direitos reservados.
+  verbose: >-
+    Exceto onde indicado de outra forma, as postagens do blog neste site são licenciadas sob a
+    Creative Commons Attribution 4.0 International (CC BY 4.0) License pelo autor.
+
+meta: Feito com :PLATFORM usando o tema :THEME.
+
+not_found:
+  statment: Desculpe, a página não foi encontrada.
+
+notification:
+  update_found: Uma nova versão do conteúdo está disponível.
+  update: atualização
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Por
+  posted: Postado em
+  updated: Atualizado
+  words: palavras
+  pageview_measure: visualizações
+  read_time:
+    unit: min
+    prompt: " de leitura"
+  relate_posts: Leia também
+  share: Compartilhar
+  button:
+    next: Próximo
+    previous: Anterior
+    copy_code:
+      succeed: Copiado!
+    share_link:
+      title: Copie o link
+      succeed: Link copiado com sucesso!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Fixado
+
+# categories page
+categories:
+  category_measure: categorias
+  post_measure: posts

_data/locales/ru-RU.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Публикация
+  category: Категория
+  tag: Тег
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Домашняя страница
+  categories: Категории
+  tags: Теги
+  archives: Архив
+  about: О сайте
+
+# the text displayed in the search bar & search results
+search:
+  hint: поиск
+  cancel: Отменить
+  no_results: Ох! Ничего не найдено.
+
+panel:
+  lastmod: Недавно обновлено
+  trending_tags: Популярные теги
+  toc: Содержание
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Публикация защищена лицензией :LICENSE_NAME.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Некоторые права защищены.
+  verbose: >-
+    Публикации на сайте защищены лицензией Creative Commons Attribution 4.0 International (CC BY 4.0),
+    если в тексте публикации не указано иное.
+
+meta: Powered by :PLATFORM with :THEME theme.
+
+not_found:
+  statment: Извините, эта ссылка указывает на ресурс который не существует.
+
+notification:
+  update_found: Доступна новая версия контента.
+  update: Обновлять
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Автор
+  posted: Время публикации
+  updated: Обновлено
+  words: слов
+  pageview_measure: просмотров
+  read_time:
+    unit: минут
+    prompt: чтения
+  relate_posts: Вам также может быть интересно
+  share: Поделиться
+  button:
+    next: Предыдущая публикация
+    previous: Следующая публикация
+    copy_code:
+      succeed: Скопировано успешно!
+    share_link:
+      title: Скопировать ссылку
+      succeed: Ссылка успешно скопирована!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Закреплено
+
+# categories page
+categories:
+  category_measure: категории
+  post_measure: публикации

_data/locales/tr-TR.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Gönderi
+  category: Kategori
+  tag: Etiket
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Ana Sayfa
+  categories: Kategoriler
+  tags: Etiketler
+  archives: Arşiv
+  about: Hakkında
+
+# the text displayed in the search bar & search results
+search:
+  hint: Ara...
+  cancel: İptal
+  no_results: Hop! Öyle bir şey bulamadım.
+
+panel:
+  lastmod: Yeni Güncellendi
+  trending_tags: Yükselen Etiketler
+  toc: İçindekiler
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Bu gönderi :LICENSE_NAME lisansı altındadır.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/deed.tr
+
+  # Displayed in the footer
+  brief: Bazı hakları saklıdır.
+  verbose: >-
+    Aksi belirtilmediği sürece, bu sitedeki gönderiler Creative Commons Atıf 4.0 Uluslararası (CC BY 4.0) Lisansı altındadır.
+    Kısaca sayfa linkini de vererek paylaşabilir veya düzenleyip paylaşabilirsin.
+
+meta: :PLATFORM ve :THEME teması.
+
+not_found:
+  statment: Üzgünüz, bu linki yanlış yerleştirdik veya var olmayan bir şeye işaret ediyor.
+
+notification:
+  update_found: İçeriğin yeni bir sürümü mevcut.
+  update: Güncelle
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Yazan
+  posted: Gönderilme Tarihi
+  updated: Güncellenme Tarihi
+  words: sözcük
+  pageview_measure: görüntülenme
+  read_time:
+    unit: dakikada
+    prompt: okunabilir
+  relate_posts: Benzer Gönderiler
+  share: Paylaş
+  button:
+    next: İleri
+    previous: Geri
+    copy_code:
+      succeed: Kopyalandı.
+    share_link:
+      title: Linki kopyala
+      succeed: Link kopyalandı.
+  # pinned prompt of posts list on homepage
+  pin_prompt: Sabitlendi
+
+# categories page
+categories:
+  category_measure: kategori
+  post_measure: gönderi

_data/locales/uk-UA.yml

@@ -0,0 +1,79 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Публікація
+  category: Категорія
+  tag: Тег
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Домашня сторінка
+  categories: Категорії
+  tags: Теги
+  archives: Архів
+  about: Про сайт
+
+# the text displayed in the search bar & search results
+search:
+  hint: пошук
+  cancel: Скасувати
+  no_results: Ох! Нічого не знайдено.
+
+panel:
+  lastmod: Нещодавно оновлено
+  trending_tags: Популярні теги
+  toc: Зміст
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Публікація захищена ліцензією :LICENSE_NAME.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Деякі права захищено.
+  verbose: >-
+    Публікації на сайті захищено ліцензією Creative Commons Attribution 4.0 International (CC BY 4.0),
+    якщо інше не вказано в тексті.
+
+meta: Powered by :PLATFORM with :THEME theme.
+
+not_found:
+  statment: Вибачте, це посилання вказує на ресурс, що не існує.
+
+notification:
+  update_found: Доступна нова версія вмісту.
+  update: Оновлення
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Автор
+  posted: Час публікації
+  updated: Оновлено
+  words: слів
+  pageview_measure: переглядів
+  read_time:
+    unit: хвилин
+    prompt: читання
+  relate_posts: Вас також може зацікавити
+  share: Поділитися
+  button:
+    next: Попередня публікація
+    previous: Наступна публікація
+    copy_code:
+      succeed: Успішно скопійовано!
+    share_link:
+      title: Скопіювати посилання
+      succeed: Посилання успішно скопійовано!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Закріплено
+
+# categories page
+categories:
+  category_measure: категорії
+  post_measure: публікації

_data/locales/vi-VN.yml

@@ -0,0 +1,77 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Bài viết
+  category: Danh mục
+  tag: Thẻ
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Trang chủ
+  categories: Các danh mục
+  tags: Các thẻ
+  archives: Lưu trữ
+  about: Giới thiệu
+
+# the text displayed in the search bar & search results
+search:
+  hint: tìm kiếm
+  cancel: Hủy
+  no_results: Không có kết quả tìm kiếm.
+
+panel:
+  lastmod: Mới cập nhật
+  trending_tags: Các thẻ thịnh hành
+  toc: Mục lục
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Bài viết này được cấp phép bởi tác giả theo giấy phép :LICENSE_NAME.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Một số quyền được bảo lưu.
+  verbose: >-
+    Trừ khi có ghi chú khác, các bài viết đăng trên trang này được cấp phép bởi tác giả theo giấy phép Creative Commons Attribution 4.0 International (CC BY 4.0).
+meta: Trang web này được tạo bởi :PLATFORM với chủ đề :THEME.
+
+not_found:
+  statment: Xin lỗi, chúng tôi đã đặt nhầm URL hoặc đường dẫn trỏ đến một trang nào đó không tồn tại.
+
+notification:
+  update_found: Đã có phiên bản mới của nội dung.
+  update: Cập nhật
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Viết bởi
+  posted: Đăng lúc
+  updated: Cập nhật lúc
+  words: từ
+  pageview_measure: lượt xem
+  read_time:
+    unit: phút
+    prompt: đọc
+  relate_posts: Bài viết liên quan
+  share: Chia sẻ
+  button:
+    next: Mới hơn
+    previous: Cũ hơn
+    copy_code:
+      succeed: Đã sao chép!
+    share_link:
+      title: Sao chép đường dẫn
+      succeed: Đã sao chép đường dẫn thành công!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Bài ghim
+
+# categories page
+categories:
+  category_measure: danh mục
+  post_measure: bài viết

_data/locales/zh-CN.yml

@@ -27,14 +27,6 @@ panel:
   trending_tags: 热门标签
   toc: 文章内容
 
-#  The liquid date format › http://strftime.net/
-date_format:
-  tooltip: '%F, %R %z'
-  post:
-    long: '%F'
-    short: '%m-%d'
-    archive_month: '%m月'
-
 copyright:
   # Shown at the bottom of the post
   license:
@@ -51,20 +43,17 @@ meta: 本站由 :PLATFORM 生成，采用 :THEME 主题。
 
 not_found:
   statment: 抱歉，我们放错了该 URL，或者它指向了不存在的内容。
-  hint_template: :HEAD_BAK尝试再次查找它，或在:ARCHIVES_PAGE上搜索它。
-  head_back: 返回主页
-  archives_page: 归档页面
+
+notification:
+  update_found: 发现新版本的内容。
+  update: 更新
 
 # ----- Posts related labels -----
 
 post:
-  published: 发表于
+  written_by: 作者
+  posted: 发表于
   updated: 更新于
-  timeago:
-    day: 天前
-    hour: 小时前
-    minute: 分钟前
-    just_now: 刚刚
   words: 字
   pageview_measure: 次浏览
   read_time:
@@ -78,11 +67,18 @@ post:
     copy_code:
       succeed: 已复制！
     share_link:
-      title:  分享链接
+      title: 分享链接
       succeed: 链接已复制！
   # pinned prompt of posts list on homepage
   pin_prompt: 顶置
 
+# Date time format.
+# See: <http://strftime.net/>, <https://day.js.org/docs/en/display/format>
+df:
+  post:
+    strftime: '%Y/%m/%d'
+    dayjs: 'YYYY/MM/DD'
+
 # categories page
 categories:
   category_measure: 个分类

_data/share.yml

@@ -13,7 +13,7 @@ platforms:
   -
     type: Telegram
     icon: "fab fa-telegram"
-    link: "https://telegram.me/share?text=TITLE&url=URL"
+    link: "https://t.me/share/url?url=URL&text=TITLE"
 
   # Uncomment below if you need to.
   # -

_includes/assets-origin.html

@@ -0,0 +1,12 @@
+{% comment %} Site static assets origin {% endcomment %}
+{% assign origin = 'cross_origin' %}
+
+{% if site.assets.self_host.enabled %}
+  {% if site.assets.self_host.env %}
+    {% if site.assets.self_host.env == jekyll.environment %}
+      {% assign origin = 'self_host' %}
+    {% endif %}
+  {% else %}
+    {% assign origin = 'self_host' %}
+  {% endif %}
+{% endif %}

_includes/comments.html

@@ -0,0 +1,5 @@
+<!--  The comments switcher -->
+{% if page.comments and site.comments.active %}
+  {% capture path %}comments/{{ site.comments.active }}.html{% endcapture %}
+  {% include {{ path }} %}
+{% endif %}

_includes/comments/disqus.html

@@ -1,7 +1,6 @@
 <!--
   The Disqus lazy loading.
 -->
-
 <div id="disqus_thread" class="pt-2 pb-2">
   <p class="text-center text-muted small">
     Comments powered by <a href="https://disqus.com/">Disqus</a>.
@@ -9,18 +8,18 @@
 </div>
 
 <script type="text/javascript">
+
   var disqus_config = function () {
     this.page.url = '{{ page.url | absolute_url }}';
     this.page.identifier = '{{ page.url }}';
   };
 
   /* Lazy loading */
-
   var disqus_observer = new IntersectionObserver(function (entries) {
     if(entries[0].isIntersecting) {
         (function () {
             var d = document, s = d.createElement('script');
-            s.src = 'https://{{ site.disqus.shortname }}.disqus.com/embed.js';
+            s.src = 'https://{{ site.comments.disqus.shortname }}.disqus.com/embed.js';
             s.setAttribute('data-timestamp', +new Date());
             (d.head || d.body).appendChild(s);
         })();
@@ -32,23 +31,24 @@
   disqus_observer.observe(document.querySelector('#disqus_thread'));
 
   /* Auto switch theme */
-
   function reloadDisqus() {
-    /* Disqus hasn't been loaded */
-    if (typeof DISQUS === "undefined") {
-      return;
-    }
+    if (event.source === window && event.data &&
+      event.data.direction === ModeToggle.ID) {
+      /* Disqus hasn't been loaded */
+      if (typeof DISQUS === "undefined") {
+        return;
+      }
 
-    if (document.readyState == 'complete') {
-      DISQUS.reset({ reload: true, config: disqus_config });
+      if (document.readyState == 'complete') {
+        DISQUS.reset({ reload: true, config: disqus_config });
+      }
     }
   }
 
   const modeToggle = document.querySelector(".mode-toggle");
 
-  if (modeToggle !== null) {
-    modeToggle.addEventListener('click', reloadDisqus);
-    window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', reloadDisqus);
+  if (typeof modeToggle !== "undefined") {
+    window.addEventListener("message", reloadDisqus);
   }
 
 </script>

_includes/comments/giscus.html

@@ -0,0 +1,56 @@
+<!-- https://giscus.app/ -->
+<script type="text/javascript">
+  $(function () {
+    const origin = "https://giscus.app";
+    const iframe = "iframe.giscus-frame";
+    const lightTheme = "light";
+    const darkTheme = "dark_dimmed";
+    let initTheme = lightTheme;
+
+    if ($("html[data-mode=dark]").length > 0
+        || ($("html[data-mode]").length == 0
+            && window.matchMedia("(prefers-color-scheme: dark)").matches)) {
+      initTheme = darkTheme;
+    }
+
+    let giscusAttributes = {
+      "src": "https://giscus.app/client.js",
+      "data-repo": "{{ site.comments.giscus.repo}}",
+      "data-repo-id": "{{ site.comments.giscus.repo_id }}",
+      "data-category": "{{ site.comments.giscus.category }}",
+      "data-category-id": "{{ site.comments.giscus.category_id }}",
+      "data-mapping": "{{ site.comments.giscus.mapping | default: 'pathname' }}",
+      "data-reactions-enabled": "{{ site.comments.giscus.reactions_enabled | default: '1' }}",
+      "data-emit-metadata": "0",
+      "data-theme": initTheme,
+      "data-input-position": "{{ site.comments.giscus.input_position | default: 'bottom' }}",
+      "data-lang": "{{ site.comments.giscus.lang | default: lang }}",
+      "crossorigin": "anonymous",
+      "async": ""
+    };
+
+    let giscusScript = document.createElement("script");
+    Object.entries(giscusAttributes).forEach(([key, value]) => giscusScript.setAttribute(key, value));
+    document.getElementById("tail-wrapper").appendChild(giscusScript);
+
+    addEventListener("message", (event) => {
+      if (event.source === window && event.data &&
+            event.data.direction === ModeToggle.ID) {
+        /* global theme mode changed */
+        const mode = event.data.message;
+        const theme = (mode === ModeToggle.DARK_MODE ? darkTheme : lightTheme);
+
+        const message = {
+          setConfig: {
+            theme: theme
+          }
+        };
+
+        const giscus = document.querySelector(iframe).contentWindow;
+        giscus.postMessage({ giscus: message }, origin);
+      }
+
+    });
+
+  });
+</script>

_includes/comments/utterances.html

@@ -0,0 +1,51 @@
+<!-- https://utteranc.es/ -->
+<script src="https://utteranc.es/client.js"
+        repo="{{ site.comments.utterances.repo }}"
+        issue-term="{{ site.comments.utterances.issue_term }}"
+        crossorigin="anonymous"
+        async>
+</script>
+
+<script type="text/javascript">
+  $(function() {
+    const origin = "https://utteranc.es";
+    const iframe = "iframe.utterances-frame";
+    const lightTheme = "github-light";
+    const darkTheme = "github-dark";
+    let initTheme = lightTheme;
+
+    if ($("html[data-mode=dark]").length > 0
+        || ($("html[data-mode]").length == 0
+            && window.matchMedia("(prefers-color-scheme: dark)").matches)) {
+      initTheme = darkTheme;
+    }
+
+    addEventListener("message", (event) => {
+      let theme;
+
+      /* credit to <https://github.com/utterance/utterances/issues/170#issuecomment-594036347> */
+      if (event.origin === origin) {
+        /* page initial */
+        theme = initTheme;
+
+      } else if (event.source === window && event.data &&
+            event.data.direction === ModeToggle.ID) {
+        /* global theme mode changed */
+        const mode = event.data.message;
+        theme = (mode === ModeToggle.DARK_MODE ? darkTheme : lightTheme);
+
+      } else {
+        return;
+      }
+
+      const message = {
+        type: "set-theme",
+        theme: theme
+      };
+
+      const utterances = document.querySelector(iframe).contentWindow;
+      utterances.postMessage(message, origin);
+    });
+
+  });
+</script>

_includes/css-selector.html

@@ -1,15 +0,0 @@
-<!--
-  CSS selector for site.
--->
-
-<link rel="stylesheet" href="{{ '/assets/css/style.css' | relative_url }}">
-
-{% if site.toc and page.toc %}
-  <link rel="stylesheet"
-    href="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@1.0.1/dist/bootstrap-toc.min.css">
-{% endif %}
-
-{% if page.layout == 'page' or page.layout == 'post' %}
-  <!-- Manific Popup -->
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/magnific-popup@1.1.0/dist/magnific-popup.min.css">
-{% endif %}

_includes/datetime.html

@@ -0,0 +1,15 @@
+<!--
+  Date format snippet
+  See: ${JS_ROOT}/utils/locale-dateime.js
+-->
+
+{% assign wrap_elem = include.wrap | default: 'em' %}
+{% assign df_strftime = site.data.locales[site.lang].df.post.strftime | default: '%d/%m/%Y' %}
+{% assign df_dayjs = site.data.locales[site.lang].df.post.dayjs | default: 'DD/MM/YYYY' %}
+
+<{{ wrap_elem }} class="{% if include.class %}{{ include.class }}{% endif %}"
+    data-ts="{{ include.date | date: '%s' }}"
+    data-df="{{ df_dayjs }}"
+    {% if include.tooltip %}data-toggle="tooltip" data-placement="bottom"{% endif %}>
+  {{ include.date | date: df_strftime }}
+</{{ wrap_elem }}>

_includes/embed/twitch.html

@@ -0,0 +1,4 @@
+<iframe class="embed-video twitch lazyload"
+  src="https://player.twitch.tv/?video={{ include.id }}&parent={{ site.url | split: '://' | last | remove: '/' }}"
+  frameborder="0" allowfullscreen="true"
+  scrolling="no"></iframe>

_includes/embed/youtube.html

@@ -0,0 +1,6 @@
+<iframe class="embed-video youtube lazyload"
+  src="https://www.youtube.com/embed/{{ include.id }}"
+  title="YouTube video player"
+  frameborder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowfullscreen></iframe>

_includes/footer.html

@@ -1,37 +1,36 @@
-<!--
-  The Footer
--->
+<!-- The Footer -->
 
-<footer class="d-flex w-100 justify-content-center">
-  <div class="d-flex justify-content-between align-items-center">
-    <div class="footer-left">
-      <p class="mb-0">
-        © {{ 'now' | date: "%Y" }}
-        <a href="{{ site.social.links[0] }}">{{ site.social.name }}</a>.
-        {% if site.data.locales[lang].copyright.brief %}
-        <span data-toggle="tooltip" data-placement="top"
-          title="{{ site.data.locales[lang].copyright.verbose }}">{{ site.data.locales[lang].copyright.brief }}</span>
-        {% endif %}
-      </p>
-    </div>
+<footer>
+  <div class="container pl-lg-4 pr-lg-4">
+    <div class="d-flex justify-content-between align-items-center text-muted ml-md-3 mr-md-3">
+      <div class="footer-left">
+        <p class="mb-0">
+          © {{ 'now' | date: "%Y" }}
+          <a href="{{ site.social.links[0] }}">{{ site.social.name }}</a>.
+          {% if site.data.locales[site.lang].copyright.brief %}
+          <span data-toggle="tooltip" data-placement="top"
+            title="{{ site.data.locales[site.lang].copyright.verbose }}">{{ site.data.locales[site.lang].copyright.brief }}</span>
+          {% endif %}
+        </p>
+      </div>
 
-    <div class="footer-right">
-      <p class="mb-0">
-        {% capture _platform %}
+      <div class="footer-right">
+        <p class="mb-0">
+
+          {%- capture _platform -%}
           <a href="https://jekyllrb.com" target="_blank" rel="noopener">Jekyll</a>
-        {% endcapture %}
+          {%- endcapture -%}
 
-        {% capture _theme %}
+          {%- capture _theme -%}
           <a href="https://github.com/cotes2020/jekyll-theme-chirpy" target="_blank" rel="noopener">Chirpy</a>
-        {% endcapture %}
+          {%- endcapture -%}
 
-        {{ site.data.locales[lang].meta
-          | default: 'Powered by :PLATFORM with :THEME theme.'
-          | replace: ':PLATFORM', _platform | replace: ':THEME', _theme
-        }}
-
-      </p>
+          {{ site.data.locales[site.lang].meta
+            | default: 'Using the :PLATFORM theme :THEME.'
+            | replace: ':PLATFORM', _platform | replace: ':THEME', _theme
+          }}
+        </p>
+      </div>
     </div>
-
-  </div> <!-- div.d-flex -->
+  </div>
 </footer>

_includes/head.html

@@ -8,12 +8,6 @@
 
   {% if page.layout == 'home' or page.layout == 'post' %}
 
-    <!-- i18n for `_javascript/utils/timeago.js` -->
-    <meta name="day-prompt" content="{{ site.data.locales[lang].post.timeago.day }}">
-    <meta name="hour-prompt" content="{{ site.data.locales[lang].post.timeago.hour }}">
-    <meta name="minute-prompt" content="{{ site.data.locales[lang].post.timeago.minute }}">
-    <meta name="justnow-prompt" content="{{ site.data.locales[lang].post.timeago.just_now }}">
-
     {% if site.google_analytics.pv.proxy_endpoint %}
       <meta name="pv-proxy-endpoint" content="{{ site.google_analytics.pv.proxy_endpoint }}">
     {% endif %}
@@ -24,7 +18,34 @@
 
   {% endif %}
 
-  {% seo title=false %}
+  {% capture seo_tags %}
+    {% seo title=false %}
+  {% endcapture %}
+
+  {% if page.image %}
+    {% assign img = page.image.path | default: page.image %}
+
+    {% unless img contains '://' %}
+      {% assign img_path = page.img_path | append: '/' | append: img | replace: '//', '/' %}
+      {% capture target %}"{{ img | absolute_url }}"{% endcapture %}
+
+      {% if site.img_cdn contains '//' %}
+        <!-- it's a cross-origin URL -->
+        {% capture replacement %}"{{ site.img_cdn }}{{ img_path }}"{% endcapture %}
+      {% else %}
+        <!-- it's a local file path -->
+        {%- capture replacement -%}
+          "{{ site.img_cdn | append: '/' | append: img_path | replace: '//', '/' | absolute_url }}"
+        {%- endcapture -%}
+      {% endif %}
+
+      {% assign seo_tags = seo_tags | replace: target, replacement %}
+
+    {% endunless %}
+
+  {% endif %}
+
+  {{ seo_tags }}
 
   <title>
   {%- unless page.layout == "home" -%}
@@ -35,12 +56,24 @@
 
   {% include favicons.html %}
 
-  <!-- Google Fonts -->
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin="anonymous">
-  <link rel="dns-prefetch" href="https://fonts.gstatic.com">
+  {% if site.resources.ignore_env != jekyll.environment and site.resources.self_hosted %}
+
+    <link href="{{ site.data.assets[origin].webfonts | relative_url }}" rel="stylesheet">
+
+  {% else %}
+
+    {% for cdn in site.data.assets[origin].cdns %}
+      <link rel="preconnect" href="{{ cdn.url }}" {{ cdn.args }}>
+      <link rel="dns-prefetch" href="{{ cdn.url }}" {{ cdn.args }}>
+    {% endfor %}
+
+    <link rel="stylesheet" href="{{ site.data.assets[origin].webfonts | relative_url }}">
+
+  {% endif %}
 
   <!-- GA -->
-  {% if jekyll.environment == 'production' %}
+  {% if jekyll.environment == 'production'
+      and site.google_analytics.id != empty and site.google_analytics.id %}
     <link rel="preconnect" href="https://www.google-analytics.com" crossorigin="use-credentials">
     <link rel="dns-prefetch" href="https://www.google-analytics.com">
 
@@ -49,27 +82,34 @@
 
     {% if site.google_analytics.pv.proxy_endpoint %}
       {% assign proxy_url = site.google_analytics.pv.proxy_endpoint
-        | replace: "https://", "" | split: "/" | first | prepend: "https://" %}
-
+          | replace: "https://", "" | split: "/" | first | prepend: "https://" %}
       <link rel="preconnect" href="{{ proxy_url }}" crossorigin="use-credentials">
       <link rel="dns-prefetch" href="{{ proxy_url }}">
     {% endif %}
   {% endif %}
 
-  <!-- jsDelivr CDN -->
-  <link rel="preconnect" href="https://cdn.jsdelivr.net">
-  <link rel="dns-prefetch" href="https://cdn.jsdelivr.net">
-
   <!-- Bootstrap -->
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.0.0/dist/css/bootstrap.min.css">
+  <link rel="stylesheet" href="{{ site.data.assets[origin].bootstrap.css | relative_url}}">
 
   <!-- Font Awesome -->
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css">
+  <link rel="stylesheet" href="{{ site.data.assets[origin].fontawesome.css | relative_url }}">
 
-  {% include css-selector.html %}
+  <link rel="stylesheet" href="{{ '/assets/css/style.css' | relative_url }}">
+
+  {% if site.toc and page.toc %}
+    <link rel="stylesheet" href="{{ site.data.assets[origin].bootstrap-toc.css | relative_url }}">
+  {% endif %}
+
+  {% if page.layout == 'page' or page.layout == 'post' %}
+    <!-- Manific Popup -->
+    <link rel="stylesheet" href="{{ site.data.assets[origin].magnific-popup.css | relative_url }}">
+  {% endif %}
 
   <!-- JavaScript -->
 
-  <script src="https://cdn.jsdelivr.net/npm/jquery@3/dist/jquery.min.js"></script>
+  <script src="{{ site.data.assets[origin].jquery.js | relative_url }}"></script>
 
+  {% unless site.theme_mode %}
+    {% include mode-toggle.html %}
+  {% endunless %}
 </head>

_includes/js-selector.html

@@ -4,17 +4,41 @@
 
 <!-- layout specified -->
 
-{% if page.layout == 'home' or page.layout == 'post' %}
+{% if page.layout == 'post' %}
   {% if site.google_analytics.pv.proxy_endpoint or site.google_analytics.pv.cache_path %}
     <!-- pv-report needs countup.js -->
-    <script async src="https://cdn.jsdelivr.net/npm/countup.js@1.9.3/dist/countUp.min.js"></script>
+    <script async src="{{ site.data.assets[origin].countup.js | relative_url }}"></script>
     <script defer src="{{ '/assets/js/dist/pvreport.min.js' | relative_url }}"></script>
   {% endif %}
 {% endif %}
 
 {% if page.layout == 'post' or page.layout == 'page' %}
-  <!-- image lazy-loading & popup -->
-  <script src="https://cdn.jsdelivr.net/combine/npm/lozad/dist/lozad.min.js,npm/magnific-popup@1/dist/jquery.magnific-popup.min.js,npm/clipboard@2/dist/clipboard.min.js"></script>
+  <!-- image lazy-loading & popup & clipboard -->
+  {% assign _urls = site.data.assets[origin].magnific-popup.js
+      | append: ',' | append: site.data.assets[origin].lazysizes.js
+      | append: ',' | append: site.data.assets[origin].clipboard.js
+  %}
+
+  {% include jsdelivr-combine.html urls=_urls %}
+{% endif %}
+
+{% if page.layout == 'home'
+    or page.layout == 'post'
+    or page.layout == 'archives'
+    or page.layout == 'category'
+    or page.layout == 'tag' %}
+
+  {% assign locale = site.lang | split: '-' | first %}
+
+  {% assign _urls = site.data.assets[origin].dayjs.js.common
+      | append: ',' | append: site.data.assets[origin].dayjs.js.locale
+      | replace: ':LOCALE', locale
+      | append: ',' | append: site.data.assets[origin].dayjs.js.relativeTime
+      | append: ',' | append: site.data.assets[origin].dayjs.js.localizedFormat
+  %}
+
+  {% include jsdelivr-combine.html urls=_urls %}
+
 {% endif %}
 
 {% if page.layout == 'home'
@@ -22,12 +46,16 @@
     or page.layout == 'post'
     or page.layout == 'page' %}
   {% assign type = page.layout %}
+{% elsif page.layout == 'archives'
+    or page.layout == 'category'
+    or page.layout == 'tag' %}
+  {% assign type = "misc" %}
 {% else %}
   {% assign type = "commons" %}
 {% endif %}
 
-{% assign js = type | prepend: '/assets/js/dist/' | append: '.min.js' %}
-<script defer src="{{ js | relative_url }}"></script>
+{% capture script %}/assets/js/dist/{{ type }}.min.js{% endcapture %}
+<script defer src="{{ script | relative_url }}"></script>
 
 {% if page.math %}
   <!-- MathJax -->
@@ -46,22 +74,25 @@
     }
   };
   </script>
-  <script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
-  <script type="text/javascript" id="MathJax-script" async
-    src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js">
+  <script src="{{ site.data.assets[origin].polyfill.js | relative_url }}"></script>
+  <script id="MathJax-script" async src="{{ site.data.assets[origin].mathjax.js | relative_url }}">
   </script>
 {% endif %}
 
 <!-- commons -->
 
-<script src="https://cdn.jsdelivr.net/combine/npm/popper.js@1.16.1,npm/bootstrap@4/dist/js/bootstrap.min.js"></script>
+<script src="{{ site.data.assets[origin].bootstrap.js | relative_url }}"></script>
 
 {% if jekyll.environment == 'production' %}
   <!-- PWA -->
-  <script defer src="{{ '/app.js' | relative_url }}"></script>
+  {% if site.pwa.enabled %}
+    <script defer src="{{ '/app.js' | relative_url }}"></script>
+  {% else %}
+    <script defer src="{{ '/unregister.js' | relative_url }}"></script>
+  {% endif %}
 
   <!-- GA -->
-  {% if site.google_analytics.id %}
+  {% if site.google_analytics.id != empty and site.google_analytics.id %}
     {% include google-analytics.html %}
   {% endif %}
 

_includes/jsdelivr-combine.html

@@ -0,0 +1,32 @@
+{% assign urls = include.urls | split: ',' %}
+
+{% assign combined_urls = nil %}
+
+{% assign domain = 'https://cdn.jsdelivr.net/' %}
+
+{% for url in urls %}
+
+  {% if url contains domain %}
+    {% assign url_snippet = url | slice: domain.size, url.size %}
+
+    {% if combined_urls %}
+      {% assign combined_urls = combined_urls | append: ',' | append: url_snippet %}
+    {% else %}
+      {% assign combined_urls = domain | append: 'combine/' | append: url_snippet %}
+    {% endif %}
+
+  {% elsif url contains '//' %}
+
+    <script src="{{ url }}"></script>
+
+  {% else %}
+
+    <script src="{{ url | relative_url }}"></script>
+
+  {% endif %}
+
+{% endfor %}
+
+{% if combined_urls %}
+  <script src="{{ combined_urls }}"></script>
+{% endif %}

_includes/lang.html

@@ -1,8 +0,0 @@
-{% comment %}
-Detect appearance language and return it through variable "lang"
-{% endcomment %}
-{% if site.data.locales[site.lang] %}
-  {% assign lang = site.lang %}
-{% else %}
-  {% assign lang = 'en' %}
-{% endif %}

_includes/language-alias.html

@@ -41,8 +41,6 @@
     {{ 'Perl' }}
   {% when 'php','php3','php4','php5' %}
     {{ 'PHP' }}
-  {% when 'plaintext', 'text' %}
-    {{ 'Text' }}
   {% when 'py' %}
     {{ 'Python' }}
   {% when 'rb' %}
@@ -65,7 +63,7 @@
     {{ 'Vue.js' }}
   {% when 'yml' %}
     {{ 'YAML' }}
-  {% when 'css', 'html', 'scss', 'ssh', 'toml', 'xml', 'yaml' %}
+  {% when 'css', 'html', 'scss', 'ssh', 'toml', 'xml', 'yaml', 'json' %}
     {{ _lang | upcase }}
   {% else %}
     {{ _lang | capitalize }}

_includes/mermaid.html

@@ -2,14 +2,41 @@
   mermaid-js loader
 -->
 
-<script src="https://cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js"></script>
+<script src="{{ site.data.assets[origin].mermaid.js | relative_url }}"></script>
+
 <script>
-  $(function() {
+  (function () {
+
+    function updateMermaid(event) {
+      if (event.source === window && event.data &&
+        event.data.direction === ModeToggle.ID) {
+
+        const mode = event.data.message;
+
+        if (typeof mermaid === "undefined") {
+          return;
+        }
+
+        let expectedTheme = (mode === ModeToggle.DARK_MODE ? "dark" : "default");
+        let config = {theme: expectedTheme};
+
+        /* Re-render the SVG › <https://github.com/mermaid-js/mermaid/issues/311#issuecomment-332557344> */
+        $(".mermaid").each(function () {
+          let svgCode = $(this).prev().children().html();
+          $(this).removeAttr("data-processed");
+          $(this).html(svgCode);
+        });
+
+        mermaid.initialize(config);
+        mermaid.init(undefined, ".mermaid");
+      }
+    }
+
     let initTheme = "default";
 
-    if ($("html[mode=dark]").length > 0
-      || ($("html[mode]").length == 0
-        && window.matchMedia("(prefers-color-scheme: dark)").matches ) ) {
+    if ($("html[data-mode=dark]").length > 0
+      || ($("html[data-mode]").length == 0
+        && window.matchMedia("(prefers-color-scheme: dark)").matches)) {
       initTheme = "dark";
     }
 
@@ -17,13 +44,16 @@
       theme: initTheme  /* <default|dark|forest|neutral> */
     };
 
-    /* Markdown converts to HTML */
-    $("pre").has("code.language-mermaid").each(function() {
+    /* Create mermaid tag */
+    $("pre").has("code.language-mermaid").each(function () {
       let svgCode = $(this).children().html();
       $(this).addClass("unloaded");
-      $(this).after(`<div class=\"mermaid\">${svgCode}</div>`);
+      $(this).after(`<pre class=\"mermaid\">${svgCode}</pre>`);
     });
 
     mermaid.initialize(mermaidConf);
-  });
+
+    window.addEventListener("message", updateMermaid);
+  })();
+
 </script>

_includes/mode-toggle.html

@@ -2,14 +2,13 @@
   Switch the mode between dark and light.
 -->
 
-<i class="mode-toggle fas fa-adjust"></i>
-
 <script type="text/javascript">
-
   class ModeToggle {
     static get MODE_KEY() { return "mode"; }
+    static get MODE_ATTR() { return "data-mode"; }
     static get DARK_MODE() { return "dark"; }
     static get LIGHT_MODE() { return "light"; }
+    static get ID() { return "mode-toggle"; }
 
     constructor() {
       if (this.hasMode) {
@@ -24,10 +23,10 @@
         }
       }
 
-      var self = this;
+      let self = this;
 
       /* always follow the system prefers */
-      this.sysDarkPrefers.addListener(function() {
+      this.sysDarkPrefers.addEventListener("change", () => {
         if (self.hasMode) {
           if (self.isDarkMode) {
             if (!self.isSysDarkPrefer) {
@@ -43,34 +42,19 @@
           self.clearMode();
         }
 
-        self.updateMermaid();
+        self.notify();
+
       });
 
     } /* constructor() */
 
-
-    setDark() {
-      $('html').attr(ModeToggle.MODE_KEY, ModeToggle.DARK_MODE);
-      sessionStorage.setItem(ModeToggle.MODE_KEY, ModeToggle.DARK_MODE);
-    }
-
-    setLight() {
-      $('html').attr(ModeToggle.MODE_KEY, ModeToggle.LIGHT_MODE);
-      sessionStorage.setItem(ModeToggle.MODE_KEY, ModeToggle.LIGHT_MODE);
-    }
-
-    clearMode() {
-      $('html').removeAttr(ModeToggle.MODE_KEY);
-      sessionStorage.removeItem(ModeToggle.MODE_KEY);
-    }
-
     get sysDarkPrefers() { return window.matchMedia("(prefers-color-scheme: dark)"); }
 
     get isSysDarkPrefer() { return this.sysDarkPrefers.matches; }
 
-    get isDarkMode() { return this.mode == ModeToggle.DARK_MODE; }
+    get isDarkMode() { return this.mode === ModeToggle.DARK_MODE; }
 
-    get isLightMode() { return this.mode == ModeToggle.LIGHT_MODE; }
+    get isLightMode() { return this.mode === ModeToggle.LIGHT_MODE; }
 
     get hasMode() { return this.mode != null; }
 
@@ -79,67 +63,67 @@
     /* get the current mode on screen */
     get modeStatus() {
       if (this.isDarkMode
-        || (!this.hasMode && this.isSysDarkPrefer) ) {
+        || (!this.hasMode && this.isSysDarkPrefer)) {
         return ModeToggle.DARK_MODE;
       } else {
         return ModeToggle.LIGHT_MODE;
       }
     }
 
-    updateMermaid() {
-      if (typeof mermaid !== "undefined") {
-        let expectedTheme = (this.modeStatus === ModeToggle.DARK_MODE? "dark" : "default");
-        let config = { theme: expectedTheme };
-
-        /* re-render the SVG › <https://github.com/mermaid-js/mermaid/issues/311#issuecomment-332557344> */
-        $(".mermaid").each(function() {
-          let svgCode = $(this).prev().children().html();
-          $(this).removeAttr("data-processed");
-          $(this).html(svgCode);
-        });
-
-        mermaid.initialize(config);
-        mermaid.init(undefined, ".mermaid");
-      }
+    setDark() {
+      $('html').attr(ModeToggle.MODE_ATTR, ModeToggle.DARK_MODE);
+      sessionStorage.setItem(ModeToggle.MODE_KEY, ModeToggle.DARK_MODE);
     }
 
-    flipMode() {
-      if (this.hasMode) {
-        if (this.isSysDarkPrefer) {
-          if (this.isLightMode) {
-            this.clearMode();
-          } else {
-            this.setLight();
-          }
+    setLight() {
+      $('html').attr(ModeToggle.MODE_ATTR, ModeToggle.LIGHT_MODE);
+      sessionStorage.setItem(ModeToggle.MODE_KEY, ModeToggle.LIGHT_MODE);
+    }
 
-        } else {
-          if (this.isDarkMode) {
-            this.clearMode();
-          } else {
-            this.setDark();
-          }
-        }
+    clearMode() {
+      $('html').removeAttr(ModeToggle.MODE_ATTR);
+      sessionStorage.removeItem(ModeToggle.MODE_KEY);
+    }
 
-      } else {
-        if (this.isSysDarkPrefer) {
-          this.setLight();
-        } else {
-          this.setDark();
-        }
-      }
-
-      this.updateMermaid();
-
-    } /* flipMode() */
+    /* Notify another plugins that the theme mode has changed */
+    notify() {
+      window.postMessage({
+        direction: ModeToggle.ID,
+        message: this.modeStatus
+      }, "*");
+    }
 
   } /* ModeToggle */
 
-  let toggle = new ModeToggle();
+  const toggle = new ModeToggle();
 
-  $(".mode-toggle").click(function() {
+  function flipMode() {
+    if (toggle.hasMode) {
+      if (toggle.isSysDarkPrefer) {
+        if (toggle.isLightMode) {
+          toggle.clearMode();
+        } else {
+          toggle.setLight();
+        }
 
-    toggle.flipMode();
+      } else {
+        if (toggle.isDarkMode) {
+          toggle.clearMode();
+        } else {
+          toggle.setDark();
+        }
+      }
 
-  });
+    } else {
+      if (toggle.isSysDarkPrefer) {
+        toggle.setLight();
+      } else {
+        toggle.setDark();
+      }
+    }
+
+    toggle.notify();
+
+  } /* flipMode() */
 
 </script>

_includes/no-zero-date.html

@@ -1,13 +0,0 @@
-{% comment %}
-  Remove the zero padding from a month/day string
-{% endcomment %}
-
-{% assign ret = include.date_str %}
-{% assign _first_chat = ret | slice: 0 %}
-
-{% if _first_chat == '0' %}
-  {% assign _last_idx = ret.size | minus: 1 %}
-  {% assign ret = ret | slice: 1, _last_idx %}
-{% endif %}
-
-{{ ret | replace: ' 0', ' ' }}

_includes/panel.html

@@ -1,59 +0,0 @@
-<!--
-  The Pannel on right side (Desktop views)
--->
-
-{% include lang.html %}
-
-<div id="panel-wrapper" class="col-xl-3 pl-2 text-muted topbar-down">
-
-  <div class="access">
-
-  {% include update-list.html %}
-
-  {% if update_list.size > 0 %}
-
-    <div id="access-lastmod" class="post">
-      <span>{{- site.data.locales[lang].panel.lastmod -}}</span>
-      <ul class="post-content pl-0 pb-1 ml-1 mt-2">
-
-      {% for item in update_list %}
-        {% assign index = item | split: "::" | last | plus: 0 %}
-        {% assign post = site.posts[index] %}
-        {% assign url = post.url | relative_url %}
-        <li><a href="{{ url }}">{{ post.title }}</a></li>
-      {% endfor %}
-
-      </ul>
-    </div> <!-- #access-lastmod -->
-
-  {% endif %}
-
-  {% include trending-tags.html %}
-
-  {% if trending_tags.size > 0 %}
-    <div id="access-tags">
-      <span>{{- site.data.locales[lang].panel.trending_tags -}}</span>
-      <div class="d-flex flex-wrap mt-3 mb-1 mr-3">
-
-      {% for tag_name in trending_tags %}
-        {% assign url = tag_name | slugify | url_encode | prepend: "/tags/" | append: "/" %}
-        <a class="post-tag" href="{{ url | relative_url }}">{{ tag_name }}</a>
-      {% endfor %}
-
-      </div>
-    </div>
-  {% endif %}
-  </div> <!-- .access -->
-
-  {% if include.toc %}
-    <!-- BS-toc.js will be loaded at medium priority -->
-    <script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@1.0.1/dist/bootstrap-toc.min.js"></script>
-    <div id="toc-wrapper" class="pl-0 pr-4 mb-5">
-      <span class="pl-3 pt-2 mb-2">
-      {{- site.data.locales[lang].panel.toc -}}
-      </span>
-      <nav id="toc" data-toggle="toc"></nav>
-    </div>
-  {% endif %}
-
-</div> <!-- #panel-wrapper -->

_includes/post-nav.html

@@ -5,26 +5,26 @@
 <div class="post-navigation d-flex justify-content-between">
   {% if page.previous.url %}
   <a href="{{ site.baseurl }}{{ page.previous.url }}" class="btn btn-outline-primary"
-    prompt="{{ site.data.locales[lang].post.button.previous }}">
+    prompt="{{ site.data.locales[site.lang].post.button.previous }}">
     <p>{{ page.previous.title }}</p>
   </a>
   {% else %}
-  <span class="btn btn-outline-primary disabled"
-    prompt="{{ site.data.locales[lang].post.button.previous }}">
+  <div class="btn btn-outline-primary disabled"
+    prompt="{{ site.data.locales[site.lang].post.button.previous }}">
     <p>-</p>
-  </span>
+  </div>
   {% endif %}
 
   {% if page.next.url %}
   <a href="{{ site.baseurl }}{{page.next.url}}" class="btn btn-outline-primary"
-    prompt="{{ site.data.locales[lang].post.button.next }}">
+    prompt="{{ site.data.locales[site.lang].post.button.next }}">
     <p>{{ page.next.title }}</p>
   </a>
   {% else %}
-  <span class="btn btn-outline-primary disabled"
-    prompt="{{ site.data.locales[lang].post.button.next }}">
+  <div class="btn btn-outline-primary disabled"
+    prompt="{{ site.data.locales[site.lang].post.button.next }}">
     <p>-</p>
-  </span>
+  </div>
   {% endif %}
 
 </div>

_includes/post-paginator.html

@@ -2,7 +2,7 @@
   The paginator for post list on HomgPage.
 -->
 
-<ul class="pagination align-items-center mt-4 mb-0 pl-lg-2">
+<ul class="pagination align-items-center mt-4 pl-lg-2">
   <!-- left arrow -->
   {% if paginator.previous_page %}
     {% assign prev_url = paginator.previous_page_path | relative_url %}
@@ -47,7 +47,7 @@
     {% if show %}
       <!-- show number -->
       <li class="page-item {% if i == paginator.page %} active{% endif %}">
-        <a class="page-link btn-box-shadow" href="{{ site.baseurl }}/{% if i > 1%}page{{ i }}/{% endif %}">{{ i }}</a>
+        <a class="page-link btn-box-shadow" href="{% if i > 1 %}{{ site.paginate_path | replace: ':num', i | relative_url }}{% else %}{{ '/' | relative_url }}{% endif %}">{{ i }}</a>
       </li>
     {% else %}
       <!-- hide number -->

_includes/post-sharing.html

@@ -3,10 +3,10 @@
 -->
 
 <div class="share-wrapper">
-  <span class="share-label text-muted mr-1">{{ site.data.locales[lang].post.share }}</span>
+  <span class="share-label text-muted mr-1">{{ site.data.locales[site.lang].post.share }}</span>
   <span class="share-icons">
     {% capture title %}{{ page.title }} - {{ site.title }}{% endcapture %}
-    {% assign url = page.url | absolute_url %}
+    {% assign url = page.url | absolute_url | url_encode %}
 
     {% for share in site.data.share.platforms %}
       {% assign link = share.link | replace: 'TITLE', title | replace: 'URL', url %}
@@ -18,8 +18,8 @@
 
     <i id="copy-link" class="fa-fw fas fa-link small"
         data-toggle="tooltip" data-placement="top"
-        title="{{ site.data.locales[lang].post.button.share_link.title }}"
-        title-succeed="{{ site.data.locales[lang].post.button.share_link.succeed }}">
+        title="{{ site.data.locales[site.lang].post.button.share_link.title }}"
+        data-title-succeed="{{ site.data.locales[site.lang].post.button.share_link.succeed }}">
     </i>
 
   </span>

_includes/read-time.html

@@ -16,15 +16,15 @@
 {% endunless %}
 
 {% capture read_prompt %}
-  {{- site.data.locales[lang].post.read_time.prompt -}}
+  {{- site.data.locales[site.lang].post.read_time.prompt -}}
 {% endcapture %}
 
 <!-- return element -->
 <span class="readtime" data-toggle="tooltip" data-placement="bottom"
-  title="{{ words }} {{ site.data.locales[lang].post.words }}">
-  {{- read_time -}}{{" "}}{{- site.data.locales[lang].post.read_time.unit -}}
+  title="{{ words }} {{ site.data.locales[site.lang].post.words }}">
+  <em>{{- read_time -}}{{" "}}{{- site.data.locales[site.lang].post.read_time.unit -}}</em>
   {%- if include.prompt -%}
-    {% assign _prompt_words = read_prompt | number_of_words: 'auto' %}
-    {% unless _prompt_words > 1 %}{{" "}}{% endunless %}{{ read_prompt }}
+    {%- assign _prompt_words = read_prompt | number_of_words: 'auto' -%}
+    {%- unless _prompt_words > 1 -%}{{ " " }}{%- endunless -%}{{ read_prompt }}
   {%- endif -%}
 </span>

_includes/refactor-content.html

@@ -9,10 +9,11 @@
   we suround the markdown table with `<div class="table-wrapper">` and `</div>`
 -->
 
-{% if _content contains '<table>' %}
+{% if _content contains '<table' %}
   {% assign _content = _content
-    | replace: '<table>', '<div class="table-wrapper"><table>'
+    | replace: '<table', '<div class="table-wrapper"><table'
     | replace: '</table>', '</table></div>'
+    | replace: '<code><div class="table-wrapper">', '<code>'
     | replace: '</table></div></code>', '</table></code>'
   %}
 {% endif %}
@@ -30,75 +31,165 @@
   %}
 {% endif %}
 
-<!-- Add attribute 'hide-bullet' to the checkbox list -->
-
-{% if _content contains '<li class="task-list-item"><' %}
+<!-- Change the icon of checkbox -->
+{% if _content contains '<input type="checkbox"' %}
   {% assign _content = _content
-    | replace: '"task-list-item"><', '"task-list-item" hide-bullet><'
+    | replace:
+        '<input type="checkbox" class="task-list-item-checkbox" disabled="disabled" checked="checked" />',
+        '<i class="fas fa-check-circle fa-fw checked"></i>'
+    | replace:
+        '<input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />',
+        '<i class="far fa-circle fa-fw"></i>'
   %}
 {% endif %}
 
-
 <!-- images -->
 
-{% if _content contains '<img src="' %}
+{% assign IMG_TAG = '<img ' %}
 
-  <!-- add CDN prefix if it exists -->
+{% if _content contains IMG_TAG %}
+  {% assign _img_content = nil %}
+  {% assign _img_snippets = _content | split: IMG_TAG %}
 
-  {% if site.img_cdn != '' %}
-    {% assign img_path_replacement = '<img src="' | append: site.img_cdn | append: '/' %}
+  <!-- CDN URL -->
+  {% if site.img_cdn %}
+    {% if site.img_cdn contains '//' %}
+      {% assign _path_prefix = site.img_cdn %}
+    {% else %}
+      {% assign _path_prefix = site.img_cdn | relative_url %}
+    {% endif %}
   {% else %}
-    {% assign img_path_replacement = '<img src="' | append: site.baseurl | append: '/' %}
+    {% assign _path_prefix = site.baseurl %}
   {% endif %}
 
-  {% assign _content = _content | replace: '<img src="/', img_path_replacement %}
+  <!-- Add image path -->
+  {% if page.img_path %}
+    {% assign _path = page.img_path | append: '/' | replace: '//', '/' %}
+    {% assign _path_prefix = _path_prefix | append: _path %}
+  {% endif %}
 
-  <!-- lazy-load images <https://github.com/ApoorvSaxena/lozad.js#usage> -->
-
-  {% assign _content = _content | replace: '<img src="', '<img data-proofer-ignore data-src="' %}
-
-  <!-- add image placehoder to prevent layout reflow -->
-
-  {% assign _img_content = nil %}
-
-  {% assign _images = _content | split: '<img ' %}
-
-  {% for _img in _images %}
+  {% for _img_snippet in _img_snippets %}
     {% if forloop.first %}
-      {% assign _img_content = _img %}
+      {% assign _img_content = _img_snippet %}
       {% continue %}
     {% endif %}
 
+    {% assign _left = _img_snippet | split: '>' | first %}
+    {% assign _right = _img_snippet | remove: _left %}
+
+    {% unless _left contains 'src=' %}
+      {% continue %}
+    {% endunless %}
+
+    {% assign _left = _left | remove: ' /' | replace: ' w=', ' width=' | replace: ' h=', ' height=' %}
+    {% assign _attrs = _left | split: '" ' %}
+
     {% assign _width = nil %}
     {% assign _height = nil %}
-    {% assign _attrs = _img | split: '>' | first | split: ' ' %}
+    {% assign _lqip = nil %}
+    {% assign _class = nil %}
 
     {% for _attr in _attrs %}
-      {% capture _key %}{{ _attr | split: '=' | first }}{% endcapture %}
-      {% capture _value %}{{ _attr | split: '=' | last | replace: '"', '' }}{% endcapture %}
+      {% unless _attr contains '=' %}
+        {% continue %}
+      {% endunless %}
+
+      {% assign _pair = _attr | remove: '"' | split: '=' %}
+      {% capture _key %}{{ _pair | first }}{% endcapture %}
+      {% capture _value %}{{ _pair | last }}{% endcapture %}
 
       {% case _key %}
         {% when 'width' %}
           {% assign _width = _value %}
         {% when 'height' %}
           {% assign _height = _value %}
+        {% when 'src' %}
+          {% assign _src = _value %}
+        {% when 'lqip' %}
+          {% assign _lqip = _value %}
+        {% when 'class' %}
+          {% assign _class = _value %}
       {% endcase %}
 
-      {% if _width and _height %}
-        {% capture _svg %}data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 {{_width}} {{_height}}'%3E%3C/svg%3E{% endcapture %}
-        {% assign _img_content = _img_content | append: '<img src="' | append: _svg | append: '" ' | append: _img %}
-        {% break %}
-      {% endif %}
-
     {% endfor %}
 
-    {% unless _width and _height %}
-      {% assign _img_content = _img_content | append: '<img ' | append: _img %}
+    <!-- take out classes -->
+    {% if _class %}
+      {% capture _old_class %}class="{{ _class }}"{% endcapture %}
+      {% assign _left = _left | remove: _old_class %}
+    {% endif %}
+
+    {% assign _final_src = nil %}
+
+    {% unless _src contains '//' %}
+      {% assign _final_src = _path_prefix | append: _src %}
+      {% capture _src_from %}"{{ _src }}"{% endcapture %}
+      {% capture _src_to %}"{{ _final_src }}"{% endcapture %}
+      {% assign _left = _left | replace: _src_from, _src_to %}
     {% endunless %}
 
+    {% if _lqip %}
+      {% unless _lqip contains ':' %}
+        {% assign _final_lqip = _path_prefix | append: _lqip %}
+        {% capture _lqip_from %}"{{ _lqip }}"{% endcapture %}
+        {% capture _lqip_to %}"{{ _final_lqip }}"{% endcapture %}
+        {% assign _left = _left | replace: _lqip_from, _lqip_to %}
+      {% endunless %}
+    {% endif %}
+
+    <!-- lazy-load images <https://github.com/aFarkas/lazysizes#readme> -->
+    {% assign _left = _left | replace: 'src=', 'data-src=' %}
+    {% if _left contains 'class=' %}
+      {% assign _left = _left | replace: 'class="', 'class="lazyload '%}
+    {% else %}
+      {% assign _left = _left | append: ' class="lazyload"' %}
+    {% endif %}
+
+    <!-- add image placeholder -->
+    {% if _lqip %}
+      {% assign _left = _left | replace: ' lqip=', ' data-lqip="true" src=' %}
+    {% else %}
+      {% if _width and _height %}
+        <!-- add SVG placehoder -->
+        {%- capture _svg -%}
+          src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 {{ _width  }} {{ _height }}'%3E%3C/svg%3E"
+        {%- endcapture -%}
+        {% assign _left =  _svg | append: ' ' | append: _left %}
+        {% assign _class = _class | append: ' shimmer' %}
+      {% endif %}
+    {% endif %}
+
+    <!-- Bypass the HTML-proofer test -->
+    {% assign _left = _left | append: ' data-proofer-ignore' %}
+
+    <!-- make sure the `<img>` is wrapped by `<a>` -->
+    {% assign _parent = _right | slice: 1, 4 %}
+
+    {% if _parent == '</a>' %}
+      <!-- add class to exist <a> tag -->
+      {% assign _size = _img_content | size | minus: 1 %}
+      {% capture _class %}
+        class="img-link{% unless _lqip %} shimmer{% endunless %}"
+      {% endcapture %}
+      {% assign _img_content = _img_content | slice: 0, _size | append: _class | append: '>'  %}
+
+    {% else %}
+      <!-- create the image wrapper -->
+      {%- capture _wrapper_start -%}
+        <a href="{{ _final_src | default: _src  }}" class="popup img-link {{ _class }}">
+      {%- endcapture -%}
+      {% assign _img_content = _img_content | append: _wrapper_start %}
+      {% assign _right = _right | prepend: '></a' %}
+    {% endif %}
+
+    <!-- combine -->
+    {% assign _img_content = _img_content | append: IMG_TAG | append: _left | append: _right %}
+
   {% endfor %}
 
-  {% assign _content = _img_content %}
+  {% if _img_content %}
+    {% assign _content = _img_content %}
+  {% endif %}
 
 {% endif %}
 
@@ -118,23 +209,23 @@
       {% assign _left = _snippet | split: '><' | last%}
 
       {% if _left contains 'file="' %}
-        {% assign _text = _left | split: 'file="' | last | split: '"' | first %}
+        {% assign _label_text = _left | split: 'file="' | last | split: '"' | first %}
         {% assign _label_icon = 'far fa-file-code' %}
       {% else %}
         {% assign _lang = _left | split: 'language-' | last | split: ' ' | first %}
-        {% capture _text %}{% include language-alias.html language=_lang %}{% endcapture %}
+        {% capture _label_text %}{% include language-alias.html language=_lang %}{% endcapture %}
         {% assign _label_icon = 'fas fa-code small' %}
       {% endif %}
 
       {% capture _label %}
-        <span text-data="{{ _text }}"><i class="fa-fw {{ _label_icon }}"></i></span>
+        <span data-label-text="{{ _label_text | strip }}"><i class="{{ _label_icon }}"></i></span>
       {% endcapture %}
 
       {% assign _new_content = _new_content | append: _snippet
           | append: '<div class="code-header">'
           | append: _label
-          | append: '<button aria-label="copy" title-succeed="'
-          | append: site.data.locales[lang].post.button.copy_code.succeed
+          | append: '<button aria-label="copy" data-title-succeed="'
+          | append: site.data.locales[site.lang].post.button.copy_code.succeed
           | append: '"><i class="far fa-clipboard"></i></button></div>'
           | append: '<div class="highlight"><code>'
       %}
@@ -147,6 +238,92 @@
 
 {% endif %}
 
+<!-- Create heading anchors -->
+
+{% assign heading_levels = '2,3,4,5' | split: ',' %}
+{% assign _heading_content = _content %}
+
+{% for level in heading_levels %}
+  {% capture mark_start %}<h{{ level }} id="{% endcapture %}
+  {% capture mark_end %}</h{{ level }}>{% endcapture %}
+
+  {% if _heading_content contains mark_start %}
+    {% assign _new_content = nil %}
+    {% assign heading_snippets = _heading_content | split: mark_start %}
+
+    {% for snippet in heading_snippets %}
+      {% if forloop.first %}
+        {% assign _new_content = snippet %}
+        {% continue %}
+      {% endif %}
+
+      {% assign id = snippet | split: '"' | first %}
+      {% capture anchor %}<a href="#{{ id }}" class="anchor text-muted"><i class="fas fa-hashtag"></i></a>{% endcapture %}
+
+      {% assign left = snippet | split: mark_end | first %}
+      {% assign right = snippet | slice: left.size, snippet.size %}
+      {% assign left = left | replace_first: '">', '"><span class="mr-2">' | append: '</span>' %}
+
+      {% assign _new_content = _new_content | append: mark_start
+          | append: left | append: anchor | append: right
+      %}
+
+    {% endfor %}
+
+    {% assign _heading_content = _new_content %}
+
+  {% endif %}
+{% endfor %}
+
+{% assign _content = _heading_content %}
+
+<!-- Wrap prompt element of blockquote with the <div> tag -->
+
+{% assign blockquote_start = '<blockquote class=' %}
+{% assign blockquote_end = '</blockquote>' %}
+{% assign cls_prefix = 'prompt-' %}
+
+{% if _content contains blockquote_start %}
+
+  {% assign _prompt_content = nil %}
+  {% assign _prompt_snippets = _content | split: blockquote_start %}
+
+  {% for _snippet in _prompt_snippets %}
+
+    {% if forloop.first %}
+      {% assign _prompt_content =  _snippet %}
+      {% continue %}
+    {% endif %}
+
+    {% assign left = _snippet | split: blockquote_end | first %}
+    {% assign right = _snippet | slice: left.size, _snippet.size %}
+
+    {% assign cls_str = left | split: '>' | first %}
+    {% assign cls_array = cls_str | remove: '"' | split: ' ' %}
+    {% assign is_prompt = false %}
+
+    {% for cls in cls_array %}
+      {% if cls contains cls_prefix %}
+        {% assign is_prompt = true %}
+        {% break %}
+      {% endif %}
+    {% endfor %}
+
+    {% unless is_prompt %}
+      {% assign _prompt_content = _prompt_content | append: blockquote_start | append: _snippet %}
+      {% continue %}
+    {% endunless %}
+
+    {% assign left = left | slice: cls_str.size, left.size %}
+    {% assign left = cls_str | append: '><div' | append: left | append: '</div>' %}
+
+    {% assign _prompt_content = _prompt_content | append: blockquote_start | append: left | append: right %}
+
+  {% endfor %}
+
+  {% assign _content = _prompt_content %}
+
+{% endif %}
 
 <!-- return -->
 

_includes/related-posts.html

@@ -60,7 +60,6 @@
 {% assign less = TOTAL_SIZE | minus: index_list.size %}
 
 {% if less > 0 %}
-
   {% for i in (0..last_index) %}
     {% assign post = site.posts[i] %}
     {% if post.url != page.url  %}
@@ -74,14 +73,12 @@
       {% endunless %}
     {% endif %}
   {% endfor %}
-
 {% endif %}
 
-
 {% if index_list.size > 0 %}
-  <div id="related-posts" class="mt-5 mb-2 mb-sm-4">
-    <h3 class="pt-2 mt-1 mb-4 ml-1"
-      data-toc-skip>{{ site.data.locales[lang].post.relate_posts }}</h3>
+  <div id="related-posts" class="mb-2 mb-sm-4">
+    <h3 class="pt-2 mb-4 ml-1"
+      data-toc-skip>{{ site.data.locales[site.lang].post.relate_posts }}</h3>
     <div class="card-deck mb-4">
     {% for entry in index_list %}
       {% assign index = entry | plus: 0 %}
@@ -89,12 +86,12 @@
       <div class="card">
         <a href="{{ post.url | relative_url }}">
           <div class="card-body">
-            {% include timeago.html date=post.date class="small" %}
+            {% include datetime.html date=post.date class="small" %}
             <h3 class="pt-0 mt-1 mb-3" data-toc-skip>{{ post.title }}</h3>
             <div class="text-muted small">
               <p>
                 {% include no-linenos.html content=post.content %}
-                {{ content | markdownify | strip_html | truncate: 200 }}
+                {{ content | markdownify | strip_html | truncate: 200 | escape }}
               </p>
             </div>
           </div>

_includes/search-loader.html

@@ -5,7 +5,7 @@
 
 {% capture result_elem %}
 <div class="pl-1 pr-1 pl-sm-2 pr-sm-2 pl-lg-4 pr-lg-4 pl-xl-0 pr-xl-0">
-  <a href="{{ site.url }}{url}">{title}</a>
+  <a href="{url}">{title}</a>
   <div class="post-meta d-flex flex-column flex-sm-row text-muted mt-1 mb-1">
     {categories}
     {tags}
@@ -14,9 +14,9 @@
 </div>
 {% endcapture %}
 
-{% capture not_found %}<p class="mt-5">{{ site.data.locales[lang].search.no_results }}</p>{% endcapture %}
+{% capture not_found %}<p class="mt-5">{{ site.data.locales[site.lang].search.no_results }}</p>{% endcapture %}
 
-<script src="https://cdn.jsdelivr.net/npm/simple-jekyll-search@1.10.0/dest/simple-jekyll-search.min.js"></script>
+<script src="{{ site.data.assets[origin].search.js | relative_url }}"></script>
 
 <script>
 SimpleJekyllSearch({

_includes/search-results.html

@@ -4,15 +4,7 @@
 <div id="search-result-wrapper" class="d-flex justify-content-center unloaded">
   <div class="col-12 col-sm-11 post-content">
     <div id="search-hints">
-      <h4 class="text-muted mb-4">{{ site.data.locales[lang].panel.trending_tags }}</h4>
-
       {% include trending-tags.html %}
-
-      {% for tag in trending_tags %}
-        {% capture url %}/tags/{{ tag | slugify | url_encode }}/{% endcapture %}
-        <a class="post-tag" href="{{ url | relative_url }}">{{ tag | replace: '-', ' ' }}</a>
-      {% endfor %}
-
     </div>
     <div id="search-results" class="d-flex flex-wrap justify-content-center text-muted mt-3"></div>
   </div>

_includes/sidebar.html

@@ -2,26 +2,26 @@
   The Side Bar
 -->
 
-<div id="sidebar" class="d-flex flex-column align-items-end" lang="{{lang}}">
+<div id="sidebar" class="d-flex flex-column align-items-end">
   <div class="profile-wrapper text-center">
     <div id="avatar">
-      <a href="{{ '/' | relative_url }}" alt="avatar" class="mx-auto">
-        {% if site.avatar != '' and site.avatar %}
+      <a href="{{ '/' | relative_url }}" class="mx-auto">
+        {% if site.avatar != empty and site.avatar %}
           {% capture avatar_url %}
-            {%- if site.avatar contains '://' -%}
+            {% if site.avatar contains '://' %}
               {{ site.avatar }}
-            {%- elsif site.img_cdn != '' and site.img_cdn -%}
+            {% elsif site.img_cdn != empty and site.img_cdn %}
               {{ site.avatar | prepend: site.img_cdn }}
-            {%- else -%}
+            {% else %}
               {{ site.avatar | relative_url }}
-            {%- endif -%}
+            {% endif %}
           {% endcapture %}
-          <img src="{{ avatar_url }}" alt="avatar" onerror="this.style.display='none'">
+          <img src="{{ avatar_url | strip }}" alt="avatar" onerror="this.style.display='none'">
         {% endif %}
       </a>
     </div>
 
-    <div class="site-title mt-3">
+    <div class="site-title">
       <a href="{{ '/' | relative_url }}">{{ site.title }}</a>
     </div>
     <div class="site-subtitle font-italic">{{ site.tagline }}</div>
@@ -34,7 +34,7 @@
     <li class="nav-item{% if page.layout == 'home' %}{{ " active" }}{% endif %}">
       <a href="{{ '/' | relative_url }}" class="nav-link">
         <i class="fa-fw fas fa-home ml-xl-3 mr-xl-3 unloaded"></i>
-        <span>{{ site.data.locales[lang].tabs.home | upcase }}</span>
+        <span>{{ site.data.locales[site.lang].tabs.home | upcase }}</span>
       </a>
     </li>
     <!-- the real tabs -->
@@ -44,7 +44,7 @@
         <i class="fa-fw {{ tab.icon }} ml-xl-3 mr-xl-3 unloaded"></i>
         {% capture tab_name %}{{ tab.url | split: '/' }}{% endcapture %}
 
-        <span>{{ site.data.locales[lang].tabs.[tab_name] | default: tab.title | upcase }}</span>
+        <span>{{ site.data.locales[site.lang].tabs.[tab_name] | default: tab.title | upcase }}</span>
       </a>
     </li> <!-- .nav-item -->
     {% endfor %}
@@ -53,6 +53,16 @@
 
   <div class="sidebar-bottom mt-auto d-flex flex-wrap justify-content-center align-items-center">
 
+    {% unless site.theme_mode %}
+      <button class="mode-toggle btn" aria-label="Switch Mode">
+        <i class="fas fa-adjust"></i>
+      </button>
+
+      {% if site.data.contact.size > 0 %}
+        <span class="icon-border"></span>
+      {% endif %}
+    {% endunless %}
+
     {% for entry in site.data.contact %}
       {% capture url %}
         {%- if entry.type == 'github' -%}
@@ -71,24 +81,23 @@
 
       {% if url %}
       <a href="{{ url }}" aria-label="{{ entry.type }}"
-        {% unless site.theme_mode %}class="order-{{ forloop.index | plus: 2 }}"{% endunless %}
-        {% unless entry.noblank %}target="_blank" rel="noopener"{% endunless %}>
+        {% assign link_types = nil %}
+        {% unless entry.noblank %}
+          {% assign link_types = link_types | append: " noopener" %}
+          target="_blank"
+        {% endunless %}
+
+        {% if entry.type == 'mastodon' %}
+          {% assign link_types = link_types | append: " me" %}
+        {% endif %}
+
+        {% if link_types %}rel="{{ link_types | lstrip }}"{% endif %}>
         <i class="{{ entry.icon }}"></i>
       </a>
       {% endif %}
 
     {% endfor %}
 
-    {% unless site.theme_mode %}
-      {% if site.data.contact.size > 0 %}
-        <span class="icon-border order-2"></span>
-      {% endif %}
-
-      <span id="mode-toggle-wrapper" class="order-1">
-        {% include mode-toggle.html %}
-      </span>
-    {% endunless %}
-
   </div> <!-- .sidebar-bottom -->
 
 </div><!-- #sidebar -->

_includes/timeago.html

@@ -1,27 +0,0 @@
-<!--
-  Date format snippet
-  See: /assets/js/_utils/timeage.js
--->
-
-{% assign tooltip_df = site.data.locales[lang].date_format.tooltip %}
-{% assign post_long_df = site.data.locales[lang].date_format.post.long %}
-{% assign post_short_df = site.data.locales[lang].date_format.post.short %}
-
-{% if include.preposition %}
-  {{ include.preposition }}
-{% endif %}
-<span class="timeago {% if include.class %}{{ include.class }}{% endif %}"
-  {% if include.tooltip %}
-    data-toggle="tooltip"
-    data-placement="bottom"
-    title="{{ include.date | date: tooltip_df }}"
-  {% endif %}>
-  {%- assign this_year = site.time | date: "%Y" -%}
-  {%- assign post_year = include.date | date: "%Y" -%}
-  {%- if post_year == this_year -%}
-    {{ include.date | date: post_short_df }}
-  {%- else -%}
-    {{ include.date | date: post_long_df }}
-  {%- endif -%}
-  <i class="unloaded">{{ include.date | date_to_xmlschema }}</i>
-</span>

_includes/toc.html

@@ -0,0 +1,16 @@
+{% assign enable_toc = false %}
+{% if site.toc and page.toc %}
+  {% if page.content contains '<h2' or page.content contains '<h3' %}
+    {% assign enable_toc = true %}
+  {% endif %}
+{% endif %}
+
+{% if enable_toc %}
+<!-- BS-toc.js will be loaded at medium priority -->
+<script src="{{ site.data.assets[origin].bootstrap-toc.js | relative_url }}"></script>
+
+<div id="toc-wrapper" class="pl-0 pr-4 mb-5">
+  <div class="panel-heading pl-3 pt-2 mb-2">{{- site.data.locales[site.lang].panel.toc -}}</div>
+  <nav id="toc" data-toggle="toc"></nav>
+</div>
+{% endif %}

_includes/topbar.html

@@ -2,15 +2,15 @@
   The Top Bar
 -->
 
-<div id="topbar-wrapper" class="row justify-content-center topbar-down">
-  <div id="topbar" class="col-11 d-flex h-100 align-items-center justify-content-between">
+<div id="topbar-wrapper">
+  <div id="topbar" class="container d-flex align-items-center justify-content-between h-100 pl-3 pr-3 pl-md-4 pr-md-4">
     <span id="breadcrumb">
 
     {% assign paths = page.url | split: '/' %}
 
     {% if paths.size == 0 or page.layout == 'home' %}
       <!-- index page -->
-      <span>{{ site.data.locales[lang].tabs.home | capitalize }}</span>
+      <span>{{ site.data.locales[site.lang].tabs.home | capitalize }}</span>
 
     {% else %}
 
@@ -19,14 +19,14 @@
         {% if forloop.first %}
           <span>
             <a href="{{ '/' | relative_url }}">
-              {{ site.data.locales[lang].tabs.home | capitalize }}
+              {{ site.data.locales[site.lang].tabs.home | capitalize }}
             </a>
           </span>
 
         {% elsif forloop.last %}
 
           {% if page.collection == 'tabs' %}
-            <span>{{ site.data.locales[lang].tabs[item] | default: page.title }}</span>
+            <span>{{ site.data.locales[site.lang].tabs[item] | default: page.title }}</span>
           {% else %}
             <span>{{ page.title }}</span>
           {% endif %}
@@ -34,7 +34,7 @@
         {% elsif page.layout == 'category' or page.layout == 'tag' %}
           <span>
             <a href="{{ item | relative_url }}">
-              {{ site.data.locales[lang].tabs[item] | default: page.title }}
+              {{ site.data.locales[site.lang].tabs[item] | default: page.title }}
             </a>
           </span>
         {% endif %}
@@ -49,12 +49,12 @@
 
     <div id="topbar-title">
       {% if page.layout == 'home' %}
-        {{- site.data.locales[lang].title | default: site.title -}}
-      {% elsif page.collection == 'tabs' %}
+        {{- site.data.locales[site.lang].title | default: site.title -}}
+      {% elsif page.collection == 'tabs' or page.layout == 'page' %}
         {%- capture tab_key -%}{{ page.url | split: '/' }}{%- endcapture -%}
-        {{- site.data.locales[lang].tabs[tab_key] | default: page.title -}}
+        {{- site.data.locales[site.lang].tabs[tab_key] | default: page.title -}}
       {% else %}
-        {{- site.data.locales[lang].layout[page.layout] | default: page.layout | capitalize -}}
+        {{- site.data.locales[site.lang].layout[page.layout] | default: page.layout | capitalize -}}
       {% endif %}
     </div>
 
@@ -62,10 +62,9 @@
     <span id="search-wrapper" class="align-items-center">
       <i class="fas fa-search fa-fw"></i>
       <input class="form-control" id="search-input" type="search"
-        aria-label="search" autocomplete="off" placeholder="{{ site.data.locales[lang].search.hint | capitalize }}...">
-      <i class="fa fa-times-circle fa-fw" id="search-cleaner"></i>
+        aria-label="search" autocomplete="off" placeholder="{{ site.data.locales[site.lang].search.hint | capitalize }}...">
     </span>
-    <span id="search-cancel" >{{ site.data.locales[lang].search.cancel }}</span>
+    <span id="search-cancel" >{{ site.data.locales[site.lang].search.cancel }}</span>
   </div>
 
 </div>

_includes/trending-tags.html

@@ -34,3 +34,17 @@
     {% endif %}
   {% endfor %}
 {% endfor %}
+
+{% if trending_tags.size > 0 %}
+  <div id="access-tags">
+    <div class="panel-heading">{{- site.data.locales[site.lang].panel.trending_tags -}}</div>
+    <div class="d-flex flex-wrap mt-3 mb-1 mr-3">
+
+    {% for tag_name in trending_tags %}
+      {% assign url = tag_name | slugify | url_encode | prepend: "/tags/" | append: "/" %}
+      <a class="post-tag" href="{{ url | relative_url }}">{{ tag_name }}</a>
+    {% endfor %}
+
+    </div>
+  </div>
+{% endif %}

_includes/update-list.html

@@ -22,3 +22,19 @@
 {% for entry in all_list limit:MAX_SIZE %}
   {% assign update_list = update_list | push: entry %}
 {% endfor %}
+
+{% if update_list.size > 0 %}
+
+  <div id="access-lastmod" class="post">
+    <div class="panel-heading">{{- site.data.locales[site.lang].panel.lastmod -}}</div>
+    <ul class="post-content pl-0 pb-1 ml-1 mt-2">
+      {% for item in update_list %}
+        {% assign index = item | split: "::" | last | plus: 0 %}
+        {% assign post = site.posts[index] %}
+        {% assign url = post.url | relative_url %}
+      <li><a href="{{ url }}">{{ post.title }}</a></li>
+      {% endfor %}
+    </ul>
+  </div> <!-- #access-lastmod -->
+
+{% endif %}

_javascript/commons/back-to-top.js

@@ -1,20 +1,20 @@
-/*
-Reference: https://bootsnipp.com/snippets/featured/link-to-top-page
-*/
+/**
+ * Reference: https://bootsnipp.com/snippets/featured/link-to-top-page
+ */
 $(function() {
-  $(window).scroll(() => {
-    if ($(this).scrollTop() > 50 &&
-      $("#sidebar-trigger").css("display") === "none") {
-      $("#back-to-top").fadeIn();
-    } else {
-      $("#back-to-top").fadeOut();
-    }
-  });
+    $(window).scroll(() => {
+        if ($(this).scrollTop() > 50 &&
+            $("#sidebar-trigger").css("display") === "none") {
+            $("#back-to-top").fadeIn();
+        } else {
+            $("#back-to-top").fadeOut();
+        }
+    });
 
-  $("#back-to-top").click(() => {
-    $("body,html").animate({
-      scrollTop: 0
-    }, 800);
-    return false;
-  });
+    $("#back-to-top").click(() => {
+        $("body,html").animate({
+            scrollTop: 0
+        }, 800);
+        return false;
+    });
 });

_javascript/commons/mode-toggle.js

@@ -0,0 +1,13 @@
+/**
+ * Listener for theme mode toggle
+ */
+$(function () {
+    $(".mode-toggle").click((e) => {
+        const $target = $(e.target);
+        let $btn = ($target.prop("tagName") === "button".toUpperCase() ?
+            $target : $target.parent());
+
+        $btn.blur(); // remove the clicking outline
+        flipMode();
+    });
+});

_javascript/commons/scroll-helper.js

@@ -0,0 +1,38 @@
+/**
+ * A tool for smooth scrolling and topbar switcher
+ */
+const ScrollHelper = (function () {
+    const $body = $("body");
+    const ATTR_TOPBAR_VISIBLE = "data-topbar-visible";
+    const topbarHeight = $("#topbar-wrapper").outerHeight();
+
+    let scrollUpCount = 0; // the number of times the scroll up was triggered by ToC or anchor
+    let topbarLocked = false;
+    let orientationLocked = false;
+
+    return {
+        hideTopbar: () => $body.attr(ATTR_TOPBAR_VISIBLE, false),
+        showTopbar: () => $body.attr(ATTR_TOPBAR_VISIBLE, true),
+
+        // scroll up
+
+        addScrollUpTask: () => {
+            scrollUpCount += 1;
+            if (!topbarLocked) {
+                topbarLocked = true;
+            }
+        },
+        popScrollUpTask: () => scrollUpCount -= 1,
+        hasScrollUpTask: () => scrollUpCount > 0,
+        topbarLocked: () => topbarLocked === true,
+        unlockTopbar: () => topbarLocked = false,
+        getTopbarHeight: () => topbarHeight,
+
+        // orientation change
+
+        orientationLocked: () => orientationLocked === true,
+        lockOrientation: () => orientationLocked = true,
+        unLockOrientation: () => orientationLocked = false
+    };
+
+}());

_javascript/commons/search-display.js

@@ -1,153 +1,129 @@
-/*
-* This script make #search-result-wrapper switch to unloaded or shown automatically.
-*/
+/**
+ * This script make #search-result-wrapper switch to unloaded or shown automatically.
+ */
 
-$(function() {
+$(function () {
+    const btnSbTrigger = $("#sidebar-trigger");
+    const btnSearchTrigger = $("#search-trigger");
+    const btnCancel = $("#search-cancel");
+    const main = $("#main");
+    const topbarTitle = $("#topbar-title");
+    const searchWrapper = $("#search-wrapper");
+    const resultWrapper = $("#search-result-wrapper");
+    const results = $("#search-results");
+    const input = $("#search-input");
+    const hints = $("#search-hints");
 
-  const btnSbTrigger = $("#sidebar-trigger");
-  const btnSearchTrigger = $("#search-trigger");
-  const btnCancel = $("#search-cancel");
-  const btnClear = $("#search-cleaner");
+    const scrollBlocker = (function () {
+        let offset = 0;
+        return {
+            block() {
+                offset = window.scrollY;
+                $("html,body").scrollTop(0);
+            },
+            release() {
+                $("html,body").scrollTop(offset);
+            },
+            getOffset() {
+                return offset;
+            }
+        };
+    }());
 
-  const main = $("#main");
-  const topbarTitle = $("#topbar-title");
-  const searchWrapper = $("#search-wrapper");
-  const resultWrapper = $("#search-result-wrapper");
-  const results = $("#search-results");
-  const input = $("#search-input");
-  const hints = $("#search-hints");
+    /*--- Actions in mobile screens (Sidebar hidden) ---*/
 
-  const scrollBlocker = (function () {
-    let offset = 0;
-    return {
-      block() {
-        offset = window.scrollY;
-        $("html,body").scrollTop(0);
-      },
-      release() {
-        $("html,body").scrollTop(offset);
-      },
-      getOffset() {
-        return offset;
-      }
-    };
-  }());
+    const mobileSearchBar = (function () {
+        return {
+            on() {
+                btnSbTrigger.addClass("unloaded");
+                topbarTitle.addClass("unloaded");
+                btnSearchTrigger.addClass("unloaded");
+                searchWrapper.addClass("d-flex");
+                btnCancel.addClass("loaded");
+            },
+            off() {
+                btnCancel.removeClass("loaded");
+                searchWrapper.removeClass("d-flex");
+                btnSbTrigger.removeClass("unloaded");
+                topbarTitle.removeClass("unloaded");
+                btnSearchTrigger.removeClass("unloaded");
+            }
+        };
+    }());
 
+    const resultSwitch = (function () {
+        let visible = false;
 
-  /*--- Actions in small screens (Sidebar unloaded) ---*/
+        return {
+            on() {
+                if (!visible) {
+                    // the block method must be called before $(#main) unloaded.
+                    scrollBlocker.block();
+                    resultWrapper.removeClass("unloaded");
+                    main.addClass("unloaded");
+                    visible = true;
+                }
+            },
+            off() {
+                if (visible) {
+                    results.empty();
+                    if (hints.hasClass("unloaded")) {
+                        hints.removeClass("unloaded");
+                    }
+                    resultWrapper.addClass("unloaded");
+                    main.removeClass("unloaded");
 
-  const mobileSearchBar = (function () {
-    return {
-      on() {
-        btnSbTrigger.addClass("unloaded");
-        topbarTitle.addClass("unloaded");
-        btnSearchTrigger.addClass("unloaded");
-        searchWrapper.addClass("d-flex");
-        btnCancel.addClass("loaded");
-      },
-      off() {
-        btnCancel.removeClass("loaded");
-        searchWrapper.removeClass("d-flex");
-        btnSbTrigger.removeClass("unloaded");
-        topbarTitle.removeClass("unloaded");
-        btnSearchTrigger.removeClass("unloaded");
-      }
-    };
-  }());
+                    // now the release method must be called after $(#main) display
+                    scrollBlocker.release();
 
-  const resultSwitch = (function () {
-    let visible = false;
+                    input.val("");
+                    visible = false;
+                }
+            },
+            isVisible() {
+                return visible;
+            }
+        };
 
-    return {
-      on() {
-        if (!visible) {
-          // the block method must be called before $(#main) unloaded.
-          scrollBlocker.block();
-          resultWrapper.removeClass("unloaded");
-          main.addClass("unloaded");
-          visible = true;
-        }
-      },
-      off() {
-        if (visible) {
-          results.empty();
-          if (hints.hasClass("unloaded")) {
-            hints.removeClass("unloaded");
-          }
-          resultWrapper.addClass("unloaded");
-          btnClear.removeClass("visible");
-          main.removeClass("unloaded");
+    }());
 
-          // now the release method must be called after $(#main) display
-          scrollBlocker.release();
+    function isMobileView() {
+        return btnCancel.hasClass("loaded");
+    }
 
-          input.val("");
-          visible = false;
-        }
-      },
-      isVisible() {
-        return visible;
-      }
-    };
-
-  }());
-
-
-  function isMobileView() {
-    return btnCancel.hasClass("loaded");
-  }
-
-  btnSearchTrigger.click(function() {
-    mobileSearchBar.on();
-    resultSwitch.on();
-    input.focus();
-  });
-
-  btnCancel.click(function() {
-    mobileSearchBar.off();
-    resultSwitch.off();
-  });
-
-  input.focus(function() {
-    searchWrapper.addClass("input-focus");
-  });
-
-  input.focusout(function() {
-    searchWrapper.removeClass("input-focus");
-  });
-
-  input.on("keyup", function(e) {
-    if (e.keyCode === 8 && input.val() === "") {
-      if (!isMobileView()) {
-        resultSwitch.off();
-      } else {
-        hints.removeClass("unloaded");
-      }
-    } else {
-      if (input.val() !== "") {
+    btnSearchTrigger.click(function () {
+        mobileSearchBar.on();
         resultSwitch.on();
+        input.focus();
+    });
 
-        if (!btnClear.hasClass("visible")) {
-          btnClear.addClass("visible");
+    btnCancel.click(function () {
+        mobileSearchBar.off();
+        resultSwitch.off();
+    });
+
+    input.focus(function () {
+        searchWrapper.addClass("input-focus");
+    });
+
+    input.focusout(function () {
+        searchWrapper.removeClass("input-focus");
+    });
+
+    input.on("input", () => {
+        if (input.val() === "") {
+            if (isMobileView()) {
+                hints.removeClass("unloaded");
+            } else {
+                resultSwitch.off();
+            }
+
+        } else {
+            resultSwitch.on();
+            if (isMobileView()) {
+                hints.addClass("unloaded");
+            }
         }
-
-        if (isMobileView()) {
-          hints.addClass("unloaded");
-        }
-      }
-    }
-  });
-
-  btnClear.on("click", function() {
-    input.val("");
-    if (isMobileView()) {
-      hints.removeClass("unloaded");
-      results.empty();
-    } else {
-      resultSwitch.off();
-    }
-    input.focus();
-    btnClear.removeClass("visible");
-  });
+    });
 
 });

_javascript/commons/sidebar.js

@@ -2,29 +2,27 @@
  * Expand or close the sidebar in mobile screens.
  */
 
-$(function() {
+$(function () {
+    const sidebarUtil = (function () {
+        const ATTR_DISPLAY = "sidebar-display";
+        let isExpanded = false;
+        const body = $("body");
 
-  const sidebarUtil = (function () {
-    const ATTR_DISPLAY = "sidebar-display";
-    let isExpanded = false;
-    const body = $("body");
+        return {
+            toggle() {
+                if (isExpanded === false) {
+                    body.attr(ATTR_DISPLAY, "");
+                } else {
+                    body.removeAttr(ATTR_DISPLAY);
+                }
 
-    return {
-      toggle() {
-        if (isExpanded === false) {
-          body.attr(ATTR_DISPLAY, "");
-        } else {
-          body.removeAttr(ATTR_DISPLAY);
-        }
+                isExpanded = !isExpanded;
+            }
+        };
 
-        isExpanded = !isExpanded;
-      }
-    };
+    }());
 
-  }());
-
-  $("#sidebar-trigger").click(sidebarUtil.toggle);
-
-  $("#mask").click(sidebarUtil.toggle);
+    $("#sidebar-trigger").click(sidebarUtil.toggle);
 
+    $("#mask").click(sidebarUtil.toggle);
 });

_javascript/commons/tooltip-loader.js

@@ -1,6 +1,6 @@
 /**
  * Initial Bootstrap Tooltip.
-*/
+ */
 $(function () {
-  $("[data-toggle=\"tooltip\"]").tooltip();
+    $("[data-toggle=\"tooltip\"]").tooltip();
 });

_javascript/commons/topbar-switch.js

@@ -1,69 +0,0 @@
-/*
- * Hide Header on scroll down
- */
-
-$(function() {
-
-  const topbarWrapper = $("#topbar-wrapper");
-  const toc = $("#toc-wrapper");
-  const access = $(".access");
-  const searchInput = $("#search-input");
-
-  let didScroll;
-  let lastScrollTop = 0;
-
-  const delta = 5;
-  const topbarHeight = topbarWrapper.outerHeight();
-
-  function hasScrolled() {
-    var st = $(this).scrollTop();
-
-    /* Make sure they scroll more than delta */
-    if (Math.abs(lastScrollTop - st) <= delta) {
-      return;
-    }
-
-    if (st > lastScrollTop && st > topbarHeight) {
-      /* Scroll Down */
-      topbarWrapper.removeClass("topbar-down").addClass("topbar-up");
-
-      if (toc.length > 0) {
-        toc.removeClass("topbar-down");
-      }
-
-      if (access.length > 0) {
-        access.removeClass("topbar-down");
-      }
-
-      if (searchInput.is(":focus")) {
-        searchInput.blur(); /* remove focus */
-      }
-
-    } else if (st + $(window).height() < $(document).height()) {
-      /* Scroll Up */
-      topbarWrapper.removeClass("topbar-up").addClass("topbar-down");
-      if (toc.length > 0) {
-        toc.addClass("topbar-down");
-      }
-      if (access.length > 0) {
-        access.addClass("topbar-down");
-      }
-    }
-
-    lastScrollTop = st;
-  }
-
-  $(window).scroll(function(event) {
-    if ($("#topbar-title").is(":hidden")) { /* Not in small screens */
-      didScroll = true;
-    }
-  });
-
-  setInterval(function() {
-    if (didScroll) {
-      hasScrolled();
-      didScroll = false;
-    }
-  }, 250);
-
-});

_javascript/commons/topbar-switcher.js

@@ -0,0 +1,89 @@
+/**
+ * Hide Header on scroll down
+ */
+
+$(function () {
+    const $searchInput = $("#search-input");
+    const delta = ScrollHelper.getTopbarHeight();
+
+    let didScroll;
+    let lastScrollTop = 0;
+
+    function hasScrolled() {
+        let st = $(this).scrollTop();
+
+        /* Make sure they scroll more than delta */
+        if (Math.abs(lastScrollTop - st) <= delta) {
+            return;
+        }
+
+        if (st > lastScrollTop) { // Scroll Down
+            ScrollHelper.hideTopbar();
+
+            if ($searchInput.is(":focus")) {
+                $searchInput.blur(); /* remove focus */
+            }
+
+        } else { // Scroll up
+            // has not yet scrolled to the bottom of the screen, that is, there is still space for scrolling
+            if (st + $(window).height() < $(document).height()) {
+
+                if (ScrollHelper.hasScrollUpTask()) {
+                    return;
+                }
+
+                if (ScrollHelper.topbarLocked()) { // avoid redundant scroll up event from smooth scrolling
+                    ScrollHelper.unlockTopbar();
+                } else {
+                    if (ScrollHelper.orientationLocked()) { // avoid device auto scroll up on orientation change
+                        ScrollHelper.unLockOrientation();
+                    } else {
+                        ScrollHelper.showTopbar();
+                    }
+                }
+            }
+        }
+
+        lastScrollTop = st;
+
+    } // hasScrolled()
+
+    function handleLandscape() {
+        if ($(window).scrollTop() === 0) {
+            return;
+        }
+        ScrollHelper.lockOrientation();
+        ScrollHelper.hideTopbar();
+    }
+
+    if (screen.orientation) {
+        screen.orientation.onchange = () => {
+            const type = screen.orientation.type;
+            if (type === "landscape-primary" || type === "landscape-secondary") {
+                handleLandscape();
+            }
+        };
+
+    } else {
+        // for the browsers that not support `window.screen.orientation` API
+        $(window).on("orientationchange", () => {
+            if ($(window).width() < $(window).height()) { // before rotating, it is still in portrait mode.
+                handleLandscape();
+            }
+        });
+    }
+
+    $(window).scroll(() => {
+        if (didScroll) {
+            return;
+        }
+        didScroll = true;
+    });
+
+    setInterval(() => {
+        if (didScroll) {
+            hasScrolled();
+            didScroll = false;
+        }
+    }, 250);
+});

_javascript/commons/topbar-title.js

@@ -1,47 +1,67 @@
-/*
- * Top bar title auto change while scrolling in mobile screens.
-*/
+/**
+ * Top bar title auto change while scrolling up/down in mobile screens.
+ */
 
-$(function() {
+$(function () {
+    const titleSelector = "div.post>h1:first-of-type";
+    const $pageTitle = $(titleSelector);
+    const $topbarTitle = $("#topbar-title");
 
-  const topbarTitle = $("#topbar-title");
-  const postTitle = $("div.post>h1");
-
-  const DEFAULT = topbarTitle.text().trim();
-
-  let title = (postTitle.length > 0) ?
-    postTitle.text().trim() : $("h1").text().trim();
-
-  if ($("#page-category").length || $("#page-tag").length) {
-    /* The title in Category or Tag page will be "<title> <count_of_posts>" */
-    if (/\s/.test(title)) {
-      title = title.replace(/[0-9]/g, "").trim();
-    }
-  }
-
-  /* Replace topbar title while scroll screens. */
-  $(window).scroll(function () {
-    if ($("#post-list").length /* in Home page */
-      || postTitle.is(":hidden") /* is tab pages */
-      || topbarTitle.is(":hidden") /* not mobile screens */
-      || $("#sidebar.sidebar-expand").length) { /* when the sidebar trigger is clicked */
-      return false;
+    if ($pageTitle.length === 0 /* on Home page */
+        || $pageTitle.hasClass("dynamic-title")
+        || $topbarTitle.is(":hidden")) {/* not in mobile views */
+        return;
     }
 
-    if ($(this).scrollTop() >= 95) {
-      if (topbarTitle.text() !== title) {
-        topbarTitle.text(title);
-      }
-    } else {
-      if (topbarTitle.text() !== DEFAULT) {
-        topbarTitle.text(DEFAULT);
-      }
-    }
-  });
+    const defaultTitleText = $topbarTitle.text().trim();
+    let pageTitleText = $pageTitle.text().trim();
+    let hasScrolled = false;
+    let lastScrollTop = 0;
 
-  /* Click title remove hover effect. */
-  topbarTitle.click(function() {
-    $("body,html").animate({scrollTop: 0}, 800);
-  });
+    if ($("#page-category").length || $("#page-tag").length) {
+        /* The title in Category or Tag page will be "<title> <count_of_posts>" */
+        if (/\s/.test(pageTitleText)) {
+            pageTitleText = pageTitleText.replace(/[0-9]/g, "").trim();
+        }
+    }
+
+    // When the page is scrolled down and then refreshed, the topbar title needs to be initialized
+    if ($pageTitle.offset().top < $(window).scrollTop()) {
+        $topbarTitle.text(pageTitleText);
+    }
+
+    let options = {
+        rootMargin: '-48px 0px 0px 0px', // 48px equals to the topbar height (3rem)
+        threshold: [0, 1]
+    };
+
+    let observer = new IntersectionObserver((entries) => {
+        if (!hasScrolled) {
+            hasScrolled = true;
+            return;
+        }
+
+        let curScrollTop = $(window).scrollTop();
+        let isScrollDown = lastScrollTop < curScrollTop;
+        lastScrollTop = curScrollTop;
+        let heading = entries[0];
+
+        if (isScrollDown) {
+            if (heading.intersectionRatio === 0) {
+                $topbarTitle.text(pageTitleText);
+            }
+        } else {
+            if (heading.intersectionRatio === 1) {
+                $topbarTitle.text(defaultTitleText);
+            }
+        }
+    }, options);
+
+    observer.observe(document.querySelector(titleSelector));
+
+    /* Click title will scroll to top */
+    $topbarTitle.click(function () {
+        $("body,html").animate({scrollTop: 0}, 800);
+    });
 
 });

_javascript/copyright

@@ -1,5 +1,5 @@
 /*!
- * Chirpy v4.3.1 (https://github.com/cotes2020/jekyll-theme-chirpy/)
+ * Chirpy v5.4.0 (https://github.com/cotes2020/jekyll-theme-chirpy/)
  * © 2019 Cotes Chung
  * MIT Licensed
  */

_javascript/utils/category-collapse.js

@@ -1,30 +1,30 @@
-/*
+/**
  * Tab 'Categories' expand/close effect.
  */
 
-$(function() {
-  const childPrefix = "l_";
-  const parentPrefix = "h_";
-  const collapse = $(".collapse");
+$(function () {
+    const childPrefix = "l_";
+    const parentPrefix = "h_";
+    const collapse = $(".collapse");
 
-  /* close up top-category */
-  collapse.on("hide.bs.collapse", function () { /* Bootstrap collapse events. */
-    const parentId = parentPrefix + $(this).attr("id").substring(childPrefix.length);
-    if (parentId) {
-      $(`#${parentId} .far.fa-folder-open`).attr("class", "far fa-folder fa-fw");
-      $(`#${parentId} i.fas`).addClass("rotate");
-      $(`#${parentId}`).removeClass("hide-border-bottom");
-    }
-  });
+    /* close up top-category */
+    collapse.on("hide.bs.collapse", function () { /* Bootstrap collapse events. */
+        const parentId = parentPrefix + $(this).attr("id").substring(childPrefix.length);
+        if (parentId) {
+            $(`#${parentId} .far.fa-folder-open`).attr("class", "far fa-folder fa-fw");
+            $(`#${parentId} i.fas`).addClass("rotate");
+            $(`#${parentId}`).removeClass("hide-border-bottom");
+        }
+    });
 
-  /* expand the top category */
-  collapse.on("show.bs.collapse", function() {
-    const parentId = parentPrefix + $(this).attr("id").substring(childPrefix.length);
-    if (parentId) {
-      $(`#${parentId} .far.fa-folder`).attr("class", "far fa-folder-open fa-fw");
-      $(`#${parentId} i.fas`).removeClass("rotate");
-      $(`#${parentId}`).addClass("hide-border-bottom");
-    }
-  });
+    /* expand the top category */
+    collapse.on("show.bs.collapse", function () {
+        const parentId = parentPrefix + $(this).attr("id").substring(childPrefix.length);
+        if (parentId) {
+            $(`#${parentId} .far.fa-folder`).attr("class", "far fa-folder-open fa-fw");
+            $(`#${parentId} i.fas`).removeClass("rotate");
+            $(`#${parentId}`).addClass("hide-border-bottom");
+        }
+    });
 
 });

_javascript/utils/checkbox.js

@@ -1,12 +0,0 @@
-/*
- * Create a more beautiful checkbox
- */
-
-$(function() {
-  /* hide browser default checkbox */
-  $("input[type=checkbox]").addClass("unloaded");
-  /* create checked checkbox */
-  $("input[type=checkbox][checked]").before("<i class=\"fas fa-check-circle checked\"></i>");
-  /* create normal checkbox */
-  $("input[type=checkbox]:not([checked])").before("<i class=\"far fa-circle\"></i>");
-});

_javascript/utils/clipboard.js

@@ -1,4 +1,4 @@
-/*
+/**
  * Clipboard functions
  *
  * Dependencies:
@@ -6,126 +6,128 @@
  *   - clipboard.js (https://github.com/zenorocha/clipboard.js)
  */
 
-$(function() {
-  const btnSelector = '.code-header>button';
-  const ICON_SUCCESS = 'fas fa-check';
-  const ATTR_TIMEOUT = 'timeout';
-  const TIMEOUT = 2000; // in milliseconds
+$(function () {
+    const btnSelector = '.code-header>button';
+    const ICON_SUCCESS = 'fas fa-check';
+    const ATTR_TIMEOUT = 'timeout';
+    const ATTR_TITLE_SUCCEED = 'data-title-succeed';
+    const ATTR_TITLE_ORIGIN = 'data-original-title';
+    const TIMEOUT = 2000; // in milliseconds
 
-  function isLocked(node) {
-    if ($(node)[0].hasAttribute(ATTR_TIMEOUT)) {
-      let timeout = $(node).attr(ATTR_TIMEOUT);
-      if (Number(timeout) > Date.now()) {
-        return true;
-      }
-    }
-    return false;
-  }
-
-  function lock(node) {
-    $(node).attr(ATTR_TIMEOUT, Date.now() + TIMEOUT);
-  }
-
-  function unlock(node) {
-    $(node).removeAttr(ATTR_TIMEOUT);
-  }
-
-  /* --- Copy code block --- */
-
-  // Initial the clipboard.js object
-  const clipboard = new ClipboardJS(btnSelector, {
-    target(trigger) {
-      let codeBlock = trigger.parentNode.nextElementSibling;
-      return codeBlock.querySelector('code .rouge-code');
-    }
-  });
-
-  $(btnSelector).tooltip({
-    trigger: 'hover',
-    placement: 'left'
-  });
-
-  function getIcon(btn) {
-    let iconNode = $(btn).children();
-    return iconNode.attr('class');
-  }
-
-  const ICON_DEFAULT = getIcon(btnSelector);
-
-  function showTooltip(btn) {
-    const succeedTitle = $(btn).attr('title-succeed');
-    $(btn).attr('data-original-title', succeedTitle).tooltip('show');
-  }
-
-  function hideTooltip(btn) {
-    $(btn).tooltip('hide').removeAttr('data-original-title');
-  }
-
-  function setSuccessIcon(btn) {
-    let btnNode = $(btn);
-    let iconNode = btnNode.children();
-    iconNode.attr('class', ICON_SUCCESS);
-  }
-
-  function resumeIcon(btn) {
-    let btnNode = $(btn);
-    let iconNode = btnNode.children();
-    iconNode.attr('class', ICON_DEFAULT);
-  }
-
-  clipboard.on('success', (e) => {
-    e.clearSelection();
-
-    const trigger = e.trigger;
-    if (isLocked(trigger)) {
-      return;
+    function isLocked(node) {
+        if ($(node)[0].hasAttribute(ATTR_TIMEOUT)) {
+            let timeout = $(node).attr(ATTR_TIMEOUT);
+            if (Number(timeout) > Date.now()) {
+                return true;
+            }
+        }
+        return false;
     }
 
-    setSuccessIcon(trigger);
-    showTooltip(trigger);
-    lock(trigger);
-
-    setTimeout(() => {
-      hideTooltip(trigger);
-      resumeIcon(trigger);
-      unlock(trigger);
-    }, TIMEOUT);
-
-  });
-
-  /* --- Post link sharing --- */
-
-  $('#copy-link').click((e) => {
-
-    let target = $(e.target);
-
-    if (isLocked(target)) {
-      return;
+    function lock(node) {
+        $(node).attr(ATTR_TIMEOUT, Date.now() + TIMEOUT);
     }
 
-    // Copy URL to clipboard
+    function unlock(node) {
+        $(node).removeAttr(ATTR_TIMEOUT);
+    }
 
-    const url = window.location.href;
-    const $temp = $("<input>");
+    /* --- Copy code block --- */
 
-    $("body").append($temp);
-    $temp.val(url).select();
-    document.execCommand("copy");
-    $temp.remove();
+    // Initial the clipboard.js object
+    const clipboard = new ClipboardJS(btnSelector, {
+        target(trigger) {
+            let codeBlock = trigger.parentNode.nextElementSibling;
+            return codeBlock.querySelector('code .rouge-code');
+        }
+    });
 
-    // Switch tooltip title
+    $(btnSelector).tooltip({
+        trigger: 'hover',
+        placement: 'left'
+    });
 
-    const defaultTitle = target.attr('data-original-title');
-    const succeedTitle = target.attr('title-succeed');
+    function getIcon(btn) {
+        let iconNode = $(btn).children();
+        return iconNode.attr('class');
+    }
 
-    target.attr('data-original-title', succeedTitle).tooltip('show');
-    lock(target);
+    const ICON_DEFAULT = getIcon(btnSelector);
 
-    setTimeout(() => {
-      target.attr('data-original-title', defaultTitle);
-      unlock(target);
-    }, TIMEOUT);
+    function showTooltip(btn) {
+        const succeedTitle = $(btn).attr(ATTR_TITLE_SUCCEED);
+        $(btn).attr(ATTR_TITLE_ORIGIN, succeedTitle).tooltip('show');
+    }
 
-  });
+    function hideTooltip(btn) {
+        $(btn).tooltip('hide').removeAttr(ATTR_TITLE_ORIGIN);
+    }
+
+    function setSuccessIcon(btn) {
+        let btnNode = $(btn);
+        let iconNode = btnNode.children();
+        iconNode.attr('class', ICON_SUCCESS);
+    }
+
+    function resumeIcon(btn) {
+        let btnNode = $(btn);
+        let iconNode = btnNode.children();
+        iconNode.attr('class', ICON_DEFAULT);
+    }
+
+    clipboard.on('success', (e) => {
+        e.clearSelection();
+
+        const trigger = e.trigger;
+        if (isLocked(trigger)) {
+            return;
+        }
+
+        setSuccessIcon(trigger);
+        showTooltip(trigger);
+        lock(trigger);
+
+        setTimeout(() => {
+            hideTooltip(trigger);
+            resumeIcon(trigger);
+            unlock(trigger);
+        }, TIMEOUT);
+
+    });
+
+    /* --- Post link sharing --- */
+
+    $('#copy-link').click((e) => {
+
+        let target = $(e.target);
+
+        if (isLocked(target)) {
+            return;
+        }
+
+        // Copy URL to clipboard
+
+        const url = window.location.href;
+        const $temp = $("<input>");
+
+        $("body").append($temp);
+        $temp.val(url).select();
+        document.execCommand("copy");
+        $temp.remove();
+
+        // Switch tooltip title
+
+        const defaultTitle = target.attr(ATTR_TITLE_ORIGIN);
+        const succeedTitle = target.attr(ATTR_TITLE_SUCCEED);
+
+        target.attr(ATTR_TITLE_ORIGIN, succeedTitle).tooltip('show');
+        lock(target);
+
+        setTimeout(() => {
+            target.attr(ATTR_TITLE_ORIGIN, defaultTitle);
+            unlock(target);
+        }, TIMEOUT);
+
+    });
 
 });

_javascript/utils/img-extra.js

@@ -1,47 +1,28 @@
 /**
-  Lazy load images (https://github.com/ApoorvSaxena/lozad.js)
-  and popup when clicked (https://github.com/dimsemenov/Magnific-Popup)
-*/
+ * Set up image stuff
+ */
 
-$(function() {
-
-  const IMG_SCOPE = '#main > div.row:first-child > div:first-child';
-
-  if ($(`${IMG_SCOPE} img`).length <= 0 ) {
-    return;
-  }
-
-  /* lazy loading */
-
-  const imgList = document.querySelectorAll(`${IMG_SCOPE} img[data-src]`);
-  const observer = lozad(imgList);
-  observer.observe();
-
-  /* popup */
-
-  $(`${IMG_SCOPE} p > img[data-src],${IMG_SCOPE} img[data-src].preview-img`).each(
-    function() {
-      let nextTag = $(this).next();
-      const title = nextTag.prop('tagName') === 'EM' ? nextTag.text() : '';
-      const src = $(this).attr('data-src'); // created by lozad.js
-
-      $(this).wrap(`<a href="${src}" title="${title}" class="popup"></a>`);
+(function() {
+    if ($('#core-wrapper img[data-src]') <= 0) {
+        return;
     }
-  );
 
-  $('.popup').magnificPopup({
-    type: 'image',
-    closeOnContentClick: true,
-    showCloseBtn: false,
-    zoom: {
-      enabled: true,
-      duration: 300,
-      easing: 'ease-in-out'
-    }
-  });
+    /* See: <https://github.com/dimsemenov/Magnific-Popup> */
+    $('.popup').magnificPopup({
+        type: 'image',
+        closeOnContentClick: true,
+        showCloseBtn: false,
+        zoom: {
+            enabled: true,
+            duration: 300,
+            easing: 'ease-in-out'
+        }
+    });
 
-  /* markup the image links */
+    /* Stop shimmer when image loaded */
+    document.addEventListener('lazyloaded', function(e) {
+        const $img = $(e.target);
+        $img.parent().removeClass('shimmer');
+    });
 
-  $(`${IMG_SCOPE} a`).has('img').addClass('img-link');
-
-});
+})();

_javascript/utils/locale-datetime.js

@@ -0,0 +1,43 @@
+/**
+ * Update month/day to locale datetime
+ *
+ * Requirement: <https://github.com/iamkun/dayjs>
+ */
+
+/* A tool for locale datetime */
+const LocaleHelper = (function () {
+    const locale = $('html').attr('lang').substr(0, 2);
+    const attrTimestamp = 'data-ts';
+    const attrDateFormat = 'data-df';
+
+    return {
+        locale: () => locale,
+        attrTimestamp: () => attrTimestamp,
+        attrDateFormat: () => attrDateFormat,
+        getTimestamp: ($elem) => Number($elem.attr(attrTimestamp)), // unix timestamp
+        getDateFormat: ($elem) => $elem.attr(attrDateFormat)
+    };
+
+}());
+
+$(function () {
+    dayjs.locale(LocaleHelper.locale());
+    dayjs.extend(window.dayjs_plugin_localizedFormat);
+
+    $(`[${LocaleHelper.attrTimestamp()}]`).each(function () {
+        const date = dayjs.unix(LocaleHelper.getTimestamp($(this)));
+        const text = date.format(LocaleHelper.getDateFormat($(this)));
+        $(this).text(text);
+        $(this).removeAttr(LocaleHelper.attrTimestamp());
+        $(this).removeAttr(LocaleHelper.attrDateFormat());
+
+        // setup tooltips
+        const tooltip = $(this).attr('data-toggle');
+        if (typeof tooltip === 'undefined' || tooltip !== 'tooltip') {
+            return;
+        }
+
+        const tooltipText = date.format('llll'); // see: https://day.js.org/docs/en/display/format#list-of-localized-formats
+        $(this).attr('data-original-title', tooltipText);
+    });
+});

_javascript/utils/pageviews.js

@@ -1,4 +1,4 @@
-/*
+/**
  * Count page views form GA or local cache file.
  *
  * Dependencies:
@@ -7,244 +7,244 @@
  */
 
 const getInitStatus = (function () {
-  let hasInit = false;
-  return () => {
-    let ret = hasInit;
-    if (!hasInit) {
-      hasInit = true;
-    }
-    return ret;
-  };
+    let hasInit = false;
+    return () => {
+        let ret = hasInit;
+        if (!hasInit) {
+            hasInit = true;
+        }
+        return ret;
+    };
 }());
 
 const PvOpts = (function () {
-  function getContent(selector) {
-    return $(selector).attr("content");
-  }
-
-  function hasContent(selector) {
-    let content = getContent(selector);
-    return (typeof content !== "undefined" && content !== false);
-  }
-
-  return {
-    getProxyMeta() {
-      return getContent("meta[name=pv-proxy-endpoint]");
-    },
-    getLocalMeta() {
-      return getContent("meta[name=pv-cache-path]");
-    },
-    hasProxyMeta() {
-      return hasContent("meta[name=pv-proxy-endpoint]");
-    },
-    hasLocalMeta() {
-      return hasContent("meta[name=pv-cache-path]");
+    function getContent(selector) {
+        return $(selector).attr("content");
     }
-  };
+
+    function hasContent(selector) {
+        let content = getContent(selector);
+        return (typeof content !== "undefined" && content !== false);
+    }
+
+    return {
+        getProxyMeta() {
+            return getContent("meta[name=pv-proxy-endpoint]");
+        },
+        getLocalMeta() {
+            return getContent("meta[name=pv-cache-path]");
+        },
+        hasProxyMeta() {
+            return hasContent("meta[name=pv-proxy-endpoint]");
+        },
+        hasLocalMeta() {
+            return hasContent("meta[name=pv-cache-path]");
+        }
+    };
 
 }());
 
 const PvStorage = (function () {
-  const Keys = {
-    KEY_PV: "pv",
-    KEY_PV_SRC: "pv_src",
-    KEY_CREATION: "pv_created_date"
-  };
+    const Keys = {
+        KEY_PV: "pv",
+        KEY_PV_SRC: "pv_src",
+        KEY_CREATION: "pv_created_date"
+    };
 
-  const Source = {
-    LOCAL: "same-origin",
-    PROXY: "cors"
-  };
+    const Source = {
+        LOCAL: "same-origin",
+        PROXY: "cors"
+    };
 
-  function get(key) {
-    return localStorage.getItem(key);
-  }
-
-  function set(key, val) {
-    localStorage.setItem(key, val);
-  }
-
-  function saveCache(pv, src) {
-    set(Keys.KEY_PV, pv);
-    set(Keys.KEY_PV_SRC, src);
-    set(Keys.KEY_CREATION, new Date().toJSON());
-  }
-
-  return {
-    keysCount() {
-      return Object.keys(Keys).length;
-    },
-    hasCache() {
-      return (localStorage.getItem(Keys.KEY_PV) !== null);
-    },
-    getCache() {
-      return JSON.parse(localStorage.getItem(Keys.KEY_PV));
-    },
-    saveLocalCache(pv) {
-      saveCache(pv, Source.LOCAL);
-    },
-    saveProxyCache(pv) {
-      saveCache(pv, Source.PROXY);
-    },
-    isExpired() {
-      let date = new Date(get(Keys.KEY_CREATION));
-      date.setHours(date.getHours() + 1);   // per hour
-      return Date.now() >= date.getTime();
-    },
-    isFromLocal() {
-      return get(Keys.KEY_PV_SRC) === Source.LOCAL;
-    },
-    isFromProxy() {
-      return get(Keys.KEY_PV_SRC) === Source.PROXY;
-    },
-    newerThan(pv) {
-      return PvStorage.getCache().totalsForAllResults["ga:pageviews"] > pv.totalsForAllResults["ga:pageviews"];
-    },
-    inspectKeys() {
-      if (localStorage.length !== PvStorage.keysCount()) {
-        localStorage.clear();
-        return;
-      }
-
-      for(let i = 0; i < localStorage.length; i++){
-        const key = localStorage.key(i);
-        switch (key) {
-          case Keys.KEY_PV:
-          case Keys.KEY_PV_SRC:
-          case Keys.KEY_CREATION:
-            break;
-          default:
-            localStorage.clear();
-            return;
-        }
-      }
+    function get(key) {
+        return localStorage.getItem(key);
     }
-  };
+
+    function set(key, val) {
+        localStorage.setItem(key, val);
+    }
+
+    function saveCache(pv, src) {
+        set(Keys.KEY_PV, pv);
+        set(Keys.KEY_PV_SRC, src);
+        set(Keys.KEY_CREATION, new Date().toJSON());
+    }
+
+    return {
+        keysCount() {
+            return Object.keys(Keys).length;
+        },
+        hasCache() {
+            return (localStorage.getItem(Keys.KEY_PV) !== null);
+        },
+        getCache() {
+            return JSON.parse(localStorage.getItem(Keys.KEY_PV));
+        },
+        saveLocalCache(pv) {
+            saveCache(pv, Source.LOCAL);
+        },
+        saveProxyCache(pv) {
+            saveCache(pv, Source.PROXY);
+        },
+        isExpired() {
+            let date = new Date(get(Keys.KEY_CREATION));
+            date.setHours(date.getHours() + 1);   // per hour
+            return Date.now() >= date.getTime();
+        },
+        isFromLocal() {
+            return get(Keys.KEY_PV_SRC) === Source.LOCAL;
+        },
+        isFromProxy() {
+            return get(Keys.KEY_PV_SRC) === Source.PROXY;
+        },
+        newerThan(pv) {
+            return PvStorage.getCache().totalsForAllResults["ga:pageviews"] > pv.totalsForAllResults["ga:pageviews"];
+        },
+        inspectKeys() {
+            if (localStorage.length !== PvStorage.keysCount()) {
+                localStorage.clear();
+                return;
+            }
+
+            for (let i = 0; i < localStorage.length; i++) {
+                const key = localStorage.key(i);
+                switch (key) {
+                    case Keys.KEY_PV:
+                    case Keys.KEY_PV_SRC:
+                    case Keys.KEY_CREATION:
+                        break;
+                    default:
+                        localStorage.clear();
+                        return;
+                }
+            }
+        }
+    };
 }()); /* PvStorage */
 
 function countUp(min, max, destId) {
-  if (min < max) {
-    let numAnim = new CountUp(destId, min, max);
-    if (!numAnim.error) {
-      numAnim.start();
-    } else {
-      console.error(numAnim.error);
+    if (min < max) {
+        let numAnim = new CountUp(destId, min, max);
+        if (!numAnim.error) {
+            numAnim.start();
+        } else {
+            console.error(numAnim.error);
+        }
     }
-  }
 }
 
 function countPV(path, rows) {
-  let count = 0;
+    let count = 0;
 
-  if (typeof rows !== "undefined" ) {
-    for (let i = 0; i < rows.length; ++i) {
-      const gaPath = rows[parseInt(i, 10)][0];
-      if (gaPath === path) { /* path format see: site.permalink */
-        count += parseInt(rows[parseInt(i, 10)][1], 10);
-        break;
-      }
+    if (typeof rows !== "undefined") {
+        for (let i = 0; i < rows.length; ++i) {
+            const gaPath = rows[parseInt(i, 10)][0];
+            if (gaPath === path) { /* path format see: site.permalink */
+                count += parseInt(rows[parseInt(i, 10)][1], 10);
+                break;
+            }
+        }
     }
-  }
 
-  return count;
+    return count;
 }
 
 function tacklePV(rows, path, elem, hasInit) {
-  let count = countPV(path, rows);
-  count = (count === 0 ? 1 : count);
+    let count = countPV(path, rows);
+    count = (count === 0 ? 1 : count);
 
-  if (!hasInit) {
-    elem.text(new Intl.NumberFormat().format(count));
-  } else {
-    const initCount = parseInt(elem.text().replace(/,/g, ""), 10);
-    if (count > initCount) {
-      countUp(initCount, count, elem.attr("id"));
+    if (!hasInit) {
+        elem.text(new Intl.NumberFormat().format(count));
+    } else {
+        const initCount = parseInt(elem.text().replace(/,/g, ""), 10);
+        if (count > initCount) {
+            countUp(initCount, count, elem.attr("id"));
+        }
     }
-  }
 }
 
 function displayPageviews(data) {
-  if (typeof data === "undefined") {
-    return;
-  }
+    if (typeof data === "undefined") {
+        return;
+    }
 
-  let hasInit = getInitStatus();
-  const rows = data.rows; /* could be undefined */
+    let hasInit = getInitStatus();
+    const rows = data.rows; /* could be undefined */
 
-  if ($("#post-list").length > 0) { /* the Home page */
-    $(".post-preview").each(function() {
-      const path = $(this).find("a").attr("href");
-      tacklePV(rows, path, $(this).find(".pageviews"), hasInit);
-    });
+    if ($("#post-list").length > 0) { /* the Home page */
+        $(".post-preview").each(function () {
+            const path = $(this).find("a").attr("href");
+            tacklePV(rows, path, $(this).find(".pageviews"), hasInit);
+        });
 
-  } else if ($(".post").length > 0) { /* the post */
-    const path = window.location.pathname;
-    tacklePV(rows, path, $("#pv"), hasInit);
-  }
+    } else if ($(".post").length > 0) { /* the post */
+        const path = window.location.pathname;
+        tacklePV(rows, path, $("#pv"), hasInit);
+    }
 }
 
 function fetchProxyPageviews() {
-  if (PvOpts.hasProxyMeta()) {
-    $.ajax({
-      type: "GET",
-      url: PvOpts.getProxyMeta(),
-      dataType: "jsonp",
-      jsonpCallback: "displayPageviews",
-      success: (data) => {
-        PvStorage.saveProxyCache(JSON.stringify(data));
-      },
-      error: (jqXHR, textStatus, errorThrown) => {
-        console.log("Failed to load pageviews from proxy server: " + errorThrown);
-      }
-    });
-  }
+    if (PvOpts.hasProxyMeta()) {
+        $.ajax({
+            type: "GET",
+            url: PvOpts.getProxyMeta(),
+            dataType: "jsonp",
+            jsonpCallback: "displayPageviews",
+            success: (data) => {
+                PvStorage.saveProxyCache(JSON.stringify(data));
+            },
+            error: (jqXHR, textStatus, errorThrown) => {
+                console.log("Failed to load pageviews from proxy server: " + errorThrown);
+            }
+        });
+    }
 }
 
 function fetchLocalPageviews(hasCache = false) {
-  return fetch(PvOpts.getLocalMeta())
-    .then(response => response.json())
-    .then(data => {
-      if (hasCache) {
-        // The cache from the proxy will sometimes be more recent than the local one
-        if (PvStorage.isFromProxy() && PvStorage.newerThan(data)) {
-          return;
-        }
-      }
-      displayPageviews(data);
-      PvStorage.saveLocalCache(JSON.stringify(data));
-    });
+    return fetch(PvOpts.getLocalMeta())
+        .then(response => response.json())
+        .then(data => {
+            if (hasCache) {
+                // The cache from the proxy will sometimes be more recent than the local one
+                if (PvStorage.isFromProxy() && PvStorage.newerThan(data)) {
+                    return;
+                }
+            }
+            displayPageviews(data);
+            PvStorage.saveLocalCache(JSON.stringify(data));
+        });
 }
 
-$(function() {
-  if ($(".pageviews").length <= 0) {
-    return;
-  }
-
-  PvStorage.inspectKeys();
-
-  if (PvStorage.hasCache()) {
-    displayPageviews(PvStorage.getCache());
-
-    if (PvStorage.isExpired()) {
-      if (PvOpts.hasLocalMeta()) {
-        fetchLocalPageviews(true).then(fetchProxyPageviews);
-      } else {
-        fetchProxyPageviews();
-      }
-
-    } else {
-      if (PvStorage.isFromLocal()) {
-        fetchProxyPageviews();
-      }
+$(function () {
+    if ($(".pageviews").length <= 0) {
+        return;
     }
 
-  } else { // no cached
+    PvStorage.inspectKeys();
 
-    if (PvOpts.hasLocalMeta()) {
-      fetchLocalPageviews().then(fetchProxyPageviews);
-    } else {
-      fetchProxyPageviews();
+    if (PvStorage.hasCache()) {
+        displayPageviews(PvStorage.getCache());
+
+        if (PvStorage.isExpired()) {
+            if (PvOpts.hasLocalMeta()) {
+                fetchLocalPageviews(true).then(fetchProxyPageviews);
+            } else {
+                fetchProxyPageviews();
+            }
+
+        } else {
+            if (PvStorage.isFromLocal()) {
+                fetchProxyPageviews();
+            }
+        }
+
+    } else { // no cached
+
+        if (PvOpts.hasLocalMeta()) {
+            fetchLocalPageviews().then(fetchProxyPageviews);
+        } else {
+            fetchProxyPageviews();
+        }
     }
-  }
 
 });

_javascript/utils/smooth-scroll.js

@@ -1,81 +1,96 @@
-/*
-  Safari doesn't support CSS `scroll-behavior: smooth`,
-  so here is a compatible solution for all browser to smooth scrolling
+/**
+ Safari doesn't support CSS `scroll-behavior: smooth`,
+ so here is a compatible solution for all browser to smooth scrolling
 
-  See: <https://css-tricks.com/snippets/jquery/smooth-scrolling/>
+ See: <https://css-tricks.com/snippets/jquery/smooth-scrolling/>
 
-  Warning: It must be called after all `<a>` tags (e.g., the dynamic TOC) are ready.
-*/
+ Warning: It must be called after all `<a>` tags (e.g., the dynamic TOC) are ready.
+ */
 
-$(function() {
-  $("a[href*='#']")
-    .not("[href='#']")
-    .not("[href='#0']")
-    .click(function(event) {
+$(function () {
+    const $topbarTitle = $("#topbar-title");
+    const REM = 16; // in pixels
+    const ATTR_SCROLL_FOCUS = "scroll-focus";
 
-      if (this.pathname.replace(/^\//, "") === location.pathname.replace(/^\//, "")) {
-        if (location.hostname === this.hostname) {
+    $("a[href*='#']")
+        .not("[href='#']")
+        .not("[href='#0']")
+        .click(function (event) {
+            if (this.pathname.replace(/^\//, "") !==
+                location.pathname.replace(/^\//, "")) {
+                return;
+            }
 
-          const REM = 16; /* 16px */
+            if (location.hostname !== this.hostname) {
+                return;
+            }
 
-          const hash = decodeURI(this.hash);
-          let isFnRef = RegExp(/^#fnref:/).test(hash);
-          let isFn = RegExp(/^#fn:/).test(hash);
-          let selector = hash.includes(":") ? hash.replace(/\:/, "\\:") : hash;
-          let target = $(selector);
+            const hash = decodeURI(this.hash);
+            let toFootnoteRef = RegExp(/^#fnref:/).test(hash);
+            let toFootnote = toFootnoteRef ? false : RegExp(/^#fn:/).test(hash);
+            let selector = hash.includes(":") ? hash.replace(/:/g, "\\:") : hash;
+            let $target = $(selector);
+
+            let isMobileViews = $topbarTitle.is(":visible");
+            let isPortrait = $(window).width() < $(window).height();
+
+            if (typeof $target === "undefined") {
+                return;
+            }
 
-          if (target.length) {
             event.preventDefault();
 
             if (history.pushState) { /* add hash to URL */
-              history.pushState(null, null, hash);
+                history.pushState(null, null, hash);
             }
 
-            let curOffset = $(this).offset().top;
-            let destOffset = target.offset().top;
-            const scrollUp = (destOffset < curOffset);
-            const topbarHeight = $("#topbar-wrapper").outerHeight();
+            let curOffset = $(window).scrollTop();
+            let destOffset = $target.offset().top -= REM / 2;
 
-            if (scrollUp && isFnRef) {
-              /* Avoid the top-bar covering `fnref` when scrolling up
-                because `fnref` has no `%anchor`(see: module.scss) style. */
-              destOffset -= (topbarHeight + REM / 2);
+            if (destOffset < curOffset) { // scroll up
+                ScrollHelper.hideTopbar();
+                ScrollHelper.addScrollUpTask();
+
+                if (isMobileViews && isPortrait) {
+                    destOffset -= ScrollHelper.getTopbarHeight();
+                }
+
+            } else { // scroll down
+                if (isMobileViews && isPortrait) {
+                    destOffset -= ScrollHelper.getTopbarHeight();
+                }
             }
 
-            $("html,body").animate({
-              scrollTop: destOffset
-            }, 800, () => {
+            $("html").animate({
+                scrollTop: destOffset
+            }, 500, () => {
+                $target.focus();
 
-              const $target = $(target);
-              $target.focus();
+                /* clean up old scroll mark */
+                if ($(`[${ATTR_SCROLL_FOCUS}=true]`).length) {
+                    $(`[${ATTR_SCROLL_FOCUS}=true]`).attr(ATTR_SCROLL_FOCUS, false);
+                }
 
-              const SCROLL_MARK = "scroll-focus";
+                /* Clean :target links */
+                if ($(":target").length) { /* element that visited by the URL with hash */
+                    $(":target").attr(ATTR_SCROLL_FOCUS, false);
+                }
 
-              /* clean up old scroll mark */
-              if ($(`[${SCROLL_MARK}=true]`).length) {
-                $(`[${SCROLL_MARK}=true]`).attr(SCROLL_MARK, false);
-              }
+                /* set scroll mark to footnotes */
+                if (toFootnote || toFootnoteRef) {
+                    $target.attr(ATTR_SCROLL_FOCUS, true);
+                }
 
-              /* Clean :target links */
-              if ($(":target").length) { /* element that visited by the URL with hash */
-                $(":target").attr(SCROLL_MARK, false);
-              }
+                if ($target.is(":focus")) { /* Checking if the target was focused */
+                    return false;
+                } else {
+                    $target.attr("tabindex", "-1"); /* Adding tabindex for elements not focusable */
+                    $target.focus(); /* Set focus again */
+                }
 
-              /* set scroll mark to footnotes */
-              if (isFn || isFnRef) {
-                $target.attr(SCROLL_MARK, true);
-              }
-
-              if ($target.is(":focus")) { /* Checking if the target was focused */
-                return false;
-              } else {
-                $target.attr("tabindex", "-1"); /* Adding tabindex for elements not focusable */
-                $target.focus(); /* Set focus again */
-              }
+                if (ScrollHelper.hasScrollUpTask()) {
+                    ScrollHelper.popScrollUpTask();
+                }
             });
-          }
-        }
-      }
-
-    }); /* click() */
+        }); /* click() */
 });

_javascript/utils/timeago.js

@@ -1,73 +0,0 @@
-/*
- * Calculate the Timeago
- */
-
-$(function() {
-
-  const timeagoElem = $(".timeago");
-
-  let toRefresh = timeagoElem.length;
-
-  let intervalId = void 0;
-
-  const dPrompt = $("meta[name=day-prompt]").attr("content");
-  const hrPrompt = $("meta[name=hour-prompt]").attr("content");
-  const minPrompt = $("meta[name=minute-prompt]").attr("content");
-  const justnowPrompt = $("meta[name=justnow-prompt]").attr("content");
-
-  function timeago(isoDate, dateStr) {
-    let now = new Date();
-    let past = new Date(isoDate);
-
-    if (past.getFullYear() !== now.getFullYear()
-        || past.getMonth() !== now.getMonth()) {
-      return dateStr;
-    }
-
-    let seconds = Math.floor((now - past) / 1000);
-
-    let day = Math.floor(seconds / 86400);
-    if (day >= 1) {
-      toRefresh -= 1;
-      return ` ${day} ${dPrompt}`;
-    }
-
-    let hour = Math.floor(seconds / 3600);
-    if (hour >= 1) {
-      return ` ${hour} ${hrPrompt}`;
-    }
-
-    let minute = Math.floor(seconds / 60);
-    if (minute >= 1) {
-      return ` ${minute} ${minPrompt}`;
-    }
-
-    return justnowPrompt;
-  }
-
-  function updateTimeago() {
-    $(".timeago").each(function() {
-      if ($(this).children("i").length > 0) {
-        let dateStr = $(this).clone().children().remove().end().text();
-        let node = $(this).children("i");
-        let iosDate = node.text(); /* ISO Date: "YYYY-MM-DDTHH:MM:SSZ" */
-        $(this).text(timeago(iosDate, dateStr));
-        $(this).append(node);
-      }
-    });
-
-    if (toRefresh === 0 && typeof intervalId !== "undefined") {
-      clearInterval(intervalId); /* stop interval */
-    }
-    return toRefresh;
-  }
-
-  if (toRefresh === 0) {
-    return;
-  }
-
-  if (updateTimeago() > 0) { /* run immediately */
-    intervalId = setInterval(updateTimeago, 60000); /* run every minute */
-  }
-
-});

_layouts/archives.html

@@ -3,37 +3,32 @@ layout: page
 # The Archives of posts.
 ---
 
-{% include lang.html %}
+{% assign df_strftime_m = site.data.locales[site.lang].df.archives.strftime | default: '/ %m' %}
+{% assign df_dayjs_m = site.data.locales[site.lang].df.archives.dayjs | default: '/ MM' %}
 
-<div id="archives" class="pl-xl-2">
+<div id="archives" class="pl-xl-3">
 
 {% for post in site.posts %}
-  {% capture this_year %}{{ post.date | date: "%Y" }}{% endcapture %}
-  {% capture pre_year %}{{ post.previous.date | date: "%Y" }}{% endcapture %}
-  {% if forloop.first %}
-    {% assign last_day = "" %}
-    {% assign last_month = "" %}
-  <span class="lead">{{this_year}}</span>
-  <ul class="list-unstyled">
-  {% endif %}
-    <li>
-      <div>
-        {% capture this_day %}{{ post.date | date: "%d" }}{% endcapture %}
-        {% capture _mth_df %}{{ site.data.locales[lang].date_format.post.archive_month }}{% endcapture %}
-        {% capture this_month %}{{ post.date | date: _mth_df }}{% endcapture %}
-        <span class="date day">{{ this_day }}</span>
-        <span class="date month small text-muted">{% include no-zero-date.html date_str=this_month %}</span>
-        <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
-      </div>
-    </li>
-  {% if forloop.last %}
-  </ul>
-  {% elsif this_year != pre_year %}
-  </ul>
-  <span class="lead">{{pre_year}}</span>
-  <ul class="list-unstyled">
-    {% assign last_day = "" %}
-    {% assign last_month = "" %}
+  {% capture cur_year %}{{ post.date | date: "%Y" }}{% endcapture %}
+
+  {% if cur_year != last_year %}
+    {% unless forloop.first %}</ul>{% endunless %}
+    <div class="year lead">{{ cur_year }}</div>
+    <ul class="list-unstyled">
+    {% assign last_year = cur_year %}
   {% endif %}
+
+  <li>
+  {% assign ts = post.date | date: '%s' %}
+    <span class="date day" data-ts="{{ ts }}" data-df="DD">{{ post.date | date: "%d" }}</span>
+    <span class="date month small text-muted ml-1" data-ts="{{ ts }}" data-df="{{ df_dayjs_m }}">
+      {{ post.date | date: df_strftime_m }}
+    </span>
+    <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+  </li>
+
+  {% if forloop.last %}</ul>{% endif %}
+
 {% endfor %}
+
 </div>

_layouts/categories.html

@@ -3,8 +3,6 @@ layout: page
 # All the Categories of posts
 ---
 
-{% include lang.html %}
-
 {% assign HEAD_PREFIX = "h_" %}
 {% assign LIST_PREFIX = "l_" %}
 
@@ -47,10 +45,24 @@ layout: page
         <span class="text-muted small font-weight-light">
           {% if sub_categories_size > 0 %}
             {{ sub_categories_size }}
-            {{ site.data.locales[lang].categories.category_measure }},
+            {% if sub_categories_size > 1 %}
+              {{ site.data.locales[site.lang].categories.category_measure.plural
+                | default: site.data.locales[site.lang].categories.category_measure }}
+            {% else %}
+              {{ site.data.locales[site.lang].categories.category_measure.singular
+                | default: site.data.locales[site.lang].categories.category_measure }}
+            {% endif %},
+          {% endif %}
+
+          {{ top_posts_size }}
+
+          {% if top_posts_size > 1 %}
+            {{ site.data.locales[site.lang].categories.post_measure.plural
+              | default: site.data.locales[site.lang].categories.post_measure }}
+          {% else %}
+            {{ site.data.locales[site.lang].categories.post_measure.singular
+              | default: site.data.locales[site.lang].categories.post_measure }}
           {% endif %}
-            {{ top_posts_size }}
-            {{ site.data.locales[lang].categories.post_measure }}
         </span>
       </span>
 
@@ -83,7 +95,14 @@ layout: page
           {% assign posts_size = site.categories[sub_category] | size %}
           <span class="text-muted small font-weight-light">
             {{ posts_size }}
-            {{ site.data.locales[lang].categories.post_measure }}
+
+            {% if posts_size > 1 %}
+              {{ site.data.locales[site.lang].categories.post_measure.plural
+                | default: site.data.locales[site.lang].categories.post_measure }}
+            {% else %}
+              {{ site.data.locales[site.lang].categories.post_measure.singular
+                | default: site.data.locales[site.lang].categories.post_measure }}
+            {% endif %}
           </span>
         </li>
         {% endfor %}

_layouts/category.html

@@ -3,8 +3,6 @@ layout: page
 # The Category layout
 ---
 
-{% include lang.html %}
-
 <div id="page-category">
   <h1 class="pl-lg-2">
     <i class="far fa-folder-open fa-fw text-muted"></i>
@@ -13,13 +11,11 @@ layout: page
   </h1>
 
   <ul class="post-content pl-0">
-    {% assign post_df = site.data.locales[lang].date_format.post.long %}
-
     {% for post in page.posts %}
     <li class="d-flex justify-content-between pl-md-3 pr-md-3">
       <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
       <span class="dash flex-grow-1"></span>
-      <span class="text-muted small">{{ post.date | date: post_df }}</span>
+      {% include datetime.html date=post.date wrap='span' class='text-muted small' %}
     </li>
     {% endfor %}
   </ul>

_layouts/default.html

@@ -5,37 +5,36 @@ layout: compress
 
 <!DOCTYPE html>
 
-{% include lang.html %}
+{% include assets-origin.html %}
 
 {% capture prefer_mode %}
   {% if site.theme_mode %}
-    mode="{{ site.theme_mode }}"
+    data-mode="{{ site.theme_mode }}"
   {% endif %}
 {% endcapture %}
 
-<html lang="{{ site.lang }}" {{ prefer_mode }}>
+<!-- `site.alt_lang` can specify a language different from the UI -->
+<html lang="{{ site.alt_lang | default: site.lang }}"{{ prefer_mode }}>
 
   {% include head.html %}
 
-  <body data-spy="scroll" data-target="#toc">
+  <body data-spy="scroll" data-target="#toc" data-topbar-visible="true">
 
     {% include sidebar.html %}
 
     {% include topbar.html %}
 
-    <div id="main-wrapper">
-      <div id="main">
-
-        {% include refactor-content.html content=content %}
-
-        {% include footer.html %}
-
+    <div id="main-wrapper" class="d-flex justify-content-center">
+      <div id="main" class="container pl-xl-4 pr-xl-4">
+        {{ content }}
       </div>
 
       {% include search-results.html %}
 
     </div> <!-- #main-wrapper -->
 
+    {% include footer.html %}
+
     {% if page.mermaid %}
       {% include mermaid.html %}
     {% endif %}
@@ -46,6 +45,23 @@ layout: compress
       <i class="fas fa-angle-up"></i>
     </a>
 
+    {% if site.pwa.enabled %}
+      <div id="notification" class="toast" role="alert" aria-live="assertive" aria-atomic="true"
+        data-animation="true" data-autohide="false">
+        <div class="toast-header">
+          <button type="button" class="ml-2 ml-auto close" data-dismiss="toast" aria-label="Close">
+            <span aria-hidden="true">&times;</span>
+          </button>
+        </div>
+        <div class="toast-body text-center pt-0">
+          <p class="pl-2 pr-2 mb-3">{{ site.data.locales[site.lang].notification.update_found }}</p>
+          <button type="button" class="btn btn-primary" aria-label="Update">
+            {{ site.data.locales[site.lang].notification.update }}
+          </button>
+        </div>
+      </div>
+    {% endif %}
+
     {% include search-loader.html %}
 
     {% include js-selector.html %}