本文档详细介绍 极简(jijian) 主题的所有配置参数，包含站点级配置和文章级配置。
1️⃣ 站点级配置
在站点根目录的 hugo.yaml 文件中配置以下参数：
基础配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| baseURL: https://your-domain.com/ # 站点 URL
title: 站点标题 # 站点名称
copyright: 版权信息 # 页脚版权文字
theme: jijian # 主题名称
defaultContentLanguage: zh-cn # 默认语言（决定 HTML lang 属性，防止浏览器询问是否翻译）
languageCode: zh-cn # 语言代码（对应 i18n/zh-cn.yaml 翻译文件）
timeZone: "Asia/Shanghai" # 时区
enableRobotsTXT: true # 生成 robots.txt
cleanDestinationDir: true # 构建前清理目标目录
buildDrafts: false # 是否构建草稿
buildFuture: false # 是否构建未来日期的文章
buildExpired: false # 是否构建已过期的文章
hasCJKLanguage: true # 开启中文/日韩文支持
summaryLength: 20 # 自动摘要的长度
|
高级构建与渲染配置
这些配置通常不需要修改，除非你有特殊需求。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| # 1. 输出格式配置
outputs:
home:
- HTML # 默认网页格式
- RSS # 开启 RSS 订阅支持
# 2. 压缩配置
minify:
disableXML: true # 禁用对 XML 文件的压缩 (建议开启以保证 RSS 兼容性)
minifyOutput: false # 是否在构建时压缩 HTML 输出 (开启后 HTML 会变成一行)
# 3. 渲染器配置 (核心)
markup:
goldmark:
renderer:
unsafe: false # 是否允许在 Markdown 中直接书写 HTML。建议设为 false (配合 rawhtml 短代码使用更安全)
highlight:
noClasses: false # 是否不使用 CSS 类名进行高亮
lineNos: true # 是否在代码块中显示行号
|
菜单导航配置
用于配置顶部导航栏的链接、顺序及下拉菜单。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
| menu:
main:
- identifier: posts # 唯一标识符，父级菜单标识
name: BLOG # 导航显示的文字
url: /posts/ # 链接地址
weight: 10 # 排序权重（数值越小越靠左）
- identifier: archives # 唯一标识符，子级菜单（因为有parent字段）
name: 时光轴
url: /archives/
weight: 11
parent: posts # 指定父级菜单的 identifier，实现下拉效果
- identifier: search
name: 搜索
url: /search/
weight: 20
- identifier: link
name: 外部链接
url: https://example.com/ # 也支持跳转到外部网站
weight: 30
|
2️⃣ params 配置块
所有主题特定的参数都配置在 params 块中：
站点信息
1
2
3
4
5
6
7
8
| params:
env: production # 环境：production / development
description: "站点描述" # 用于 SEO 的站点描述
keywords: ["关键词1", "关键词2"] # 用于 SEO 的站点关键词
author: 作者名 # 作者名称
shareImages: ["/img/share.png"] # 默认分享图片 (用于社交平台 OpenGraph)
defaultImage: "/img/cover.png" # 列表悬停默认封面图 (竖版 3:4，用于列表页悬停预览)
topDefaultImage: "/img/top-cover.png" # 文章顶部默认封面图 (横版 32:9，用于文章顶部)
|
Logo 配置
1
2
3
4
5
| params:
label:
text: 站点名称 # Logo 文字
icon: /img/logo.svg # Logo 图标
iconHeight: 32 # 图标高度
|
首页模式
主题提供三种首页模式，详见 02-首页模式
文档。
显示控制
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
| params:
# 阅读相关
ShowReadingTime: true # 显示阅读时长
ShowWordCount: true # 显示字数统计
readingSpeed: 200 # 阅读速度（字/分钟）
# 导航与交互
ShowPostNavLinks: true # 显示上下篇导航
ShowBreadCrumbs: true # 显示面包屑导航
ShowRssButtonInSectionTermList: true # 在列表页显示 RSS 按钮
ShowPageNums: true # 分页显示页码
# 分享
ShowShareButtons: true # 显示分享按钮
ShareButtons: # 分享按钮列表（留空则按语言自动选择默认按钮）
# 国内平台
- weibo # 微博
- qq # QQ
- douban # 豆瓣
- copylink # 复制链接
# 国际平台
- x # Twitter/X
- linkedin # LinkedIn
- reddit # Reddit
- facebook # Facebook
- whatsapp # WhatsApp
- telegram # Telegram
- ycombinator # Hacker News
|
目录配置
1
2
3
4
5
6
7
8
| params:
ShowToc: true # 显示目录（默认 true，不配置也会显示）
TocOpen: true # 目录默认展开（默认 true，不配置也会展开）
TocPosition: auto # 目录位置：left / right / auto
tocHover: true # 启用目录悬浮模式
tocHoverDelay: 200 # 目录悬浮延迟（毫秒）
tocHideDelay: 2000 # 目录隐藏延迟（毫秒）
UseHugoToc: false # 使用 Hugo 原生目录
|
说明：
ShowToc 和 TocOpen 默认值均为 true，即使不配置也会显示并展开目录- 如需隐藏目录，可设置
ShowToc: false - 如需目录默认折叠，可设置
TocOpen: false TocPosition：left：目录固定在左侧right：目录固定在右侧auto：根据屏幕宽度自动选择（默认是left）
tocHover：启用后，鼠标悬停时才显示目录，点击后保持显示
主题与样式
1
2
3
4
5
6
7
8
| params:
defaultTheme: auto # 默认主题：light / dark / auto
disableThemeToggle: false # 禁用主题切换按钮
disableLangToggle: false # 禁用语言切换按钮
disableScrollToTop: false # 禁用返回顶部按钮
disableSpecial1stPost: false # 禁用首篇特殊样式
displayFullLangName: true # 显示完整语言名称
DateFormat: 2006年01月02日 15:04:05 # 日期格式
|
日期格式示例：
1
2
3
4
5
6
7
| # 自定义格式（Go 时间格式）
DateFormat: 2006年01月02日 # 这个格式必须是这个日期和时间，错了就不准哟
DateFormat: 2006-01-02 15:04:05 # 比如你写2026年03月19日，时间就不准哟
# Hugo 预定义格式
DateFormat: ":date_long" # 使用这个会显示为英文的日期
DateFormat: ":date_full" # 使用这个会显示为英文的日期，带星期几
|
资源配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| params:
assets:
# Favicon
favicon: /img/favicon.ico
favicon16x16: /img/favicon-16x16.png
favicon32x32: /img/favicon-32x32.png
apple_touch_icon: /img/apple-touch-icon.png
safari_pinned_tab: /img/safari-pinned-tab.svg
# 主题色
theme_color: "#2e2e33" # 移动端浏览器地址栏颜色
msapplication_TileColor: "#2e2e33" # Windows 磁贴颜色
# 其他
disableFingerprinting: false # 禁用资源指纹
disableScrollBarStyle: false # 禁用自定义滚动条样式
code:
chromaStyle: catppuccin-macchiato # 代码高亮样式
showCopyButtons: true # 显示代码块复制按钮
|
代码高亮样式列表：
| 样式名称 | 说明 |
|---|
catppuccin-macchiato | 默认样式 |
catppuccin-mocha | Catppuccin 深色 |
catppuccin-frappe | Catppuccin 中等深度 |
catppuccin-latte | Catppuccin 浅色 |
github | GitHub 浅色 |
github-dark | GitHub 深色 |
monokai | 经典 Monokai |
dracula | Dracula 主题 |
nord | Nord 极光 |
tokyonight-night | Tokyo Night |
gruvbox | Gruvbox 复古 |
onedark | Atom OneDark |
solarized-dark | Solarized 深色 |
封面配置
1
2
3
4
5
| params:
cover:
linkFullImages: true # 封面图片可点击放大
responsiveImages: true # 生成响应式图片
displayTopDefault: false # 未设置文章封面时，是否在文章顶部显示默认图 (params.topDefaultImage)
|
封面图类型说明：
| 类型 | 用途 | 比例 | 参数 |
|---|
| 竖版封面图 | 列表页/时光轴悬停预览 | 3:4 | cover.image / defaultImage |
| 横版封面图 | 文章页顶部（类似banner） | 32:9 | topCover / topDefaultImage |
社交图标
详见 02-首页模式
文档。
评论系统
主题支持 Giscus 评论系统，详见 05-功能配置
文档。
页脚配置
详见05-功能配置
文档。
编辑文章链接
1
2
3
4
5
6
| params:
editPost:
disabled: false # 禁用编辑按钮
URL: "https://github.com/user/repo/tree/main/content"
Text: "我要编辑" # 按钮文字
appendFilePath: true # 追加文件路径
|
搜索引擎验证与统计
1
2
3
4
5
6
7
8
9
10
11
12
| params:
analytics:
google:
SiteVerificationTag: "xxxxx" # Google Search Console 验证
yandex:
SiteVerificationTag: "xxxxx" # Yandex 验证
bing:
SiteVerificationTag: "xxxxx" # Bing 验证
naver:
SiteVerificationTag: "xxxxx" # Naver 验证
baidu:
hm: "xxxxx" # 百度统计 ID
|
3️⃣ 文章级配置
在文章的 Front Matter 中（前置参数）可以覆盖站点级配置：
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
42
43
44
| ---
title: "文章标题"
realTitle: "文章的真实标题" # 解密后显示的真实标题
date: 2026-03-19 15:26:34 # 发布时间
lastmod: 2026-03-28 22:13:41 # 最后修改时间
draft: false # 是否为草稿
categories: ["分类"]
tags: ["标签1", "标签2"]
summary: "文章摘要" # 给人看的
description: "文章描述" # 给SEO看的
keywords: ["关键词1", "关键词2"] # 给SEO看的
url: "your-url" # 自定义URL，彻底接管整个路径
slug: "your-slug" # 自定义URL，只是修改路径的最后一部分
link: "your-link" # 在列表页中，指定链接地址，相当于快捷方式，不影响文章的URL
# 显示控制（覆盖站点配置）
hideMeta: false # 隐藏元信息
hideSummary: false # 隐藏摘要
hideFooter: false # 隐藏页脚
ShowReadingTime: true # 显示阅读时长
ShowWordCount: true # 显示字数统计
ShowToc: true # 显示目录（默认 true，不配置也会显示）
TocOpen: true # 目录默认展开（默认 true，不配置也会展开）
TocPosition: left # 目录位置
tocHover: false # 目录悬浮模式
comments: true # 启用评论
disableShare: false # 禁用分享按钮
hiddenInHomeList: false # 在首页列表隐藏
hiddenInList: false # 在所有列表页隐藏
# SEO
canonicalURL: "" # 如果这篇文章是搬运的，告诉搜索引擎这个页面的原始链接
robotsNoIndex: false # 不索引此页面，有密码的文章已经默认不索引
# 编辑链接
editPost:
disabled: false # 禁用编辑按钮
---
|
封面图与顶部图
详见06-特殊配置
文档。
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
| # 竖版封面配置（列表页悬停预览，3:4 比例）
cover:
image: "/images/cover.jpg"
alt: "封面描述" # 给SEO看的
caption: "" # 封面图片说明，给人看的，但是目前样式有点丑，可以考虑不加。
hidden: false # 是否隐藏封面（默认 false）
hiddenInSingle: false # 仅在文章详情页隐藏横版封面（默认跟随 hidden）
hiddenInList: false # 仅在列表页隐藏悬停封面（默认跟随 hidden）
responsiveImages: true # 生成响应式图片
# 横版封面配置（文章顶部，32:9 比例）
topCover: # 对象方式：
image: "/images/top-cover.jpg"
alt: "顶部封面描述"
caption: "顶部封面说明"
topCoverAlt: "顶部封面描述" # 与上面的对象方式相比，也有这样的简写方式，realCover和realTopCover同理
# 真实竖版封面配置-简写方式
realCover: "" # 解密后显示的真实竖版封面
realCoverAlt: "" # 解密后显示的真实封面alt，给SEO看的
realCoverCaption: "" # 解密后显示的真实封面说明
# 真实横版封面配置（解密后替换文章顶部封面）
realTopCover: # 对象方式
image: ""
alt: ""
caption: ""
---
|
密码文章
详见06-特殊配置
文档。
加载评论中...