这可能不仅仅是使用 极简(jijian) 主题的文档了，还是一个从零到一搭建 Hugo 博客的保姆级教程。以 Windows 为例。

环境要求

在使用 极简(jijian) 主题之前，请确保你的环境满足以下条件：

确保网络环境“正常”

必要时可借助以下工具或网址：

PowerShell

CMD、Windows PowerShell、PowerShell是三种不同的工具，如果你知道的话，就当我没说。

Hugo

  • 前往 Hugo Releases 下载 hugo_extended_x.x.x_windows-amd64.zip，解压到合适的目录下并将 hugo.exe 所在的目录路径添加到系统环境变量。
  • win + r 打开运行窗口，输入 pwsh 打开 PowerShell 。
  • 在 PowerShell 窗口输入 hugo version 确认版本号 ≥ 0.150.1 ，则安装成功。

Git

用于克隆主题和管理版本，主要是为了方便部署。

  • 前往 Git 下载，双击安装，一路无脑点击下一步即可。
  • 验证安装：在 PowerShell 窗口输入 git -v 确认版本号为最新版。

Node.js (附赠 npm)

在本地构建时，运行文章加密脚本和构建 Pagefind 时需要 Node.js。

  • 前往 Node.js 下载，双击安装。
  • 验证安装：在 PowerShell 窗口输入 node -v 确认版本号为最新版。
  • 验证安装：在 PowerShell 窗口输入 npm -v 确认版本号为最新版。

安装 Node.js 时会自动包含包管理器 npm 。如果你只在本地编写文章，使用 Cloudflare、Vercel 等云端服务进行自动化部署，则本地无需安装 Node.js。云端环境通常已自带。

IDE 工具（或者 Markdown 编辑器）

快速开始

只需几步，即可从零开始构建你的极简博客，。

1. 初始化站点

在你希望存放博客的目录下运行以下命令（强烈推荐使用 YAML 格式）：

1
2
3
4
5
6
7
8

# 创建站点目录，将"MyBlog"替换为你的站点名称
hugo new site MyBlog --format yaml

# 进入目录
cd MyBlog

# 初始化 Git 仓库
git init

2. 安装 jijian 主题

提供两种安装方式，任选其一即可：

方式一：Git 子模块（推荐）

通过 git submodule add 安装，Git 会将主题注册为子模块并自动生成 .gitmodules 配置文件。之后只需一条命令即可拉取主题的最新版本：

1
2
3
4
5

# 安装
git submodule add https://github.com/hcllmsx/hugo-jijian.git themes/jijian

# 日后更新主题
git submodule update --remote

然后在 hugo.yaml 中激活主题：

1

theme: jijian

方式二：Git Clone

直接将主题克隆到 themes 目录。主题文件会作为普通文件存在于你的仓库中，后续更新需要手动删除旧文件夹再重新克隆：

1

git clone https://github.com/hcllmsx/hugo-jijian.git themes/jijian

然后在 hugo.yaml 中激活主题：

1

theme: jijian

3. 启用功能页面（指定布局页面）

标签 (Tags) 和 分类 (Categories) 页面是主题默认支持的，无需手动创建文件。只要你的文章中有对应的 tags 或 categories 字段，这些页面就会自动生成。

为了让你的博客拥有 归档 和 搜索 页面，你需要手动在 content 目录下创建对应的 Markdown 文件并指定布局（layout）：

  • 归档 (Archives)：创建 content/archives.md

    1
2
3
4

    ---
title: 时光轴
layout: archives
---

  • 搜索 (Search)：创建 content/search.md

    1
2
3
4
5

    ---
title: 搜索一下
layout: search
placeholder: 你想要找些什么呢
---

  • 其他自定义页面 (如 About)：创建 content/about.md

    1
2
3
4

    ---
title: 关于我
layout: blank
---

建议

  • layout: search 的 “placeholder” 为搜索框占位符。

  • 关于搜索的更多信息，请看 05-功能配置 。

  • layout: blank 是一个通用的空白页面布局，适用于“关于”、“友情链接”等不需要列表样式的独立页面。

使用配置工具

主题配置工具 (Config Tools)

为了降低配置负担，主题在根目录提供了一个可视化的配置管理页面：极简(hugo-jijian)配置工具-config-tools.html。

  1. 在主题文件夹(themes/jijian)下，双击打开 极简(hugo-jijian)配置工具-config-tools.html
  2. 根据界面提示配置各项参数
  3. 点击预览按钮，确认无误后分别导出各项配置文件，替换你博客目录的相应文件

核心功能

  1. 部署一键通：
    • EdgeOne 支持：勾选"部署在腾讯 EdgeOne Pages"后，可指定 Hugo 版本号并直接导出标准的 edgeone.json
    • 自动依赖生成：自动生成包含加密和搜索指令的 package.json
  2. 可视化 YAML 管理：以类 App 的界面管理 hugo.yaml 中的菜单、社交图标、页脚信息等，无需直接编辑复杂的 YAML 语法
  3. 配置快照 (Snapshot)：
    • 如果你担心配置丢失，可以将当前所有设置导出为 .ssjson 快照文件
    • 下次使用时，只需将该快照文件拖入工具，即可瞬间恢复所有配置并进行再次修改

路径纠正功能

在配置工具中管理文章路径时，点击输入框旁的 “纠正” 按钮，工具会自动处理以下逻辑：

  • 去除 Windows 式的 \ 反斜杠
  • 自动识别并去除文章的 .md 后缀
  • 确保 URL 以 / 开头和结尾
  • 强制转换为小写，以适配 Hugo 的默认路由行为

建议

让你快速上手毫无压力！爽吧？爽…你他喵的不快给我一键三连？！

关于预览

本地预览

在你的博客根目录下打开 PowerShell ：

1

hugo server

访问 http://localhost:1313 预览站点。

搜索预览

请参考 05-功能配置 。

加密文章预览

请参考 06-特殊功能 。