Bump version to 3.0.3

Add more spec meta to gem
Merge gem-build & bump tool
2025-12-18 21:53:26 +00:00 · 2021-01-28 23:44:53 +08:00 · 2021-01-28 23:39:03 +08:00 · 2021-01-28 23:17:16 +08:00 · 2021-01-28 20:56:23 +08:00 · 2021-01-28 20:56:23 +08:00
28 changed files with 1034 additions and 999 deletions
--- a/README.md
+++ b/README.md
@@ -14,9 +14,10 @@ A minimal, sidebar, responsive web design Jekyll theme that focuses on text pres
 ## Table of Contents

 - [Features](#features)
- [Installation](#installation)
 - [Prerequisites](#prerequisites)
+- [Installation](#installation)
 - [Usage](#usage)
+- [Documentation](#documentation)
 - [Contributing](#contributing)
 - [Credits](#credits)
 - [Supporting](#supporting)
@@ -48,8 +49,8 @@ Follow the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete th

 There are two ways to get the theme:

-  - Install from [RubyGems](https://rubygems.org/gems/jekyll-theme-chirpy)
-  - Fork from GitHub
+- Install from [RubyGems](https://rubygems.org/gems/jekyll-theme-chirpy)
+- Fork from GitHub

 ### Install From Rubygems

@@ -81,9 +82,6 @@ $ bundle info --path jekyll-theme-chirpy

 Or you can [use the starter template][use-starter] to create a Jekyll site to save time copying contents from theme's gem.

-[starter]: https://github.com/cotes2020/chirpy-starter
-[use-starter]: https://github.com/cotes2020/chirpy-starter/generate
-
 ### Fork From GitHub

 [Fork **Chirpy**](https://github.com/cotes2020/jekyll-theme-chirpy/fork) from GitHub and clone your fork to local.
@@ -104,16 +102,14 @@ $ bash tools/init.sh

 What it does is:

-  1. Remove some files or directories from your repository:
+1. Remove some files or directories from your repository:
+    - `.travis.yml`
+    - files under `_posts`
+    - folder `docs`

-      - `.travis.yml`
-      - files under `_posts`
-      - folder `docs`
-
-  2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.
-
-  3. Automatically create a commit to save the changes.
+2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.

+3. Automatically create a commit to save the changes.

 ## Usage

@@ -121,10 +117,10 @@ What it does is:

 Update the variables of `_config.yml` as needed. Some of them are typical options:

-  - `url`
-  - `avatar`
-  - `timezone`
-  - `theme_mode`
+- `url`
+- `avatar`
+- `timezone`
+- `theme_mode`

 ### Running Local Server

@@ -157,23 +153,20 @@ For security reasons, GitHub Pages build runs on `safe` mode, which restricts us

 Quickly check the files needed for GitHub Actions build:

-  1. Ensure your Jekyll site has the file `/.github/workflows/pages-deploy.yml`. Otherwise, create a new one and fill in the contents of the [workflow file][workflow], and the value of the `on.push.branches` should be the same as your repo's default branch name.
-
-  2. Ensuer your Jekyll site has file `/tools/test.sh` and `/tools/deploy.sh`. Otherwise, copy them from this repo to your Jekyll site.
-
-[workflow]:https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/.github/workflows/pages-deploy.yml.hook
+1. Ensure your Jekyll site has the file `/.github/workflows/pages-deploy.yml`. Otherwise, create a new one and fill in the contents of the [workflow file][workflow], and the value of the `on.push.branches` should be the same as your repo's default branch name.
+2. Ensuer your Jekyll site has file `/tools/test.sh` and `/tools/deploy.sh`. Otherwise, copy them from this repo to your Jekyll site.

 Next, rename your repoistory to `<GH-USERNAME>.github.io` on GitHub.

 And then 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.
+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 repo's landing page on GitHub and select the branch `gh-pages` as the [publishing source](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site) throught _Settings_ → _Options_ → _GitHub Pages_:
+2. Browse to your repo's landing page on GitHub and select the branch `gh-pages` as the [publishing source](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site) throught _Settings_ → _Options_ → _GitHub Pages_:

-      ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/posts/20190809/gh-pages-sources.png)
+    ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/posts/20190809/gh-pages-sources.png)

-  3. Visit your website at the address indicated by GitHub.
+3. Visit your website at the address indicated by GitHub.

 #### Deploy on Other Platforms

@@ -197,7 +190,6 @@ $ docker run -it --rm \

 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 your web server.

-
 ## Documentation

 For more details and the better reading experience, please check out the [tutorials on 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).
@@ -212,11 +204,9 @@ This theme is mainly built with [Jekyll](https://jekyllrb.com/) ecosystem, [Boot

 :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.

-Also, thank [JetBrains][JB] for providing the open source license.
+Also, thank [JetBrains][jb] for providing the open source license.

-[![JB-logo](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/commons/jetbrains.svg)][JB]
-
-[JB]:https://www.jetbrains.com/?from=jekyll-theme-chirpy
+[![JB-logo](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/commons/jetbrains.svg)][jb]

 ## Supporting

@@ -225,3 +215,8 @@ If you enjoy this theme or find it helpful, please consider becoming my sponsor,
 ## License

 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
+[jb]:https://www.jetbrains.com/?from=jekyll-theme-chirpy
--- a/_posts/2019-08-09-getting-started.md
+++ b/_posts/2019-08-09-getting-started.md
@@ -15,8 +15,8 @@ Follow the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete th

 There are two ways to get the theme:

-  - Install from [RubyGems](https://rubygems.org/gems/jekyll-theme-chirpy)
-  - Fork from GitHub
+- Install from [RubyGems](https://rubygems.org/gems/jekyll-theme-chirpy)
+- Fork from GitHub

 ### Install From Rubygems

@@ -48,9 +48,6 @@ $ bundle info --path jekyll-theme-chirpy

 Or you can [use the starter template][use-starter] to create a Jekyll site to save time copying contents from theme's gem.

-[starter]: https://github.com/cotes2020/chirpy-starter
-[use-starter]: https://github.com/cotes2020/chirpy-starter/generate
-
 ### Fork From GitHub

 [Fork **Chirpy**](https://github.com/cotes2020/jekyll-theme-chirpy/fork) from GitHub and clone your fork to local.
@@ -71,15 +68,15 @@ $ bash tools/init.sh

 What it does is:

-  1. Remove some files or directories from your repository:
+1. Remove some files or directories from your repository:

-      - `.travis.yml`
-      - files under `_posts`
-      - folder `docs`
+    - `.travis.yml`
+    - files under `_posts`
+    - folder `docs`

-  2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.
+2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.

-  3. Automatically create a commit to save the changes.
+3. Automatically create a commit to save the changes.


 ## Usage
@@ -88,10 +85,10 @@ What it does is:

 Update the variables of `_config.yml` as needed. Some of them are typical options:

-  - `url`
-  - `avatar`
-  - `timezone`
-  - `theme_mode`
+- `url`
+- `avatar`
+- `timezone`
+- `theme_mode`

 ### Running Local Server

@@ -124,23 +121,20 @@ For security reasons, GitHub Pages build runs on `safe` mode, which restricts us

 Quickly check the files needed for GitHub Actions build:

-  1. Ensure your Jekyll site has the file `/.github/workflows/pages-deploy.yml`. Otherwise, create a new one and fill in the contents of the [workflow file][workflow], and the value of the `on.push.branches` should be the same as your repo's default branch name.
-
-  2. Ensuer your Jekyll site has file `/tools/test.sh` and `/tools/deploy.sh`. Otherwise, copy them from this repo to your Jekyll site.
-
-[workflow]:https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/.github/workflows/pages-deploy.yml.hook
+1. Ensure your Jekyll site has the file `/.github/workflows/pages-deploy.yml`. Otherwise, create a new one and fill in the contents of the [workflow file][workflow], and the value of the `on.push.branches` should be the same as your repo's default branch name.
+2. Ensuer your Jekyll site has file `/tools/test.sh` and `/tools/deploy.sh`. Otherwise, copy them from this repo to your Jekyll site.

 Next, rename your repoistory to `<GH-USERNAME>.github.io` on GitHub.

 And then 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.
+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 repo's landing page on GitHub and select the branch `gh-pages` as the [publishing source](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site) throught _Settings_ → _Options_ → _GitHub Pages_:
+2. Browse to your repo's landing page on GitHub and select the branch `gh-pages` as the [publishing source](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site) throught _Settings_ → _Options_ → _GitHub Pages_:

-      ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/posts/20190809/gh-pages-sources.png)
+    ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/posts/20190809/gh-pages-sources.png)

-  3. Visit your website at the address indicated by GitHub.
+3. Visit your website at the address indicated by GitHub.

 #### Deploy on Other Platforms

--- a/_posts/2021-01-03-enable-google-pv.md
+++ b/_posts/2021-01-03-enable-google-pv.md
@@ -16,10 +16,10 @@ This post is to enable Page Views on the [**Chirpy**][chirpy-homepage] theme bas
 First, you need to setup your account on Google analytics. While your create your account, you must create your first **Property** as well.

 1. Head to <https://analytics.google.com/> and click on **Start Measuring**
-2. Enter your desired *Account Name* and choose the desired checkboxes
-3. Enter your desired *Property Name*. This is the name of the tracker project that appears on your Google Analytics dashboard
-4. Enter the required information *About your business*
-5. Hit *Create* and accept any license popup to setup your Google Analytics account and create your property
+2. Enter your desired _Account Name_ and choose the desired checkboxes
+3. Enter your desired _Property Name_. This is the name of the tracker project that appears on your Google Analytics dashboard
+4. Enter the required information _About your business_
+5. Hit _Create_ and accept any license popup to setup your Google Analytics account and create your property

 ### Create Data Stream

@@ -75,9 +75,9 @@ There is a detailed [tutorial](https://developers.google.com/analytics/solutions

 8. Click on **Enable APIs and Services** button on the top

-9. Enable the following APIs: *Google Analytics API*
+9. Enable the following APIs: _Google Analytics API_

-10. On the left, Click on *OAuth Consent Screen* and accept **Configure Consent Screen**. Select **External** since your blog is probably hosted for the public. Click on **Publish** under *Publishing Status*
+10. On the left, Click on _OAuth Consent Screen_ and accept **Configure Consent Screen**. Select **External** since your blog is probably hosted for the public. Click on **Publish** under _Publishing Status_

 11. Click on **Credentials** on the left and create a new **OAuth Client IDs** credential. Make sure to add a entry under `Authorized redirect URIs` that matches: `https://<project-id>.<region>.r.appspot.com/admin/auth`

@@ -116,10 +116,11 @@ There is a detailed [tutorial](https://developers.google.com/analytics/solutions
 1. Clone the **Google Analytics superProxy** project on Github: <https://github.com/googleanalytics/google-analytics-super-proxy> to your local.

 2. Remove the first 2 lines in the [`src/app.yaml`](https://github.com/googleanalytics/google-analytics-super-proxy/blob/master/src/app.yaml#L1-L2) file:
-	```diff
- application: your-project-id
- version: 1
-	```
+
+    ```yaml
+    -application: your-project-id
+    -version: 1
+    ```

 3. In `src/config.py`, add the `OAUTH_CLIENT_ID` and `OAUTH_CLIENT_SECRET` that you gathered from you App Engine Dashboard.

@@ -143,7 +144,8 @@ There is a detailed [tutorial](https://developers.google.com/analytics/solutions
    # XSRF Settings
    XSRF_KEY = 'OnceUponATimeThereLivedALegend'
    ```
-**Tip:** You can configure a custom domain instead of `https://PROJECT_ID.REGION_ID.r.appspot.com`. But, for the sake of keeping it simple, we will be using the Google provided default URL.
+
+    **Tip:** You can configure a custom domain instead of `https://PROJECT_ID.REGION_ID.r.appspot.com`. But, for the sake of keeping it simple, we will be using the Google provided default URL.

 5. From inside the src/ directory, deploy the app

@@ -194,20 +196,17 @@ Head to `https://PROJECT_ID.REGION_ID.r.appspot.com/admin` and create a query af
 The query parameters are as follows:

 - **start-date**: fill in the first day of blog posting
-
 - **end-date**: fill in `today` (this is a parameter supported by GA Report, which means that it will always end according to the current query date)
-
 - **metrics**: select `ga:pageviews`
-
 - **dimensions**: select `ga:pagePath`

 In order to reduce the returned results and reduce the network bandwidth, we add custom filtering rules [^ga-filters]:

- **filters**: fill in `ga:pagePath=~^/posts/.*/$;ga:pagePath!@=`
+- **filters**: fill in `ga:pagePath=~^/posts/.*/$;ga:pagePath!@=`.

-  Among them, `;` means using _logical AND_ to concatenate two rules.
+    Among them, `;` means using _logical AND_ to concatenate two rules.

-  If the `site.baseurl` is specified, change the first filtering rule to `ga:pagePath=~^/BASE_URL/posts/.*/$`, where `BASE_URL` is the value of `site.baseurl`.
+    If the `site.baseurl` is specified, change the first filtering rule to `ga:pagePath=~^/BASE_URL/posts/.*/$`, where `BASE_URL` is the value of `site.baseurl`.

 After <kbd>Run Query</kbd>, copy the generated contents of **API Query URI** at the bottom of the page, and fill in the **Encoded URI for the query** of SuperProxy on GAE.

@@ -224,6 +223,7 @@ Once all the hard part is done, it is very easy to enable the Page View on Chirp

 Update the `_config.yml` file of [**Chirpy**][chirpy-homepage] project with the values from your dashboard, to look similar to the following:

+
 ```yaml
 google_analytics:
  id: 'G-XXXXXXXXXX'   # Fill with your Google Analytics ID
--- a/_sass/addon/commons.scss
+++ b/_sass/addon/commons.scss
--- a/_sass/addon/module.scss
+++ b/_sass/addon/module.scss
@@ -1,10 +1,5 @@
 /*
 * Mainly scss modules, only imported to `assets/css/main.scss`
-*
-* v2.1
-* https://github.com/cotes2020/jekyll-theme-chirpy
-* © 2020 Cotes Chung
-* MIT Licensed
 */

 /* ---------- scss placeholder --------- */
@@ -100,6 +95,7 @@

@mixin panel-label {
  @include label(inherit);
+
  display: block;
  line-height: 1.2;
  padding-top: 0.5rem;
--- a/_sass/addon/syntax.scss
+++ b/_sass/addon/syntax.scss
@@ -1,9 +1,5 @@
 /*
 * The syntax highlight.
-* v2.0
-* https://github.com/cotes2020/jekyll-theme-chirpy
-* © 2018-2019 Cotes Chung
-* MIT Licensed
 */

@import "colors/light-syntax";
--- a/_sass/addon/variables.scss
+++ b/_sass/addon/variables.scss
@@ -1,10 +1,5 @@
 /*
 * Mainly scss variables
-*
-* v2.1
-* https://github.com/cotes2020/jekyll-theme-chirpy
-* © 2020 Cotes Chung
-* MIT Licensed
 */

 /* --- ↓ width and height ---- */
--- a/_sass/jekyll-theme-chirpy.scss
+++ b/_sass/jekyll-theme-chirpy.scss
@@ -1,22 +1,23 @@
 /*!
 * The styles for Jekyll theme Chirpy
 *
- * Chirpy v3.0.2 (https://github.com/cotes2020/jekyll-theme-chirpy)
- * © 2021 Cotes Chung
+ * Chirpy v3.0.3 (https://github.com/cotes2020/jekyll-theme-chirpy)
+ * © 2019 Cotes Chung
 * MIT Licensed
 */

-@import "colors/light-typography";
-@import "colors/dark-typography";
+@import
+  "colors/light-typography",
+  "colors/dark-typography",

-@import "addon/module";
-@import "addon/variables";
-@import 'addon/syntax';
-@import "addon/commons";
+  "addon/module",
+  "addon/variables",
+  "addon/syntax",
+  "addon/commons",

-@import "layout/home";
-@import "layout/post";
-@import "layout/tags";
-@import "layout/archives";
-@import "layout/categories";
-@import "layout/category-tag";
+  "layout/home",
+  "layout/post",
+  "layout/tags",
+  "layout/archives",
+  "layout/categories",
+  "layout/category-tag";
--- a/_sass/layout/archives.scss
+++ b/_sass/layout/archives.scss
@@ -14,34 +14,12 @@

 #archives {
  letter-spacing: 0.03rem;
-  li {
-    font-size: 1.1rem;
-    line-height: 3rem;
-    &:nth-child(odd) {
-      background-color: var(--main-wrapper-bg, #fff);
-      background-image: linear-gradient(
-        to left, #fff, #fbfbfb, #fbfbfb, #fbfbfb, #fff);
-    }
-    > div {
-      white-space: nowrap;
-      overflow: hidden;
-      text-overflow: ellipsis;
-    }
-  }

  span.lead {
    font-size: 1.5rem;
    position: relative;
    left: 8px;

-    &:not(:first-child) {
-      position: relative;
-      left: 4px;
-      &::after {
-        left: 67px;
-      }
-    }
-
    &::after { /* Year dot */
      content: "";
      display: block;
@@ -59,8 +37,64 @@
      box-shadow: 0 0 2px 0 #c2c6cc;
      z-index: 1;
    }
+
+    &:not(:first-child) {
+      position: relative;
+      left: 4px;
+      &::after {
+        left: 67px;
+      }
+    }
+
  } // #archives span.lead

+  ul {
+    li {
+      font-size: 1.1rem;
+      line-height: 3rem;
+
+      div {
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+
+        a {
+          /* post title in Archvies */
+          margin-left: 2.5rem;
+          position: relative;
+          top: 0.1rem;
+        }
+      }
+
+      &:nth-child(odd) {
+        background-color: var(--main-wrapper-bg, #fff);
+        background-image: linear-gradient(to left, #fff, #fbfbfb, #fbfbfb, #fbfbfb, #fff);
+      }
+
+      &::after {
+        @extend %date-timeline;
+
+        height: 2.8rem;
+        top: -1.3rem;
+      }
+
+      &:first-child::before {
+        @extend %date-timeline;
+
+        height: 3.06rem;
+        top: -1.61rem;
+      }
+    }
+
+    &:not(:last-child) > li:last-child::after {
+      height: 3.4rem;
+    }
+
+    &:last-child > li:last-child::after {
+      display: none;
+    }
+  } // #archives ul
+
  .date {
    white-space: nowrap;
    display: inline-block;
@@ -97,36 +131,8 @@
    }
  } // #archives .date

-  ul {
-    > li {
-      > div > a {
-        /* post title in Archvies */
-        margin-left: 2.5rem;
-        position: relative;
-        top: 0.1rem;
-      }
-      &::after {
-        @extend %date-timeline;
-        height: 2.8rem;
-        top: -1.3rem;
-      }
-      &:first-child::before {
-        @extend %date-timeline;
-        height: 3.06rem;
-        top: -1.61rem;
-      }
-    }
-    &:not(:last-child) > li:last-child::after {
-      height: 3.4rem;
-    }
-    &:last-child > li:last-child::after {
-      display: none;
-    }
-  } // #archives ul
-
 } // #archives

-
@media all and (max-width: 576px) {
  #archives {
    margin-top: -1rem;
--- a/_sass/layout/categories.scss
+++ b/_sass/layout/categories.scss
@@ -11,6 +11,14 @@
  .card-header {
    padding-right: 12px;
  }
+
+  i {
+    &.far,
+    &.fas {
+      font-size: 86%; // fontawesome icons
+    }
+  }
+
  .list-group-item {
    border-left: none;
    border-right: none;
@@ -29,12 +37,6 @@
    @extend %category-icon-color;
  }

-  i {
-    &.far, &.fas {
-      font-size: 86%; // fontawesome icons
-    }
-  }
-
 } // .categories

 .category-trigger {
@@ -42,7 +44,7 @@
  height: 1.7rem;
  border-radius: 50%;
  text-align: center;
-  color: #6c757d!important;
+  color: #6c757d !important;
  > i.fas {
    position: relative;
    height: 0.7rem;
--- a/_sass/layout/category-tag.scss
+++ b/_sass/layout/category-tag.scss
@@ -2,10 +2,17 @@
  Style for page Category and Tag
 */

-#page-category, #page-tag {
+.dash {
+  margin: 0 .5rem .6rem .5rem;
+  border-bottom: 2px dotted var(--dash-color);
+}
+
+#page-category,
+#page-tag {
  ul > li {
    line-height: 1.5rem;
    padding: 0.6rem 0;
+
    &::before { // dot
      background: #999;
      width: 5px;
@@ -17,14 +24,16 @@
      top: 0.6rem;
      margin-right: 0.5rem;
    }
+
    > a { /* post's title */
-      font-size: 1.1rem;
      @extend %no-bottom-border;
+
+      font-size: 1.1rem;
    }
+
    > span:last-child {
      white-space: nowrap;
-    }
-    /* post's date */
+    } /* post's date */
  }
 }

@@ -36,22 +45,19 @@
  font-size: 1.25rem;
 }

-a:hover {
-  #page-category &,
-  #page-tag &,
-  #access-lastmod & {
+#page-category,
+#page-tag,
+#access-lastmod {
+  a:hover {
    @extend %link-hover;
+
    margin-bottom: -1px; // Avoid jumping
  }
 }

-.dash {
-  margin: 0 .5rem .6rem .5rem;
-  border-bottom: 2px dotted var(--dash-color);
-}
-
@media all and (max-width: 576px) {
-  #page-category, #page-tag {
+  #page-category,
+  #page-tag {
    ul > li {
      &::before {
        margin: 0 .5rem;
--- a/_sass/layout/home.scss
+++ b/_sass/layout/home.scss
@@ -2,6 +2,60 @@
  Style for Homepage
 */

+.pagination {
+  font-size: 1rem;
+  a:hover {
+    text-decoration: none;
+  }
+
+  .page-item {
+    .page-link {
+      color: var(--btn-patinator-text-color);
+      width: 2.5rem;
+      height: 2.5rem;
+      padding: 0;
+      text-align: center;
+      display: -webkit-box;
+      display: flex;
+      -webkit-box-pack: center;
+      justify-content: center;
+      -webkit-box-align: center;
+      align-items: center;
+      border-radius: 50%;
+      border: 1px solid var(--btn-paginator-border-color);
+      font-family: 'Lato', sans-serif;
+      background-color: var(--button-bg);
+      &:hover {
+        background-color: var(--btn-paginator-hover-color);
+      }
+    }
+    &.active {
+      .page-link {
+        background-color: var(--btn-active-bg);
+        border-color: var(--btn-active-border-color);
+        box-shadow: 0 0 8px 0 var(--btn-paginator-shadow) !important;
+        color: var(--btn-text-color);
+      }
+    }
+    &.disabled {
+      cursor: not-allowed;
+      .page-link {
+        color: rgba(108, 117, 125, 0.57);
+        border-color: var(--btn-paginator-border-color);
+        background-color: var(--button-bg);
+      }
+    }
+    &:first-child .page-link,
+    &:last-child .page-link {
+      border-radius: 50%;
+    }
+    &:not(:last-child) {
+      margin-right: 0.7rem;
+    }
+  } // .page-item
+
+} // .pagination
+
 #post-list {
  margin-top: 1rem;
  padding-right: 0.5rem;
@@ -11,6 +65,10 @@
    padding-bottom: 1rem;
    border-bottom: 1px solid var(--main-border-color);

+    a:hover {
+      @extend %link-hover;
+    }
+
    h1 {
      font-size: 1.4rem;
      margin: 0;
@@ -55,60 +113,6 @@

 } // #post-list

-.pagination {
-  font-size: 1rem;
-  a:hover {
-    text-decoration: none;
-  }
-
-  .page-item {
-    .page-link {
-      color: var(--btn-patinator-text-color);
-      width: 2.5rem;
-      height: 2.5rem;
-      padding: 0;
-      text-align: center;
-      display: -webkit-box;
-      display: flex;
-      -webkit-box-pack: center;
-      justify-content: center;
-      -webkit-box-align: center;
-      align-items: center;
-      border-radius: 50%;
-      border: 1px solid var(--btn-paginator-border-color);
-      font-family: 'Lato', sans-serif;
-      background-color: var(--button-bg);
-      &:hover {
-        background-color: var(--btn-paginator-hover-color)
-      }
-    }
-    &.active {
-      .page-link {
-        background-color: var(--btn-active-bg);
-        border-color: var(--btn-active-border-color);
-        box-shadow: 0 0 8px 0 var(--btn-paginator-shadow) !important;
-        color: var(--btn-text-color);
-      }
-    }
-    &.disabled {
-      cursor: not-allowed;
-      .page-link {
-        color: rgba(108, 117, 125, 0.57);
-        border-color: var(--btn-paginator-border-color);
-        background-color: var(--button-bg);
-      }
-    }
-    &:first-child .page-link,
-    &:last-child .page-link {
-      border-radius: 50%;
-    }
-    &:not(:last-child) {
-      margin-right: 0.7rem;
-    }
-  } // .page-item
-
-} // .pagination
-
 /* Hide SideBar and TOC */
@media all and (max-width: 830px) {
  .pagination {
--- a/_sass/layout/post.scss
+++ b/_sass/layout/post.scss
@@ -4,7 +4,7 @@

@mixin btn-sharing-color($light-color, $important: false) {
  @if $important {
-    color: var(--btn-share-color, $light-color)!important;
+    color: var(--btn-share-color, $light-color) !important;
  } @else {
    color: var(--btn-share-color, $light-color);
  }
@@ -41,9 +41,10 @@

 .post-content {
  .preview-img {
+    @include align-center;
+
    margin-top: 0;
    margin-bottom: 2.5rem;
-    @include align-center;
  }
 }

@@ -63,6 +64,7 @@

  .btn {
    @include btn-post-nav;
+
    color: var(--link-color);
    &:hover {
      background: #2a408e;
@@ -71,6 +73,7 @@
    }
    &.disabled {
      @include btn-post-nav;
+
      pointer-events: auto;
      cursor: not-allowed;
      background: none;
@@ -139,17 +142,16 @@
  }
 }

-#toc li>a {
+#toc li > a {
  line-height: 1rem;
  padding-top: 0.5rem;
  padding-bottom: 0.5rem;
 }

-
-/*--- Related Posts ---*/
+/* --- Related Posts --- */

 #related-posts {
-  >h3 {
+  > h3 {
    @include label(1.1rem, 600);
  }
  .card {
@@ -165,7 +167,7 @@
    &:hover {
      -webkit-transform: translate3d(0, -3px, 0);
      transform: translate3d(0, -3px, 0);
-      box-shadow: 0 10px 15px -4px rgba(0,0,0,0.15);
+      box-shadow: 0 10px 15px -4px rgba(0, 0, 0, 0.15);
    }
  }

@@ -190,7 +192,7 @@
  ul {
    list-style-type: none;
    padding-inline-start: 1.5rem;
-    >li::before {
+    > li::before {
      background: #c2c9d4;
      width: 5px;
      height: 5px;
@@ -216,12 +218,17 @@
 }

 %btn-share-hovor {
-  color: var(--btn-share-hover-color)!important;
+  color: var(--btn-share-hover-color) !important;
 }

 .share-wrapper {
  vertical-align: middle;
  user-select: none;
+
+  i {
+    font-weight: 400;
+  }
+
  .share-icons {
    font-size: 1.2rem;
    a {
@@ -230,12 +237,12 @@
      }
      &:hover {
        text-decoration: none;
-        >i {
+        > i {
          @extend %btn-share-hovor;
        }
      }
    }
-    >i {
+    > i {
      padding-top: 0.35rem;
      &:hover {
        @extend %btn-share-hovor;
@@ -243,7 +250,7 @@
    }
    .fab {
      &.fa-twitter {
-        @include btn-sharing-color(rgba(29, 161, 242, 1.00));
+        @include btn-sharing-color(rgba(29, 161, 242, 1));
      }
      &.fa-facebook-square {
        @include btn-sharing-color(rgb(66, 95, 156));
@@ -264,9 +271,9 @@

 } // .share-wrapper

-
 .share-label {
  @include label(inherit, 400, inherit);
+
  &::after {
    content: ":";
  }
@@ -274,25 +281,22 @@

 .license-wrapper {
  line-height: 1.2rem;
-  >a {
+  > a {
    font-weight: 600;
    &:hover {
      @extend %link-hover;
    }
  }
-  i {
-    font-weight: 400;
-  }
+
  span:last-child {
    font-size: 0.85rem;
  }
 } // .license-wrapper

-
@media all and (max-width: 576px) {
  .post-tail-bottom {
-    -ms-flex-wrap: wrap-reverse!important;
-    flex-wrap: wrap-reverse!important;
+    -ms-flex-wrap: wrap-reverse !important;
+    flex-wrap: wrap-reverse !important;
    >div:first-child {
      width: 100%;
      margin-top: 1rem;
@@ -301,8 +305,8 @@

  .post-content > div[class^='language-'] {
    @include ml-mr(-1.25rem);
-    border-radius: 0;

+    border-radius: 0;
    &::before { // the lang badge
      right: 1rem;
    }
@@ -323,10 +327,10 @@
        @include dot(0.5rem, 0.2rem);
      }
      &.flex-column {
-        -webkit-box-orient: horizontal!important;
-        -webkit-box-direction: normal!important;
-        -ms-flex-direction: row!important;
-        flex-direction: row!important;
+        -webkit-box-orient: horizontal !important;
+        -webkit-box-direction: normal !important;
+        -ms-flex-direction: row !important;
+        flex-direction: row !important;
      }
    }
  } // .post
--- a/assets/img/favicons/browserconfig.xml
+++ b/assets/img/favicons/browserconfig.xml
@@ -2,10 +2,6 @@
 layout: compress

 # A part of the Favicons
-# v2.0
-# https://github.com/cotes2020/jekyll-theme-chirpy
-# © 2019 Cotes Chung
-# MIT License
 ---
 <?xml version="1.0" encoding="utf-8"?>
 <browserconfig>
@@ -17,4 +13,4 @@ layout: compress
      <TileColor>#ffffff</TileColor>
    </tile>
  </msapplication>
-</browserconfig>
+</browserconfig>
--- a/assets/img/favicons/manifest.json
+++ b/assets/img/favicons/manifest.json
@@ -2,10 +2,6 @@
 layout: compress
 #
 # A part of the Favicons
-# Chirpy v2.0
-# https://github.com/cotes2020/jekyll-theme-chirpy
-# © 2019 Cotes Chung
-# MIT License
 ---

 {% assign icon_url = "/assets/img/favicons" | relative_url %}
--- a/assets/js/.copyright
+++ b/assets/js/.copyright
@@ -1,5 +1,5 @@
 /*!
- * Chirpy v3.0.2 (https://github.com/cotes2020/jekyll-theme-chirpy/)
- * © 2021 Cotes Chung
+ * Chirpy v3.0.3 (https://github.com/cotes2020/jekyll-theme-chirpy/)
+ * © 2019 Cotes Chung
 * MIT Licensed
 */
--- a/assets/js/data/cache-list.js
+++ b/assets/js/data/cache-list.js
@@ -2,10 +2,6 @@
 layout: compress

 # The list to be cached by PWA
-# Chirpy v2.2
-# https://github.com/cotes2020/jekyll-theme-chirpy
-# © 2020 Cotes Chung
-# MIT Licensed
 ---

 const include = [
--- a/assets/js/dist/categories.min.js
+++ b/assets/js/dist/categories.min.js
@@ -1,6 +1,6 @@
 /*!
- * Chirpy v3.0.2 (https://github.com/cotes2020/jekyll-theme-chirpy/)
- * © 2021 Cotes Chung
+ * Chirpy v3.0.3 (https://github.com/cotes2020/jekyll-theme-chirpy/)
+ * © 2019 Cotes Chung
 * MIT Licensed
 */
 function copyLink(e){e&&0!==e.length||(e=window.location.href);const o=$("<input>");$("body").append(o),o.val(e).select(),document.execCommand("copy"),o.remove(),alert("Link copied successfully!")}$(function(){$(window).scroll(()=>{$(this).scrollTop()>50&&"none"===$("#sidebar-trigger").css("display")?$("#back-to-top").fadeIn():$("#back-to-top").fadeOut()}),$("#back-to-top").click(()=>($("body,html").animate({scrollTop:0},800),!1))}),$(function(){$("input[type=checkbox]").addClass("unloaded"),$("input[type=checkbox][checked]").before('<i class="fas fa-check-circle checked"></i>'),$("input[type=checkbox]:not([checked])").before('<i class="far fa-circle"></i>')}),$(function(){const e=$("#sidebar-trigger"),o=$("#search-trigger"),s=$("#search-cancel"),t=$("#search-cleaner"),a=$("#main"),l=$("#topbar-title"),n=$("#search-wrapper"),d=$("#search-result-wrapper"),r=$("#search-results"),c=$("#search-input"),i=$("#search-hints"),f=function(){let e=0;return{block(){e=$(window).scrollTop()},release(){$("html,body").scrollTop(e)},getOffset:()=>e}}(),u={on(){e.addClass("unloaded"),l.addClass("unloaded"),o.addClass("unloaded"),n.addClass("d-flex"),s.addClass("loaded")},off(){s.removeClass("loaded"),n.removeClass("d-flex"),e.removeClass("unloaded"),l.removeClass("unloaded"),o.removeClass("unloaded")}},p=function(){let e=!1;return{on(){e||(d.removeClass("unloaded"),a.addClass("hidden"),e=!0,f.block())},off(){e&&(r.empty(),i.hasClass("unloaded")&&i.removeClass("unloaded"),d.addClass("unloaded"),t.removeClass("visible"),a.removeClass("hidden"),c.val(""),e=!1,f.release())},isVisible:()=>e}}();function h(){return s.hasClass("loaded")}o.click(function(){u.on(),p.on(),c.focus()}),s.click(function(){u.off(),p.off()}),c.focus(function(){n.addClass("input-focus")}),c.focusout(function(){n.removeClass("input-focus")}),c.on("keyup",function(e){8===e.keyCode&&""===c.val()?h()?i.removeClass("unloaded"):p.off():""!==c.val()&&(p.on(),t.hasClass("visible")||t.addClass("visible"),h()&&i.addClass("unloaded"))}),t.on("click",function(){c.val(""),h()?(i.removeClass("unloaded"),r.empty()):p.off(),c.focus(),t.removeClass("visible")})}),$(function(){const e=function(){let e=!1;const o=$("body");return{toggle(){!1===e?o.attr("sidebar-display",""):o.removeAttr("sidebar-display"),e=!e}}}();$("#sidebar-trigger").click(e.toggle),$("#mask").click(e.toggle)}),$(function(){$('[data-toggle="tooltip"]').tooltip()}),$(function(){const e=$("#topbar-wrapper"),o=$("#toc-wrapper"),s=$(".access"),t=$("#search-input");let a,l=0;const n=5,d=e.outerHeight();$(window).scroll(function(e){$("#topbar-title").is(":hidden")&&(a=!0)}),setInterval(function(){a&&(!function(){var a=$(this).scrollTop();Math.abs(l-a)<=n||(a>l&&a>d?(e.removeClass("topbar-down").addClass("topbar-up"),o.length>0&&o.removeClass("topbar-down"),s.length>0&&s.removeClass("topbar-down"),t.is(":focus")&&t.blur()):a+$(window).height()<$(document).height()&&(e.removeClass("topbar-up").addClass("topbar-down"),o.length>0&&o.addClass("topbar-down"),s.length>0&&s.addClass("topbar-down")),l=a)}(),a=!1)},250)}),$(function(){const e=$("#topbar-title"),o=$("div.post>h1"),s=e.text().trim();let t=o.length>0?o.text().trim():$("h1").text().trim();($("#page-category").length||$("#page-tag").length)&&/\s/.test(t)&&(t=t.replace(/[0-9]/g,"").trim()),$(window).scroll(function(){if($("#post-list").length||o.is(":hidden")||e.is(":hidden")||$("#sidebar.sidebar-expand").length)return!1;$(this).scrollTop()>=95?e.text()!==t&&e.text(t):e.text()!==s&&e.text(s)}),e.click(function(){$("body,html").animate({scrollTop:0},800)})}),$(function(){const e=$(".collapse");e.on("hide.bs.collapse",function(){const e="h_"+$(this).attr("id").substring("l_".length);e&&($(`#${e} .far.fa-folder-open`).attr("class","far fa-folder fa-fw"),$(`#${e} i.fas`).addClass("rotate"),$(`#${e}`).removeClass("hide-border-bottom"))}),e.on("show.bs.collapse",function(){const e="h_"+$(this).attr("id").substring("l_".length);e&&($(`#${e} .far.fa-folder`).attr("class","far fa-folder-open fa-fw"),$(`#${e} i.fas`).removeClass("rotate"),$(`#${e}`).addClass("hide-border-bottom"))})});
--- a/assets/js/dist/home.min.js
+++ b/assets/js/dist/home.min.js
@@ -1,6 +1,6 @@
 /*!
- * Chirpy v3.0.2 (https://github.com/cotes2020/jekyll-theme-chirpy/)
- * © 2021 Cotes Chung
+ * Chirpy v3.0.3 (https://github.com/cotes2020/jekyll-theme-chirpy/)
+ * © 2019 Cotes Chung
 * MIT Licensed
 */
 function copyLink(e){e&&0!==e.length||(e=window.location.href);const t=$("<input>");$("body").append(t),t.val(e).select(),document.execCommand("copy"),t.remove(),alert("Link copied successfully!")}$(function(){$(window).scroll(()=>{$(this).scrollTop()>50&&"none"===$("#sidebar-trigger").css("display")?$("#back-to-top").fadeIn():$("#back-to-top").fadeOut()}),$("#back-to-top").click(()=>($("body,html").animate({scrollTop:0},800),!1))}),$(function(){$("input[type=checkbox]").addClass("unloaded"),$("input[type=checkbox][checked]").before('<i class="fas fa-check-circle checked"></i>'),$("input[type=checkbox]:not([checked])").before('<i class="far fa-circle"></i>')}),$(function(){const e=$("#sidebar-trigger"),t=$("#search-trigger"),o=$("#search-cancel"),a=$("#search-cleaner"),s=$("#main"),n=$("#topbar-title"),l=$("#search-wrapper"),i=$("#search-result-wrapper"),r=$("#search-results"),c=$("#search-input"),d=$("#search-hints"),u=function(){let e=0;return{block(){e=$(window).scrollTop()},release(){$("html,body").scrollTop(e)},getOffset:()=>e}}(),h={on(){e.addClass("unloaded"),n.addClass("unloaded"),t.addClass("unloaded"),l.addClass("d-flex"),o.addClass("loaded")},off(){o.removeClass("loaded"),l.removeClass("d-flex"),e.removeClass("unloaded"),n.removeClass("unloaded"),t.removeClass("unloaded")}},f=function(){let e=!1;return{on(){e||(i.removeClass("unloaded"),s.addClass("hidden"),e=!0,u.block())},off(){e&&(r.empty(),d.hasClass("unloaded")&&d.removeClass("unloaded"),i.addClass("unloaded"),a.removeClass("visible"),s.removeClass("hidden"),c.val(""),e=!1,u.release())},isVisible:()=>e}}();function p(){return o.hasClass("loaded")}t.click(function(){h.on(),f.on(),c.focus()}),o.click(function(){h.off(),f.off()}),c.focus(function(){l.addClass("input-focus")}),c.focusout(function(){l.removeClass("input-focus")}),c.on("keyup",function(e){8===e.keyCode&&""===c.val()?p()?d.removeClass("unloaded"):f.off():""!==c.val()&&(f.on(),a.hasClass("visible")||a.addClass("visible"),p()&&d.addClass("unloaded"))}),a.on("click",function(){c.val(""),p()?(d.removeClass("unloaded"),r.empty()):f.off(),c.focus(),a.removeClass("visible")})}),$(function(){const e=function(){let e=!1;const t=$("body");return{toggle(){!1===e?t.attr("sidebar-display",""):t.removeAttr("sidebar-display"),e=!e}}}();$("#sidebar-trigger").click(e.toggle),$("#mask").click(e.toggle)}),$(function(){$('[data-toggle="tooltip"]').tooltip()}),$(function(){const e=$("#topbar-wrapper"),t=$("#toc-wrapper"),o=$(".access"),a=$("#search-input");let s,n=0;const l=5,i=e.outerHeight();$(window).scroll(function(e){$("#topbar-title").is(":hidden")&&(s=!0)}),setInterval(function(){s&&(!function(){var s=$(this).scrollTop();Math.abs(n-s)<=l||(s>n&&s>i?(e.removeClass("topbar-down").addClass("topbar-up"),t.length>0&&t.removeClass("topbar-down"),o.length>0&&o.removeClass("topbar-down"),a.is(":focus")&&a.blur()):s+$(window).height()<$(document).height()&&(e.removeClass("topbar-up").addClass("topbar-down"),t.length>0&&t.addClass("topbar-down"),o.length>0&&o.addClass("topbar-down")),n=s)}(),s=!1)},250)}),$(function(){const e=$("#topbar-title"),t=$("div.post>h1"),o=e.text().trim();let a=t.length>0?t.text().trim():$("h1").text().trim();($("#page-category").length||$("#page-tag").length)&&/\s/.test(a)&&(a=a.replace(/[0-9]/g,"").trim()),$(window).scroll(function(){if($("#post-list").length||t.is(":hidden")||e.is(":hidden")||$("#sidebar.sidebar-expand").length)return!1;$(this).scrollTop()>=95?e.text()!==a&&e.text(a):e.text()!==o&&e.text(o)}),e.click(function(){$("body,html").animate({scrollTop:0},800)})}),$(function(){let e=$(".timeago").length,t=void 0;function o(){return $(".timeago").each(function(){if($(this).children("i").length>0){$(this).text();let t=$(this).hasClass("lastmod"),o=$(this).children("i"),a=o.text();$(this).text(function(t,o){let a=new Date,s=new Date(t);if(s.getFullYear()!==a.getFullYear())return e-=1,s.toLocaleString("en-US",{year:"numeric",month:"short",day:"numeric"});if(s.getMonth()!==a.getMonth())return e-=1,s.toLocaleString("en-US",{month:"short",day:"numeric"});let n=Math.floor((a-s)/1e3),l=Math.floor(n/86400);if(l>=1)return e-=1,l+" day"+(l>1?"s":"")+" ago";let i=Math.floor(n/3600);if(i>=1)return i+" hour"+(i>1?"s":"")+" ago";let r=Math.floor(n/60);return r>=1?r+" minute"+(r>1?"s":"")+" ago":(o?"just":"Just")+" now"}(a,t)),$(this).append(o)}}),0===e&&void 0!==t&&clearInterval(t),e}0!==e&&o()>0&&(t=setInterval(o,6e4))});
--- a/assets/js/dist/page.min.js
+++ b/assets/js/dist/page.min.js
@@ -1,6 +1,6 @@
 /*!
- * Chirpy v3.0.2 (https://github.com/cotes2020/jekyll-theme-chirpy/)
- * © 2021 Cotes Chung
+ * Chirpy v3.0.3 (https://github.com/cotes2020/jekyll-theme-chirpy/)
+ * © 2019 Cotes Chung
 * MIT Licensed
 */
 function copyLink(e){e&&0!==e.length||(e=window.location.href);const t=$("<input>");$("body").append(t),t.val(e).select(),document.execCommand("copy"),t.remove(),alert("Link copied successfully!")}$(function(){$(window).scroll(()=>{$(this).scrollTop()>50&&"none"===$("#sidebar-trigger").css("display")?$("#back-to-top").fadeIn():$("#back-to-top").fadeOut()}),$("#back-to-top").click(()=>($("body,html").animate({scrollTop:0},800),!1))}),$(function(){$("input[type=checkbox]").addClass("unloaded"),$("input[type=checkbox][checked]").before('<i class="fas fa-check-circle checked"></i>'),$("input[type=checkbox]:not([checked])").before('<i class="far fa-circle"></i>')}),$(function(){const e=$("#sidebar-trigger"),t=$("#search-trigger"),o=$("#search-cancel"),s=$("#search-cleaner"),a=$("#main"),l=$("#topbar-title"),n=$("#search-wrapper"),c=$("#search-result-wrapper"),r=$("#search-results"),i=$("#search-input"),d=$("#search-hints"),u=function(){let e=0;return{block(){e=$(window).scrollTop()},release(){$("html,body").scrollTop(e)},getOffset:()=>e}}(),f={on(){e.addClass("unloaded"),l.addClass("unloaded"),t.addClass("unloaded"),n.addClass("d-flex"),o.addClass("loaded")},off(){o.removeClass("loaded"),n.removeClass("d-flex"),e.removeClass("unloaded"),l.removeClass("unloaded"),t.removeClass("unloaded")}},p=function(){let e=!1;return{on(){e||(c.removeClass("unloaded"),a.addClass("hidden"),e=!0,u.block())},off(){e&&(r.empty(),d.hasClass("unloaded")&&d.removeClass("unloaded"),c.addClass("unloaded"),s.removeClass("visible"),a.removeClass("hidden"),i.val(""),e=!1,u.release())},isVisible:()=>e}}();function h(){return o.hasClass("loaded")}t.click(function(){f.on(),p.on(),i.focus()}),o.click(function(){f.off(),p.off()}),i.focus(function(){n.addClass("input-focus")}),i.focusout(function(){n.removeClass("input-focus")}),i.on("keyup",function(e){8===e.keyCode&&""===i.val()?h()?d.removeClass("unloaded"):p.off():""!==i.val()&&(p.on(),s.hasClass("visible")||s.addClass("visible"),h()&&d.addClass("unloaded"))}),s.on("click",function(){i.val(""),h()?(d.removeClass("unloaded"),r.empty()):p.off(),i.focus(),s.removeClass("visible")})}),$(function(){const e=function(){let e=!1;const t=$("body");return{toggle(){!1===e?t.attr("sidebar-display",""):t.removeAttr("sidebar-display"),e=!e}}}();$("#sidebar-trigger").click(e.toggle),$("#mask").click(e.toggle)}),$(function(){$('[data-toggle="tooltip"]').tooltip()}),$(function(){const e=$("#topbar-wrapper"),t=$("#toc-wrapper"),o=$(".access"),s=$("#search-input");let a,l=0;const n=5,c=e.outerHeight();$(window).scroll(function(e){$("#topbar-title").is(":hidden")&&(a=!0)}),setInterval(function(){a&&(!function(){var a=$(this).scrollTop();Math.abs(l-a)<=n||(a>l&&a>c?(e.removeClass("topbar-down").addClass("topbar-up"),t.length>0&&t.removeClass("topbar-down"),o.length>0&&o.removeClass("topbar-down"),s.is(":focus")&&s.blur()):a+$(window).height()<$(document).height()&&(e.removeClass("topbar-up").addClass("topbar-down"),t.length>0&&t.addClass("topbar-down"),o.length>0&&o.addClass("topbar-down")),l=a)}(),a=!1)},250)}),$(function(){const e=$("#topbar-title"),t=$("div.post>h1"),o=e.text().trim();let s=t.length>0?t.text().trim():$("h1").text().trim();($("#page-category").length||$("#page-tag").length)&&/\s/.test(s)&&(s=s.replace(/[0-9]/g,"").trim()),$(window).scroll(function(){if($("#post-list").length||t.is(":hidden")||e.is(":hidden")||$("#sidebar.sidebar-expand").length)return!1;$(this).scrollTop()>=95?e.text()!==s&&e.text(s):e.text()!==o&&e.text(o)}),e.click(function(){$("body,html").animate({scrollTop:0},800)})}),$(function(){$("a[href*='#']").not("[href='#']").not("[href='#0']").click(function(e){if(this.pathname.replace(/^\//,"")===location.pathname.replace(/^\//,"")&&location.hostname===this.hostname){const t=16,o=decodeURI(this.hash);let s=RegExp(/^#fnref:/).test(o),a=RegExp(/^#fn:/).test(o),l=o.includes(":")?o.replace(/\:/,"\\:"):o,n=$(l);if(n.length){e.preventDefault(),history.pushState&&history.pushState(null,null,o);let l=$(this).offset().top,c=n.offset().top;const r=c<l,i=$("#topbar-wrapper").outerHeight();r&&s&&(c-=i+t/2),$("html,body").animate({scrollTop:c},800,()=>{const e=$(n);e.focus();if($("[scroll-focus=true]").length&&$("[scroll-focus=true]").attr("scroll-focus",!1),$(":target").length&&$(":target").attr("scroll-focus",!1),(a||s)&&e.attr("scroll-focus",!0),e.is(":focus"))return!1;e.attr("tabindex","-1"),e.focus()})}}})});
--- a/assets/js/dist/post.min.js
+++ b/assets/js/dist/post.min.js
--- a/assets/js/dist/pvreport.min.js
+++ b/assets/js/dist/pvreport.min.js
@@ -1,6 +1,6 @@
 /*!
- * Chirpy v3.0.2 (https://github.com/cotes2020/jekyll-theme-chirpy/)
- * © 2021 Cotes Chung
+ * Chirpy v3.0.3 (https://github.com/cotes2020/jekyll-theme-chirpy/)
+ * © 2019 Cotes Chung
 * MIT Licensed
 */
 const getInitStatus=function(){let e=!1;return()=>{let t=e;return e||(e=!0),t}}(),PvOpts={isEnabled:()=>"true"===$("meta[name=pv-cache-enabled]").attr("content"),getProxyEndpoint:()=>$("meta[name=pv-proxy-endpoint]").attr("content"),getLocalData:()=>$("meta[name=pv-cache-data]").attr("content")},PvCache=function(){const e="origin",t="proxy";function a(e){return localStorage.getItem(e)}function n(e,t){localStorage.setItem(e,t)}return{getData:()=>JSON.parse(localStorage.getItem("pv")),saveOriginCache(t){n("pv",t),n("pv_source",e),n("pv_created_date",(new Date).toJSON())},saveProxyCache(e){n("pv",e),n("pv_source",t),n("pv_created_date",(new Date).toJSON())},isFromOrigin:()=>a("pv_source")===e,isFromProxy:()=>a("pv_source")===t,isExpired(){if(PvCache.isFromOrigin()){let e=new Date(a("pv_created_date"));return e.setDate(e.getDate()+1),Date.now()>=e.getTime()}if(PvCache.isFromProxy()){let e=new Date(a("pv_created_date"));return e.setHours(e.getHours()+1),Date.now()>=e.getTime()}return!1},getAllPageviews:()=>PvCache.getData().totalsForAllResults["ga:pageviews"],newerThan:e=>PvCache.getAllPageviews()>e.totalsForAllResults["ga:pageviews"],inspectKeys(){null!==localStorage.getItem("pv")&&null!==localStorage.getItem("pv_source")&&null!==localStorage.getItem("pv_created_date")||localStorage.clear()}}}();function countUp(e,t,a){if(e<t){let n=new CountUp(a,e,t);n.error?console.error(n.error):n.start()}}function countPV(e,t){let a=0;if(void 0!==t)for(let n=0;n<t.length;++n){if(t[parseInt(n,10)][0]===e){a+=parseInt(t[parseInt(n,10)][1],10);break}}return a}function tacklePV(e,t,a,n){let r=countPV(t,e);if(r=0===r?1:r,n){const e=parseInt(a.text().replace(/,/g,""),10);r>e&&countUp(e,r,a.attr("id"))}else a.text((new Intl.NumberFormat).format(r))}function displayPageviews(e){if(void 0===e)return;let t=getInitStatus();const a=e.rows;if($("#post-list").length>0)$(".post-preview").each(function(){const e=$(this).find("a").attr("href");tacklePV(a,e,$(this).find(".pageviews"),t)});else if($(".post").length>0){const e=window.location.pathname;tacklePV(a,e,$("#pv"),t)}}function fetchProxyPageviews(){$.ajax({type:"GET",url:PvOpts.getProxyEndpoint(),dataType:"jsonp",jsonpCallback:"displayPageviews",success:(e,t,a)=>{PvCache.saveProxyCache(JSON.stringify(e))},error:(e,t,a)=>{console.log("Failed to load pageviews from proxy server: "+a)}})}function fetchPageviews(e=!0,t=!1){PvOpts.isEnabled()&&e?fetch(PvOpts.getLocalData()).then(e=>e.json()).then(e=>{t&&PvCache.newerThan(e)||(displayPageviews(e),PvCache.saveOriginCache(JSON.stringify(e)))}).then(()=>fetchProxyPageviews()):fetchProxyPageviews()}$(function(){if($(".pageviews").length>0){PvCache.inspectKeys();let e=PvCache.getData();e?(displayPageviews(e),PvCache.isExpired()?fetchPageviews(!0,PvCache.isFromProxy()):PvCache.isFromOrigin()&&fetchPageviews(!1)):fetchPageviews()}});
--- a/docs/README.zh-CN.md
+++ b/docs/README.zh-CN.md
@@ -19,6 +19,7 @@ Language: [English](https://github.com/cotes2020/jekyll-theme-chirpy#readme) |
 - [前提要求](#前提要求)
 - [安装](#安装)
 - [使用](#使用)
+- [文档](#文档)
 - [参与贡献](#参与贡献)
 - [鸣谢](#鸣谢)
 - [赞助](#赞助)
@@ -53,8 +54,8 @@ Language: [English](https://github.com/cotes2020/jekyll-theme-chirpy#readme) |

 有二法可得此主题:

-  - 从 [RubyGems](https://rubygems.org/gems/jekyll-theme-chirpy) 安装
-  - 从 GitHub 上 Fork
+- 从 [RubyGems](https://rubygems.org/gems/jekyll-theme-chirpy) 安装
+- 从 GitHub 上 Fork

 ### Rubygems 安装

@@ -86,9 +87,6 @@ $ bundle info --path jekyll-theme-chirpy

 或者你可以 [使用 starter template][use-starter] 来快速创建 Jekyll 站点，以省去复制主题 gem 文件的时间。

-[starter]: https://github.com/cotes2020/chirpy-starter
-[use-starter]: https://github.com/cotes2020/chirpy-starter/generate
-
 ### 在 GitHub 上 Fork

 [Fork **Chirpy**](https://github.com/cotes2020/jekyll-theme-chirpy/fork) 然后克隆到本地。
@@ -109,15 +107,14 @@ $ bash tools/init.sh

 上述脚本完成了以下工作:

-  1. 从你的仓库中删除了:
-
+1. 从你的仓库中删除了:
    - `.travis.yml`
    - `_posts` 下的文件
    - `docs` 目录

-  2. 如果使用了参数 `--no-gh`，则会怒删 `.github`。否则，将会配置 GitHub Actions：把 `.github/workflows/pages-deploy.yml.hook` 的后缀 `.hook` 去除，然后删除 `.github` 里的其他目录和文件。
+2. 如果使用了参数 `--no-gh`，则会怒删 `.github`。否则，将会配置 GitHub Actions：把 `.github/workflows/pages-deploy.yml.hook` 的后缀 `.hook` 去除，然后删除 `.github` 里的其他目录和文件。

-  3. 自动提交一个 Commit 以保存上述文件的更改。
+3. 自动提交一个 Commit 以保存上述文件的更改。

 ## 使用

@@ -159,19 +156,20 @@ $ docker run -it --rm \

 由于安全原因，GitHub Pages 的构建强制加了 `safe`参数，这导致了我们不能使用插件去创建所需的附加页面。因此，我们可以使用 GitHub Actions 去构建站点，把站点文件存储在一个新分支上，再指定该分支作为 Pages 服务的源。

-确保你的 Jekyll 站点存在文件 `/.github/workflows/pages-deploy.yml`。没有的话，新建并填入[示例工作流][workflow]的内容, 注意参数 `on.push.branches` 的值必须和你的仓库默认分支名相同。
+快速检查 GitHub Actions 构建需要的文件:

-[workflow]:https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/.github/workflows/pages-deploy.yml.hook
+1. 确保你的 Jekyll 站点存在文件 `/.github/workflows/pages-deploy.yml`。没有的话，新建并填入[示例工作流][workflow]的内容, 注意参数 `on.push.branches` 的值必须和你的仓库默认分支名相同。
+2. 检查你的 Jekyll 站点是否有文件 `/tools/test.sh` 和 `/tools/deploy.sh`. 没有的话, 从本仓库拷贝到你的 Jekyll 项目.

 在 GitHub 把你的仓库命名为 `<GH-USERNAME>.github.io`，然后：

-  1. 推送任意一个 commit 到 `origin/master` 以触发 GitHub Actions workflow。一旦 build 完毕并且成功，远端将会自动出现一个新分支 `gh-pages` 用来存储构建的站点文件。
+1. 推送任意一个 commit 到 `origin/master` 以触发 GitHub Actions workflow。一旦 build 完毕并且成功，远端将会自动出现一个新分支 `gh-pages` 用来存储构建的站点文件。

-  2. 回到 GitHub 上的仓库， 通过 _Settings_ → _Options_ → _GitHub Pages_ 选择分支 `gh-pages` 作为[_发布源_](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site):
+2. 回到 GitHub 上的仓库， 通过 _Settings_ → _Options_ → _GitHub Pages_ 选择分支 `gh-pages` 作为[_发布源_](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site):

-      ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/posts/20190809/gh-pages-sources.png)
+    ![gh-pages-sources](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/posts/20190809/gh-pages-sources.png)

-  3. 按照 GitHub 指示的地址去访问你的网站。
+3. 按照 GitHub 指示的地址去访问你的网站。

 #### 部署到其他 Pages 平台

@@ -209,11 +207,9 @@ $ docker run -it --rm \

 :tada: 感谢所有参与代码贡献的小伙伴, 他们的 GayHub ID 在这个[列表](https://github.com/cotes2020/jekyll-theme-chirpy/graphs/contributors)。 另外, 提交过 issues(或者未被合并 PR) 的高富帅和白富美也不会被遗忘,他/她们帮助报告 bug、分享新点子或者启发了我写出更通俗易懂的文档。

-还有，感谢 [JetBrains][JB] 提供开源 License！
+还有，感谢 [JetBrains][jb] 提供开源 License！

-[![JB-logo](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/commons/jetbrains.svg)][JB]
-
-[JB]:https://www.jetbrains.com/?from=jekyll-theme-chirpy
+[![JB-logo](https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/commons/jetbrains.svg)][jb]

 ## 赞助

@@ -222,3 +218,8 @@ $ docker run -it --rm \
 ## 许可证书

 本项目开源，基于 [MIT](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/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
+[jb]:https://www.jetbrains.com/?from=jekyll-theme-chirpy
--- a/gulpfile.js/tasks/js.js
+++ b/gulpfile.js/tasks/js.js
@@ -12,7 +12,6 @@ const fs = require('fs');

 const JS_ROOT = './assets/js';
 const jsDest = `${ JS_ROOT }/dist/`;
-const copyrightPath = `${ JS_ROOT }/.copyright`;

 function concatJs(files, output) {
  return src(files)
@@ -23,7 +22,7 @@ function concatJs(files, output) {

 function minifyJs() {
  return src(`${ jsDest }/*.js`)
-    .pipe(insert.prepend(fs.readFileSync(copyrightPath, 'utf8')))
+    .pipe(insert.prepend(fs.readFileSync(`${ JS_ROOT }/.copyright`, 'utf8')))
    .pipe(uglify({output: {comments: /^!|@preserve|@license|@cc_on/i}}))
    .pipe(dest(jsDest));
 }
--- a/jekyll-theme-chirpy.gemspec
+++ b/jekyll-theme-chirpy.gemspec
@@ -2,18 +2,27 @@

 Gem::Specification.new do |spec|
  spec.name          = "jekyll-theme-chirpy"
-  spec.version       = "3.0.2"
+  spec.version       = "3.0.3"
  spec.authors       = ["Cotes Chung"]
  spec.email         = ["cotes.chung@gmail.com"]

  spec.summary       = "Chirpy is a minimal, sidebar, responsive web design Jekyll theme that focuses on text presentation."
-  spec.homepage      = "https://github.com/cotes2020/jekyll-theme-chirpy#readme"
+  spec.homepage      = "https://github.com/cotes2020/jekyll-theme-chirpy"
  spec.license       = "MIT"

  spec.files         = `git ls-files -z`.split("\x0").select { |f|
    f.match(%r!^((assets\/(css|img|js\/[a-z])|_(includes|layouts|sass|config|data|tabs|plugins))|README|LICENSE|index|feed|app|sw|404|robots)!i)
  }

+  spec.metadata = {
+    "bug_tracker_uri"   => "https://github.com/cotes2020/jekyll-theme-chirpy/issues",
+    "documentation_uri" => "https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/README.md",
+    "homepage_uri"      => "https://cotes2020.github.io/chirpy-demo",
+    "source_code_uri"   => "https://github.com/cotes2020/jekyll-theme-chirpy",
+    "wiki_uri"          => "https://github.com/cotes2020/jekyll-theme-chirpy/wiki",
+    "plugin_type"       => "theme"
+  }
+
  spec.add_runtime_dependency "jekyll", "~> 4.1"
  spec.add_runtime_dependency "jekyll-paginate", "~> 1.1"
  spec.add_runtime_dependency "jekyll-redirect-from", "~> 0.16"
@@ -21,6 +30,4 @@ Gem::Specification.new do |spec|
  spec.add_runtime_dependency "jekyll-archives", "~> 2.2"
  spec.add_runtime_dependency "jekyll-sitemap", "~> 1.4"

-  spec.add_development_dependency "html-proofer", "~> 3.18"
-
 end
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "jekyll-theme-chirpy",
-  "version": "3.0.2",
+  "version": "3.0.3",
  "description": "A minimal, sidebar, responsive web design Jekyll theme that focuses on text presentation.",
  "main": "index.js",
  "directories": {
--- a/tools/bump.sh
+++ b/tools/bump.sh
@@ -1,12 +1,17 @@
 #!/usr/bin/env bash
 #
-# Bump latest version to
+# 1. Bump latest version number to files:
 #   - _sass/jekyll-theme-chirpy.scss
-#   - assets/js/_commons/_copyright.js
-#   - assets/js/dist/*.js
+#   - assets/js/.copyright.js
+#   - assets/js/dist/*.js (will be built by gulp later)
 #   - jekyll-theme-chirpy.gemspec
+#   - package.json
 #
-# Required: gulp
+# 2. Create a git-tag
+#
+# 3. Build a rubygem package
+#
+# Requires: gulp, rubygem

 set -eu

@@ -19,29 +24,50 @@ GEM_SPEC="jekyll-theme-chirpy.gemspec"

 NODE_META="package.json"

-bump_assets() {
+_check_src() {
+  if [[ ! -f $1 && ! -d $1 ]]; then
+    echo -e "Error: missing file \"$1\"!\n"
+    exit -1
+  fi
+}
+
+check() {
+  if [[ -n $(git status . -s) ]]; then
+    echo "Warning: commit unstaged files first, and then run this tool againt."
+    exit -1
+  fi
+
+  for i in "${!ASSETS[@]}"; do
+    _check_src "${ASSETS[$i]}"
+  done
+
+  _check_src "$NODE_META"
+  _check_src "$GEM_SPEC"
+}
+
+_bump_assets() {
  _version="$1"
-  for i in ${!ASSETS[@]}; do
-    sed -i "s/v[[:digit:]]\.[[:digit:]]\.[[:digit:]]/v$_version/" ${ASSETS[$i]}
+  for i in "${!ASSETS[@]}"; do
+    sed -i "s/v[[:digit:]]\.[[:digit:]]\.[[:digit:]]/v$_version/" "${ASSETS[$i]}"
  done

  gulp
 }

-bump_gemspec() {
-  sed -i "s/[[:digit:]]\.[[:digit:]]\.[[:digit:]]/$1/" $GEM_SPEC
+_bump_gemspec() {
+  sed -i "s/[[:digit:]]\.[[:digit:]]\.[[:digit:]]/$1/" "$GEM_SPEC"
 }

-bump_node() {
+_bump_node() {
  sed -i \
    "s,[\"]version[\"]: [\"][[:digit:]]\.[[:digit:]]\.[[:digit:]][\"],\"version\": \"$1\"," \
    $NODE_META
 }

 bump() {
-  bump_assets $1
-  bump_gemspec $1
-  bump_node $1
+  _bump_assets "$1"
+  _bump_gemspec "$1"
+  _bump_node "$1"

  if [[ -n $(git status . -s) ]]; then
    git add .
@@ -49,11 +75,12 @@ bump() {
  fi
 }

+build_gem() {
+  gem build "$GEM_SPEC"
+}
+
 main() {
-  if [[ -n $(git status . -s) ]]; then
-    echo "Warning: commit unstaged files first, and then run this tool againt."
-    exit -1
-  fi
+  check

  _latest_tag="$(git describe --tags --abbrev=0)"

@@ -68,15 +95,18 @@ main() {
      exit -1
    fi

-    echo "Bump version to $_version"
+    echo -e "Bump version to $_version\n"
    bump "$_version"

-    echo "Create tag v$_version"
+    echo -e "Create tag v$_version\n"
    git tag "v$_version"

+    build_gem
+
  else

    echo "Error: Illegal version number: '$_version'"
+
  fi
 }

--- a/tools/pv.sh
+++ b/tools/pv.sh
@@ -1,20 +0,0 @@
-#!/usr/bin/env bash
-#
-# Fetch Google Analytics Pageviews reporting cache
-# and save as 'assets/data/pagevies.json'
-#
-# Requirement:
-#   - jq
-#   - wget
-
-set -eu
-
-WORK_DIR="$(dirname "$(dirname "$(realpath "$0")")")"
-URL_FILE="${WORK_DIR}/_config.yml"
-PV_CACHE="${WORK_DIR}/assets/js/data/pageviews.json"
-
-PROXY_URL="$(grep "proxy_endpoint:" "$URL_FILE" | sed "s/.*: '//g;s/'.*//")"
-
-wget "$PROXY_URL" -O "$PV_CACHE"
-
-echo "ls $PV_CACHE"
Author	SHA1	Message	Date
Cotes Chung	7a87ab4d05	Bump version to 3.0.3	2021-01-28 23:44:53 +08:00
Cotes Chung	c4be7c0cd6	Add more spec meta to gem	2021-01-28 23:39:03 +08:00
Cotes Chung	c9765e6923	Merge gem-build & bump tool Drop the yard doc	2021-01-28 23:17:16 +08:00
Cotes Chung	5c04d4e45b	Bypass the jekyll build on source branch	2021-01-28 20:56:23 +08:00
Cotes Chung	4d969ca0c5	Fix toc of readme	2021-01-28 20:56:23 +08:00
Cotes Chung	4a084eb681	Add new tool to build gem	2021-01-28 04:57:11 +08:00
Cotes Chung	adc117972a	Fix the year of copyright	2021-01-28 03:37:08 +08:00
Cotes Chung	8e84c6b9d6	Improve code style - js/css - markdown - shell	2021-01-28 03:21:58 +08:00