Update critical file(s) according to Chirpy v5.1.0

Update critical file(s) according to Chirpy v5.0.2
Update critical file(s) according to Chirpy v5.0.1
2025-07-01 20:08:55 +10:00 · 2022-02-14 17:30:02 +00:00 · 2022-01-07 18:52:12 +00:00 · 2022-01-04 19:50:28 +00:00 · 2022-01-04 18:58:52 +08:00 · 2022-01-02 16:53:02 +00:00
23 changed files with 704 additions and 206 deletions
--- a/.github/workflows/pages-deploy.yml
+++ b/.github/workflows/pages-deploy.yml
@ -25,29 +25,5 @@ jobs:
          ruby-version: 2.7
          bundler-cache: true

-      - name: Check baseurl
-        run: |
-          baseurl="$(grep '^baseurl:' _config.yml | sed "s/.*: *//;s/['\"]//g;s/#.*//")"
-          if [[ -n $baseurl ]]; then
-            echo "BASE_URL=$baseurl" >> $GITHUB_ENV
-          fi
-
-      - name: Build Site
-        env:
-          JEKYLL_ENV: production
-        run: |
-          bundle exec jekyll b -d "_site$BASE_URL"
-
-      - name: Test Site
-        run: |
-          bash tools/test.sh
-
      - name: Deploy
-        run: |
-          if [[ -n $BASE_URL ]]; then
-            mv _site$BASE_URL _site-rename
-            rm -rf _site
-            mv _site-rename _site
-          fi
-
-          bash tools/deploy.sh
+        run: bash tools/deploy.sh
--- a/.gitignore
+++ b/.gitignore
@ -3,11 +3,11 @@
 !.git*
 !.editorconfig
 !.nojekyll
+!.travis.yml

 # bundler cache
 _site
 vendor
-Gemfile.lock

 # rubygem
 *.gem
--- a/.gitmodules
+++ b/.gitmodules
@ -0,0 +1,3 @@
+[submodule "assets/lib"]
+	path = assets/lib
+	url = https://github.com/cotes2020/chirpy-static-assets.git
--- a/.nojekyll
+++ b/.nojekyll
@ -0,0 +1 @@
+
--- a/12
+++ b/12
@ -1,11 +1,8 @@
+# frozen_string_literal: true
+
 source "https://rubygems.org"

-gem "jekyll-theme-chirpy", "~> 4.1", ">= 4.1.0"
-
-group :jekyll_plugins do
-  # If you have any plugins, put them here!
-  # gem "jekyll-xxx", "~> x.y"
-end
+gem "jekyll-theme-chirpy", "~> 5.1", ">= 5.1.0"

 group :test do
  gem "html-proofer", "~> 3.18"
@ -20,3 +17,6 @@ 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"
--- a/README.md
+++ b/README.md
@ -1,28 +1,31 @@
 # Chirpy Starter [![Gem Version](https://img.shields.io/gem/v/jekyll-theme-chirpy)](https://rubygems.org/gems/jekyll-theme-chirpy) [![GitHub license](https://img.shields.io/github/license/cotes2020/chirpy-starter.svg?color=blue)][mit]

+When installing the [**Chirpy**][chirpy] theme through [RubyGems.org][gem], Jekyll can only read files in the folders `_includes`, `_layout`, `_sass` and `assets`, as well as a small part of options of the `_config.yml` file from the theme's gem. If you have ever installed this theme gem, you can use the command `bundle info --path jekyll-theme-chirpy` to locate these files.

-The startup template for [**Jekyll Theme Chirpy**][chirpy].
+The Jekyll organization claims that this is to leave the ball in the user’s court, but this also results in users not being able to enjoy the out-of-the-box experience when using feature-rich themes.

