content/
├── en/
│   ├── about.md
│   ├── archives/
│   ├── friend.md
│   └── post/
├── yue/
│   ├── about.md
│   ├── archives/
│   ├── friend.md
│   └── post/
├── zh-CN/
│   ├── about.md
│   ├── archives/
│   ├── friend.md
│   └── post/
└── zh-TW/          # 可选，以此类推
    ├── about.md
    ├── archives/
    ├── friend.md
    └── post/

translationKey: about

[languages.yue]
  locale = "yue"                # 语言代码，需与文件夹名一致
  label = "粵語"                # 界面显示的语言名称（可自定义）
  hasCJKLanguage = true         # 若语言包含中日韩文字，设为 true
  contentDir = "content/yue"    # 指向该语言的内容文件夹
  weight = 2                    # 在语言切换列表中的排序，数值越小越靠前

[languages.en]
  locale = "en"
  label = "English"
  hasCJKLanguage = false
  contentDir = "content/en"
  weight = 3

defaultContentLanguage = "zh-CN"   # 设为你的主语言

clipboard:
  success: 
    en: Copy successfully (*^▽^*)
    zh-CN: 复制成功 (*^▽^*)
    yue: 複製成功 (*^▽^*)          # 新增 yue 的翻译
    zh-TW: 複製成功 (*^▽^*)
    ja: コピー成功 (*^▽^*)
    pt-BR: Copiado com sucesso (*^▽^*)

[~]$ pkg install golang

$ go version
go version go1.26.5 android/arm64

CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest

