├── images
    ├── tn.jpg
    └── screenshot.png
├── layouts
    ├── _default
    │   ├── _markup
    │   │   ├── render-codeblock-mermaid.html
    │   │   └── render-codeblock.html
    │   ├── baseof.html
    │   ├── section.html
    │   ├── term.html
    │   ├── taxonomy.html
    │   ├── home.html
    │   └── single.html
    └── partials
    │   ├── sidebar.html
    │   ├── module
    │       ├── sidebar_btn.html
    │       ├── page_translated.html
    │       ├── term_icon.html
    │       ├── breadcrumb.html
    │       ├── show_math.html
    │       └── section_tree.html
    │   ├── header.html
    │   ├── html_footer.html
    │   ├── footer.html
    │   └── html_head.html
├── .prettierignore
├── .gitignore
├── .prettierrc.json
├── assets
    └── _theme
    │   ├── js
    │       ├── dir_toggle.js
    │       ├── codeblock_copy.js
    │       └── sidebar.js
    │   └── css
    │       ├── 01_layout.css
    │       ├── 04_responsive.css
    │       ├── 03_home.css
    │       ├── 05_markdown.css
    │       └── 02_style.css
├── archetypes
    └── default.md
├── theme.toml
├── i18n
    └── en.toml
├── .eslintrc.json
├── package.json
├── .github
    └── workflows
    │   └── hugo.yml
├── hugo.toml
├── LICENSE
├── hugo.multilang.toml
└── README.md


/images/tn.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/JingWangTW/dark-theme-editor/HEAD/images/tn.jpg


--------------------------------------------------------------------------------
/images/screenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/JingWangTW/dark-theme-editor/HEAD/images/screenshot.png


--------------------------------------------------------------------------------
/layouts/_default/_markup/render-codeblock-mermaid.html:
--------------------------------------------------------------------------------
1 | <pre class="mermaid">
2 |     {{- .Inner | safeHTML }}
3 | </pre>
4 | 
5 | {{ .Page.Store.Set "hasMermaid" true }}
6 | 


--------------------------------------------------------------------------------
/layouts/partials/sidebar.html:
--------------------------------------------------------------------------------
1 | <aside class="sidebar">
2 |     {{ partial "module/section_tree" ( dict "context" .Site.Home "currentPage" . ) }}
3 | </aside>
4 | <aside class="exapandable"></aside>
5 | 


--------------------------------------------------------------------------------
/layouts/partials/module/sidebar_btn.html:
--------------------------------------------------------------------------------
1 | <button
2 |     class="sidebar-toggle-btn"
3 |     type="menu"
4 |     aria-expanded="false"
5 |     aria-haspopup="true">
6 |     <i class="bi bi-list"></i>
7 | </button>
8 | 


--------------------------------------------------------------------------------
/.prettierignore:
--------------------------------------------------------------------------------
 1 | # node modules and config files are ignored
 2 | /node_modules
 3 | 
 4 | # node dependency version is not required to this project
 5 | package-lock.json
 6 | 
 7 | # ignore hugo generated
 8 | /public/**
 9 | /resources/**
10 | .hugo_build.lock
11 | 
12 | # ignore vscode configuration
13 | /.vscode


--------------------------------------------------------------------------------
/layouts/partials/module/page_translated.html:
--------------------------------------------------------------------------------
 1 | <a class="lang-btn">
 2 |     {{ $.Site.Language.LanguageName }}
 3 | </a>
 4 | 
 5 | {{ range $index, $element := .Translations }}
 6 |     /
 7 | 
 8 |     <a href="{{ .Permalink }}" class="lang-btn">
 9 |         {{ .Language.LanguageName }}
10 |     </a>
11 | {{ end }}
12 | 


--------------------------------------------------------------------------------
/layouts/partials/module/term_icon.html:
--------------------------------------------------------------------------------
 1 | {{ if eq .Data.Singular "tag" }}
 2 |     <i class="bi bi-tag"></i>
 3 | {{ else if eq .Data.Singular "category" }}
 4 |     <i class="bi bi-bookmark"></i>
 5 | {{ else if eq .Data.Singular "autor" }}
 6 |     <i class="bi bi-person"></i>
 7 | {{ else }}
 8 |     <i class="bi bi-gear"></i>
 9 | {{ end }}
10 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # node modules and config files are ignored
 2 | /node_modules
 3 | 
 4 | # node dependency version is not required to this project
 5 | package-lock.json
 6 | 
 7 | # ignore hugo generated
 8 | /public/**
 9 | /resources/**
10 | .hugo_build.lock
11 | 
12 | # ignore vscode configuration
13 | /.vscode
14 | 
15 | # this is a theme, we don't need these files
16 | /content
17 | /themes
18 | 


--------------------------------------------------------------------------------
/.prettierrc.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "tabWidth": 4,
 3 |     "useTabs": false,
 4 |     "singleQuote": false,
 5 |     "quoteProps": "as-needed",
 6 |     "bracketSpacing": true,
 7 |     "bracketSameLine": true,
 8 |     "overrides": [
 9 |         {
10 |             "files": ["*.html"],
11 |             "options": {
12 |                 "parser": "go-template"
13 |             }
14 |         }
15 |     ]
16 | }
17 | 


--------------------------------------------------------------------------------
/assets/_theme/js/dir_toggle.js:
--------------------------------------------------------------------------------
 1 | window.addEventListener("load", function () {
 2 |     // sub dir toggle
 3 |     document.querySelectorAll("li.dir > span.dir-text").forEach((element) => {
 4 |         element.addEventListener("click", function () {
 5 |             this.parentNode.classList.toggle("opened-dir");
 6 |             this.parentNode.classList.toggle("closed-dir");
 7 |         });
 8 |     });
 9 | });
10 | 


--------------------------------------------------------------------------------
/layouts/_default/baseof.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html {{ with .Site.LanguageCode }}lang="{{ . }}"{{ end }}>
 3 |     {{ partial "html_head.html" . }}
 4 | 
 5 | 
 6 |     <body>
 7 |         {{ partial "header.html" . }}
 8 | 
 9 | 
10 |         <main>
11 |             {{ partial "sidebar.html" . }}
12 | 
13 |             {{ block "main_article" . }}
14 |             {{ end }}
15 |         </main>
16 | 
17 |         {{ partial "footer.html" . }}
18 |     </body>
19 | 
20 |     {{ partial "html_footer.html" . }}
21 | </html>
22 | 


--------------------------------------------------------------------------------
/archetypes/default.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: "{{ replace .Name "-" " " | title }}"
 3 | date: {{ .Date }}
 4 | author: {{ .Site.Params.globalFrontmatter.author }}
 5 | tags: ["put", "some", "tags", "here"]
 6 | categories: ["catgorized", "the", "page"]
 7 | description: "Description of this page."
 8 | keywords: "keywords,used,for,SEO"
 9 | draft: false
10 | includeToc: true
11 | localCss: []
12 | externalCss: []
13 | externalCssDownload: []
14 | localJs: []
15 | externalJs: []
16 | externalJsDownload: []
17 | useMath: false
18 | ---
19 | 
20 | 
21 | 


--------------------------------------------------------------------------------
/layouts/_default/section.html:
--------------------------------------------------------------------------------
 1 | {{ define "main_article" }}
 2 |     <article class="main">
 3 |         {{ partial "module/sidebar_btn" . }}
 4 | 
 5 | 
 6 |         <div class="title">
 7 |             <h1 class="title-header">{{ .Title }}</h1>
 8 |         </div>
 9 | 
10 |         <div class="article-meta">
11 |             <div class="breadcumb">
12 |                 <i class="bi bi-folder"></i>
13 |                 {{ partial "module/breadcrumb" . }}
14 |             </div>
15 |         </div>
16 | 
17 |         <hr />
18 | 
19 |         <div class="list-files">
20 |             {{ partial "module/section_tree" ( dict "context" . "currentPage" . ) }}
21 |         </div>
22 |     </article>
23 | {{ end }}
24 | 


--------------------------------------------------------------------------------
/theme.toml:
--------------------------------------------------------------------------------
 1 | name = "Dark Theme Editor"
 2 | license = "Apache-2.0"
 3 | licenselink = "https://github.com/JingWangTW/dark-theme-editor/blob/main/LICENSE"
 4 | demosite = "https://jingwangtw.github.io/dark-theme-editor/"
 5 | description = "A simple, editor-like theme for Hugo."
 6 | homepage = "https://github.com/JingWangTW/dark-theme-editor"
 7 | tags = ["multilingual", "dark", "responsive", "technical", "editor", "Docs"]
 8 | features = ["multilingual", "syntax highlighting", "responsive"]
 9 | 
10 | [author]
11 |     name = "Jing Wang"
12 |     homepage = "https://github.com/JingWangTW"
13 | 
14 | [origin]
15 |     name = "edidor"
16 |     homepage = "https://github.com/sfengyuan/edidor"
17 |     repo = "https://github.com/sfengyuan/edidor"


--------------------------------------------------------------------------------
/layouts/_default/_markup/render-codeblock.html:
--------------------------------------------------------------------------------
 1 | {{/* https://discourse.gohugo.io/t/documentation-for-code-block-render-hooks/37610/3 */}}
 2 | 
 3 | {{ $class := .Attributes.class | default "" }}
 4 | {{ $lang  := .Attributes.lang  | default .Type }}
 5 | {{ $opts  := .Options | default dict }}
 6 | 
 7 | 
 8 | <div class="codeblock">
 9 |     {{ with $.Page.Site.Params.page.codeBlockCopible }}
10 |         <div class="copy-button-box">
11 |             <button class="copy-button" state="copy" data="{{ $.Inner }}">
12 |                 <i class="bi bi-copy"></i>
13 |             </button>
14 |         </div>
15 |     {{ end }}
16 | 
17 |     {{ if transform.CanHighlight $lang }}
18 |         {{ highlight .Inner $lang $opts }}
19 |     {{ else }}
20 |         <pre><code>{{ .Inner }}</code></pre>
21 |     {{ end }}
22 | </div>
23 | 


--------------------------------------------------------------------------------
/layouts/partials/module/breadcrumb.html:
--------------------------------------------------------------------------------
 1 | {{ if .Parent }}
 2 |     {{ partial "module/breadcrumb" .Parent }}
 3 | {{ else if not .IsHome }}
 4 |     {{ partial "module/breadcrumb" .Site.Home }}
 5 | {{ end }}
 6 | 
 7 | {{ if not .IsHome }}
 8 |     /
 9 | {{ end }}
10 | 
11 | 
12 | <a href="{{ .Permalink }}" class="bread-btn">
13 |     {{ if .IsHome }}
14 |         <i class="bi bi-house-fill"></i>
15 |     {{ else if eq .Kind "taxonomy" }}
16 |         {{ partial "module/term_icon" . }}
17 |     {{ end }}
18 | 
19 |     {{ if .IsHome }}
20 |         {{ i18n "breadcrumb_home" | title }}
21 |     {{ else if .IsPage }}
22 |         {{ if $.Site.Params.preference.showFileName }}
23 |             {{ .File.TranslationBaseName }}.{{ .File.Ext }}
24 |         {{ else }}
25 |             {{ .Title }}
26 |         {{ end }}
27 | 
28 |     {{ else }}
29 |         {{ .Title }}
30 |     {{ end }}
31 | </a>
32 | 


--------------------------------------------------------------------------------
/i18n/en.toml:
--------------------------------------------------------------------------------
 1 | 
 2 | # The "recent posts" show in home page
 3 | recent_posts = 'recent posts'
 4 | 
 5 | # The "Walkthroughs" show in home page
 6 | walkthroughs = 'walkthroughs'
 7 | 
 8 | # Hint text of page meta data related icons
 9 | author = 'author'
10 | date = 'date'
11 | time_to_read = 'time to read'
12 | 
13 | # Hint text to indicate an empty page
14 | empty_page = 'no content on this page.'
15 | 
16 | # Title of a terms page
17 | all_about = 'all about'
18 | 
19 | # Hint text to show for language menu icon
20 | language = 'language'
21 | 
22 | # The "Home" shown in breadcrumb root
23 | breadcrumb_home = 'home'
24 | 
25 | # Hint text of related icons of a content
26 | [category]
27 |     one = 'category'
28 |     other = 'categories'
29 | 
30 | [tag]
31 |     one = 'Tag'
32 |     other = 'Tags'
33 | 
34 | # Time of minutes to read a page
35 | [min_to_read]
36 |     one = '{{ . }} min to read'
37 |     other = '{{ . }} mins to read'


--------------------------------------------------------------------------------
/assets/_theme/css/01_layout.css:
--------------------------------------------------------------------------------
 1 | /*******************************************************************************************
 2 |  * This file contains the stlying used for layout.
 3 |  *******************************************************************************************/
 4 | 
 5 | @charset "UTF-8";
 6 | 
 7 | :root {
 8 |     /*
 9 |         3pt: expand bar
10 |         4%: <article> padding
11 |         1px: dummpy
12 |     */
13 |     --artile_main_width: calc(85% - 3pt - 4% - 1px);
14 | }
15 | 
16 | body {
17 |     height: 100vh;
18 |     max-height: 100vh;
19 | }
20 | 
21 | header {
22 |     height: 3%;
23 | }
24 | 
25 | main {
26 |     /* 
27 |         2pt: border in headr and footer 
28 |     */
29 |     height: calc(94% - 2pt);
30 |     display: flex;
31 | }
32 | 
33 | aside.sidebar {
34 |     width: 15%;
35 | }
36 | 
37 | article {
38 |     width: var(--artile_main_width);
39 | }
40 | 
41 | footer {
42 |     height: 3%;
43 | }
44 | 


--------------------------------------------------------------------------------
/layouts/partials/header.html:
--------------------------------------------------------------------------------
 1 | <header class="header">
 2 |     <div class="header_left">
 3 |         {{ with $.Site.Params.header.logo.imgUrl }}
 4 |             {{ if $.Site.Params.header.logo.logoLink }}
 5 |                 <a href="{{ $.Site.Params.header.logo.logoLink }}">
 6 |                     <img class="logo" src="{{ "{{ . }}" | relLangURL }}"
 7 |                     alt="logo" />
 8 |                 </a>
 9 |             {{ else }}
10 |                 <a href="/">
11 |                     <img class="logo" src="{{ "{{ . }}" | relLangURL }}"
12 |                     alt="logo" />
13 |                 </a>
14 |             {{ end }}
15 | 
16 |         {{ end }}
17 |     </div>
18 | 
19 |     <div class="header_middle">
20 |         {{ if .IsHome }}
21 |             {{ $.Site.Params.header.title }}
22 |         {{ else }}
23 |             {{ $.Page.Title }} -
24 |             {{ $.Site.Params.header.title }}
25 |         {{ end }}
26 |     </div>
27 | </header>
28 | 


--------------------------------------------------------------------------------
/assets/_theme/js/codeblock_copy.js:
--------------------------------------------------------------------------------
 1 | window.addEventListener("load", function () {
 2 |     document.querySelectorAll("button.copy-button").forEach((element) => {
 3 |         element.addEventListener("click", (event) => {
 4 |             let button = event.currentTarget;
 5 |             let iconElement = button.querySelector("i");
 6 | 
 7 |             if (button.getAttribute("state") === "copy") {
 8 |                 navigator.clipboard.writeText(
 9 |                     decodeURI(button.getAttribute("data"))
10 |                 );
11 | 
12 |                 button.setAttribute("state", "copied");
13 |                 iconElement.classList.remove("bi-copy");
14 |                 iconElement.classList.add("bi-check2-all");
15 | 
16 |                 window.setTimeout(() => {
17 |                     button.setAttribute("state", "copy");
18 |                     iconElement.classList.remove("bi-check2-all");
19 |                     iconElement.classList.add("bi-copy");
20 |                 }, 2 * 1000);
21 |             }
22 |         });
23 |     });
24 | });
25 | 