-When installing the **Chirpy** theme through [RubyGems][gem], Jekyll can only read files in the folders `_includes`, `_layout`, `_sass` and `assets`, as well as a small part of options of the `_config.yml` file from the theme's gem. (You can find the gem files by using the command `bundle info --path jekyll-theme-chirpy`). To fully use all the features of **Chirpy**, you need to copy the other critical files/directories from the theme's gem to your Jekyll site.
-
-The critical files/directories to run or build the **Chirpy** theme are as follows:
+To fully use all the features of **Chirpy**, you need to copy the other critical files from the theme's gem to your Jekyll site. The following is a list of targets:

 ```shell
 .
+├── _config.yml
 ├── _data
 ├── _plugins
 ├── _tabs
-├── _config.yml
-└──  index.html
+└── index.html
 ```

-So we've extracted all the **Chirpy** gem necessary content here to help you get started quickly.
+In order to save your time, and to prevent you from missing some files when copying, we extract those files/configurations of the latest version of the **Chirpy** theme and the [CD][CD] workflow to here, so that you can start writing in minutes.
+
+## Prerequisites
+
+Follow the instructions in the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of `Ruby`, `RubyGems`, `Jekyll` and `Bundler`.

 ## Installation

-[Use this template][usetemplate] to generate a new repository, and then execute:
+[**Use this template**][use-template] to generate a brand new repository and name it `<GH_USERNAME>.github.io`, where `GH_USERNAME` represents your GitHub username.

-[usetemplate]: https://github.com/cotes2020/chirpy-starter/generate
+Then clone it to your local machine and run:

 ```
 $ bundle
@ -30,19 +33,7 @@ $ bundle

 ## Usage

-Please see the [theme's docs](https://github.com/cotes2020/jekyll-theme-chirpy#usage).
-
-## Upgrading
-
-First, please modify the target version number of `jekyll-theme-chirpy` in the `Gemfile` (e.g., `gem "jekyll-theme-chirpy", "~> 4.0", ">= 4.0.1"`).
-
-After that, execute the following command:
-
-```console
-$ bundle update jekyll-theme-chirpy
-```
-
-As the version upgrades, the critical files and configuration options will change. Please refer to the [Upgrade Guide](https://github.com/cotes2020/jekyll-theme-chirpy/wiki/Upgrade-Guide) to keep your website files in sync with the latest version of the theme.
+Please see the [theme's docs](https://github.com/cotes2020/jekyll-theme-chirpy#documentation).

 ## License

@ -50,4 +41,6 @@ This work is published under [MIT][mit] License.

 [gem]: https://rubygems.org/gems/jekyll-theme-chirpy
 [chirpy]: https://github.com/cotes2020/jekyll-theme-chirpy/
+[use-template]: https://github.com/cotes2020/chirpy-starter/generate
+[CD]: https://en.wikipedia.org/wiki/Continuous_deployment
 [mit]: https://github.com/cotes2020/chirpy-starter/blob/master/LICENSE
--- a/_config.yml
+++ b/_config.yml
@ -3,21 +3,20 @@
 # Import the theme
 theme: jekyll-theme-chirpy

-# Only if your site type is GitHub Project sites and doesn't have a custom domain,
-# change below value to '/projectname'.
+# Change the following value to '/PROJECT_NAME' ONLY IF your site type is GitHub Pages Project sites
+# and doesn't have a custom domain.
 baseurl: ''

-# The language of the site layout › http://www.lingoes.net/en/translator/langcode.htm
-# Go to folder '_data/locales' to check the available language options
+# The language of the webpage › http://www.lingoes.net/en/translator/langcode.htm
+# If it has the same name as one of the files in folder `_data/locales`, the layout language will also be changed,
+# otherwise, the layout language will use the default value of 'en'.
 lang: en

-# The lang attribute of HTML › http://www.lingoes.net/en/translator/langcode.htm
-# We can specify a language different from the layout of the content.
-# If it is not assigned, the site will use the value of 'lang' instead.
-content_lang: ''
+# Additional parameters for datetime localization, optional. › https://github.com/iamkun/dayjs/tree/dev/src/locale
+prefer_datetime_locale:

 # Change to your timezone › http://www.timezoneconverter.com/cgi-bin/findzone/findzone
-timezone: Asia/Shanghai
+timezone:

 # jekyll-seo-tag settings › https://github.com/jekyll/jekyll-seo-tag/blob/master/docs/usage.md
 # ↓ --------------------------
@ -27,9 +26,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: ''
@ -53,13 +50,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
@ -83,17 +80,40 @@ theme_mode:   # [light|dark]
 # will be added to all image (site avatar & posts' images) paths starting with '/'
 #
 # e.g. 'https://cdn.com'
-img_cdn: ''
+img_cdn:

 # the avatar on sidebar, support local or CORS resources
-avatar: https://cdn.jsdelivr.net/gh/cotes2020/chirpy-images/commons/avatar.jpg
+avatar:

 # 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`