[~]$ CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
go: downloading github.com/gohugoio/hugo v0.164.0                 go: downloading github.com/bep/godartsass/v2 v2.5.0               go: downloading github.com/bep/golibsass v1.2.0                   go: downloading github.com/pelletier/go-toml/v2 v2.4.3            go: downloading github.com/spf13/afero v1.15.0                    go: downloading github.com/tdewolff/parse/v2 v2.8.12              go: downloading github.com/bep/logg v0.4.0                        go: downloading github.com/fatih/color v1.18.0                    go: downloading github.com/alecthomas/chroma/v2 v2.27.0           go: downloading github.com/bep/clocks v0.5.0                      go: downloading github.com/bep/debounce v1.2.0                    go: downloading github.com/bep/lazycache v0.8.1                   go: downloading github.com/bep/mclib v1.20401.20400               go: downloading github.com/bep/overlayfs v0.11.0                  go: downloading github.com/fsnotify/fsnotify v1.9.0               go: downloading github.com/bep/simplecobra v0.7.0                 go: downloading github.com/goccy/go-yaml v1.19.2                  go: downloading github.com/spf13/cobra v1.10.2                    go: downloading github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c                                                           go: downloading github.com/spf13/fsync v0.10.1                    go: downloading github.com/spf13/pflag v1.0.10                    go: downloading go.uber.org/automaxprocs v1.5.3                   go: downloading golang.org/x/sync v0.21.0                         go: downloading golang.org/x/text v0.38.0                         go: downloading github.com/cespare/xxhash/v2 v2.3.0               go: downloading github.com/gohugoio/hashstructure v0.6.0          go: downloading github.com/mattn/go-isatty v0.0.22                go: downloading github.com/mattn/go-colorable v0.1.14             go: downloading google.golang.org/protobuf v1.36.11
go: downloading github.com/hashicorp/golang-lru/v2 v2.0.7
go: downloading github.com/dlclark/regexp2/v2 v2.2.1
go: downloading github.com/pkg/errors v0.9.1
go: downloading github.com/bep/helpers v0.12.0
go: downloading github.com/bep/golocales v0.2.0
go: downloading github.com/spf13/cast v1.10.0
go: downloading github.com/gobwas/glob v0.2.3
go: downloading github.com/mitchellh/mapstructure v1.5.1-0.20231216201459-8508981c8b6c
go: downloading github.com/pbnjay/memory v0.0.0-20210728143218-7b4eea64cf58
go: downloading github.com/gohugoio/go-radix v1.2.0
go: downloading github.com/jdkato/prose v1.2.1
go: downloading github.com/dlclark/regexp2 v1.12.0
go: downloading github.com/kyokomi/emoji/v2 v2.2.13
go: downloading github.com/olekukonko/tablewriter v1.1.4
go: downloading github.com/bep/gitmap v1.9.0
go: downloading github.com/frankban/quicktest v1.14.6
go: downloading github.com/gobuffalo/flect v1.0.3
go: downloading github.com/hairyhenderson/go-codeowners v0.7.0
go: downloading github.com/yuin/goldmark v1.8.2
go: downloading golang.org/x/tools v0.47.0
go: downloading github.com/rogpeppe/go-internal v1.15.0
go: downloading github.com/gorilla/websocket v1.5.3
go: downloading golang.org/x/mod v0.37.0
go: downloading github.com/clbanning/mxj/v2 v2.7.0
go: downloading github.com/niklasfasching/go-org v1.9.1
go: downloading github.com/bits-and-blooms/bitset v1.24.5
go: downloading golang.org/x/sys v0.46.0
go: downloading github.com/cpuguy83/go-md2man/v2 v2.0.6
go: downloading go.yaml.in/yaml/v3 v3.0.4
go: downloading github.com/BurntSushi/locker v0.0.0-20171006230638-a6e239ea1c69
go: downloading github.com/gohugoio/httpcache v0.8.0
go: downloading github.com/tdewolff/minify/v2 v2.24.13
go: downloading github.com/bep/imagemeta v0.17.2
go: downloading github.com/gohugoio/gift v0.2.0
go: downloading github.com/makeworld-the-better-one/dither/v2 v2.4.0
go: downloading golang.org/x/image v0.43.0
go: downloading github.com/muesli/smartcrop v0.3.0
go: downloading github.com/tetratelabs/wazero v1.12.0
go: downloading github.com/bep/textandbinarywriter v0.1.0
go: downloading github.com/marekm4/color-extractor v1.2.1
go: downloading github.com/mattn/go-runewidth v0.0.19
go: downloading github.com/olekukonko/errors v1.2.0
go: downloading github.com/olekukonko/ll v0.1.6
go: downloading github.com/evanw/esbuild v0.28.1
go: downloading github.com/gohugoio/go-i18n/v2 v2.1.3-0.20251018145728-cfcc22d823c6
go: downloading golang.org/x/net v0.56.0
go: downloading github.com/google/go-cmp v0.7.0
go: downloading github.com/kr/pretty v0.3.1
go: downloading software.sslmate.com/src/go-pkcs12 v0.7.0
go: downloading github.com/russross/blackfriday/v2 v2.1.0
go: downloading github.com/bep/tmc v0.6.0
go: downloading github.com/gohugoio/hugo-goldmark-extensions/extras v0.7.0
go: downloading github.com/gohugoio/hugo-goldmark-extensions/passthrough v0.5.0
go: downloading github.com/microcosm-cc/bluemonday v1.0.27
go: downloading github.com/yuin/goldmark-emoji v1.0.6
go: downloading github.com/clipperhouse/uax29/v2 v2.6.0
go: downloading github.com/olekukonko/cat v0.0.0-20250911104152-50322a0618f6
go: downloading github.com/clipperhouse/displaywidth v0.10.0
go: downloading rsc.io/qr v0.2.0
go: downloading github.com/bep/goat v0.5.0
go: downloading github.com/getkin/kin-openapi v0.140.0
go: downloading github.com/JohannesKaufmann/html-to-markdown/v2 v2.5.2
go: downloading github.com/bep/goportabletext v0.2.0
go: downloading github.com/kr/text v0.2.0
go: downloading golang.org/x/crypto v0.53.0
go: downloading github.com/aymerick/douceur v0.2.0
go: downloading github.com/JohannesKaufmann/dom v0.3.1
go: downloading github.com/santhosh-tekuri/jsonschema/v6 v6.0.2
go: downloading github.com/go-openapi/jsonpointer v0.22.5
go: downloading github.com/oasdiff/yaml v0.1.0
go: downloading github.com/gorilla/css v1.0.1
go: downloading github.com/go-openapi/swag/jsonname v0.25.5
go: downloading github.com/oasdiff/yaml3 v0.0.13

