1# 检查是否是 extended 版本（看到 extended 就算成功）
2hugo version

 1# 1. 创建项目文件夹
 2mkdir my-docs && cd my-docs
 3
 4# 2. 初始化 Hugo 模块
 5hugo mod init github.com/你的用户名/my-docs
 6
 7# 3. 下载并启用 Docsy 主题
 8echo '[module]
 9[[module.imports]]
10path = "github.com/google/docsy"' >> hugo.toml

 1baseURL = "https://你的域名.com/"
 2languageCode = "zh-cn"
 3title = "我的文档库博客"
 4theme = "docsy"
 5
 6[markup]
 7  [markup.goldmark]
 8    [markup.goldmark.renderer]
 9      unsafe = true  # 允许在 MD 里写 HTML
10
11[params]
12  ui = "light" # 默认亮色 / dark 暗色
13  search = true # 开启全文搜索
14  navbar_menu = true
15  toc = true # 右侧自动生成目录
16  editURL = "" # 在线编辑链接（后面教你配）
17
18[module]
19[[module.imports]]
20path = "github.com/google/docsy"

1mkdir -p content/zh/docs

1content/zh/docs/
2├── 教程/
3│   ├── 入门.md
4│   ├── 进阶.md
5├── 工具/
6│   ├── 工具1.md
7│   ├── 工具2.md
8├── _index.md  # 必须有这个文件

1---
2title: 文档库首页
3weight: 1
4---
5
6# 欢迎来到我的文档库
7
8这里存放了 1000+ 篇学习笔记。

1hugo server --disableFastRender

1---
2title: 文章标题
3weight: 10  # 排序用
4---

1[params]
2  github_repo = "https://github.com/你的用户名/你的仓库"
3  github_subdir = "content/zh/docs"
4  edit_page = true

1[params]
2  feedback = false
3  marketing = false
4  versioning = false

1hugo --minify

1$td-sidebar-nav-expand: true !default;
2$td-sidebar-nav-autocollapse: false !default;

1[build]
2  buildStats = true
3[imaging]
4  resampleFilter = "box"
5  quality = 75