+
+# 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]

 paginate: 10

@ -115,10 +135,8 @@ collections:
    output: true
    sort_by: order

-
 defaults:
-  -
-    scope:
+  - scope:
      path: ''          # An empty string here means all files in the project
      type: posts
    values:
@ -128,19 +146,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
@ -158,12 +181,11 @@ exclude:
  - '*.gem'
  - '*.gemspec'
  - tools
-  - docs
  - README.md
  - LICENSE
  - gulpfile.js
  - node_modules
-  - '*.json'
+  - package*.json

 jekyll-archives:
  enabled: [categories, tags]
@ -173,6 +195,3 @@ jekyll-archives:
  permalinks:
    tag: /tags/:name/
    category: /categories/:name/
-
-# Outdated configuration warning
-outdated: '-- Missing configuration options! --'
--- a/_data/assets/cross_origin.yml
+++ b/_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/dist/jquery.min.js
+
+bootstrap:
+  css: https://cdn.jsdelivr.net/npm/bootstrap@4/dist/css/bootstrap.min.css
+  js: https://cdn.jsdelivr.net/npm/bootstrap@4/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@5.11.2/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@8/dist/mermaid.min.js
+
+dayjs:
+  js:
+    common: https://cdn.jsdelivr.net/npm/dayjs@1/dayjs.min.js
+    locale: https://cdn.jsdelivr.net/npm/dayjs@1/locale/:LOCALE.min.js
+    relativeTime: https://cdn.jsdelivr.net/npm/dayjs@1/plugin/relativeTime.min.js
+    localizedFormat: https://cdn.jsdelivr.net/npm/dayjs@1/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/dist/magnific-popup.min.css
+  js: https://cdn.jsdelivr.net/npm/magnific-popup@1/dist/jquery.magnific-popup.min.js
+
+lozad:
+  js: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js
+
+clipboard:
+  js:  https://cdn.jsdelivr.net/npm/clipboard@2/dist/clipboard.min.js
+
+polyfill:
+  js: https://polyfill.io/v3/polyfill.min.js?features=es6
+
+mathjax:
+  js: https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js
--- a/_data/assets/self_host.yml
+++ b/_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-5.15.4/css/all.min.css
+
+search:
+  js: /assets/lib/simple-jekyll-search-1.10.0/simple-jekyll-search.min.js
+
+mermaid:
+  js: /assets/lib/mermaid-8.13.10/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
+
+lozad:
+  js: /assets/lib/lozad-1.16.0/lozad.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
--- a/_data/contact.yml
+++ b/_data/contact.yml
@ -2,7 +2,7 @@

 -
  type: github
-  icon: 'fab fa-github-alt'
+  icon: 'fab fa-github'
 -
  type: twitter
  icon: 'fab fa-twitter'
--- a/_data/locales/en.yml
+++ b/_data/locales/en.yml
@ -16,24 +16,17 @@ tabs:
  archives: Archives
  about: About