--------------------------------------------------------------------------------
/.eslintrc.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "env": {
 3 |         "browser": true,
 4 |         "commonjs": true,
 5 |         "es2021": true
 6 |     },
 7 |     "extends": ["eslint:recommended", "plugin:json/recommended"],
 8 |     "parserOptions": {
 9 |         "ecmaVersion": "latest"
10 |     },
11 | 
12 |     "ignorePatterns": ["node_modules/", "public/", "resources/"],
13 |     "rules": {
14 |         "no-trailing-spaces": "error",
15 |         "comma-dangle": [
16 |             "error",
17 |             {
18 |                 "arrays": "always-multiline",
19 |                 "objects": "always-multiline",
20 |                 "imports": "always-multiline",
21 |                 "exports": "always-multiline",
22 |                 "functions": "never"
23 |             }
24 |         ],
25 |         "function-paren-newline": "off",
26 |         "global-require": "error",
27 |         "import/no-dynamic-require": "off",
28 |         "no-inner-declarations": "off",
29 |         "class-methods-use-this": "off",
30 |         "import/extensions": "off",
31 |         "import/prefer-default-export": "off",
32 |         "no-multiple-empty-lines": ["error"]
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/layouts/_default/term.html:
--------------------------------------------------------------------------------
 1 | {{ define "main_article" }}
 2 |     <article class="main">
 3 |         {{ partial "module/sidebar_btn" . }}
 4 | 
 5 | 
 6 |         <div class="title">
 7 |             <h1 class="title-header">
 8 |                 {{ partial "module/term_icon" . }}
 9 | 
10 |                 {{ i18n "all_about" | title }}
11 |                 <em>
12 |                     {{ .Title | singularize }}
13 |                 </em>
14 |             </h1>
15 |         </div>
16 | 
17 |         <div class="article-meta">
18 |             <div class="breadcumb">
19 |                 <i class="bi bi-folder"></i>
20 |                 {{ partial "module/breadcrumb" . }}
21 |             </div>
22 |         </div>
23 | 
24 |         <hr />
25 | 
26 |         <div class="list-files">
27 |             <ul class="section-tree">
28 |                 {{ range .Pages }}
29 |                     <li class="file">
30 |                         <a href="{{ .Permalink }}">
31 |                             {{ .Title }}
32 |                         </a>
33 |                     </li>
34 |                 {{ end }}
35 |             </ul>
36 |         </div>
37 |     </article>
38 | {{ end }}
39 | 


--------------------------------------------------------------------------------
/layouts/_default/taxonomy.html:
--------------------------------------------------------------------------------
 1 | {{ define "main_article" }}
 2 |     <article class="main">
 3 |         {{ partial "module/sidebar_btn" . }}
 4 | 
 5 | 
 6 |         <div class="title">
 7 |             <h1 class="title-header">
 8 |                 {{ if eq .Data.Singular "tag" }}
 9 |                     <i class="bi bi-tags"></i>
10 |                 {{ else if eq .Data.Singular "category" }}
11 |                     <i class="bi bi-bookmarks"></i>
12 |                 {{ else if eq .Data.Singular "autor" }}
13 |                     <i class="bi bi-person-fill"></i>
14 |                 {{ else }}
15 |                     <i class="bi bi-gear"></i>
16 |                 {{ end }}
17 | 
18 |                 {{ i18n ( lower .Title | singularize) 1 }}
19 |             </h1>
20 |         </div>
21 | 
22 |         <div class="article-meta">
23 |             <div class="breadcumb">
24 |                 <i class="bi bi-folder"></i>
25 |                 {{ partial "module/breadcrumb" . }}
26 |             </div>
27 |         </div>
28 | 
29 |         <hr />
30 | 
31 |         <div class="list-terms">
32 |             <ul>
33 |                 {{ range .Pages }}
34 |                     <li>
35 |                         <a href="{{ .Permalink }}">
36 |                             {{ partial "module/term_icon" . }}
37 |                             {{ .Title }}
38 |                         </a>
39 |                     </li>
40 |                 {{ end }}
41 |             </ul>
42 |         </div>
43 |     </article>
44 | {{ end }}
45 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "dark-theme-editor",
 3 |     "version": "3.2.4",
 4 |     "description": "[![Example Site](https://github.com/JingWangTW/dark-theme-editor/actions/workflows/hugo.yml/badge.svg)](https://github.com/JingWangTW/dark-theme-editor/actions/workflows/hugo.yml)",
 5 |     "main": "index.js",
 6 |     "scripts": {
 7 |         "format:check": "prettier --check .",
 8 |         "format:write": "prettier --write .",
 9 |         "lint": "eslint . --ext .js,.json --quiet",
10 |         "lint:fix": "eslint . --ext .js,.json --fix",
11 |         "precommit": "lint-staged",
12 |         "commit": "git-cz"
13 |     },
14 |     "author": "Jing Wang",
15 |     "license": "Apache 2.0",
16 |     "devDependencies": {
17 |         "commitlint": "^17.5.0",
18 |         "eslint": "^8.36.0",
19 |         "eslint-config-google": "^0.14.0",
20 |         "eslint-plugin-json": "^3.1.0",
21 |         "git-cz": "^4.9.0",
22 |         "husky": "^8.0.3",
23 |         "lint-staged": "^13.2.0",
24 |         "prettier": "^2.8.5",
25 |         "prettier-plugin-go-template": "^0.0.13"
26 |     },
27 |     "husky": {
28 |         "hooks": {
29 |             "commit-msg": "commitlint -E HUSKY_GIT_PARAMS",
30 |             "pre-commit": "lint-staged"
31 |         }
32 |     },
33 |     "lint-staged": {
34 |         "*.{js,json}": [
35 |             "prettier --write",
36 |             "eslint --fix",
37 |             "eslint"
38 |         ],
39 |         "*.{css,html}": [
40 |             "prettier --write"
41 |         ]
42 |     },
43 |     "commitlint": {
44 |         "extends": [
45 |             "@commitlint/config-conventional"
46 |         ]
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/layouts/partials/module/show_math.html:
--------------------------------------------------------------------------------
 1 | <!-- Include required packages for KATEX 
 2 |         KaTeX is a fast, easy-to-use JavaScript library for TeX math rendering on the web.
 3 |         https://katex.org/docs/browser.html 
 4 | -->
 5 | 
 6 | {{ $trustedMath := false }}
 7 | {{ if isset $.Params "trustedmath" }}
 8 | 
 9 |     {{ if $.Params.trustedmath }}
10 |         {{ $trustedMath = . }}
11 |     {{ end }}
12 | 
13 | {{ else if isset $.Site.Params.page "trustedmath" }}
14 | 
15 |     {{ if $.Site.Params.page.trustedmath }}
16 |         {{ $trustedMath = . }}
17 |     {{ end }}
18 | 
19 | {{ end }}
20 | 
21 | 
22 | <link
23 |     rel="stylesheet"
24 |     href="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css"
25 |     integrity="sha384-n8MVd4RsNIU0tAv4ct0nTaAbDJwPJzDEaqSD1odI+WdtXRGWt2kTvGFasHpSy3SV"
26 |     crossorigin="anonymous" />
27 | 
28 | <!-- The loading of KaTeX is deferred to speed up page rendering -->
29 | <script
30 |     defer
31 |     src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.js"
32 |     integrity="sha384-XjKyOOlGwcjNTAIQHIpgOno0Hl1YQqzUOEleOLALmuqehneUG+vnGctmUb0ZY0l8"
33 |     crossorigin="anonymous"></script>
34 | 
35 | <!-- To automatically render math in text elements, include the auto-render extension: -->
36 | <script
37 |     defer
38 |     src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/contrib/auto-render.min.js"
39 |     integrity="sha384-+VBxd3r6XgURycqtZ117nYw44OOcIax56Z4dCRWbxyPt0Koah1uHoK0o4+/RRE05"
40 |     crossorigin="anonymous"
41 |     {{ if $trustedMath }}
42 |         onload="renderMathInElement(document.body , { trust: true });"
43 |     {{ else }}
44 |         onload="renderMathInElement(document.body);"
45 |     {{ end }}></script>
46 | 
47 | <script>
48 |     document.addEventListener("DOMContentLoaded", function () {
49 |         renderMathInElement(document.body, {
50 |             // customised options
51 |             // • auto-render specific keys, e.g.:
52 |             delimiters: [
53 |                 { left: "$$", right: "$$", display: true },
54 |                 { left: "$", right: "$", display: false },
55 |                 { left: "\\(", right: "\\)", display: false },
56 |                 { left: "\\[", right: "\\]", display: true },
57 |             ],
58 |             // • rendering keys, e.g.:
59 |             throwOnError: false,
60 | 
61 |             {{ if $trustedMath }}
62 |                 trust: true
63 |             {{ end }}
64 |         });
65 |     });
66 | </script>
67 | 


--------------------------------------------------------------------------------
/.github/workflows/hugo.yml:
--------------------------------------------------------------------------------
 1 | # Sample workflow for building and deploying a Hugo site to GitHub Pages
 2 | name: Deploy example site to GitHub Pages
 3 | 
 4 | on:
 5 |     # Triggers the workflow on push to any tags
 6 |     push:
 7 |         tags:
 8 |             - "*"
 9 | 
10 | # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
11 | permissions:
12 |     contents: read
13 |     pages: write
14 |     id-token: write
15 | 
16 | # Allow one concurrent deployment
17 | concurrency:
18 |     group: "pages"
19 |     cancel-in-progress: true
20 | 
21 | # Default to bash
22 | defaults:
23 |     run:
24 |         shell: bash
25 | 
26 | jobs:
27 |     # Build job
28 |     build:
29 |         runs-on: ubuntu-latest
30 |         env:
31 |             HUGO_VERSION: 0.124.0
32 |         steps:
33 |             - name: Install Hugo CLI
34 |               run: |
35 |                   wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
36 |                   && sudo dpkg -i ${{ runner.temp }}/hugo.deb
37 |             - name: Install Dart Sass Embedded
38 |               run: sudo snap install dart-sass-embedded
39 |             - name: Checkout
40 |               uses: actions/checkout@v3
41 |               with:
42 |                   submodules: recursive
43 |                   fetch-depth: 0
44 |                   ref: "example-site"
45 |             - name: Setup Pages
46 |               id: pages
47 |               uses: actions/configure-pages@v3
48 |             - name: Install Theme
49 |               run: mkdir themes && cd themes && git clone https://github.com/JingWangTW/dark-theme-editor.git
50 |             - name: Build with Hugo
51 |               env:
52 |                   # For maximum backward compatibility with Hugo modules
53 |                   HUGO_ENVIRONMENT: production
54 |                   HUGO_ENV: production
55 |               run: |
56 |                   hugo \
57 |                     --minify \
58 |                     --enableGitInfo \
59 |                     --baseURL "${{ steps.pages.outputs.base_url }}/"
60 |             - name: Upload static files as artifact
61 |               id: deployment
62 |               uses: actions/upload-pages-artifact@v3 # or specific "vX.X.X" version tag for this action
63 |               with:
64 |                   path: ./public
65 | 
66 |     # Deployment job
67 |     deploy:
68 |         environment:
69 |             name: github-pages
70 |             url: ${{ steps.deployment.outputs.page_url }}
71 |         runs-on: ubuntu-latest
72 |         needs: build
73 |         steps:
74 |             - name: Deploy to GitHub Pages
75 |               id: deployment
76 |               uses: actions/deploy-pages@v4
77 | 


--------------------------------------------------------------------------------
/layouts/partials/module/section_tree.html:
--------------------------------------------------------------------------------
 1 | {{ $context := .context }}
 2 | {{ $currentPage := .currentPage }}
 3 | 
 4 | {{ with $context }}
 5 |     {{ $page_children := where ( union .Sections .Pages ) "Kind" "page" }}
 6 |     {{ $section_children := where ( union .Sections .Pages ) "Kind" "!=" "page" }}
 7 | 
 8 |     {{ $sortBy := or .Site.Params.preference.sortBy "title" }}
 9 | 
10 |     {{ $sortInAsc := true }}
11 |     {{ if isset .Site.Params.preference "sortInAsc" }}
12 |         {{ $sortInAsc = .Site.Params.preference.sortInAsc }}
13 |     {{ end }}
14 | 
15 |     {{ if eq $sortBy "lastmod" }}
16 |         {{ $page_children = $page_children.ByLastmod }}
17 |         {{ $section_children = $section_children.ByLastmod }}
18 |     {{ else if eq $sortBy "weight" }}
19 |         {{ $page_children = $page_children.ByWeight }}
20 |         {{ $section_children = $section_children.ByWeight }}
21 |     {{ else if eq $sortBy "pubdate" }}
22 |         {{ $page_children = $page_children.ByPublishDate }}
23 |         {{ $section_children = $section_children.ByPublishDate }}
24 |     {{ else if eq $sortBy "date" }}
25 |         {{ $page_children = $page_children.ByDate }}
26 |         {{ $section_children = $section_children.ByDate }}
27 |     {{ else }}
28 |         {{ $page_children = $page_children.ByTitle }}
29 |         {{ $section_children = $section_children.ByTitle }}
30 |     {{ end }}
31 | 
32 |     {{ if not $sortInAsc }}
33 |         {{ $page_children = $page_children.Reverse }}
34 |         {{ $section_children = $section_children.Reverse }}
35 |     {{ end }}
36 | 
37 |     {{/* show page child first than section child */}}
38 |     {{ $children := $section_children | append $page_children }}
39 | 
40 | 
41 |     <ul class="section-tree">
42 |         {{ range $children }}
43 |             {{ if .IsNode }}
44 |                 <li
45 |                     {{ if .IsAncestor $currentPage }}
46 |                         class="dir opened-dir"
47 |                     {{ else }}
48 |                         class="dir closed-dir"
49 |                     {{ end }}>
50 |                     <span class="dir-text"> {{ .Title }} </span>
51 | 
52 |                     {{ partial "module/section_tree" ( dict "context" . "currentPage" $currentPage ) }}
53 |                 </li>
54 |             {{ else }}
55 |                 <li class="file">
56 |                     <a href="{{ .Permalink }}" title=".{{ .RelPermalink }}">
57 |                         {{ if .Site.Params.preference.showFileName }}
58 |                             {{ .File.TranslationBaseName }}.{{ .File.Ext }}
59 |                         {{ else }}
60 |                             {{ .Title }}
61 |                         {{ end }}
62 |                     </a>
63 |                 </li>
64 |             {{ end }}
65 |         {{ end }}
66 |     </ul>
67 | {{ end }}
68 | 


--------------------------------------------------------------------------------
/layouts/_default/home.html:
--------------------------------------------------------------------------------
 1 | {{ define "main_article" }}
 2 |     <article class="main">
 3 |         {{ partial "module/sidebar_btn" . }}
 4 | 
 5 | 
 6 |         <div class="home">
 7 |             <div class="title">
 8 |                 {{ with $.Site.Params.header.logo.imgUrl }}
 9 |                     <img class="logo" src="{{ $.Site.BaseURL }}{{ . }}" />
10 |                 {{ end }}
11 | 
12 |                 {{ with $.Site.Params.header.title }}
13 |                     <h1 class="title-caption">{{ . }}</h1>
14 |                 {{ end }}
15 | 
16 |                 {{ with $.Site.Params.header.subtitle }}
17 |                     <h2 class="subtitle">
18 |                         {{ . }}
19 |                     </h2>
20 |                 {{ end }}
21 |             </div>
22 |             <div class="recommend">
23 |                 <div class="left">
24 |                     <div class="start">
25 |                         {{ with $.Site.Params.homePage.siteLongDescription }}
26 |                             <h3 class="recommend-title">
27 |                                 {{ $.Site.Params.homePage.siteLongDescriptionTitle | default "Start" }}
28 |                             </h3>
29 |                             <p class="long-description">
30 |                                 {{ . }}
31 |                             </p>
32 |                         {{ end }}
33 |                     </div>
34 |                     <div class="recent">
35 |                         {{ with $.Site.Params.homePage.showRecentPostsBlock }}
36 |                             <h3 class="recommend-title">
37 |                                 {{ i18n "recent_posts" | title }}
38 |                             </h3>
39 |                             <ul class="recent-posts-list">
40 |                                 {{ range ( $.Site.RegularPages | first ($.Site.Params.homePage.numOfRecentPosts | default 5) ) }}
41 |                                     {{ $page := . }}
42 |                                     <li>
43 |                                         <a
44 |                                             href="{{ .Permalink }}"
45 |                                             title=".{{ .RelPermalink }}"
46 |                                             >{{ $page.Title }}</a
47 |                                         >
48 |                                         {{ with $.Site.Params.homePage.recentPostShowUrl }}
49 |                                             <span
50 |                                                 class="recent-posts-items-path"
51 |                                                 title=".{{ $page.RelPermalink }}">
52 |                                                 .
53 |                                                 {{ $page.RelPermalink }}
54 |                                             </span>
55 |                                         {{ end }}
56 |                                     </li>
57 |                                 {{ end }}
58 |                             </ul>
59 |                         {{ end }}
60 |                     </div>
61 |                 </div>
62 |                 {{ if not $.Site.Params.homePage.disableWalkthroughs }}
63 |                     <div class="right">
64 |                         <h3 class="recommend-title">
65 |                             {{ i18n "walkthroughs"  | title }}
66 |                         </h3>
67 |                         {{ partial "module/section_tree" ( dict "context" . "currentPage" . ) }}
68 |                     </div>
69 |                 {{ end }}
70 |             </div>
71 |         </div>
72 |     </article>
73 | {{ end }}
74 | 


--------------------------------------------------------------------------------
/layouts/partials/html_footer.html:
--------------------------------------------------------------------------------
  1 | <!-- Bundle all JS -->
  2 | {{ $script := slice }}
  3 | 
  4 | {{/* Record all the JS file names, except the general files. */}}
  5 | {{ $script_files_list := slice }}
  6 | 
  7 | 
  8 | <!-- Get all local JS -->
  9 | {{ $script = $script | append ( resources.Match "_theme/js/*.js" ) }}
 10 | 
 11 | 
 12 | <!-- Append all custom script listed in the global config.-->
 13 | {{ with $.Site.Params.globalFrontmatter.externalJs }}
 14 |     {{ range $js_src := $.Site.Params.globalFrontmatter.externalJs }}
 15 |         {{ $script = $script | append (resources.GetRemote $js_src ) }}
 16 |         {{ $script_files_list =  $script_files_list | append $js_src }}
 17 |     {{ end }}
 18 | {{ end }}
 19 | 
 20 | {{ with $.Site.Params.globalFrontmatter.localJs }}
 21 |     {{ range $js_src := $.Site.Params.globalFrontmatter.localJs }}
 22 |         {{ $script = $script | append (resources.Match $js_src ) }}
 23 |         {{ $script_files_list =  $script_files_list | append $js_src }}
 24 |     {{ end }}
 25 | {{ end }}
 26 | 
 27 | 
 28 | <!-- Append all custom CSS listed in the page metadata. -->
 29 | {{ if isset $.Params "externaljs" }}
 30 |     {{ range $js_src :=  $.Params.externaljs }}
 31 |         {{ $script = $script | append (resources.GetRemote $js_src ) }}
 32 |         {{ $script_files_list =  $script_files_list | append $js_src }}
 33 |     {{ end }}
 34 | {{ end }}
 35 | 
 36 | {{ if isset $.Params "localjs" }}
 37 |     {{ range $js_src :=  $.Params.localjs }}
 38 |         {{ $script = $script | append (resources.Match $js_src ) }}
 39 |         {{ $script_files_list =  $script_files_list | append $js_src }}
 40 |     {{ end }}
 41 | {{ end }}
 42 | 
 43 | {{ if hugo.IsProduction }}
 44 | 
 45 |     {{/* Create a hash based on the file list, to determince different style file */}}
 46 |     {{ $hash:= substr (jsonify $script_files_list | md5) 0 7 }}
 47 | 
 48 | 
 49 |     <!-- Concat to a single file -->
 50 |     {{ $script = $script | resources.Concat ( printf "js/index_%s.js" $hash ) | minify | resources.Fingerprint "sha512" }}
 51 | 
 52 | 
 53 |     <script
 54 |         type="text/javascript"
 55 |         src="{{ $script.RelPermalink }}"
 56 |         integrity="{{ $script.Data.Integrity }}"></script>
 57 | {{ else }}
 58 |     {{ range $script }}
 59 |         {{ $currentScript := . | resources.Fingerprint "sha512" }}
 60 |         <script
 61 |             type="text/javascript"
 62 |             src="{{ $currentScript.RelPermalink }}"
 63 |             integrity="{{ $currentScript.Data.Integrity }}"></script>
 64 |     {{ end }}
 65 | 
 66 | {{ end }}
 67 | 
 68 | 
 69 | <!-- External JS that needs to be included separately. -->
 70 | {{ $js_seprated := slice }}
 71 | 
 72 | {{ if isset $.Params "externaljs" }}
 73 |     {{ range $js_src :=  $.Params.externaljs }}
 74 |         {{ $js_seprated = $js_seprated | append ($js_src ) }}
 75 |     {{ end }}
 76 | {{ end }}
 77 | 
 78 | {{ with $.Site.Params.globalFrontmatter.externalJs }}
 79 |     {{ range $js_src :=  $.Site.Params.globalFrontmatter.externalJs }}
 80 |         {{ $js_seprated = $js_seprated | append ( $js_src ) }}
 81 |     {{ end }}
 82 | {{ end }}
 83 | 
 84 | {{ range $js_seprated }}
 85 |     <script type="text/javascript" src="{{ . }}"></script>
 86 | {{ end }}
 87 | 
 88 | 
 89 | <!-- CSS to support icon will include font inside, it's better to ref it explicit. -->
 90 | <link
 91 |     rel="stylesheet"
 92 |     href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.1/font/bootstrap-icons.css" />
 93 | 
 94 | {{/* Include the mermaid script if needed */}}
 95 | {{ if .Page.Store.Get "hasMermaid" }}
 96 |     <script type="module">
 97 |         import mermaid from "https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs";
 98 |         mermaid.initialize({
 99 |             startOnLoad: true,
100 |             theme: "dark",
101 |         });
102 |     </script>
103 | {{ end }}
104 | 


--------------------------------------------------------------------------------
/layouts/partials/footer.html:
--------------------------------------------------------------------------------
  1 | <footer class="footer">
  2 |     <div class="footer-left">
  3 |         <ul class="social">
  4 |             {{ with $.Site.Params.footer.copyrightStr }}
  5 |                 <li>{{ . }}</li>
  6 |             {{ end }}
  7 | 
  8 |             {{ with $.Site.Params.globalFrontmatter.author }}
  9 |                 <li>{{ . }}</li>
 10 |             {{ end }}
 11 | 
 12 |             {{ range $key, $val := $.Site.Params.footer.socialLink }}
 13 |                 {{ with $val }}
 14 |                     <li>
 15 |                         {{ if eq $key "email" }}
 16 |                             <a href="mailto:{{ $val }}" target="_blank">
 17 |                                 <i class="bi-envelope"></i>
 18 |                             </a>
 19 |                         {{ else }}
 20 |                             <a href="{{ $val }}" target="_blank">
 21 |                                 <i class="bi-{{ $key }}"></i>
 22 |                             </a>
 23 |                         {{ end }}
 24 | 
 25 |                     </li>
 26 |                 {{ end }}
 27 |             {{ end }}
 28 |         </ul>
 29 |     </div>
 30 | 
 31 |     <div class="footer-right">
 32 |         <ul class="control status clearfix">
 33 |             {{ with $.Site.Params.footer.counter }}
 34 |                 <li>
 35 |                     {{ if $.IsPage }}
 36 |                         Word Count:
 37 |                         {{ $.WordCount }}
 38 |                     {{ else if $.IsSection }}
 39 |                         Pages In Section:
 40 |                         {{ len (where $.Pages "Params.hidden" "!=" true) }}
 41 |                     {{ else if $.IsHome }}
 42 |                         Pages:
 43 |                         {{ len (where $.Site.RegularPages "Params.hidden" "!=" true) }}
 44 |                     {{ else if $.IsNode }}
 45 |                         Pages:
 46 |                         {{ len (where $.Pages "Params.hidden" "!=" true) }}
 47 |                     {{ end }}
 48 |                 </li>
 49 |             {{ end }}
 50 | 
 51 |             {{/* Use this as a trick to check if the multilingual mode is enabled. */}}
 52 |             {{ if hugo.IsMultilingual }}
 53 |                 <li class="language-selector">
 54 |                     <i class="bi bi-translate"></i>
 55 | 
 56 |                     <ul class="language-selector-menu">
 57 |                         {{ range $.Site.Home.AllTranslations }}
 58 |                             <li>
 59 |                                 <a href="{{ .Permalink }}">
 60 |                                     {{ .Lang }}
 61 |                                     -{{ .Language.LanguageName }}
 62 |                                 </a>
 63 |                             </li>
 64 |                         {{ end }}
 65 |                     </ul>
 66 |                 </li>
 67 |             {{ end }}
 68 | 
 69 |             {{ with $.Site.Params.footer.language }}
 70 |                 <li>{{ $.Site.Language.Lang }}</li>
 71 |             {{ end }}
 72 | 
 73 |             {{ with $.Site.Params.footer.hugoVersion }}
 74 |                 <li>
 75 |                     <a href="https://gohugo.io" class="btn" target="_blank"
 76 |                         >Hugo: {{ hugo.Version }}</a
 77 |                     >
 78 |                 </li>
 79 |             {{ end }}
 80 | 
 81 |             {{ with $.Site.Params.footer.theme }}
 82 |                 <li>
 83 |                     <a
 84 |                         href="https://github.com/JingWangTW/dark-theme-editor"
 85 |                         class="btn"
 86 |                         target="_blank"
 87 |                         >Theme: dark-theme-editor</a
 88 |                     >
 89 |                 </li>
 90 |             {{ end }}
 91 | 
 92 |             {{ with $.Site.Params.footer.modifiedTime }}
 93 |                 <li>
 94 |                     {{ if or ($.IsHome) ($.IsNode) }}
 95 |                         {{ with hugo.BuildDate }}
 96 |                             Last build: &nbsp;
 97 |                             <time>
 98 |                                 {{ time hugo.BuildDate | time.Format $.Site.Params.footer.dateFormat | safeHTML }}
 99 |                             </time>
100 |                         {{ end }}
101 |                     {{ else }}
102 |                         Last modified: &nbsp;
103 |                         <time>
104 |                             {{ time $.Lastmod | time.Format $.Site.Params.footer.dateFormat | safeHTML }}
105 |                         </time>
106 |                     {{ end }}
107 |                 </li>
108 |             {{ end }}
109 | 
110 |             {{ with $.Site.Params.footer.gitHash }}
111 |                 <li title="{{ $.GitInfo.Subject }}">
112 |                     {{ $.GitInfo.AbbreviatedHash }}
113 |                 </li>
114 |             {{ end }}
115 |         </ul>
116 |     </div>
117 | </footer>
118 | 


--------------------------------------------------------------------------------
/assets/_theme/js/sidebar.js:
--------------------------------------------------------------------------------
  1 | let isSidebarExpand = false;
  2 | let isSidebarShow = false;
  3 | 
  4 | function isSidebarExpandStart() {
  5 |     isSidebarExpand = true;
  6 | }
  7 | 
  8 | function isSidebarExpandEnd() {
  9 |     isSidebarExpand = false;
 10 | }
 11 | 
 12 | function isSidebarExpanding(e) {
 13 |     if (!isSidebarExpand) return;
 14 | 
 15 |     const sidebarPercentage = (e.pageX / window.innerWidth) * 100;
 16 | 
 17 |     // limitation of sidebar width
 18 |     if (sidebarPercentage > 10 && sidebarPercentage < 50) {
 19 |         const articlePercentage = 100 - sidebarPercentage;
 20 | 
 21 |         document.querySelector(
 22 |             "aside.sidebar"
 23 |         ).style.width = `${sidebarPercentage}%`;
 24 | 
 25 |         const originWidth = getComputedStyle(
 26 |             document.querySelector("article.main")
 27 |         ).getPropertyValue("--artile_main_width");
 28 | 
 29 |         const newWidth = originWidth.replace(/[\d.]+/, articlePercentage);
 30 | 
 31 |         document
 32 |             .querySelector("article.main")
 33 |             .style.setProperty("--artile_main_width", newWidth);
 34 |     }
 35 | }
 36 | 
 37 | function showSidebar() {
 38 |     document.querySelector("aside.sidebar").style.display = "block";
 39 | 
 40 |     isSidebarShow = true;
 41 |     document
 42 |         .querySelector("button.sidebar-toggle-btn")
 43 |         .setAttribute("aria-expanded", "true");
 44 | }
 45 | 
 46 | function hideSidebar() {
 47 |     if (isSidebarShow) {
 48 |         // remove the attribute instead, if set to "hudden", it would overwrite the rule in css.
 49 |         document.querySelector("aside.sidebar").style.display = "";
 50 | 
 51 |         isSidebarShow = false;
 52 |         document
 53 |             .querySelector("button.sidebar-toggle-btn")
 54 |             .setAttribute("aria-expanded", "false");
 55 |     }
 56 | }
 57 | 
 58 | window.addEventListener("load", function () {
 59 |     // sidebar expanble
 60 |     document
 61 |         .querySelector("aside.exapandable")
 62 |         .addEventListener("mousedown", isSidebarExpandStart);
 63 |     document
 64 |         .querySelector("aside.exapandable")
 65 |         .addEventListener("touchstart", isSidebarExpandStart);
 66 |     window.addEventListener("mousemove", isSidebarExpanding);
 67 |     window.addEventListener("touchmove", isSidebarExpanding);
 68 |     window.addEventListener("mouseup", isSidebarExpandEnd);
 69 |     window.addEventListener("touchend", isSidebarExpandEnd);
 70 | 
 71 |     // responsive sidebar
 72 |     document
 73 |         .querySelector("button.sidebar-toggle-btn")
 74 |         .addEventListener("click", (event) => {
 75 |             event.stopPropagation();
 76 |             event.preventDefault();
 77 | 
 78 |             if (event.currentTarget.getAttribute("aria-expanded") === "true") {
 79 |                 hideSidebar();
 80 |             } else {
 81 |                 showSidebar();
 82 |             }
 83 |         });
 84 | 
 85 |     // hides sidebar when not focus
 86 |     this.document
 87 |         .querySelector("article.main")
 88 |         .addEventListener("click", hideSidebar);
 89 |     this.document
 90 |         .querySelector("article.main")
 91 |         .addEventListener("touchstart", hideSidebar);
 92 |     this.document
 93 |         .querySelector("article.main")
 94 |         .addEventListener("mousedown", hideSidebar);
 95 | 
 96 |     // remove generated element style when windows enlarge
 97 |     this.window.addEventListener("resize", () => {
 98 |         if (window.innerWidth > 900) {
 99 |             isSidebarShow = false;
100 | 
101 |             document.querySelector("aside.sidebar").style.display = "";
102 |             document
103 |                 .querySelector("button.sidebar-toggle-btn")
104 |                 .setAttribute("aria-expanded", "false");
105 |         }
106 |     });
107 | 
108 |     // re-calculate the width when resizing the window
109 |     this.window.addEventListener("resize", () => {
110 |         let artileElement = document.querySelector("article.main");
111 | 
112 |         // get the currently configured width
113 |         const widthProperty = artileElement.style.getPropertyValue(
114 |             "--artile_main_width"
115 |         );
116 | 
117 |         if (widthProperty) {
118 |             // find the width set currently
119 |             const sidebarPercentage = widthProperty.match(/[\d.]+/)[0];
120 | 
121 |             // reset the width
122 |             artileElement.style.setProperty("--artile_main_width", "");
123 | 
124 |             // to find out the width set by the stylesheet
125 |             const appliedSWidthStyle = getComputedStyle(artileElement)
126 |                 .getPropertyValue("--artile_main_width")
127 |                 .replace(/[\d.]+/, sidebarPercentage);
128 | 
129 |             // add the width setting set by the user
130 |             artileElement.style.setProperty(
131 |                 "--artile_main_width",
132 |                 appliedSWidthStyle
133 |             );
134 |         }
135 |     });
136 | });
137 | 


--------------------------------------------------------------------------------
/assets/_theme/css/04_responsive.css:
--------------------------------------------------------------------------------
  1 | /*******************************************************************************************
  2 |  * This file add the support of the style.css
  3 |  *******************************************************************************************/
  4 | @charset "UTF-8";
  5 | 
  6 | @media only screen and (max-width: 900px) {
  7 |     :root {
  8 |         /*
  9 |             8vw: <article> padding
 10 |             1px: dummpy
 11 |         */
 12 | 
 13 |         --artile_main_width: calc(100% - 8vw - 1px);
 14 |     }
 15 | 
 16 |     /* release the static layout*/
 17 |     body {
 18 |         height: 100%;
 19 |         max-height: 100%;
 20 |         overflow-y: auto;
 21 |     }
 22 | 
 23 |     /* sticky header */
 24 |     header {
 25 |         height: 6vh;
 26 |         position: sticky;
 27 |         top: 0px;
 28 |         width: 100%;
 29 |         font-size: 10pt;
 30 |         background-color: #282c34;
 31 |         text-overflow: ellipsis;
 32 |         overflow: hidden;
 33 |     }
 34 | 
 35 |     header > div {
 36 |         line-height: 6vh;
 37 |     }
 38 | 
 39 |     /* remove the sidebar */
 40 |     aside:where(.exapandable, .sidebar) {
 41 |         display: none;
 42 |     }
 43 | 
 44 |     /* Slide sidebar */
 45 |     main:has(article.main > button.sidebar-toggle-btn[aria-expanded="true"]) {
 46 |         width: 130%;
 47 | 
 48 |         animation: slide-in 0.5s forwards;
 49 |         transform: translateX(calc(-20%));
 50 |     }
 51 | 
 52 |     aside.sidebar {
 53 |         width: 30%;
 54 |         border-right: 3pt solid rgb(59, 59, 59);
 55 |     }
 56 | 
 57 |     /* Add some padding */
 58 |     article.main {
 59 |         padding: 4vw;
 60 | 
 61 |         /*
 62 |             6vh: header
 63 |             6vh: footer
 64 |             8vw: <article> padding
 65 |             2pt: border of header and footer
 66 |             12px: padding in footer
 67 |         */
 68 |         min-height: calc(100vh - 6vh - 6vh - 8vw - 2pt - 12px);
 69 |     }
 70 | 
 71 |     /* show the navbar button */
 72 |     article.main > button.sidebar-toggle-btn {
 73 |         background-color: #282c34;
 74 |         border: 1px solid grey;
 75 |         border-radius: 20%;
 76 |         padding: 0.2em;
 77 |         color: #c6c6c7;
 78 |         font-size: 22pt;
 79 |         line-height: 0.6em;
 80 |         display: block;
 81 |         position: fixed;
 82 |         top: 20px;
 83 |         right: 10px;
 84 |         cursor: pointer;
 85 |     }
 86 | 
 87 |     article.main > button.sidebar-toggle-btn:where(:hover, :active, :focus) {
 88 |         color: white;
 89 |         border-color: white;
 90 |         border-width: 2px;
 91 |     }
 92 | 
 93 |     /* move the position of article information */
 94 |     article.main > div.title {
 95 |         flex-direction: column;
 96 |     }
 97 | 
 98 |     article.main > div.title > div.author-date-readtime {
 99 |         flex-direction: row;
100 |     }
101 | 
102 |     article.main > div.title > div.author-date-readtime > div {
103 |         padding-top: 0;
104 |         padding-right: 2em;
105 |     }
106 | 
107 |     article.main > div.article-meta {
108 |         margin-top: 0.2em;
109 |     }
110 | 
111 |     /* re-layout the footer */
112 |     footer {
113 |         height: 6vh;
114 |         font-size: 14pt;
115 |         padding-top: 6px;
116 |         padding-bottom: 6px;
117 |     }
118 | 
119 |     footer > div > ul {
120 |         flex-wrap: wrap;
121 |     }
122 | 
123 |     footer > div.footer-left {
124 |         min-width: 60%;
125 |         max-width: 100%;
126 |     }
127 | 
128 |     footer > div.footer-right {
129 |         display: none;
130 |     }
131 | }
132 | 
133 | @media only screen and (max-width: 700px) {
134 |     /* Slide sidebar */
135 |     main:has(article.main > button.sidebar-toggle-btn[aria-expanded="true"]) {
136 |         width: 150%;
137 |     }
138 | 
139 |     aside.sidebar {
140 |         width: 50%;
141 |     }
142 | }
143 | 
144 | @media only screen and (max-width: 440px) {
145 |     :root {
146 |         /*
147 |             12vw: <article> padding
148 |             1px: dummpy
149 |         */
150 | 
151 |         --artile_main_width: calc(100% - 12vw - 1px);
152 |     }
153 | 
154 |     /* Slide sidebar */
155 |     main:has(article.main > button.sidebar-toggle-btn[aria-expanded="true"]) {
156 |         width: 180%;
157 |     }
158 | 
159 |     aside.sidebar {
160 |         width: 80%;
161 |     }
162 | 
163 |     /* Add some padding */
164 |     article.main {
165 |         padding: 6vw;
166 | 
167 |         /*
168 |             6vh: header
169 |             6vh: footer
170 |             12vw: <article> padding
171 |             2pt: border of header and footer
172 |             12px: padding in footer
173 |         */
174 |         min-height: calc(100vh - 6vh - 6vh - 12vw - 2pt - 12px);
175 |     }
176 | 
177 |     /* move the position of article information */
178 |     article.main > div.title > div.author-date-readtime {
179 |         align-items: flex-start;
180 |         flex-direction: column;
181 |     }
182 | 
183 |     article.main > div.title > div.author-date-readtime > div {
184 |         padding-top: 1em;
185 |     }
186 | 
187 |     /* re-layout the footer */
188 |     footer {
189 |         font-size: 12pt;
190 |     }
191 | }
192 | 


--------------------------------------------------------------------------------
/layouts/_default/single.html:
--------------------------------------------------------------------------------
  1 | {{ define "main_article" }}
  2 |     <article class="main">
  3 |         {{ partial "module/sidebar_btn" . }}
  4 | 
  5 | 
  6 |         <div class="title">
  7 |             <h1 class="title-header">
  8 |                 {{ .Title }}
  9 |             </h1>
 10 | 
 11 |             <div class="author-date-readtime">
 12 |                 {{ if isset $.Params "author" }}
 13 | 
 14 |                     {{ if or ( and ( not (isset $.Params "showAuthor") ) $.Site.Params.page.showAuthor ) $.Params "showAuthor" }}
 15 |                         <div class="author" title="{{ i18n "author" | title }}">
 16 |                             <i class="bi bi-person"></i>
 17 |                             <a
 18 |                                 href="{{ "author" | relLangURL }}/{{ $.Params.author | urlize }}/"
 19 |                                 class="cat-btn">
 20 |                                 {{ $.Params.author }}
 21 |                             </a>
 22 |                         </div>
 23 |                     {{ end }}
 24 | 
 25 |                 {{ else if isset $.Site.Params.globalFrontmatter "author" }}
 26 | 
 27 |                     {{ if or ( and ( not (isset $.Params "showAuthor") ) $.Site.Params.page.showAuthor ) $.Params "showAuthor" }}
 28 |                         <div class="author" title="{{ i18n "author"| title }}">
 29 |                             <i class="bi bi-person"></i>
 30 |                             <a
 31 |                                 href="{{ "author" | relLangURL }}/{{ $.Site.Params.globalFrontmatter.author | urlize }}/"
 32 |                                 class="cat-btn">
 33 |                                 {{ $.Site.Params.globalFrontmatter.author }}
 34 |                             </a>
 35 |                         </div>
 36 |                     {{ end }}
 37 | 
 38 |                 {{ end }}
 39 | 
 40 |                 {{ with $.Site.Params.page.showDate }}
 41 |                     <div class="date" title="{{ i18n "date"| title }}">
 42 |                         <i class="bi bi-calendar3"></i>
 43 |                         <time
 44 |                             datetime="{{ $.Page.Date.Format $.Site.Params.page.dateFormat }}"
 45 |                             >{{ $.Page.Date.Format $.Site.Params.page.dateFormat }}
 46 |                         </time>
 47 |                     </div>
 48 |                 {{ end }}
 49 | 
 50 |                 {{ with $.Site.Params.page.showTimeToRead }}
 51 |                     <div
 52 |                         class="readtime"
 53 |                         title="{{ i18n "time_to_read" | title }}">
 54 |                         <i class="bi bi-clock"></i>
 55 |                         {{ i18n "min_to_read" $.Page.ReadingTime }}
 56 |                     </div>
 57 |                 {{ end }}
 58 |             </div>
 59 |         </div>
 60 | 
 61 |         <div class="article-meta">
 62 |             {{ with .Params.categories }}
 63 |                 <div class="categories">
 64 |                     <i
 65 |                         class="bi bi-bookmarks"
 66 |                         title="{{ i18n "category" 2  | title }}"></i>
 67 |                     {{ range . }}
 68 |                         <a
 69 |                             href="{{ "categories" | relLangURL }}/{{ . | urlize }}/"
 70 |                             class="cat-btn">
 71 |                             {{ . }}
 72 |                         </a>
 73 |                     {{ end }}
 74 |                 </div>
 75 |             {{ end }}
 76 | 
 77 |             {{ with .Params.tags }}
 78 |                 <div class="tags">
 79 |                     <i
 80 |                         class="bi bi-tags"
 81 |                         title="{{ i18n "tag" 2 | title }}"></i>
 82 |                     {{ range . }}
 83 |                         <a
 84 |                             href="{{ "tags" | relLangURL }}/{{ . | urlize }}/"
 85 |                             class="tag-btn">
 86 |                             {{ . }}
 87 |                         </a>
 88 |                     {{ end }}
 89 |                 </div>
 90 |             {{ end }}
 91 | 
 92 |             {{ with  $.Site.Params.page.showBreadcrumb }}
 93 |                 <div class="breadcumb">
 94 |                     <i class="bi bi-folder"></i>
 95 |                     {{ partial "module/breadcrumb" $ }}
 96 |                 </div>
 97 |             {{ end }}
 98 | 
 99 |             {{ if .IsTranslated }}
100 |                 <div class="translation">
101 |                     <i
102 |                         class="bi bi-globe2"
103 |                         title="{{ i18n "language" | title }}"></i>
104 |                     {{ partial "module/page_translated" $ }}
105 |                 </div>
106 |             {{ end }}
107 |         </div>
108 | 
109 |         {{ if isset $.Params "includetoc" }}
110 |             {{ if $.Params.includetoc }}
111 |                 {{ .TableOfContents }}
112 |             {{ end }}
113 | 
114 |         {{ else if $.Site.Params.page.includeToc }}
115 |             {{ .TableOfContents }}
116 |         {{ end }}
117 | 
118 | 
119 |         <div class="content">
120 |             {{ if .Content }}
121 |                 {{ .Content }}
122 |             {{ else }}
123 |                 <p class="no-content">
124 |                     {{ i18n "empty_page" |  strings.FirstUpper }}
125 |                 </p>
126 |             {{ end }}
127 |         </div>
128 |     </article>
129 | {{ end }}
130 | 


--------------------------------------------------------------------------------
/assets/_theme/css/03_home.css:
--------------------------------------------------------------------------------
  1 | /*******************************************************************************************
  2 |  * This files contain the stlying used in the <artile> > <div.home>
  3 |  * In other words, this file is used to style the content on the homepage only.
  4 |  *******************************************************************************************/
  5 | 
  6 | /*******************
  7 |   * Layout 
  8 |   *******************/
  9 | article.main:has(> div.home) {
 10 |     padding: 8vh 20vw;
 11 | 
 12 |     /*
 13 |         3%: header
 14 |         3%: footer
 15 |         16vh: <article> padding
 16 |         2pt: border of header and footer
 17 |     */
 18 |     min-height: calc(100vh - 3% - 3% - 16vh - 2pt);
 19 | 
 20 |     /*
 21 |         3pt: expand bar
 22 |         40vw: <article> padding
 23 |         1px: dummpy
 24 |     */
 25 |     --artile_main_width: calc(85% - 3pt - 40vw - 1px);
 26 | }
 27 | 
 28 | article.main > div.home {
 29 |     height: 100%;
 30 | }
 31 | 
 32 | article.main > div.home > div.recommend {
 33 |     display: flex;
 34 |     margin-top: 18pt;
 35 | }
 36 | 
 37 | article.main > div.home > div.recommend > div:where(.left, .right) {
 38 |     flex: 1 1 100%;
 39 |     width: 50%;
 40 | }
 41 | 
 42 | @media only screen and (max-width: 1400px) {
 43 |     article.main:has(> div.home) {
 44 |         padding: 8vh 10vw;
 45 | 
 46 |         /*
 47 |             3pt: expand bar
 48 |             20vw: <article> padding
 49 |             1px: dummpy
 50 |         */
 51 |         --artile_main_width: calc(85% - 3pt - 20vw - 1px);
 52 |     }
 53 | }
 54 | 
 55 | @media only screen and (max-width: 900px) {
 56 |     article.main:has(> div.home) {
 57 |         padding: 8vh 5vw;
 58 | 
 59 |         /*
 60 |             6vh: header
 61 |             6vh: footer
 62 |             12px: padding in footer
 63 |             16vh: <article> padding
 64 |             2pt: border of header and footer
 65 |         */
 66 |         min-height: calc(100vh - 6vh - 6vh - 12px - 16vh - 2pt);
 67 | 
 68 |         /*
 69 |             3pt: expand bar
 70 |             10vw: <article> padding
 71 |             1px: dummpy
 72 |         */
 73 |         --artile_main_width: calc(85% - 3pt - 10vw - 1px);
 74 |     }
 75 | }
 76 | 
 77 | @media only screen and (max-width: 700px) {
 78 |     article.main:has(> div.home) {
 79 |         padding: 5vh 5vw;
 80 | 
 81 |         /*
 82 |             6vh: header
 83 |             6vh: footer
 84 |             12px: padding in footer
 85 |             10vh: <article> padding
 86 |             2pt: border of header and footer
 87 |         */
 88 |         min-height: calc(100vh - 6vh - 6vh - 12px - 10vh - 2pt);
 89 |     }
 90 | }
 91 | 
 92 | /*******************
 93 |   * Styling
 94 |   *******************/
 95 | 
 96 | /* Title */
 97 | article.main > div.home > div.title > h1.title-caption {
 98 |     font-weight: 400;
 99 |     font-size: 2.2em;
100 |     white-space: nowrap;
101 |     margin-bottom: 16pt;
102 |     color: floralwhite;
103 | }
104 | 
105 | article.main > div.home > div.title > h2.subtitle {
106 |     font-size: 1.6em;
107 |     line-height: 1.4em;
108 |     white-space: nowrap;
109 | }
110 | 
111 | /* Recommend */
112 | article.main
113 |     > div.home
114 |     > div.recommend
115 |     > div:where(.left, .right)
116 |     h3.recommend-title {
117 |     font-size: 1.4em;
118 |     line-height: 1.4em;
119 |     white-space: nowrap;
120 |     margin-top: 8pt;
121 |     margin-bottom: 8pt;
122 |     color: floralwhite;
123 | }
124 | 
125 | article.main > div.home > div.recommend > div.left {
126 |     padding-right: 25pt;
127 | }
128 | 
129 | article.main > div.home > div.recommend > div.right {
130 |     padding-left: 25pt;
131 | }
132 | 
133 | /* Start */
134 | article.main > div.home > div.recommend > div.left > div.start {
135 |     margin-bottom: 16pt;
136 | }
137 | 
138 | article.main
139 |     > div.home
140 |     > div.recommend
141 |     > div.left
142 |     > div.start
143 |     > p.long-description {
144 |     line-height: 1.6em;
145 |     font-size: 90%;
146 |     text-align: justify;
147 | }
148 | 
149 | /* Recent Posts */
150 | article.main
151 |     > div.home
152 |     > div.recommend
153 |     > div.left
154 |     > div.recent
155 |     > ul.recent-posts-list
156 |     > li {
157 |     line-height: 1.6em;
158 |     font-size: 95%;
159 |     color: #80cbc4;
160 | }
161 | 
162 | article.main
163 |     > div.home
164 |     > div.recommend
165 |     > div.left
166 |     > div.recent
167 |     > ul.recent-posts-list
168 |     > li:hover {
169 |     line-height: 1.6em;
170 |     font-size: 95%;
171 |     color: #eeffff;
172 | }
173 | 
174 | article.main
175 |     > div.home
176 |     > div.recommend
177 |     > div.left
178 |     > div.recent
179 |     > ul.recent-posts-list
180 |     > li
181 |     > span.recent-posts-items-path {
182 |     font-size: 90%;
183 |     color: #eeffff;
184 |     padding-left: 1em;
185 | }
186 | 
187 | /* Section Tree in Walkthorughs */
188 | article.main > div.home > div.recommend > div.right > ul.section-tree > li {
189 |     padding-left: 0;
190 | }
191 | 
192 | article.main
193 |     > div.home
194 |     > div.recommend
195 |     > div.right
196 |     > ul.section-tree
197 |     > li:first-child {
198 |     padding-top: 0;
199 | }
200 | article.main > div.home > div.recommend > div.right ul.section-tree > li.file {
201 |     margin-top: 6pt;
202 | }
203 | 
204 | article.main > div.home > div.recommend > div.right ul.section-tree > li > a {
205 |     padding: 2pt 4pt;
206 |     border-radius: 5pt;
207 | }
208 | 
209 | article.main
210 |     > div.home
211 |     > div.recommend
212 |     > div.right
213 |     ul.section-tree
214 |     > li
215 |     > a:hover {
216 |     background-color: #3a3939;
217 |     color: #c9c9c9 !important;
218 | }
219 | 
220 | /*******************
221 |   * Responsive Styling
222 |   *******************/
223 | @media only screen and (max-width: 640px) {
224 |     article.main > div.home > div.recommend {
225 |         flex-wrap: wrap;
226 |     }
227 | 
228 |     article.main > div.home > div.recommend > div.left,
229 |     article.main > div.home > div.recommend > div.right {
230 |         width: 100%;
231 |         padding-right: 0;
232 |         padding-left: 0;
233 |     }
234 | 
235 |     article.main > div.home > div.recommend > div:where(.left, .right) > div {
236 |         margin-bottom: 16pt;
237 |     }
238 | }
239 | 


--------------------------------------------------------------------------------
/layouts/partials/html_head.html:
--------------------------------------------------------------------------------
  1 | <head>
  2 |     <meta charset="utf-8" />
  3 |     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
  4 |     <meta name="viewport" content="width=device-width, initial-scale=1" />
  5 | 
  6 |     {{ hugo.Generator }}
  7 | 
  8 |     {{ with $.Site.Params.site.googleVerification }}
  9 |         <meta name="google-site-verification" content="{{ . }}" />
 10 |     {{ end }}
 11 | 
 12 |     {{ with $.Site.Params.site.bingVerifivation }}
 13 |         <meta name="msvalidate.01" content="{{ . }}" />
 14 |     {{ end }}
 15 | 
 16 |     {{ if $.IsPage }}
 17 |         {{ if isset $.Params "description" }}
 18 |             <meta name="description" content="{{ $.Params.description }}" />
 19 |         {{ else if isset $.Site.Params.globalFrontmatter "description" }}
 20 |             <meta
 21 |                 name="description"
 22 |                 content="{{ $.Site.Params.globalFrontmatter.description }}" />
 23 |         {{ end }}
 24 | 
 25 |         {{ if isset $.Params "keywords" }}
 26 |             <meta name="keywords" content="{{ $.Params.keywords }}" />
 27 |         {{ else if isset $.Site.Params.globalFrontmatter "keywords" }}
 28 |             <meta
 29 |                 name="keywords"
 30 |                 content="{{ $.Site.Params.globalFrontmatter.keywords }}" />
 31 |         {{ end }}
 32 | 
 33 |         {{ if isset $.Params "author" }}
 34 |             <meta name="author" content="{{ $.Params.author }}" />
 35 |         {{ else if isset $.Site.Params.globalFrontmatter "author" }}
 36 |             <meta
 37 |                 name="author"
 38 |                 content="{{ $.Site.Params.globalFrontmatter.author }}" />
 39 |         {{ end }}
 40 | 
 41 |     {{ else }}
 42 |         {{ with $.Site.Params.globalFrontmatter.description }}
 43 |             <meta name="description" content="{{ . }}" />
 44 |         {{ end }}
 45 | 
 46 |         {{ with $.Site.Params.globalFrontmatter.author }}
 47 |             <meta name="author" content="{{ . }}" />
 48 |         {{ end }}
 49 | 
 50 |     {{ end }}
 51 | 
 52 | 
 53 |     <title>
 54 |         {{ if .IsHome }}
 55 |             {{ $.Site.Params.header.title }}
 56 |         {{ else }}
 57 |             {{ $.Page.Title }} |
 58 |             {{ $.Site.Params.header.title }}
 59 |         {{ end }}
 60 |     </title>
 61 | 
 62 |     {{ with $.Site.Params.site.faviconUrl }}
 63 |         <link rel="icon" href="{{ . }}" />
 64 |     {{ end }}
 65 | 
 66 | 
 67 |     <!-- Bundle all CSS -->
 68 |     {{ $style := slice }}
 69 | 
 70 |     {{/* Record all the css file names, except the general files. */}}
 71 |     {{ $style_files_list := slice }}
 72 | 
 73 | 
 74 |     <!-- Get all remore CSS -->
 75 |     {{ $style = $style | append ( resources.GetRemote "https://cdnjs.cloudflare.com/ajax/libs/meyer-reset/2.0/reset.min.css" ) }}
 76 | 
 77 | 
 78 |     <!-- Get all local CSS -->
 79 |     {{ $style = $style | append ( resources.Match "_theme/css/*.css" ) }}
 80 | 
 81 | 
 82 |     <!-- Append all custom CSS listed in the page metadata. -->
 83 |     {{ if isset $.Params "localcss" }}
 84 |         {{ range $css_src :=  $.Params.localcss }}
 85 |             {{ $style = $style | append ( resources.Match $css_src ) }}
 86 |             {{ $style_files_list =  $style_files_list | append $css_src }}
 87 |         {{ end }}
 88 |     {{ end }}
 89 | 
 90 |     {{ if isset $.Params "externalcssdownload" }}
 91 |         {{ range $css_src :=  $.Params.externalcssdownload }}
 92 |             {{ $style = $style | append ( resources.GetRemote $css_src  ) }}
 93 |             {{ $style_files_list =  $style_files_list | append $css_src }}
 94 |         {{ end }}
 95 |     {{ end }}
 96 | 
 97 | 
 98 |     <!-- Append all custom CSS listed in the global config.-->
 99 |     {{ with $.Site.Params.globalFrontmatter.localCss }}
100 |         {{ range $css_src :=  $.Site.Params.globalFrontmatter.localCss }}
101 |             {{ $style = $style | append ( resources.Match $css_src  ) }}
102 |             {{ $style_files_list =  $style_files_list | append $css_src }}
103 |         {{ end }}
104 |     {{ end }}
105 | 
106 |     {{ with $.Site.Params.globalFrontmatter.externalCssDownload }}
107 |         {{ range $css_src :=  $.Site.Params.globalFrontmatter.externalCssDownload }}
108 |             {{ $style = $style | append ( resources.GetRemote $css_src  ) }}
109 |             {{ $style_files_list =  $style_files_list | append $css_src }}
110 |         {{ end }}
111 |     {{ end }}
112 | 
113 |     {{ if hugo.IsProduction }}
114 | 
115 |         {{/* Create a hash based on the file list, to determince different style file */}}
116 |         {{ $hash:= substr (jsonify $style_files_list | md5) 0 7 }}
117 | 
118 | 
119 |         <!-- Concat to a single file -->
120 |         {{ $style = $style | resources.Concat ( printf "css/index_%s.css" $hash ) | minify | resources.Fingerprint "sha512" }}
121 | 
122 | 
123 |         <link
124 |             rel="stylesheet"
125 |             href="{{ $style.RelPermalink }}"
126 |             integrity="{{ $style.Data.Integrity }}" />
127 |     {{ else }}
128 | 
129 |         {{ range $style }}
130 |             {{ $currentStyle := . | resources.Fingerprint "sha512" }}
131 |             <link
132 |                 rel="stylesheet"
133 |                 href="{{ $currentStyle.RelPermalink }}"
134 |                 integrity="{{ $currentStyle.Data.Integrity }}" />
135 |         {{ end }}
136 | 
137 |     {{ end }}
138 | 
139 | 
140 |     <!-- External CSS that needs to be included separately. -->
141 |     {{ $style_seprated := slice }}
142 | 
143 |     {{ if isset $.Params "externalcss" }}
144 |         {{ range $css_src :=  $.Params.externalcss }}
145 |             {{ $style_seprated = $style_seprated | append ($css_src ) }}
146 |         {{ end }}
147 |     {{ end }}
148 | 
149 |     {{ with $.Site.Params.globalFrontmatter.externalCss }}
150 |         {{ range $css_src :=  $.Site.Params.globalFrontmatter.externalCss }}
151 |             {{ $style_seprated = $style_seprated | append ( $css_src ) }}
152 |         {{ end }}
153 |     {{ end }}
154 | 
155 |     {{ range $style_seprated }}
156 |         <link rel="stylesheet" href="{{ . }}" />
157 |     {{ end }}
158 | 
159 |     {{ if isset $.Params "usemath" }}
160 | 
161 |         {{ if $.Params.usemath }}
162 |             {{ partial "module/show_math" . }}
163 |         {{ end }}
164 | 
165 |     {{ else if isset $.Site.Params.globalFrontmatter "useMath" }}
166 | 
167 |         {{ if $.Site.Params.globalFrontmatter.useMath }}
168 |             {{ partial "module/show_math" . }}
169 |         {{ end }}
170 | 
171 |     {{ end }}
172 | </head>
173 | 


--------------------------------------------------------------------------------
/assets/_theme/css/05_markdown.css:
--------------------------------------------------------------------------------
  1 | /*******************************************************************************************
  2 |  * This files contain the stlying used in the <artile> > <div.content>
  3 |  * In other words, this file used to styling the content generated from markdown.
  4 |  *******************************************************************************************/
  5 | 
  6 | @charset "UTF-8";
  7 | 
  8 | /**************
  9 |     General
 10 | ***************/
 11 | article.main > div.content * {
 12 |     line-height: 22pt;
 13 |     color: #e6edf3;
 14 | }
 15 | 
 16 | article.main > div.content > :first-child {
 17 |     margin-top: 24pt;
 18 | }
 19 | 
 20 | /**************
 21 |     Header
 22 | ***************/
 23 | article.main > div.content :where(h1, h2, h3, h4, h5, h6) {
 24 |     margin-top: 24pt;
 25 |     margin-bottom: 16pt;
 26 |     font-weight: bold;
 27 | }
 28 | 
 29 | article.main > div.content :where(h1, h2) {
 30 |     padding-bottom: 15pt;
 31 |     border-bottom: 1px solid #5c5e60;
 32 | }
 33 | 
 34 | article.main > div.content h1 {
 35 |     font-size: 2em;
 36 | }
 37 | 
 38 | article.main > div.content h2 {
 39 |     font-size: 1.6rem;
 40 | }
 41 | 
 42 | article.main > div.content h3 {
 43 |     font-size: 1.4rem;
 44 | }
 45 | 
 46 | /**************
 47 |    Paragraph
 48 | ***************/
 49 | article.main > div.content p {
 50 |     text-align: justify;
 51 |     margin-top: 0.5em;
 52 |     margin-bottom: 0.5em;
 53 | }
 54 | 
 55 | article.main > div.content p + p {
 56 |     margin-top: 1.4em;
 57 | }
 58 | 
 59 | /**************
 60 |     Anchor
 61 | ***************/
 62 | article.main > div.content a {
 63 |     color: #4398e5;
 64 | }
 65 | 
 66 | article.main > div.content a:hover {
 67 |     color: #7fb8ee;
 68 |     text-decoration: underline;
 69 | }
 70 | 
 71 | /**************
 72 |       List
 73 | ***************/
 74 | article.main > div.content ul {
 75 |     display: block;
 76 |     list-style-type: disc;
 77 |     padding-inline-start: 20px;
 78 |     padding-left: 2em;
 79 | }
 80 | 
 81 | article.main > div.content ul ul {
 82 |     list-style-type: circle;
 83 | }
 84 | 
 85 | article.main > div.content ul ul ul {
 86 |     list-style-type: square;
 87 | }
 88 | 
 89 | article.main > div.content ol {
 90 |     display: block;
 91 |     list-style-type: decimal;
 92 |     padding-inline-start: 20px;
 93 |     padding-left: 2em;
 94 | }
 95 | 
 96 | article.main > div.content li {
 97 |     margin: 6pt 0pt;
 98 | }
 99 | 
100 | article.main > div.content li li {
101 |     margin: 4pt 0pt;
102 | }
103 | 
104 | article.main > div.content li li li {
105 |     margin: 2pt 0pt;
106 | }
107 | 
108 | /**************
109 |      Image
110 | ***************/
111 | article.main > div.content img {
112 |     height: auto;
113 |     width: 100%;
114 | }
115 | 
116 | /**************
117 |      Font
118 | ***************/
119 | article.main > div.content em {
120 |     font-style: italic;
121 | }
122 | 
123 | article.main > div.content strong {
124 |     font-weight: bold;
125 |     font-size: 106%;
126 |     color: white;
127 | }
128 | 
129 | article.main > div.content del {
130 |     text-decoration: line-through;
131 | }
132 | 
133 | /**************
134 |      Rule
135 | ***************/
136 | article.main > div.content hr {
137 |     height: 0.1em;
138 |     background-color: #525252;
139 |     margin: 12pt 0;
140 |     padding: 0;
141 |     border: 0;
142 | }
143 | 
144 | /**************
145 |      Table
146 | ***************/
147 | article.main > div.content table {
148 |     display: block;
149 |     max-width: 100%;
150 |     overflow: auto;
151 |     margin: 16pt 0pt;
152 | }
153 | 
154 | article.main > div.content :where(h1, h2, h3, h4, h5, h6) + table {
155 |     margin-top: 0;
156 | }
157 | 
158 | article.main > div.content table tr {
159 |     border-bottom: 1px solid #726f6f;
160 | }
161 | 
162 | article.main > div.content table th {
163 |     font-weight: bold;
164 |     font-size: 106%;
165 | }
166 | 
167 | article.main > div.content table :where(th, td) {
168 |     padding: 0.8em 1.4em;
169 | }
170 | 
171 | article.main > div.content table > thead > tr:last-child {
172 |     border-bottom-style: double;
173 |     border-bottom-width: 4px;
174 | }
175 | 
176 | article.main > div.content table > tbody > tr:last-child {
177 |     border-bottom: none;
178 | }
179 | 
180 | article.main > div.content table > tbody > tr:nth-child(2n) {
181 |     background-color: #202020;
182 | }
183 | 
184 | /**************
185 |    Code Block
186 | ***************/
187 | 
188 | /*** small code span ***/
189 | article.main > div.content :where(pre, code) {
190 |     font-family: Menlo, Monaco, Consolas, "Courier New", monospace;
191 | }
192 | 
193 | article.main > div.content code:not(div.highlight code) {
194 |     padding: 0.2em 0.4em;
195 |     font-size: 85%;
196 |     background-color: rgb(92 92 92);
197 |     border-radius: 5pt;
198 |     margin-left: 0.2em;
199 |     margin-right: 0.2em;
200 | }
201 | 
202 | /*** Code block indented with four spaces ***/
203 | article.main > div.content pre:not(div.highlight pre) {
204 |     border-radius: 10px;
205 |     padding: 1em;
206 |     overflow: auto;
207 |     background-color: #202020;
208 | }
209 | 
210 | article.main > div.content pre:not(div.highlight pre) > code {
211 |     border: none;
212 |     padding: 0;
213 |     font-size: 100%;
214 |     background-color: transparent;
215 | }
216 | 
217 | /*** Highlight Codeblock ***/
218 | article.main > div.content div.codeblock {
219 |     margin-top: -2em;
220 | }
221 | article.main > div.content div.codeblock > div.copy-button-box {
222 |     display: inline-flex;
223 |     position: relative;
224 |     top: 2.6em;
225 |     width: 100%;
226 |     justify-content: flex-end;
227 | }
228 | 
229 | article.main
230 |     > div.content
231 |     div.codeblock
232 |     > div.copy-button-box
233 |     > button.copy-button {
234 |     height: 2.5em;
235 |     color: rgba(238, 255, 255, 0.4);
236 |     background-color: transparent;
237 |     border: rgba(238, 255, 255, 0.4) solid 1pt;
238 |     border-radius: 10%;
239 |     margin-right: 0.5em;
240 |     cursor: pointer;
241 |     padding-left: 0.7em;
242 |     padding-right: 0.7em;
243 |     font-size: 14px;
244 | }
245 | 
246 | article.main
247 |     > div.content
248 |     div.codeblock
249 |     > div.copy-button-box
250 |     > button.copy-button:hover {
251 |     color: #eeffff;
252 |     border-color: #eeffff;
253 | }
254 | 
255 | article.main
256 |     > div.content
257 |     div.codeblock
258 |     > div.copy-button-box
259 |     > button.copy-button[state="copied"] {
260 |     > i {
261 |         color: green;
262 |     }
263 |     border-color: green;
264 |     padding-top: 3px;
265 | }
266 | 
267 | /* pre for cases where line numbers are not set to be displayed. */
268 | article.main > div.content div.codeblock > div.highlight :where(pre, div) {
269 |     border-radius: 10pt;
270 |     padding-top: 0.5em;
271 |     padding-bottom: 0.5em;
272 | }
273 | 
274 | article.main > div.content div.codeblock > div.highlight pre {
275 |     padding-left: 0.6em;
276 | }
277 | 
278 | article.main > div.content div.codeblock > div.highlight code {
279 |     background: none;
280 |     border-radius: 0;
281 | }
282 | 
283 | article.main > div.content div.codeblock > div.highlight table {
284 |     padding: 5pt !important;
285 |     overflow-y: hidden !important;
286 | }
287 | 
288 | article.main > div.content div.codeblock > div.highlight table tr {
289 |     border: none;
290 | }
291 | 
292 | /**************
293 |    Blockquote
294 | ***************/
295 | article.main > div.content blockquote {
296 |     padding: 0.6pt 1em;
297 |     border-left: 3px solid #727272;
298 |     border-radius: 10px;
299 |     background-color: #454545;
300 |     margin-top: 2em;
301 |     margin-bottom: 2em;
302 |     margin-left: 1em;
303 |     font-size: 15px;
304 | }
305 | 
306 | article.main > div.content blockquote blockquote {
307 |     margin-top: 0;
308 |     margin-bottom: 0;
309 |     border-radius: 6px;
310 |     margin-left: 12px;
311 | }
312 | 
313 | article.main > div.content blockquote p {
314 |     padding-top: 0.2em;
315 |     padding-bottom: 0.2em;
316 |     font-style: italic;
317 | }
318 | 
319 | article.main > div.content blockquote p + p {
320 |     margin-top: 0.5em;
321 | }
322 | 
323 | article.main > div.content blockquote blockquote p {
324 |     padding-top: 0.1em;
325 |     margin-top: 0.5em;
326 | }
327 | 
328 | /**************
329 |    Description
330 | ***************/
331 | article.main > div.content dt {
332 |     font-weight: bold;
333 |     font-size: 106%;
334 |     color: #c8c8c8;
335 | }
336 | 
337 | article.main > div.content dd {
338 |     margin-bottom: 1em;
339 |     margin-left: 0.5em;
340 | }
341 | 
342 | /**************
343 |    Super/sub script
344 | ***************/
345 | article.main > div.content sup {
346 |     vertical-align: super;
347 |     font-size: 80%;
348 | }
349 | 
350 | article.main > div.content sub {
351 |     vertical-align: sub;
352 |     font-size: 80%;
353 | }
354 | 
355 | /**************
356 |    Footnote
357 | ***************/
358 | article.main > div.content div.footnotes :where(p, p + p) {
359 |     margin: 0;
360 | }
361 | 
362 | /**************
363 |    Scrollbar
364 | ***************/
365 | :where(article.main, article.main *)::-webkit-scrollbar {
366 |     width: 8px;
367 |     height: 8px;
368 |     background-color: rgb(95, 94, 94);
369 | }
370 | 
371 | :where(article.main, article.main *)::-webkit-scrollbar-thumb {
372 |     background: rgb(139, 139, 139);
373 |     border-radius: 10pt;
374 | }
375 | 


--------------------------------------------------------------------------------
/assets/_theme/css/02_style.css:
--------------------------------------------------------------------------------
  1 | /*******************************************************************************************
  2 |  * This file contains all the styling for the site.
  3 |  *******************************************************************************************/
  4 | @charset "UTF-8";
  5 | 
  6 | /*** Element Styling ***/
  7 | a,
  8 | a:link,
  9 | a:visited,
 10 | a:hover,
 11 | a:active {
 12 |     text-decoration: none;
 13 |     color: inherit;
 14 | }
 15 | 
 16 | em {
 17 |     font-style: italic;
 18 | }
 19 | 
 20 | /*** HTML Body ***/
 21 | body {
 22 |     background-color: #282c34;
 23 |     font-size: 16px;
 24 |     font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue",
 25 |         Arial, "Noto Sans", "Liberation Sans", sans-serif, "Apple Color Emoji",
 26 |         "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
 27 |     overflow: hidden;
 28 | }
 29 | 
 30 | /*** Header ***/
 31 | header {
 32 |     font-size: 8pt;
 33 |     color: white;
 34 |     border-bottom: 1pt solid rgb(59, 59, 59);
 35 | }
 36 | 
 37 | header > div {
 38 |     vertical-align: middle;
 39 |     text-align: center;
 40 |     line-height: 3vh;
 41 |     height: 100%;
 42 | }
 43 | 
 44 | header > div.header_left {
 45 |     float: left;
 46 |     position: relative;
 47 |     left: 5pt;
 48 |     top: 0pt;
 49 | }
 50 | 
 51 | header > div.header_left > img.logo {
 52 |     height: 100%;
 53 | }
 54 | 
 55 | /*** sidebar ***/
 56 | aside.exapandable {
 57 |     width: 3pt;
 58 |     background-color: rgb(59, 59, 59);
 59 |     cursor: col-resize;
 60 | }
 61 | 
 62 | aside.exapandable:hover {
 63 |     background-color: rgb(99, 99, 99);
 64 | }
 65 | 
 66 | /*** main content ***/
 67 | article.main {
 68 |     text-align: left;
 69 |     color: #eeffff;
 70 |     padding: 2%;
 71 |     overflow-y: auto;
 72 | }
 73 | 
 74 | article.main > button.sidebar-toggle-btn {
 75 |     display: none;
 76 | }
 77 | 
 78 | article.main > div.title {
 79 |     display: flex;
 80 |     justify-content: space-between;
 81 |     padding-bottom: 15pt;
 82 | }
 83 | 
 84 | article.main > div.title > h1.title-header {
 85 |     flex: 0 0 auto;
 86 |     color: #e0e5e5;
 87 |     font-size: 2rem;
 88 |     font-weight: bold;
 89 |     margin-bottom: 0.5rem;
 90 | }
 91 | 
 92 | article.main > div.title > div.author-date-readtime {
 93 |     flex: 0 0 auto;
 94 |     display: flex;
 95 |     flex-direction: column;
 96 |     align-items: flex-end;
 97 |     font-size: 0.9rem;
 98 |     color: #939bab;
 99 | }
100 | 
101 | article.main > div.title > div.author-date-readtime > div:not(:first-child) {
102 |     padding-top: 1em;
103 | }
104 | 
105 | article.main > div.title > div.author-date-readtime > div.author:hover {
106 |     color: white;
107 | }
108 | 
109 | article.main > div.article-meta {
110 |     color: #939bab;
111 |     font-size: 1rem;
112 |     margin-top: -2em;
113 | }
114 | 
115 | article.main > div.article-meta a {
116 |     padding: 2pt 10pt;
117 |     margin: 0pt 5pt;
118 |     border-radius: 10px;
119 |     color: #ffffff;
120 | }
121 | 
122 | article.main > hr {
123 |     border-color: #5c5e60;
124 |     border-width: 1pt;
125 |     margin-bottom: 25pt;
126 | }
127 | 
128 | article.main > div.article-meta > div:only-child {
129 |     padding-top: 20pt;
130 | }
131 | 
132 | article.main > div.article-meta > div.categories > a.cat-btn {
133 |     background: #2f5292;
134 | }
135 | 
136 | article.main > div.article-meta > div.categories > a.cat-btn:hover {
137 |     background: #5779b9;
138 | }
139 | 
140 | article.main > div.article-meta > div.tags > a.tag-btn {
141 |     background: #327e5e;
142 | }
143 | 
144 | article.main > div.article-meta > div.tags > a.tag-btn:hover {
145 |     background: #479775;
146 | }
147 | 
148 | article.main > div.article-meta > div:where(.categories, .tags) > a {
149 |     line-height: 2.8em;
150 | }
151 | 
152 | article.main > div.article-meta > div:where(.breadcumb, .translation) > a {
153 |     color: #99a1ff;
154 |     padding-left: 5pt;
155 |     padding-right: 5pt;
156 |     line-height: 2.5em;
157 | }
158 | 
159 | /* first of a will contain the current present language */
160 | article.main > div.article-meta > div.translation > a:first-of-type {
161 |     color: #c6c6c7;
162 | }
163 | 
164 | article.main > nav#TableOfContents {
165 |     margin-bottom: 20pt;
166 | }
167 | 
168 | article.main > nav#TableOfContents ul {
169 |     display: block;
170 |     list-style-type: disc;
171 |     padding-inline-start: 20px;
172 | }
173 | 
174 | article.main > nav#TableOfContents ul ul {
175 |     list-style-type: circle;
176 | }
177 | 
178 | article.main > nav#TableOfContents ul ul ul {
179 |     list-style-type: square;
180 | }
181 | 
182 | article.main > nav#TableOfContents li {
183 |     margin: 8pt 0pt;
184 | }
185 | 
186 | article.main > nav#TableOfContents a {
187 |     color: #4398e5;
188 | }
189 | 
190 | article.main > nav#TableOfContents a:hover {
191 |     color: #7fb8ee;
192 |     text-decoration: underline;
193 | }
194 | 
195 | article.main > div.list-files ul.section-tree {
196 |     font-size: 14pt;
197 | }
198 | 
199 | article.main > div.list-files ul.section-tree > li {
200 |     line-height: 140%;
201 |     padding-left: 5pt;
202 | }
203 | 
204 | article.main > div.list-files ul.section-tree > li.file {
205 |     font-size: 12pt;
206 | }
207 | 
208 | article.main > div.list-files > ul.section-tree > li.file:hover {
209 |     color: white;
210 | }
211 | 
212 | article.main > div.list-terms > ul {
213 |     display: flex;
214 |     flex-wrap: wrap;
215 | }
216 | 
217 | article.main > div.list-terms > ul > li {
218 |     border: 1px solid #6c6d6e;
219 |     border-radius: 30px;
220 |     padding: 0.5em 1em;
221 |     margin: 0.5em 1em;
222 | }
223 | 
224 | article.main > div.list-terms > ul > li:hover {
225 |     border-color: #969697;
226 |     border-width: 2px;
227 |     color: white;
228 |     background-color: #727272;
229 | }
230 | 
231 | /*** footer ***/
232 | footer {
233 |     font-size: 8pt;
234 |     color: grey;
235 |     border-top: 1pt solid rgb(59, 59, 59);
236 |     padding: 0 3pt;
237 |     display: flex;
238 |     justify-content: space-between;
239 | }
240 | 
241 | footer > div {
242 |     display: inline;
243 |     flex: 0 0 auto;
244 |     /* overflow-x: hidden; */
245 | }
246 | 
247 | footer > div > ul {
248 |     display: flex;
249 |     height: 100%;
250 |     align-items: stretch;
251 |     white-space: nowrap;
252 | }
253 | 
254 | footer > div > ul > li {
255 |     flex: 0 0 auto;
256 |     padding: 0 5pt;
257 |     display: inline-flex;
258 |     align-items: center;
259 |     cursor: default;
260 | }
261 | 
262 | footer > div ul > li:hover {
263 |     background-color: rgb(65, 65, 65);
264 |     color: rgb(150, 150, 150);
265 | }
266 | 
267 | /* submenu */
268 | footer > div ul > li ul {
269 |     background-color: #282c34;
270 | 
271 |     display: none;
272 |     align-self: flex-end;
273 |     position: relative;
274 |     bottom: 100%;
275 | }
276 | 
277 | footer > div ul > li:hover ul,
278 | footer > div ul > li ul:hover {
279 |     display: block;
280 | }
281 | 
282 | footer > div ul > li:hover > ul > li,
283 | footer > div ul > li > ul:hover > li {
284 |     padding: 8pt;
285 | }
286 | 
287 | footer > div.footer-left {
288 |     max-width: 40%;
289 | }
290 | 
291 | footer > div.footer-left > ul {
292 |     justify-content: flex-start;
293 | }
294 | 
295 | footer > div.footer-right {
296 |     min-width: 60%;
297 | }
298 | 
299 | footer > div.footer-right > ul {
300 |     justify-content: flex-end;
301 | }
302 | 
303 | /* language navigator */
304 | footer > div.footer-right > ul > li.language-selector {
305 |     width: 1em;
306 |     cursor: pointer;
307 | }
308 | 
309 | footer
310 |     > div.footer-right
311 |     > ul
312 |     > li.language-selector
313 |     > ul.language-selector-menu {
314 |     font-size: 10pt;
315 |     left: -2em;
316 | }
317 | 
318 | /*** Section Tree Listing ***/
319 | ul.section-tree > li > a {
320 |     cursor: pointer;
321 |     line-height: 120%;
322 | }
323 | 
324 | ul.section-tree > li > a:hover {
325 |     color: white !important;
326 | }
327 | 
328 | ul.section-tree > li.dir {
329 |     padding-left: 10pt;
330 |     padding-top: 10pt;
331 |     color: grey;
332 | }
333 | 
334 | ul.section-tree > li.dir > span.dir-text {
335 |     cursor: pointer;
336 |     margin-left: 5pt;
337 | }
338 | 
339 | ul.section-tree > li.dir > span.dir-text:hover {
340 |     color: white;
341 | }
342 | 
343 | ul.section-tree > li.closed-dir::before {
344 |     content: " ";
345 |     border-color: white;
346 |     border-width: 1pt 1pt 0 0;
347 |     border-style: solid;
348 |     padding: 3pt;
349 |     transform: rotate(45deg);
350 |     display: inline-block;
351 |     position: relative;
352 |     bottom: 1pt;
353 | }
354 | 
355 | ul.section-tree > li.closed-dir > ul {
356 |     display: none;
357 | }
358 | 
359 | ul.section-tree > li.opened-dir::before {
360 |     content: " ";
361 |     border-color: white;
362 |     border-width: 1pt 1pt 0 0;
363 |     border-style: solid;
364 |     padding: 3pt;
365 |     transform: rotate(135deg);
366 |     display: inline-block;
367 |     position: relative;
368 |     bottom: 3pt;
369 | }
370 | 
371 | ul.section-tree > li.file {
372 |     padding-left: 5pt;
373 |     padding-top: 7pt;
374 |     color: grey;
375 |     font-size: 95%;
376 |     margin-left: 28pt;
377 | }
378 | 
379 | ul.section-tree > li.file::before {
380 |     content: "\f383";
381 |     font-family: bootstrap-icons !important;
382 |     font-style: normal;
383 |     font-weight: normal !important;
384 |     font-variant: normal;
385 |     text-transform: none;
386 |     margin-left: -1.6em;
387 |     vertical-align: -0.3ex;
388 |     padding-right: 0.4em;
389 | }
390 | 
391 | /* dir in nested subdir*/
392 | ul.section-tree ul.section-tree > li.dir {
393 |     padding-left: 18pt;
394 | }
395 | 
396 | /* file in nested subdir*/
397 | ul.section-tree ul.section-tree > li.file {
398 |     padding-left: 4pt;
399 | }
400 | 
401 | /* sidebar slide-in animation */
402 | @keyframes slide-in {
403 |     100% {
404 |         transform: translateX(0%);
405 |     }
406 | }
407 | 


