环境要求

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

工具 版本要求 说明
Hugo ≥ 0.146.0（Extended 版本） 你说呢
Git 要不就最新版吧 用于克隆主题和管理版本，主要是为了方便部署
Node.js (附赠 npm) 要不就最新版吧 运行文章加密脚本和构建 Pagefind 搜索索引时需要

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

快速开始

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

1. 下载并安装 Hugo

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

当然你也可以顺便把 PowerShell 也升级到最新版。

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

2. 初始化站点

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

1
2
3
4
5
6
7
8

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

# 进入目录
cd MyBlog

# 初始化 Git 仓库
git init

3. 安装 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

使用配置工具

主题配置工具 (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 的默认路由行为

[!TIP]

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

本地预览

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

1

hugo server

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