-# text displayed in the search bar
+# the text displayed in the search bar & search results
 search:
  hint: search
  cancel: Cancel
+  no_results: Oops! No result founds.

 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:
@ -58,13 +51,9 @@ not_found:
 # ----- Posts related labels -----

 post:
-  published: 'on'
+  written_by: By
+  posted: Posted
  updated: Updated
-  timeago:
-    day: d ago
-    hour: hr ago
-    minute: min ago
-    just_now: just now
  words: words
  pageview_measure: views
  read_time:
@ -75,7 +64,9 @@ post:
  button:
    next: Newer
    previous: Older
-    copy:
+    copy_code:
+      succeed: Copied!
+    share_link:
      title: Copy link
      succeed: Link copied successfully!
  # pinned prompt of posts list on homepage
--- a/_data/locales/id-ID.yml
+++ b/_data/locales/id-ID.yml
@ -0,0 +1,78 @@
+# The layout text of site
+
+# ----- Commons label -----
+
+layout:
+  post: Postingan
+  category: Kategori
+  tag: Tagar
+
+# The tabs of sidebar
+tabs:
+  # format: <filename_without_extension>: <value>
+  home: Beranda
+  categories: Kategori
+  tags: Tagar
+  archives: Arsip
+  about: Tentang
+
+# the text displayed in the search bar & search results
+search:
+  hint: Cari
+  cancel: Batal
+  no_results: Ups! Tidak ada hasil yang ditemukan.
+
+panel:
+  lastmod: Postingan Terbaru
+  trending_tags: Tagar Terpopuler
+  toc: Konten
+
+copyright:
+  # Shown at the bottom of the post
+  license:
+    template: Postingan ini dilisensikan di bawah :LICENSE_NAME oleh penulis.
+    name: CC BY 4.0
+    link: https://creativecommons.org/licenses/by/4.0/
+
+  # Displayed in the footer
+  brief: Sebagian konten dilindungi.
+  verbose: >-
+    Kecuali jika dinyatakan, Postingan blog di situs ini dilisensikan
+    di bawah Lisensi Creative Commons Attribution 4.0 International (CC BY 4.0) oleh penulis.
+
+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
+
+# ----- Posts related labels -----
+
+post:
+  written_by: Oleh
+  posted: Diterbitkan
+  updated: Diperbarui
+  words: kata
+  pageview_measure: dilihat
+  read_time:
+    unit: menit
+    prompt: baca
+  relate_posts: Postingan Lainya
+  share: Bagikan
+  button:
+    next: Terbaru
+    previous: Terlama
+    copy_code:
+      succeed: Disalin!
+    share_link:
+      title: Salin tautan
+      succeed: Tautan berhasil disalin!
+  # pinned prompt of posts list on homepage
+  pin_prompt: Disematkan
+
+# categories page
+categories:
+  category_measure: kategori
+  post_measure: Postingan
--- a/_data/locales/ko-KR.yml
+++ b/_data/locales/ko-KR.yml
@ -0,0 +1,78 @@
+# 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은 존재하지 않습니다.
+  hint_template: :HEAD_BAK을 눌러 다시 찾거나 :ARCHIVES_PAGE에서 검색해 주세요.
+  head_back: 홈으로 돌아가기
+  archives_page: 아카이브 페이지
+
+# ----- 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: 핀
+
+# categories page
+categories:
+  category_measure: 카테고리
+  post_measure: 포스트
--- a/_data/locales/my-MM.yml
+++ b/_data/locales/my-MM.yml
@ -0,0 +1,78 @@
+# 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 ကို မှားယွင်းစွာ နေရာချထားခြင်း သို့မဟုတ် ၎င်းသည် မရှိသောအရာကို ညွှန်ပြနေပါသည်။
+  hint_template: ၎င်းကို ထပ်မံရှာဖွေရန် :HEAD_BAK , သို့မဟုတ် :ARCHIVES_PAGE တွင်ရှာပါ။
+  head_back: အဓိကစာမျက်နှာသို့ပြန်သွားပါ။
+  archives_page: မှတ်တမ်းတိုက် စာမျက်နှာ။
+
+# ----- 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: ပို့စ်များ
--- a/_data/locales/ru-RU.yml
+++ b/_data/locales/ru-RU.yml
@ -0,0 +1,78 @@
+# 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: Извините, эта ссылка указывает на ресурс который не существует.
+  hint_template: :HEAD_BAK чтобы снова осуществить поиск, или поищите :ARCHIVES_PAGE.
+  head_back: Вернитесь на домашнюю страницу
+  archives_page: архиве
+
+# ----- 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: публикации
--- a/_data/locales/uk-UA.yml
+++ b/_data/locales/uk-UA.yml
@ -0,0 +1,78 @@
+# 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: Вибачте, це посилання вказує на ресурс, що не існує.
+  hint_template: :HEAD_BAK аби здійснити пошук, або пошукайте в :ARCHIVES_PAGE.
+  head_back: Поверніться на домашню сторінку
+  archives_page: архіві
+
+# ----- 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: публікації
--- a/_data/locales/zh-CN.yml
+++ b/_data/locales/zh-CN.yml
@ -16,23 +16,16 @@ tabs:
  archives: 归档
  about: 关于