--------------------------------------------------------------------------------
/hugo.toml:
--------------------------------------------------------------------------------
  1 | # Minimum support hugo
  2 | [module]
  3 |     [module.hugoVersion]
  4 |         min = "0.124.0"
  5 | 
  6 | # Support Taxonomies
  7 | [taxonomies]
  8 |     autor = "author"
  9 |     tag = "tags"
 10 |     category = "categories"
 11 |     
 12 | # Theme parameters
 13 | [params]
 14 | 
 15 |     # Parameters applied in HTML <head>
 16 |     [params.site]
 17 |         # Website ICON
 18 |         faviconUrl = ""
 19 | 
 20 |         # Do you have any CSS in local? List them in an array.
 21 |         # They should be placed inside "/assets" dir.
 22 |         # Please list your files relative to the /assets directory.
 23 |         # Glob pattern is acceptable
 24 |         # If only a few pages need the extra style files, list them in the page metadata.
 25 |         localCss = []
 26 | 
 27 |         # Do you need to add any external CSS? List their URL in an array.
 28 |         # If only a few pages need the extra style files, list them in the page metadata.
 29 |         # These URLs will be inserted into <link> tags directly without any check.
 30 |         externalCss = []
 31 | 
 32 |         # Like the one above, but this will download a local copy and combine it with 
 33 |         # other CSS files into a single file while in production mode.
 34 |         externalCssDownload = []
 35 | 
 36 |         # Do you have any script in local? List them in an array.
 37 |         # They should be placed inside "/assets" dir.
 38 |         # Please list your files relative to the /assets directory.
 39 |         # Glob pattern is acceptable
 40 |         # If only a few pages need the extra script files, list them in the page metadata.
 41 |         localJs = []
 42 | 
 43 |         # Do you have any external Script need to add on? List their URL in an array.
 44 |         # If only a few pages need the extra script files, list them in the page metadata.
 45 |         # These URLs will be inserted into <script> tags directly without any check.
 46 |         externalJs = []
 47 | 
 48 |         # Like the one above, but this will download a local copy and combine it with 
 49 |         # other JS files into a single file while in production mode.
 50 |         externalJsDownload = []
 51 | 
 52 |         # The code you could get from Google Search Console.
 53 |         # Please patse the value of content xxx in the following items
 54 |         # <meta name="google-site-verification" content="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
 55 |         googleVerification = ""
 56 | 
 57 |         # The code you could get from Microsoft Bing Webmater
 58 |         # Please patse the value of content xxx in the following items
 59 |         # <meta name="msvalidate.01" content="xxxxxxxxxxxxxxxxxxxx" />
 60 |         bingVerifivation = ""
 61 | 
 62 |     # Customized info shown in header of the page
 63 |     [params.header]
 64 |         # Website title for header banner.
 65 |         title = "My New Hugo Site"
 66 | 
 67 |         # Subtitle for this site, used in homepage only
 68 |         subtitle = "A Site Built by Hugo"
 69 | 
 70 |         # Config about your's site logo, remove this item to hide the logo
 71 |         [params.header.logo]
 72 |             # Where is your site's URL
 73 |             imgUrl = ""
 74 | 
 75 |             # If the logo is clickable, where should it be linked?
 76 |             # In default, it will linked to the homepage of the site.
 77 |             logoLink = ""
 78 | 
 79 |     # Customized info shown in footer of the page
 80 |     [params.footer]
 81 |         # CopyRight string shown in the footer. Keep it an empty string or remove this item will hide it from the page.
 82 |         copyrightStr = "All Rights Reserved ®."
 83 | 
 84 |         # Should show the counter in the footer or not
 85 |         # In the home page, it will show the numbers of all pages
 86 |         # In the sections pages, it will show the numbers of pages within the section
 87 |         # In the taxonomy pages, it will show the numbers of pages belong to the taxonomy.
 88 |         # In the regular content pages, it will show the word count.
 89 |         counter = true
 90 | 
 91 |         # Should show the language of the page or not
 92 |         language = true
 93 | 
 94 |         # Should show the hugo version or not
 95 |         hugoVersion = true
 96 | 
 97 |         # Should show the theme info or not
 98 |         theme = true
 99 | 