$ ~/go/bin/hugo version
hugo v0.164.0+extended android/arm64 BuildDate=unknown

[~]$ cp ~/go/bin/hugo ~/../usr/bin/

sudo apt install hugo    # Debian 系
yay -S hugo              # Arch 系

❯ hugo version  
hugo v0.164.0-ce2470e7012b5ab5fc4e10ebe4027e9f8d9e00dc+extended linux/amd64 BuildDate=2026-07-06T16:39:30Z VendorInfo=gohugoio

❯ hugo new site myBlog  
Congratulations! Your new Hugo site was created in /home/kuqilin/myBlog.  
  
Just a few more steps...  
  
1. Change the current directory to /home/kuqilin/myBlog.  
2. Create or install a theme:  
  - Create a new theme with the command "hugo new theme <THEMENAME>"  
  - Install a theme from https://themes.gohugo.io/  
3. Edit hugo.toml, setting the "theme" property to the theme name.  
4. Create new content with the command "hugo new content <SECTIONNAME>/<FILENAME>.<FORMAT>".  
5. Start the embedded web server with the command "hugo server --buildDrafts".  
  
See documentation at https://gohugo.io/.

cd myBlog
git init
git submodule add https://github.com/D-Sketon/hugo-theme-reimu.git themes/hugo-theme-reimu

theme = "hugo-theme-reimu"

baseURL = 'https://<你的用户名>.github.io/'
theme = "hugo-theme-reimu"
title = "xxx's Blog"       # 站点标题
locale = "zh-CN"           # 语言
languageName = "简体中文"   # 语言名称
hasCJKLanguage = true      # 是否包含 CJK 字符

[markup.highlight]         # 语法高亮（含代码块必须）
guessSyntax = true
noClasses = false

[markup.goldmark.renderer]
unsafe = true

[markup.goldmark.extensions.passthrough] # 含数学公式必须
enable = true
delimiters.block = [["\\[", "\\]"], ["$$", "$$"]]
delimiters.inline = [["\\(", "\\)"], ["$", "$"]]

menu:
  - name: home
    url: ""
  - name: archives
    url: "archives"
  - name: about
    url: "about"
  - name: friend
    url: "friend"

author: <你的名字>
email: <你的邮箱>
avatar: "avatar.jpg"           # 放在 static/avatar/ 下
banner: "images/banner.webp"   # 放在 static/images/ 下

social:
  email: mailto:<你的邮箱>
  github: https://github.com/<你的用户名>
  twitter: https://twitter.com/<你的用户名>

sidebar:
  position: left  # 左右可选
widgets:
  - category
  - tag
  - tagcloud
  - recent_posts

comment:
  default: waline
waline:
  enable: true
  serverURL: "<你的 Waline 服务地址>"

toc: true                # 目录
dark_mode:
  enable: auto           # 自动跟随系统
math:
  mathjax:
    enable: true         # 数学公式
show_update_time: true   # 显示更新时间

git clone https://github.com/<你的用户名>/<你的用户名>.github.io.git public

# 回到源码仓库根目录，先构建
hugo

# 进入 public 目录（此时它已经是页面仓库的克隆）
cd public

# 提交并推送
git add .
git commit -m "update"
git push origin main

#!/bin/bash
echo "Building..."
hugo

echo "Deploying..."
cd public
git add .
git commit -m "update $(date '+%Y-%m-%d %H:%M:%S')"
git push origin main
cd ..
echo "Done!"

name: deploy

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
        - name: Checkout
          uses: actions/checkout@v4
          with:
              fetch-depth: 0
              submodules: true       # 如果主题用 git submodule 安装，需要这行

        - name: Setup Hugo
          uses: peaceiris/actions-hugo@v3
          with:
              hugo-version: "latest"
              extended: true

        - name: Build Web
          run: hugo

        - name: Deploy Web
          uses: peaceiris/actions-gh-pages@v4
          with:
              PERSONAL_TOKEN: ${{ secrets.TOKEN }}
              EXTERNAL_REPOSITORY: <你的用户名>/<你的用户名>.github.io
              PUBLISH_BRANCH: main
              PUBLISH_DIR: ./public
              commit_message: auto deploy

git add .
git commit -m "new post"
git push origin main