-# text displayed in the search bar
+# the text displayed in the search bar & search results
 search:
  hint: 搜索
  cancel: 取消
+  no_results: 搜索结果为空

 panel:
  lastmod: 最近更新
  trending_tags: 热门标签
-  toc: 目录
-
-#  The liquid date format › http://strftime.net/
-date_format:
-  tooltip: '%a, %F, %R %z'
-  post:
-    long: '%F'
-    short: '%m-%d'
-    archive_month: '%m月'
+  toc: 文章内容

 copyright:
  # Shown at the bottom of the post
@ -57,13 +50,9 @@ not_found:
 # ----- Posts related labels -----

 post:
-  published: 发表于
+  written_by: 作者
+  posted: 发表于
  updated: 更新于
-  timeago:
-    day: 天前
-    hour: 小时前
-    minute: 分钟前
-    just_now: 刚刚
  words: 字
  pageview_measure: 次浏览
  read_time:
@ -74,8 +63,10 @@ post:
  button:
    next: 下一篇
    previous: 上一篇
-    copy:
-      title: 分享链接
+    copy_code:
+      succeed: 已复制！
+    share_link:
+      title:  分享链接
      succeed: 链接已复制！
  # pinned prompt of posts list on homepage
  pin_prompt: 顶置
--- a/_data/share.yml
+++ b/_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.
  # -
--- a/_tabs/about.md
+++ b/_tabs/about.md
@ -1,8 +1,8 @@
 ---
 title: About
-icon: fas fa-info
+icon: fas fa-info-circle
 order: 4
 ---

-
-> **Note**: Add Markdown syntax content to file `_tabs/about.md` and it will show up on this page.
+> Add Markdown syntax content to file `_tabs/about.md`{: .filepath } and it will show up on this page.
+{: .prompt-tip }
--- a/_tabs/tags.md
+++ b/_tabs/tags.md
@ -1,6 +1,6 @@
 ---
 layout: tags
 title: Tags
-icon: fas fa-tags
+icon: fas fa-tag
 order: 2
 ---
--- a/assets/lib
+++ b/assets/lib
--- a/tools/deploy.sh
+++ b/tools/deploy.sh
@ -1,28 +1,80 @@
 #!/usr/bin/env bash
 #
-# Deploy the content of _site to 'origin/<pages_branch>'
+# Build, test and then deploy the site content to 'origin/<pages_branch>'
+#
+# Requirement: html-proofer, jekyll
+#
+# Usage: See help information

 set -eu

 PAGES_BRANCH="gh-pages"