100 |         # Should show the edited time of the page or not
101 |         modifiedTime = true
102 | 
103 |         # The format of the `modifiedTime`.
104 |         # Refer to page https://gohugo.io/functions/format/ for more detail.
105 |         # Below is the default format, please do not remove it, unless you set `false` in `modifiedTime` field.
106 |         dateFormat = "Jan 02 2006 15:04:05"
107 | 
108 |         # Should show the current git HEAD hash or not
109 |         # To make this show up correctly, please follow the prerequisites in page
110 |         # https://gohugo.io/variables/git/
111 |         gitHash = true
112 | 
113 |         # Social link in the footer, listed items are supported, delete unwanted items to hide it.
114 |         [params.footer.socialLink]
115 |             github = ""
116 |             facebook = ""
117 |             twitter = ""
118 |             email = ""
119 |             linkedin = ""
120 |             instagram = ""
121 |             telegram = ""
122 |             medium = ""
123 |             vimeo = ""
124 |             youtube = ""
125 | 
126 |     # Metadata of the site, value will be used in HTML <header>
127 |     # These value would be used when they didn't appear in the frontmatter of a single page.
128 |     # In other words, these value will be overwritten by the frontmatter in the single page.
129 |     [params.globalFrontmatter]
130 |         # The author of this site. This will be shown in 
131 |         # 1. the footer of all page
132 |         # 2. the author filed in the single page. (this could be overwritten by the frontmatter of the single page.)
133 |         # Keep it an empty string or remove this item will hide it from the page
134 |         author = "Jing Wang"
135 |         
136 |         # Website description for RSS and SEO. Theme will generate a <meta> tag for this item
137 |         description = "This is my new hugo site"
138 | 
139 |         # Website keywords. Theme will generate a <meta> tag for this item.
140 |         keywords = "hugo,site,new"
141 | 
142 |     # Parameters applied in the homepage only
143 |     [params.homePage]
144 |         # Long Descripition shown in home page "Start Block". Is is recommended to have the paragraph shorter than 100 words.        
145 |         siteLongDescription = "Hugo is a fast and easy-to-use static website generator written in Go. It renders a complete HTML website from content and templates in a directory, utilizing Markdown files for metadata. It's optimized for speed and suitable for various website types."
146 | 
147 |         # If you don't like the title of "siteLongDescription" be "Start" (default), 
148 |         # you may change the value of this item to "Description" or something you like.
149 |         siteLongDescriptionTitle = "Start"
150 | 
151 |         # Param to decide whether to show the most recent blog posts or not. (Default: true)
152 |         showRecentPostsBlock = true
153 | 
154 |         # Param to decide how many recent posts to show in the home page. (Default: 5)
155 |         numOfRecentPosts = 5
156 | 
157 |         # Parameter to decide whether to show the URL behind the title.
158 |         # It will be more like an editor if it is shown. However, in general, it can be messy if it is displayed.        
159 |         # (Default: true)
160 |         recentPostShowUrl = true
161 |     
162 |     
163 |     # Paramater applied in the single page
164 |     # These values could be overwritten by the frontmatter in the single page.
165 |     [params.page]
166 |         # Should include Table of Content in front of the page or not.
167 |         includeToc = true
168 | 
169 |         # Should show the author of the page or not.
170 |         # The author name will be shown in the single page if and only if 
171 |         #   1. this items been set as true and
172 |         #   2. "aurthor" filed been provided in the 
173 |         #       A. single page frontmatter or
174 |         #       B. "author" filed in above "globalFrontmatter" block
175 |         showAuthor = true
176 | 
177 |         # Should show the date of the page or not
178 |         showDate = true
179 | 
180 |         # The format of the date.
181 |         # Refer to page https://gohugo.io/functions/format/ for more detail.
182 |         # Below is the default format, please do not remove it, unless you set `false` in `showDate` field.
183 |         dateFormat = "2006.01.02"
184 | 
185 |         # Should show the estimate reading time in front of the page or not.
186 |         showTimeToRead = true
187 | 
188 |         # Should show the breadcrumb in front of the page or not.
189 |         showBreadcrumb = true
190 | 
191 |         # Should show the "copy" button in the codeblock or not.
192 |         codeBlockCopible = true
193 | 
194 |         # Should include LaTeX support on a single page or not?
195 |         # This parameter will be overwritten by the page front matter (if it has been set).
196 |         # Since enabling this configuration loads some external JavaScript, 
197 |         #   it will slow down the page loading speed. 
198 |         # It's recommended to keep it turned off by default and only enable this configuration when required.
199 |         useMath = false
200 | 
201 |         # Filed tp describe how should we pass the "trust" params to the `KaTex` module.
202 |         # Thos params would affect if we could trust the HTML related code in LaTex blocks.
203 |         # https://katex.org/docs/options.html
204 |         trustedmath = false
205 | 
206 |     [params.preference]
207 |         # Use "true" to show the real fila name in both breadcrumb and the sidebar
208 |         # Use "false" to show the tile in the file in both breadcrumb and the sidebar
209 |         showFileName = false
210 | 
211 |         # Sort the pages in the sidebar in the following way
212 |         # Available options are:
213 |         ## "lastmod": the value is determined by your site configuration, defaulting to the `lastmod` field in front matter.
214 |         ## "title": sorted by title
215 |         ## "weight": Assign a weight to a page using the `weight` field in front matter. The `weight` must be a non-zero integer.
216 |         ## "pubdate": the value is determined by your site configuration, defaulting to the `publishDate` field in front matter.
217 |         ## "date":  the value is determined by your site configuration, defaulting to the `date` field in front matter.
218 |         sortBy = "title"
219 | 
220 |         # Used with `sortBy`, to determine to sort in ascending order (true) or in descending order (false)
221 |         sortInAsc = false


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 
178 |    APPENDIX: How to apply the Apache License to your work.
179 | 
180 |       To apply the Apache License to your work, attach the following
181 |       boilerplate notice, with the fields enclosed by brackets "[]"
182 |       replaced with your own identifying information. (Don't include
183 |       the brackets!)  The text should be enclosed in the appropriate
184 |       comment syntax for the file format. We also recommend that a
185 |       file or class name and description of purpose be included on the
186 |       same "printed page" as the copyright notice for easier
187 |       identification within third-party archives.
188 | 
189 |    Copyright [yyyy] [name of copyright owner]
190 | 
191 |    Licensed under the Apache License, Version 2.0 (the "License");
192 |    you may not use this file except in compliance with the License.
193 |    You may obtain a copy of the License at
194 | 
195 |        http://www.apache.org/licenses/LICENSE-2.0
196 | 
197 |    Unless required by applicable law or agreed to in writing, software
198 |    distributed under the License is distributed on an "AS IS" BASIS,
199 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 |    See the License for the specific language governing permissions and
201 |    limitations under the License.


