欢迎来到 极简（jijian） 主题！这是一个基于 PaperMod 二次开发的 Hugo 主题，专注于简洁、高效和中文用户体验。

主题特色

极简主题继承了 PaperMod 的优秀特性，并针对中文用户做了大量优化：

  • ✨ 完美的中文统计 - 精确识别汉字、字母和数字，提供准确的字数统计和阅读时长
  • 🖱️ 封面悬停预览 - 文章列表纯文字展示，鼠标悬停显示封面图
  • 🧭 导航菜单增强 - 支持多级子菜单，移动端体验优化
  • 📱 本土化社交图标 - 支持 Bilibili、豆瓣等国内平台，支持二维码悬浮
  • 📖 古文竖排支持 - 专门为中文古诗词设计的竖排版短代码
  • 🔍 Pagefind 搜索 - 高性能静态搜索引擎，中文搜索体验极佳
  • 🎬 Bilibili 短代码 - 简单参数即可嵌入 B 站视频
  • 🔗 智能外部链接 - 自动在新标签打开外部链接，提升安全性

环境要求

在开始之前，请确保你的环境满足以下要求：

必需环境

  • Hugo Extended (v0.146.0 或更高版本)
    • Hugo 扩展版，用于生成静态网页
    • 检查版本：hugo version

推荐环境

  • Git - 用于克隆主题和版本管理
  • Node.js / npm - 用于 Pagefind 搜索索引生成
    • 本地开发预览搜索功能时需要
    • 云端部署时通常已内置

安装主题

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

方式一：Hugo Modules（推荐）

现代 Hugo 推荐的模块化方案，无需下载主题文件：

  1. 初始化 Hugo 模块（如果尚未初始化）：

    1

    hugo mod init github.com/yourusername/yoursite

  2. 在站点根目录的 hugo.yaml 中引入主题：

    1
2
3

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

方式二：Git 克隆（经典）

将主题文件克隆到本地 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
37
38
39
40
41

baseURL: https://example.org/
languageCode: zh-cn
title: 我的极简博客
theme: jijian  # 如果使用 Git 克隆方式需要此行

# 基础参数配置
params:
  # 显示阅读时长
  ShowReadingTime: true
  # 阅读速度（字/分钟）
  readingSpeed: 200
  # 显示分享按钮
  ShowShareButtons: true
  # 显示文章导航
  ShowPostNavLinks: true
  # 显示面包屑导航
  ShowBreadCrumbs: true
  # 显示代码复制按钮
  ShowCodeCopyButtons: true
  # 显示目录
  ShowToc: true

# 导航菜单配置
menu:
  main:
    - identifier: posts
      name: 文章
      url: /posts/
      weight: 10
    - identifier: archives
      name: 归档
      url: /archives/
      weight: 20
    - identifier: search
      name: 搜索
      url: /search/
      weight: 30
    - identifier: tags
      name: 标签
      url: /tags/
      weight: 40

创建第一篇文章

使用 Hugo 命令创建新文章：

1

hugo new posts/my-first-post.md

这会在 content/posts/ 目录下创建一个包含基本 Front Matter 的 Markdown 文件。

编辑文件内容：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

---
title: "我的第一篇文章"
date: 2025-03-13T10:00:00+08:00
tags: ["测试", "第一篇"]
categories: ["随笔"]
---

这是我的第一篇博客文章内容。

欢迎使用极简主题！

本地预览

启动本地开发服务器：

1

hugo server -D

参数说明：

  • -D 或 --buildDrafts - 包含草稿文章
  • 默认访问 http://localhost:1313

预览搜索功能

如果需要在本地预览 Pagefind 搜索功能，需要先生成搜索索引：

1
2
3
4
5
6
7
8

# 构建 Hugo 站点
hugo

# 生成 Pagefind 索引到 static 目录
npx pagefind --site public --output-path static/pagefind

# 启动本地服务器
hugo server

部署上线

构建静态文件

1
2
3
4
5

# 构建最终静态文件
hugo --minify

# 生成搜索索引
npx pagefind --site public

生成的文件位于 public/ 目录，可以部署到任何静态托管服务。

GitHub Pages 自动部署

在 .github/workflows/gh-pages.yml 中配置：

1
2
3
4

- name: Build with Hugo
  run: |
    hugo --minify --baseURL "${{ steps.pages.outputs.base_url }}/"
    npx pagefind --site public

下一步

恭喜！你已经成功安装并配置了极简主题。接下来可以：

获取帮助

祝你使用愉快！享受极简、高效的博客写作体验。