-_no_branch=false
+SITE_DIR="_site"
+
+_opt_dry_run=false
+
+_config="_config.yml"
+
+_no_pages_branch=false
+
 _backup_dir="$(mktemp -d)"

+_baseurl=""
+
+help() {
+  echo "Build, test and then deploy the site content to 'origin/<pages_branch>'"
+  echo
+  echo "Usage:"
+  echo
+  echo "   bash ./tools/deploy.sh [options]"
+  echo
+  echo "Options:"
+  echo '     -c, --config   "<config_a[,config_b[...]]>"    Specify config file(s)'
+  echo "     --dry-run                Build site and test, but not deploy"
+  echo "     -h, --help               Print this information."
+}
+
 init() {
-  if [[ -z ${GITHUB_ACTION+x} ]]; then
-    echo "ERROR: This script is not allowed to run outside of GitHub Action."
+  if [[ -z ${GITHUB_ACTION+x} && $_opt_dry_run == 'false' ]]; then
+    echo "ERROR: It is not allowed to deploy outside of the GitHub Action envrionment."
+    echo "Type option '-h' to see the help information."
    exit -1
  fi

-  # Gemfile could be changed by `bundle install` in actions workflow
-  if [[ -n $(git ls-files | grep Gemfile.lock) && -n \
-  $(git status Gemfile.lock --porcelain) ]]; then
-    git checkout -- Gemfile.lock
+  _baseurl="$(grep '^baseurl:' _config.yml | sed "s/.*: *//;s/['\"]//g;s/#.*//")"
+}
+
+build() {
+  # clean up
+  if [[ -d $SITE_DIR ]]; then
+    rm -rf "$SITE_DIR"
  fi

+  # build
+  JEKYLL_ENV=production bundle exec jekyll b -d "$SITE_DIR$_baseurl" --config "$_config"
+}
+
+test() {
+  bundle exec htmlproofer \
+    --disable-external \
+    --check-html \
+    --allow_hash_href \
+    "$SITE_DIR"
+}
+
+resume_site_dir() {
+  if [[ -n $_baseurl ]]; then
+    # Move the site file to the regular directory '_site'
+    mv "$SITE_DIR$_baseurl" "${SITE_DIR}-rename"
+    rm -rf "$SITE_DIR"
+    mv "${SITE_DIR}-rename" "$SITE_DIR"
+  fi
+}
+
+setup_gh() {
  if [[ -z $(git branch -av | grep "$PAGES_BRANCH") ]]; then
-    _no_branch=true
+    _no_pages_branch=true
    git checkout -b "$PAGES_BRANCH"
  else
    git checkout "$PAGES_BRANCH"
@ -30,7 +82,7 @@ init() {
 }

 backup() {
-  mv _site/* "$_backup_dir"
+  mv "$SITE_DIR"/* "$_backup_dir"
  mv .git "$_backup_dir"

  # When adding custom domain from Github website,
@ -46,6 +98,7 @@ flush() {

  shopt -s dotglob nullglob
  mv "$_backup_dir"/* .
+  [[ -f ".nojekyll" ]] || echo "" >".nojekyll"
 }

 deploy() {
@ -56,7 +109,7 @@ deploy() {
  git add -A
  git commit -m "[Automation] Site update No.${GITHUB_RUN_NUMBER}"

-  if $_no_branch; then
+  if $_no_pages_branch; then
    git push -u origin "$PAGES_BRANCH"
  else
    git push -f
@ -65,9 +118,43 @@ deploy() {

 main() {
  init
+  build
+  test
+  resume_site_dir
+
+  if $_opt_dry_run; then
+    exit 0
+  fi
+
+  setup_gh
  backup
  flush
  deploy
 }

+while (($#)); do
+  opt="$1"
+  case $opt in
+  -c | --config)
+    _config="$2"
+    shift
+    shift
+    ;;
+  --dry-run)
+    # build & test, but not deploy
+    _opt_dry_run=true
+    shift
+    ;;
+  -h | --help)
+    help
+    exit 0
+    ;;
+  *)
+    # unknown option
+    help
+    exit 1
+    ;;
+  esac
+done
+
 main
--- a/tools/test.sh
+++ b/tools/test.sh
@ -1,67 +0,0 @@
-#!/usr/bin/env bash
-#
-# Using HTML-proofer to test site.
-#
-# Requirement: https://github.com/gjtorikian/html-proofer
-#
-# Usage: bash /path/to/test.sh [indicated path]
-
-DEST=_site
-URL_IGNORE=cdn.jsdelivr.net
-
-_build=false
-
-help() {
-  echo "Usage:"
-  echo
-  echo "   bash ./tools/test.sh [options]"
-  echo
-  echo "Options:"
-  echo "     --build                  Run Jekyll build before test."
-  echo "     -d, --dir   <path>       Specify the test path."
-  echo "     -h, --help               Print this information."
-}
-
-if [[ -n $1 && -d $1 ]]; then
-  DEST=$1
-fi
-
-while (($#)); do
-  opt="$1"
-  case $opt in
-    --build)
-      _build=true
-      shift
-      ;;
-    -d | --dir)
-      if [[ ! -d $2 ]]; then
-        echo -e "Error: path '$2' doesn't exist\n"
-        help
-        exit 1
-      fi
-      DEST=$2
-      shift
-      shift
-      ;;
-    -h | --help)
-      help
-      exit 0
-      ;;
-    *)
-      # unknown option
-      help
-      exit 1
-      ;;
-  esac
-done
-
-if $_build; then
-  JEKYLL_ENV=production bundle exec jekyll b
-fi
-
-bundle exec htmlproofer "$DEST" \
-  --disable-external \
-  --check-html \
-  --empty_alt_ignore \
-  --allow_hash_href \
-  --url_ignore $URL_IGNORE
Author	SHA1	Message	Date
Travis-CI	d1ef8d4273	Update critical file(s) according to Chirpy v5.1.0	2022-02-14 17:30:02 +00:00
Travis-CI	3b07fccfc4	Update critical file(s) according to Chirpy v5.0.2	2022-01-07 18:52:12 +00:00
Travis-CI	a8cd88041d	Update critical file(s) according to Chirpy v5.0.1	2022-01-04 19:50:28 +00:00
Cotes Chung	fc54bc5574	Update the doc's link in README	2022-01-04 18:58:52 +08:00
Travis-CI	bf93d1383d	Update critical file(s) according to Chirpy v5.0.0	2022-01-02 16:53:02 +00:00
Travis-CI	23942a94b3	Update critical file(s) according to Chirpy v4.3.4	2021-11-29 12:35:47 +00:00
Travis-CI	66a784cb71	Update critical file(s) according to Chirpy v4.3.3	2021-10-24 20:18:05 +00:00
Travis-CI	b8446c9b7b	Update critical file(s) according to Chirpy v4.3.2	2021-10-14 18:13:57 +00:00
Travis-CI	479cdc35c7	Update critical file(s) according to Chirpy v4.3.1	2021-10-01 10:58:50 +00:00
Travis-CI	ff41859240	Update critical file(s) according to Chirpy v4.3.0	2021-09-29 20:03:26 +00:00
Cotes Chung	c2a7480e65	Update README	2021-09-26 01:20:50 +08:00
Travis-CI	4abf09ed60	Update critical file(s) according to Chirpy v4.2.1	2021-09-16 13:22:01 +00:00
Travis-CI	2327ec8d83	Update critical file(s) according to Chirpy v4.2.0	2021-09-15 17:53:28 +00:00
Travis-CI	45ff5ba1bf	Update critical file(s) according to Chirpy v4.1.1	2021-08-09 08:49:14 +00:00