--------------------------------------------------------------------------------
/hugo.multilang.toml:
--------------------------------------------------------------------------------
  1 | # Minimum support hugo
  2 | [module]
  3 |     [module.hugoVersion]
  4 |         min = "0.124.0"
  5 | 
  6 | # Support Taxonomies
  7 | [taxonomies]
  8 |     autor = "author"
  9 |     tag = "tags"
 10 |     category = "categories"
 11 | 
 12 | # Multilingual Setting
 13 | [languages]
 14 | 
 15 |     [languages.en]
 16 | 
 17 |         # hugo multilingual setting
 18 |         languageCode = 'en-US'
 19 |         languageDirection = 'ltr'
 20 |         languageName = 'English'
 21 |         weight = 1
 22 | 
 23 |         # Configs that were originally in the "params" section but need to be translated.
 24 |         [languages.en.params]
 25 | 
 26 |             [languages.en.params.header]
 27 |                 # Website title for header banner.
 28 |                 title = "My New Hugo Site"
 29 | 
 30 |                 # Subtitle for this site, used in homepage only
 31 |                 subtitle = 'A Site Built by Hugo'
 32 | 
 33 |             [languages.en.params.footer]
 34 |                 # CopyRight string shown in the footer. Keep it an empty string or remove this item will hide it from the page.
 35 |                 copyrightStr = "All Rights Reserved ®."
 36 | 
 37 |             [languages.en.params.globalFrontmatter]
 38 |                 # The author of this site. This will be shown in
 39 |                 # 1. the footer of all page
 40 |                 # 2. the author filed in the single page. (this could be overwritten by the frontmatter of the single page.)
 41 |                 # Keep it an empty string or remove this item will hide it from the page
 42 |                 author = "Jing Wang"
 43 | 
 44 |                 # Website description for RSS and SEO. Theme will generate a <meta> tag for this item
 45 |                 description = "This is my new hugo site"
 46 | 
 47 |                 # Website keywords. Theme will generate a <meta> tag for this item.
 48 |                 keywords = "hugo,site,new"
 49 | 
 50 |             [languages.en.params.homePage]
 51 | 
 52 |                 # Long Descripition shown in home page "Start Block". Is is recommended to have the paragraph shorter than 100 words.
 53 |                 siteLongDescription = "Hugo is a fast and easy-to-use static website generator written in Go. It renders a complete HTML website from content and templates in a directory, utilizing Markdown files for metadata. It's optimized for speed and suitable for various website types."
 54 | 
 55 |                 # If you don't like the title of "siteLongDescription" be "Start" (default),
 56 |                 # you may change the value of this item to "Description" or something you like.
 57 |                 siteLongDescriptionTitle = "Start"
 58 | 
 59 |     # 設定為繁體中文
 60 |     [languages.zh]
 61 | 
 62 |         # Hugo 多語言設定
 63 |         languageCode = 'zh-Hant-TW'
 64 |         languageDirection = 'ltr'
 65 |         languageName = '繁體中文'
 66 |         weight = 2
 67 | 
 68 |         # 原本位於 "params" 區段但需要翻譯的設定
 69 |         [languages.zh.params]
 70 | 
 71 |             [languages.zh.params.header]
 72 |                 # 頁首橫幅的網站標題。
 73 |                 title = "我的新 Hugo 網站"
 74 | 
 75 |                 # 本站的副標題，僅用於首頁
 76 |                 subtitle = '由 Hugo 建立的網站'
 77 | 
 78 |             [languages.zh.params.footer]
 79 |                 # 在頁尾顯示的版權字串。將其保留為空字串或刪除此項目可將其從頁面中隱藏。
 80 |                 copyrightStr = "版權所有 ®."
 81 | 
 82 |             [languages.zh.params.globalFrontmatter]
 83 |                 # 本站的作者。將顯示於
 84 |                 # 1. 所有頁面的頁尾
 85 |                 # 2. 單頁的作者欄位中（可被單頁的前置資料覆寫）
 86 |                 # 將其保留為空字串或刪除此項目可將其從頁面中隱藏
 87 |                 author = "王靖"
 88 | 
 89 |                 # 用於 RSS 和 SEO 的網站描述。主題將為此項目生成 <meta> 標籤
 90 |                 description = "這是我的新 Hugo 網站"
 91 | 
 92 |                 # 網站關鍵字。主題將為此項目生成 <meta> 標籤
 93 |                 keywords = "hugo,網站,新"
 94 | 
 95 |             [languages.zh.params.homePage]
 96 | 
 97 |                 # 在首頁「開始區塊」中顯示的詳細描述。建議段落長度不超過 100 個字。
 98 |                 siteLongDescription = "Hugo 是一個快速且易於使用的靜態網站產生器，用 Go 語言編寫。它可以從目錄中的內容和模板呈現完整的 HTML 網站，利用 Markdown 檔案進行元數據。它針對速度進行了優化，適用於各種類型的網站。"
 99 | 
