jijian（极简） 是基于 PaperMod 二次开发的 Hugo 主题。本主题旨在更简洁、极致高效的基础上，保留 PaperMod 的优秀特性，并针对中文用户和个人需求做了大量优化和定制。

主要特性

  • 可视化配置工具：提供开箱即用的 config-tools.html 配置工具
  • 完美的中文统计体验：重构字数统计逻辑，精准识别汉字、字母和数字
  • 文章列表封面交互优化：鼠标悬停预览封面功能
  • 导航菜单增强：支持子菜单导航，优化移动端体验
  • 本土化社交图标：支持哔哩哔哩、豆瓣等国内平台，支持悬浮二维码
  • 中文古文竖排支持：完美支持中文古诗词竖排版展现
  • Pagefind 搜索：高性能静态搜索引擎，为中文用户提供极致搜索体验
  • 图片优雅灯箱：medium-zoom 平滑缩放
  • 路径级密码保护：结合 Vercel Edge Middleware 实现访问控制

环境要求

在使用本主题之前，请确保您的环境满足以下条件：

必需环境

工具 版本要求 说明
Hugo ≥ 0.146.0（推荐 Extended 版本） 静态站点生成器
Git 最新版 用于克隆主题和管理版本

可选环境

工具 用途
Node.js / npm 本地构建 Pagefind 搜索索引时需要

说明：如果您只在本地编写文章，使用 GitHub Actions、Vercel 等云端服务进行自动化部署，则本地无需安装 Node.js。云端环境通常已自带 npm。

安装主题

提供两种主要的安装方式：

方式一：Hugo Modules（推荐）

如果您已初始化 Hugo 模块环境，无需物理下载文件，只需在站点根目录的 hugo.yaml 中引入模块：

1
2
3

module:
  imports:
    - path: github.com/hcllmsx/hugo-jijian

初始化模块环境（如果尚未初始化）：

1

hugo mod init github.com/your/your-site

方式二：Git Clone（经典方案）

将主题克隆到 themes 目录：

1

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

在 hugo.yaml 中激活主题：

1

theme: jijian

基本配置

最小配置示例

创建或编辑站点根目录的 hugo.yaml 文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

baseURL: https://your-domain.com/
title: 你的站点标题
theme: jijian

defaultContentLanguage: zh-cn
languageCode: zh-cn
timeZone: "Asia/Shanghai"

params:
  env: production
  description: "站点描述"
  
  # 首页模式（三选一，默认为博客模式）
  # cardMode:
  #   enabled: true
  #   title: 你的名字
  #   subtitle: 欢迎来到我的小站
  #   imageUrl: /img/avatar.png
  #   imageWidth: 120
  #   imageHeight: 120

menu:
  main:
    - identifier: posts
      name: 文章
      url: /posts/
      weight: 10
    - identifier: search
      name: 搜索
      url: /search/
      weight: 20

outputs:
  home:
    - HTML
    - RSS

导航菜单配置

支持单层菜单和子菜单：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

menu:
  main:
    - identifier: posts
      name: 文章
      url: /posts/
      weight: 10
    - identifier: archives
      name: 归档
      url: /archives/
      weight: 11
      parent: posts  # 作为 posts 的子菜单
    - identifier: categories
      name: 分类
      url: /categories/
      weight: 12
      parent: posts
    - identifier: tags
      name: 标签
      url: /tags/
      weight: 13
      parent: posts

中文优化配置

启用准确的字数统计和阅读时长：

1
2
3
4

params:
  ShowWordCount: true      # 显示字数统计
  ShowReadingTime: true    # 显示阅读时长
  readingSpeed: 200        # 每分钟阅读字数（根据实际情况调整）

使用配置工具

主题提供了可视化配置工具 config-tools.html，无需手动编辑配置文件：

  1. 在浏览器中打开 themes/jijian/config-tools.html
  2. 根据界面提示配置各项参数
  3. 工具会自动生成 hugo.yaml、package.json、middleware.js 文件
  4. 复制生成的配置到您的项目根目录

该工具支持：

  • 所有主题配置项的可视化设置
  • 实时预览生成的 YAML 配置
  • 自动处理配置项之间的依赖关系
  • 一键生成所需的配置文件

本地预览

启动本地开发服务器：

1

hugo server

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

带搜索功能的本地预览

如果需要测试 Pagefind 搜索功能：

1
2
3
4
5

# 构建站点并生成搜索索引
hugo && npx pagefind --site public --output-path static/pagefind

# 启动开发服务器
hugo server

注意：后续修改文章后需要重新运行第一条命令更新搜索索引。