100 |                 # 如果您不喜歡 "siteLongDescription" 的標題是「開始」（默認值），
101 |                 # 您可以將此項目的值更改為「描述」或您喜歡的其他內容。
102 |                 siteLongDescriptionTitle = "開始"
103 | 
104 | 
105 |     # Spracheinstellung für Deutsch
106 |     [languages.de]
107 | 
108 |         languageCode = 'de-DE'
109 |         languageDirection = 'ltr'
110 |         languageName = 'Deutsch'
111 |         title = 'Projekt Dokumentation'
112 |         weight = 3
113 | 
114 |         # Konfigurationen, die ursprünglich im Abschnitt "params" waren, aber übersetzt werden müssen.
115 |         [languages.de.params]
116 | 
117 |             [languages.de.params.header]
118 |                 # Website-Titel für den Kopfzeilenbanner.
119 |                 title = "Meine neue Hugo-Website"
120 | 
121 |                 # Untertitel für diese Seite, nur auf der Startseite verwendet
122 |                 subtitle = 'Eine Website erstellt von Hugo'
123 | 
124 |             [languages.de.params.footer]
125 |                 # Urheberrechtszeichenfolge im Footer angezeigt. Lassen Sie es leer oder entfernen Sie diesen Eintrag, um sie von der Seite auszublenden.
126 |                 copyrightStr = "Alle Rechte vorbehalten ®."
127 | 
128 |             [languages.de.params.globalFrontmatter]
129 |                 # Der Autor dieser Website. Dies wird angezeigt in
130 |                 # 1. im Footer auf allen Seiten
131 |                 # 2. dem Autorenfeld auf der Einzelseite. (dies kann durch das Frontmatter der Einzelseite überschrieben werden.)
132 |                 # Lassen Sie es leer oder entfernen Sie diesen Eintrag, um ihn von der Seite auszublenden.
133 |                 author = "Jing Wang"
134 | 
135 |                 # Website-Beschreibung für RSS und SEO. Das Theme generiert ein <meta>-Tag für diesen Eintrag
136 |                 description = "Das ist meine neue Hugo-Website"
137 | 
138 |                 # Website-Schlüsselwörter. Das Theme generiert ein <meta>-Tag für diesen Eintrag.
139 |                 keywords = "hugo,website,neu"
140 | 
141 |             [languages.de.params.homePage]
142 |                 # Lange Beschreibung im "Start Block" auf der Startseite angezeigt. Es wird empfohlen, den Absatz kürzer als 100 Wörter zu halten.
143 |                 siteLongDescription = "Hugo ist ein schneller und benutzerfreundlicher statischer Website-Generator, der in Go geschrieben ist. Er rendert eine vollständige HTML-Website aus Inhalten und Vorlagen in einem Verzeichnis und verwendet Markdown-Dateien für Metadaten. Er ist optimiert für Geschwindigkeit und für verschiedene Arten von Websites geeignet."
144 | 
145 |                 # Wenn Ihnen der Titel von "siteLongDescription" nicht gefällt, der standardmäßig "Start" ist,
146 |                 # können Sie den Wert dieses Elements in "Beschreibung" oder etwas ähnliches ändern, das Ihnen gefällt.
147 |                 siteLongDescriptionTitle = "Start"
148 | 
149 | # Theme parameters
150 | [params]
151 | 
152 |     # Parameters applied in HTML <head>
153 |     [params.site]
154 |         # Website ICON
155 |         faviconUrl = ""
156 | 
157 |         # Do you have any CSS in local? List them in an array.
158 |         # They should be placed inside "/assets" dir.
159 |         # And don't named the file as "index.css" and "style.css".
160 |         # These two files are used by the theme.
161 |         localCss = []
162 | 
163 |         # Do you need to add any external CSS? List them in an array.
164 |         externalCss = []
165 | 
166 |         # Do you have any script in local? List them in an array.
167 |         # They should be placed inside "/assets" dir.
168 |         # And don't named the file as "index.js"
169 |         # Theis file is used by the theme.
170 |         localJs = []
171 | 
172 |         # Do you have any external Script need to add on? List them in an array.
173 |         externalJs = []
174 | 
175 |         # The code you could get from Google Search Console.
176 |         # Please patse the value of content xxx in the following items
177 |         # <meta name="google-site-verification" content="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
178 |         googleVerification = ""
179 | 
180 |         # The code you could get from Microsoft Bing Webmater
181 |         # Please patse the value of content xxx in the following items
182 |         # <meta name="msvalidate.01" content="xxxxxxxxxxxxxxxxxxxx" />
183 |         bingVerifivation = ""
184 | 
185 |     # Customized info shown in header of the page
186 |     [params.header]
187 |         # Config about your's site logo, remove this item to hide the logo
188 |         [params.header.logo]
189 |             # Where is your site's URL
190 |             imgUrl = ""
191 | 
192 |             # If the logo is clickable, where should it be linked?
193 |             # In default, it will linked to the homepage of the site.
194 |             logoLink = ""
195 | 
196 |     # Customized info shown in footer of the page
197 |     [params.footer]
198 |         # Should show the counter in the footer or not
199 |         # In the home page, it will show the numbers of all pages
200 |         # In the sections pages, it will show the numbers of pages within the section
201 |         # In the taxonomy pages, it will show the numbers of pages belong to the taxonomy.
202 |         # In the regular content pages, it will show the word count.
203 |         counter = true
204 | 
205 |         # Should show the language of the page or not
206 |         language = true
207 | 
208 |         # Should show the hugo version or not
209 |         hugoVersion = true
210 | 
211 |         # Should show the theme info or not
212 |         theme = true
213 | 
214 |         # Should show the edited time of the page or not
215 |         modifiedTime = true
216 | 
217 |         # The format of the `modifiedTime`.
218 |         # Refer to page https://gohugo.io/functions/format/ for more detail.
219 |         # Below is the default format, please do not remove it, unless you set `false` in `modifiedTime` field.
220 |         dateFormat = "Jan 02 2006 15:04:05"
221 | 
222 |         # Should show the current git HEAD hash or not
223 |         # To make this show up correctly, please follow the prerequisites in page
224 |         # https://gohugo.io/variables/git/
225 |         gitHash = true
226 | 
227 |         # Social link in the footer, listed items are supported, delete unwanted items to hide it.
228 |         [params.footer.socialLink]
229 |             github = ""
230 |             facebook = ""
231 |             twitter = ""
232 |             email = ""
233 |             linkedin = ""
234 |             instagram = ""
235 |             telegram = ""
236 |             medium = ""
237 |             vimeo = ""
238 |             youtube = ""
239 | 
240 |     # Parameters applied in the homepage only
241 |     [params.homePage]
242 |         # Param to decide whether to show the most recent blog posts or not. (Default: true)
243 |         showRecentPostsBlock = true
244 | 
245 |         # Param to decide how many recent posts to show in the home page. (Default: 5)
246 |         numOfRecentPosts = 5
247 | 
248 |         # Parameter to decide whether to show the URL behind the title.
249 |         # It will be more like an editor if it is shown. However, in general, it can be messy if it is displayed.
250 |         # (Default: true)
251 |         recentPostShowUrl = true
252 | 
253 | 
254 |     # Paramater applied in the single page
255 |     # These values could be overwritten by the frontmatter in the single page.
256 |     [params.page]
257 |         # Should include Table of Content in front of the page or not.
258 |         includeToc = true
259 | 
260 |         # Should show the author of the page or not.
261 |         # The author name will be shown in the single page if and only if
262 |         #   1. this items been set as true and
263 |         #   2. "aurthor" filed been provided in the
264 |         #       A. single page frontmatter or
265 |         #       B. "author" filed in above "globalFrontmatter" block
266 |         showAuthor = true
267 | 
268 |         # Should show the date of the page or not
269 |         showDate = true
270 | 
271 |         # The format of the date.
272 |         # Refer to page https://gohugo.io/functions/format/ for more detail.
273 |         # Below is the default format, please do not remove it, unless you set `false` in `showDate` field.
274 |         dateFormat = "2006.01.02"
275 | 
276 |         # Should show the estimate reading time in front of the page or not.
277 |         showTimeToRead = true
278 | 
279 |         # Should show the breadcrumb in front of the page or not.
280 |         showBreadcrumb = true
281 | 
282 |         # Should show the "copy" button in the codeblock or not.
283 |         codeBlockCopible = true
284 | 
285 |         # Should include LaTeX support on a single page or not?
286 |         # This parameter will be overwritten by the page front matter (if it has been set).
287 |         # Since enabling this configuration loads some external JavaScript, 
288 |         #   it will slow down the page loading speed. 
289 |         # It's recommended to keep it turned off by default and only enable this configuration when required.
290 |         useMath = false
291 |         
292 |         # Filed tp describe how should we pass the "trust" params to the `KaTex` module.
293 |         # Thos params would affect if we could trust the HTML related code in LaTex blocks.
294 |         # https://katex.org/docs/options.html
295 |         trustedmath = false
296 | 
297 |     [params.preference]
298 |         # Use "true" to show the real fila name in both breadcrumb and the sidebar
299 |         # Use "false" to show the tile in the file in both breadcrumb and the sidebar
300 |         showFileName = false


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # Dark Theme Editor | Hugo
  2 | 
  3 | [![Example Site](https://github.com/JingWangTW/dark-theme-editor/actions/workflows/hugo.yml/badge.svg)](https://github.com/JingWangTW/dark-theme-editor/actions/workflows/hugo.yml)
  4 | [![GitHub Release](https://img.shields.io/github/release/JingWangTW/dark-theme-editor?&color=03fcfc)]()
  5 | [![Built for - Hugo](https://img.shields.io/badge/Built_for-Hugo-a503fc)](https://gohugo.io/)
  6 | [![License - Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-036bfc)](https://github.com/JingWangTW/dark-theme-editor/blob/main/LICENSE)
  7 | 
  8 | > **Dark Theme Editor** is a blog theme for [Hugo](https://gohugo.io/).
  9 | 
 10 | DEMO - <https://jingwangtw.github.io/dark-theme-editor/>
 11 | 
 12 | ⚠️ The theme needs at least Hugo v0.124.x.
 13 | 
 14 | ---
 15 | 
 16 | ## Main Features
 17 | 
 18 | * An editor-like theme for Hugo
 19 | * [Multilingual support](#multilingual-config)
 20 | * Mermaid Support
 21 | * [LaTeX Math Support](#latex-math-support)
 22 | * Google/Bing SEO support
 23 | * Better code block
 24 | * Draggable sidebar
 25 | * Fully responsive
 26 | 
 27 | ## Installation Approaches
 28 | 
 29 | ### Download Manually
 30 | 
 31 | You can simply download the theme from [GitHub Repo](https://github.com/JingWangTW/dark-theme-editor) and paste it into the `themes/dark-theme-editor` directory in the root directory of your Hugo site.
 32 | 
 33 | ### Install Theme Locally
 34 | 
 35 | ```bash
 36 | # Under the root directory of your Hugo site
 37 | 
 38 | git clone https://github.com/JingWangTW/dark-theme-editor.git themes/dark-theme-editor
 39 | ```
 40 | 
 41 | This will clone the theme repository directly into the `themes/dark-theme-editor` directory.
 42 | 
 43 | ### Install Theme as Submodule
 44 | 
 45 | ```bash
 46 | # Under the root directory of your Hugo site  
 47 | 
 48 | git submodule add -f https://github.com/JingWangTW/dark-theme-editor.git themes/dark-theme-editor
 49 | ```
 50 | 
 51 | This will install the theme repository as a submodule in the `themes/dark-theme-editor` directory.
 52 | 
 53 | ## Usage
 54 | 
 55 | ### General Config
 56 | 
 57 | * When using `dark-theme-editor` as the theme for your Hugo site, please remember to set the [theme field in your `config.toml`/`hugo.toml` file](https://gohugo.io/getting-started/configuration/#theme).
 58 | * Additionally, the theme provides many custom fields for you to configure as needed. Please refer to the [`hugo.toml` file in the theme](https://github.com/JingWangTW/dark-theme-editor/blob/main/hugo.toml) to find all available options. You can override these values by adding them to your own configuration file or by directly modifying the file in the theme directory.
 59 |     <details>
 60 |     <summary>Click to toggle the full list of configurations.</summary>
 61 | 
 62 |     ```toml
 63 |     # Theme parameters
 64 |     [params]
 65 | 
 66 |         # Parameters applied in HTML <head>
 67 |         [params.site]
 68 |             # Website ICON
 69 |             faviconUrl = ""
 70 | 
 71 |             # Do you have any CSS in local? List them in an array.
 72 |             # They should be placed inside "/assets" dir.
 73 |             # Please list your files relative to the /assets directory.
 74 |             # Glob pattern is acceptable
 75 |             # If only a few pages need the extra style files, list them in the page metadata.
 76 |             localCss = []
 77 | 
 78 |             # Do you need to add any external CSS? List their URL in an array.
 79 |             # If only a few pages need the extra style files, list them in the page metadata.
 80 |             # These URLs will be inserted into <link> tags directly without any check.
 81 |             externalCss = []
 82 | 
 83 |             # Like the one above, but this will download a local copy and combine it with 
 84 |             # other CSS files into a single file while in production mode.
 85 |             externalCssDownload = []
 86 | 
 87 |             # Do you have any script in local? List them in an array.
 88 |             # They should be placed inside "/assets" dir.
 89 |             # Please list your files relative to the /assets directory.
 90 |             # Glob pattern is acceptable
 91 |             # If only a few pages need the extra script files, list them in the page metadata.
 92 |             localJs = []
 93 | 
 94 |             # Do you have any external Script need to add on? List their URL in an array.
 95 |             # If only a few pages need the extra script files, list them in the page metadata.
 96 |             # These URLs will be inserted into <script> tags directly without any check.
 97 |             externalJs = []
 98 | 
 99 |             # Like the one above, but this will download a local copy and combine it with 
100 |             # other JS files into a single file while in production mode.
101 |             externalJsDownload = []
102 | 
103 |             # The code you could get from Google Search Console.
104 |             # Please patse the value of content xxx in the following items
105 |             # <meta name="google-site-verification" content="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
106 |             googleVerification = ""
107 | 
108 |             # The code you could get from Microsoft Bing Webmater
109 |             # Please patse the value of content xxx in the following items
110 |             # <meta name="msvalidate.01" content="xxxxxxxxxxxxxxxxxxxx" />
111 |             bingVerifivation = ""
112 | 
113 |         # Customized info shown in header of the page        # Customized info shown in header of the page
114 |         [params.header]
115 |             # Website title for header banner.
116 |             title = "My New Hugo Site"
117 | 
118 |             # Subtitle for this site, used in homepage only
119 |             subtitle = "A Site Built by Hugo"
120 | 
121 |             # Config about your's site logo, remove this item to hide the logo
122 |             [params.header.logo]
123 |                 # Where is your site's URL
124 |                 imgUrl = ""
125 | 
126 |                 # If the logo is clickable, where should it be linked?
127 |                 # In default, it will linked to the homepage of the site.
128 |                 logoLink = ""
129 | 
130 |         # Customized info shown in footer of the page
131 |         [params.footer]
132 |             # CopyRight string shown in the footer. Keep it an empty string or remove this item will hide it from the page.
133 |             copyrightStr = "All Rights Reserved ®."
134 | 
135 |             # Should show the counter in the footer or not
136 |             # In the home page, it will show the numbers of all pages
137 |             # In the sections pages, it will show the numbers of pages within the section
138 |             # In the taxonomy pages, it will show the numbers of pages belong to the taxonomy.
139 |             # In the regular content pages, it will show the word count.
140 |             counter = true
141 | 
142 |             # Should show the language of the page or not
143 |             language = true
144 | 
145 |             # Should show the hugo version or not
146 |             hugoVersion = true
147 | 
148 |             # Should show the theme info or not
149 |             theme = true
150 | 
151 |             # Should show the edited time of the page or not
152 |             modifiedTime = true
153 | 
154 |             # The format of the `modifiedTime`.
155 |             # Refer to page https://gohugo.io/functions/format/ for more detail.
156 |             # Below is the default format, please do not remove it, unless you set `false` in `modifiedTime` field.
157 |             dateFormat = "Jan 02 2006 15:04:05"
158 | 
159 |             # Should show the current git HEAD hash or not
160 |             # To make this show up correctly, please follow the prerequisites in page
161 |             # https://gohugo.io/variables/git/
162 |             gitHash = true
163 | 
164 |             # Social link in the footer, listed items are supported, delete unwanted items to hide it.
165 |             [params.footer.socialLink]
166 |                 github = ""
167 |                 facebook = ""
168 |                 twitter = ""
169 |                 email = ""
170 |                 linkedin = ""
171 |                 instagram = ""
172 |                 telegram = ""
173 |                 medium = ""
174 |                 vimeo = ""
175 |                 youtube = ""
176 | 
177 |         # Metadata of the site, value will be used in HTML <header>
178 |         # These value would be used when they didn't appear in the frontmatter of a single page.
179 |         # In other words, these value will be overwritten by the frontmatter in the single page.
180 |         [params.globalFrontmatter]
181 |             # The author of this site. This will be shown in 
182 |             # 1. the footer of all page
183 |             # 2. the author filed in the single page. (this could be overwritten by the frontmatter of the single page.)
184 |             # Keep it an empty string or remove this item will hide it from the page
185 |             author = "Jing Wang"
186 |             
187 |             # Website description for RSS and SEO. Theme will generate a <meta> tag for this item
188 |             description = "This is my new hugo site"
189 | 
190 |             # Website keywords. Theme will generate a <meta> tag for this item.
191 |             keywords = "hugo,site,new"
192 | 
193 |         # Parameters applied in the homepage only
194 |         [params.homePage]
195 |             # Long Descripition shown in home page "Start Block". Is is recommended to have the paragraph shorter than 100 words.        
196 |             siteLongDescription = "Hugo is a fast and easy-to-use static website generator written in Go. It renders a complete HTML website from content and templates in a directory, utilizing Markdown files for metadata. It's optimized for speed and suitable for various website types."
197 | 
198 |             # If you don't like the title of "siteLongDescription" be "Start" (default), 
199 |             # you may change the value of this item to "Description" or something you like.
200 |             siteLongDescriptionTitle = "Start"
201 | 
202 |             # Param to decide whether to show the most recent blog posts or not. (Default: true)
203 |             showRecentPostsBlock = true
204 | 
205 |             # Param to decide how many recent posts to show in the home page. (Default: 5)
206 |             numOfRecentPosts = 5
207 | 
208 |             # Parameter to decide whether to show the URL behind the title.
209 |             # It will be more like an editor if it is shown. However, in general, it can be messy if it is displayed.        
210 |             # (Default: true)
211 |             recentPostShowUrl = true
212 |         
213 |         
214 |         # Paramater applied in the single page
215 |         # These values could be overwritten by the frontmatter in the single page.
216 |         [params.page]
217 |             # Should include Table of Content in front of the page or not.
218 |             includeToc = true
219 | 
220 |             # Should show the author of the page or not.
221 |             # The author name will be shown in the single page if and only if 
222 |             #   1. this items been set as true and
223 |             #   2. "aurthor" filed been provided in the 
224 |             #       A. single page frontmatter or
225 |             #       B. "author" filed in above "globalFrontmatter" block
226 |             showAuthor = true
227 | 
228 |             # Should show the date of the page or not
229 |             showDate = true
230 | 
231 |             # The format of the date.
232 |             # Refer to page https://gohugo.io/functions/format/ for more detail.
233 |             # Below is the default format, please do not remove it, unless you set `false` in `showDate` field.
234 |             dateFormat = "2006.01.02"
235 | 
236 |             # Should show the estimate reading time in front of the page or not.
237 |             showTimeToRead = true
238 | 
239 |             # Should show the breadcrumb in front of the page or not.
240 |             showBreadcrumb = true
241 | 
242 |             # Should show the "copy" button in the codeblock or not.
243 |             codeBlockCopible = true
244 | 
245 |             # Should include LaTeX support on a single page or not?
246 |             # This parameter will be overwritten by the page front matter (if it has been set).
247 |             # Since enabling this configuration loads some external JavaScript, 
248 |             #   it will slow down the page loading speed. 
249 |             # It's recommended to keep it turned off by default and only enable this configuration when required.
250 |             useMath = false
251 | 
252 |             # Filed tp describe how should we pass the "trust" params to the `KaTex` module.
253 |             # Thos params would affect if we could trust the HTML related code in LaTex blocks.
254 |             # https://katex.org/docs/options.html
255 |             trustedmath = false
256 | 
257 |         [params.preference]
258 |             # Use "true" to show the real fila name in both breadcrumb and the sidebar
259 |             # Use "false" to show the tile in the file in both breadcrumb and the sidebar
260 |             showFileName = false
261 | 
262 |             # Sort the pages in the sidebar in the following way
263 |             # Available options are:
264 |             ## "lastmod": the value is determined by your site configuration, defaulting to the `lastmod` field in front matter.
265 |             ## "title": sorted by title
266 |             ## "weight": Assign a weight to a page using the `weight` field in front matter. The `weight` must be a non-zero integer.
267 |             ## "pubdate": the value is determined by your site configuration, defaulting to the `publishDate` field in front matter.
268 |             ## "date":  the value is determined by your site configuration, defaulting to the `date` field in front matter.
269 |             sortBy = "title"
270 | 
271 |             # Used with `sortBy`, to determine to sort in ascending order (true) or in descending order (false)
272 |             sortInAsc = false
273 |     ```
274 | 
275 |     </details>
276 | 
277 | ### Multilingual Config
278 | 
279 | * If your site is in [multilingual mode](https://gohugo.io/content-management/multilingual/), there will be a language select icon at the footer of the site. Additionally, there will be a navigator on each translated page.
280 | * Please move the configuration fields that need to be translated under the corresponding language configuration blocks in your `hugo.toml`. There is an example `hugo.multilang.toml` file you could reference. Remember to rename it to `hugo.toml` when needed.
281 |     <details>
282 |     <summary>Click to toggle example <code>hugo.multilang.toml</code> file</summary>
283 | 
284 |     ```toml
285 |     # Multilingual Setting
286 |     [languages]
287 |         
288 |         [languages.en]
289 |             
290 |             # hugo multilingual setting
291 |             languageCode = 'en-US'
292 |             languageDirection = 'ltr'
293 |             languageName = 'English'
294 |             weight = 1
295 |             
296 |             # Configs that were originally in the "params" section but need to be translated.
297 |             [languages.en.params]
298 |                 
299 |                 [languages.en.params.header]
300 |                     # Website title for header banner.
301 |                     title = "My New Hugo Site"
302 | 
303 |                     # Subtitle for this site, used in homepage only
304 |                     subtitle = 'A Site Built by Hugo'
305 |                 
306 |                 [languages.en.params.footer]
307 |                     # CopyRight string shown in the footer. Keep it an empty string or remove this item will hide it from the page.
308 |                     copyrightStr = "All Rights Reserved ®."
309 | 
310 |                 [languages.en.params.globalFrontmatter]
311 |                     # The author of this site. This will be shown in 
312 |                     # 1. the footer of all page
313 |                     # 2. the author filed in the single page. (this could be overwritten by the frontmatter of the single page.)
314 |                     # Keep it an empty string or remove this item will hide it from the page
315 |                     author = "Jing Wang"
316 |                     
317 |                     # Website description for RSS and SEO. Theme will generate a <meta> tag for this item
318 |                     description = "This is my new hugo site"
319 | 
320 |                     # Website keywords. Theme will generate a <meta> tag for this item.
321 |                     keywords = "hugo,site,new"
322 | 
323 |                 [languages.en.params.homePage]
324 | 
325 |                     # Long Descripition shown in home page "Start Block". Is is recommended to have the paragraph shorter than 100 words.        
326 |                     siteLongDescription = "Hugo is a fast and easy-to-use static website generator written in Go. It renders a complete HTML website from content and templates in a directory, utilizing Markdown files for metadata. It's optimized for speed and suitable for various website types."
327 | 
328 |                     # If you don't like the title of "siteLongDescription" be "Start" (default), 
329 |                     # you may change the value of this item to "Description" or something you like.
330 |                     siteLongDescriptionTitle = "Start"
331 | 
332 |         # 設定為繁體中文
333 |         [languages.zh]
334 | 
335 |             # Hugo 多語言設定
336 |             languageCode = 'zh-Hant-TW'
337 |             languageDirection = 'ltr'
338 |             languageName = '繁體中文'
339 |             weight = 2
340 | 
341 |             # 原本位於 "params" 區段但需要翻譯的設定
342 |             [languages.zh.params]
343 |                 
344 |                 [languages.zh.params.header]
345 |                     # 頁首橫幅的網站標題。
346 |                     title = "我的新 Hugo 網站"
347 | 
348 |                     # 本站的副標題，僅用於首頁
349 |                     subtitle = '由 Hugo 建立的網站'
350 | 
351 |                 [languages.zh.params.footer]
352 |                     # 在頁尾顯示的版權字串。將其保留為空字串或刪除此項目可將其從頁面中隱藏。
353 |                     copyrightStr = "版權所有 ®."
354 | 
355 |                 [languages.zh.params.globalFrontmatter]
356 |                     # 本站的作者。將顯示於
357 |                     # 1. 所有頁面的頁尾
358 |                     # 2. 單頁的作者欄位中（可被單頁的前置資料覆寫）
359 |                     # 將其保留為空字串或刪除此項目可將其從頁面中隱藏
360 |                     author = "王靖"
361 | 
362 |                     # 用於 RSS 和 SEO 的網站描述。主題將為此項目生成 <meta> 標籤
363 |                     description = "這是我的新 Hugo 網站"
364 | 
365 |                     # 網站關鍵字。主題將為此項目生成 <meta> 標籤
366 |                     keywords = "hugo,網站,新"
367 | 
368 |                 [languages.zh.params.homePage]
369 | 
370 |                     # 在首頁「開始區塊」中顯示的詳細描述。建議段落長度不超過 100 個字。
371 |                     siteLongDescription = "Hugo 是一個快速且易於使用的靜態網站產生器，用 Go 語言編寫。它可以從目錄中的內容和模板呈現完整的 HTML 網站，利用 Markdown 檔案進行元數據。它針對速度進行了優化，適用於各種類型的網站。"
372 | 
373 |                     # 如果您不喜歡 "siteLongDescription" 的標題是「開始」（默認值），
374 |                     # 您可以將此項目的值更改為「描述」或您喜歡的其他內容。
375 |                     siteLongDescriptionTitle = "開始"
376 | 
377 | 
378 |         # Spracheinstellung für Deutsch
379 |         [languages.de]
380 | 
381 |             languageCode = 'de-DE'
382 |             languageDirection = 'ltr'
383 |             languageName = 'Deutsch'
384 |             title = 'Projekt Dokumentation'
385 |             weight = 3
386 | 
387 |             # Konfigurationen, die ursprünglich im Abschnitt "params" waren, aber übersetzt werden müssen.
388 |             [languages.de.params]
389 |                 
390 |                 [languages.de.params.header]
391 |                     # Website-Titel für den Kopfzeilenbanner.
392 |                     title = "Meine neue Hugo-Website"
393 | 
394 |                     # Untertitel für diese Seite, nur auf der Startseite verwendet
395 |                     subtitle = 'Eine Website erstellt von Hugo'
396 |                 
397 |                 [languages.de.params.footer]
398 |                     # Urheberrechtszeichenfolge im Footer angezeigt. Lassen Sie es leer oder entfernen Sie diesen Eintrag, um sie von der Seite auszublenden.
399 |                     copyrightStr = "Alle Rechte vorbehalten ®."
400 | 
401 |                 [languages.de.params.globalFrontmatter]
402 |                     # Der Autor dieser Website. Dies wird angezeigt in 
403 |                     # 1. im Footer auf allen Seiten
404 |                     # 2. dem Autorenfeld auf der Einzelseite. (dies kann durch das Frontmatter der Einzelseite überschrieben werden.)
405 |                     # Lassen Sie es leer oder entfernen Sie diesen Eintrag, um ihn von der Seite auszublenden.
406 |                     author = "Jing Wang"
407 |                     
408 |                     # Website-Beschreibung für RSS und SEO. Das Theme generiert ein <meta>-Tag für diesen Eintrag
409 |                     description = "Das ist meine neue Hugo-Website"
410 | 
411 |                     # Website-Schlüsselwörter. Das Theme generiert ein <meta>-Tag für diesen Eintrag.
412 |                     keywords = "hugo,website,neu"
413 | 
414 |                 [languages.de.params.homePage]
415 |                     # Lange Beschreibung im "Start Block" auf der Startseite angezeigt. Es wird empfohlen, den Absatz kürzer als 100 Wörter zu halten.        
416 |                     siteLongDescription = "Hugo ist ein schneller und benutzerfreundlicher statischer Website-Generator, der in Go geschrieben ist. Er rendert eine vollständige HTML-Website aus Inhalten und Vorlagen in einem Verzeichnis und verwendet Markdown-Dateien für Metadaten. Er ist optimiert für Geschwindigkeit und für verschiedene Arten von Websites geeignet."
417 | 
418 |                     # Wenn Ihnen der Titel von "siteLongDescription" nicht gefällt, der standardmäßig "Start" ist, 
419 |                     # können Sie den Wert dieses Elements in "Beschreibung" oder etwas ähnliches ändern, das Ihnen gefällt.
420 |                     siteLongDescriptionTitle = "Start"
421 | 
422 |     # Theme parameters
423 |     [params]
424 | 
425 |         # Parameters applied in HTML <head>
426 |         [params.site]
427 |             # Website ICON
428 |             faviconUrl = ""
429 | 
430 |             # Do you have any CSS in local? List them in an array.
431 |             # They should be placed inside "/assets" dir.
432 |             # And don't named the file as "index.css" and "style.css".
433 |             # These two files are used by the theme.
434 |             localCss = []
435 | 
436 |             # Do you need to add any external CSS? List them in an array.
437 |             externalCss = []
438 | 
439 |             # Do you have any script in local? List them in an array.
440 |             # They should be placed inside "/assets" dir.
441 |             # And don't named the file as "index.js"
442 |             # Theis file is used by the theme.
443 |             localJs = []
444 | 
445 |             # Do you have any external Script need to add on? List them in an array.
446 |             externalJs = []
447 | 
448 |             # The code you could get from Google Search Console.
449 |             # Please patse the value of content xxx in the following items
450 |             # <meta name="google-site-verification" content="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
451 |             googleVerification = ""
452 | 
453 |             # The code you could get from Microsoft Bing Webmater
454 |             # Please patse the value of content xxx in the following items
455 |             # <meta name="msvalidate.01" content="xxxxxxxxxxxxxxxxxxxx" />
456 |             bingVerifivation = ""
457 | 
458 |         # Customized info shown in header of the page
459 |         [params.header]
460 |             # Config about your's site logo, remove this item to hide the logo
461 |             [params.header.logo]
462 |                 # Where is your site's URL
463 |                 imgUrl = ""
464 | 
465 |                 # If the logo is clickable, where should it be linked?
466 |                 # In default, it will linked to the homepage of the site.
467 |                 logoLink = ""
468 | 
469 |         # Customized info shown in footer of the page
470 |         [params.footer]
471 |             # Should show the counter in the footer or not
472 |             # In the home page, it will show the numbers of all pages
473 |             # In the sections pages, it will show the numbers of pages within the section
474 |             # In the taxonomy pages, it will show the numbers of pages belong to the taxonomy.
475 |             # In the regular content pages, it will show the word count.
476 |             counter = true
477 | 
478 |             # Should show the language of the page or not
479 |             language = true
480 | 
481 |             # Should show the hugo version or not
482 |             hugoVersion = true
483 | 
484 |             # Should show the theme info or not
485 |             theme = true
486 | 
487 |             # Should show the edited time of the page or not
488 |             modifiedTime = true
489 | 
490 |             # The format of the `modifiedTime`.
491 |             # Refer to page https://gohugo.io/functions/format/ for more detail.
492 |             # Below is the default format, please do not remove it, unless you set `false` in `modifiedTime` field.
493 |             dateFormat = "Jan 02 2006 15:04:05"
494 | 
495 |             # Should show the current git HEAD hash or not
496 |             # To make this show up correctly, please follow the prerequisites in page
497 |             # https://gohugo.io/variables/git/
498 |             gitHash = true
499 | 
500 |             # Social link in the footer, listed items are supported, delete unwanted items to hide it.
501 |             [params.footer.socialLink]
502 |                 github = ""
503 |                 facebook = ""
504 |                 twitter = ""
505 |                 email = ""
506 |                 linkedin = ""
507 |                 instagram = ""
508 |                 telegram = ""
509 |                 medium = ""
510 |                 vimeo = ""
511 |                 youtube = ""
512 | 
513 |         # Parameters applied in the homepage only
514 |         [params.homePage]
515 |             # Param to decide whether to show the most recent blog posts or not. (Default: true)
516 |             showRecentPostsBlock = true
517 | 
518 |             # Param to decide how many recent posts to show in the home page. (Default: 5)
519 |             numOfRecentPosts = 5
520 | 
521 |             # Parameter to decide whether to show the URL behind the title.
522 |             # It will be more like an editor if it is shown. However, in general, it can be messy if it is displayed.        
523 |             # (Default: true)
524 |             recentPostShowUrl = true
525 |         
526 |         
527 |         # Paramater applied in the single page
528 |         # These values could be overwritten by the frontmatter in the single page.
529 |         [params.page]
530 |             # Should include Table of Content in front of the page or not.
531 |             includeToc = true
532 | 
533 |             # Should show the author of the page or not.
534 |             # The author name will be shown in the single page if and only if 
535 |             #   1. this items been set as true and
536 |             #   2. "aurthor" filed been provided in the 
537 |             #       A. single page frontmatter or
538 |             #       B. "author" filed in above "globalFrontmatter" block
539 |             showAuthor = true
540 | 
541 |             # Should show the date of the page or not
542 |             showDate = true
543 | 
544 |             # The format of the date.
545 |             # Refer to page https://gohugo.io/functions/format/ for more detail.
546 |             # Below is the default format, please do not remove it, unless you set `false` in `showDate` field.
547 |             dateFormat = "2006.01.02"
548 | 
549 |             # Should show the estimate reading time in front of the page or not.
550 |             showTimeToRead = true
551 | 
552 |             # Should show the breadcrumb in front of the page or not.
553 |             showBreadcrumb = true
554 | 
555 |             # Should show the "copy" button in the codeblock or not.
556 |             codeBlockCopible = true
557 | 
558 |             # Should include LaTeX support on a single page or not?
559 |             # This parameter will be overwritten by the page front matter (if it has been set).
560 |             # Since enabling this configuration loads some external JavaScript, 
561 |             #   it will slow down the page loading speed. 
562 |             # It's recommended to keep it turned off by default and only enable this configuration when required.
563 |             useMath = false
564 |             
565 |             # Filed tp describe how should we pass the "trust" params to the `KaTex` module.
566 |             # Thos params would affect if we could trust the HTML related code in LaTex blocks.
567 |             # https://katex.org/docs/options.html
568 |             trustedmath = false
569 | 
570 |         [params.preference]
571 |             # Use "true" to show the real fila name in both breadcrumb and the sidebar
572 |             # Use "false" to show the tile in the file in both breadcrumb and the sidebar
573 |             showFileName = false
574 |     ```
575 | 
576 |     </details>
577 | * Also, please [add the corresponding i18n translation table](https://gohugo.io/functions/lang/translate/) according to the language you use, so the theme can translate to the language you use properly. I have placed an example file for English containing all the words required by the theme under the `i18n` folder. You should copy it and translate it to the language you need.
578 | 
579 | ### Author Taxonomies
580 | 
581 | * Since Hugo [will not merge the taxonomies config from theme config to site config by default](https://gohugo.io/getting-started/configuration/#merge-configuration-from-themes), the author taxonomies pages need to be set in your [site configuration].
582 |     * You could simply merge the theme config into site config.  
583 | 
584 |     ```toml
585 |     [taxonomies]
586 |         _merge = "deep"
587 |     ```
588 | 
589 |     * Otherwise, you could define your taxonomies directly.
590 | 
591 |     ```toml
592 |     [taxonomies]
593 |         autor = "author"
594 |         tag = "tags"
595 |         category = "categories"
596 |     ```
597 | 
598 | * Also, you need to set up the `[params.page.showAuthor]` according to your preference. `params` config will be merged from theme config into site config by default.
599 | 
600 | ### LaTex Math Support
601 | 
602 | * This theme supports LaTeX Math interpretation and utilizes [KaTeX](https://katex.org/) as the rendering engine.
603 | * To enable this feature, please add `useMath = true` in the frontmatter of the single page or in the [site configuration]. By default, this feature is turned off. The single page configuration will override the configuration in the [site configuration].
604 | * As turning on this feature will add the related dependency in each page, which will slow down the performance of page loading, it is recommended to turn on this feature in the pages that require it, rather than turning it on globally in the [site configuration].
605 | * By default, we support the following delimiters:
606 |     * `$$ \LaTeX $$`: This will render the formula in a single line.
607 |     * `$ \LaTeX $`: This will render the formula inline.
608 |     * `\\( \LaTeX \\)`: This will render the formula inline.
609 |     * `\\[ \LaTeX \\]`: This will render the formula in a single line.
610 | * Also, as Hugo will interpret `\` as an escape character, remember to use `\\\\` for line breaks.
611 | * <details>
612 |   <summary>FYI, this is the <a href="https://katex.org/docs/options"> configuraions </a> passed to KaTeX by the theme.</summary>
613 | 
614 |     ```js
615 |     renderMathInElement(document.body, {
616 |         // customised options
617 |         // auto-render specific keys, e.g.:
618 |         delimiters: [
619 |             { left: "$$", right: "$$", display: true },
620 |             { left: "$", right: "$", display: false },
621 |             { left: "\\(", right: "\\)", display: false },
622 |             { left: "\\[", right: "\\]", display: true },
623 |         ],
624 |         // rendering keys, e.g.:
625 |         throwOnError: false,
626 |     });
627 |     ```
628 | 
629 |   </details>
630 | 
631 | ## Run & Build
632 | 
633 | ### Develop
634 | 
635 | ```
636 | hugo server
637 | ```
638 | 
639 | Then, you should be able to see your site at `localhost:1313`. From now on, all changes made locally will be reflected on the site, without the need to refresh your browser each time. Additionally, all files will not be minified or merged in this development mode, making it easier to debug any issues.
640 | 
641 | ### Release
642 | 
643 | ```
644 | hugo
645 | ```
646 | 
647 | This will build your site in release mode, where all `.html`, `.css`, and `.js` files will be minified and merged when possible.
648 | 
649 | ## Feature Plan
650 | 
651 | * Tab View Support
652 | * Store custom note in local storage.
653 | * Accessibility Support
654 | * LaTex Math Rendering in Server Side.
655 | * Search Bar Provided.
656 | 
657 | ## Acknowledgement
658 | 
659 | This theme was originally inspired by the [theme `edidor`](https://github.com/sfengyuan/edidor).
660 | 
661 | ## License
662 | 
663 | This theme was released under the Apache License 2.0.
664 | 
665 | [site configuration]: https://gohugo.io/getting-started/configuration/
666 | 


--------------------------------------------------------------------------------