极简（jijian）主题 Wiki：06-功能配置

1
2

params:
  comments: true                      # 全局启用评论

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

params:
  comments: true
  
  giscus:
    repo: "user/repo"                 # 仓库名称
    repoId: "R_xxxxx"                 # 仓库 ID
    category: "Announcements"         # Discussion 分类
    categoryId: "DIC_xxxxx"           # 分类 ID
    mapping: pathname                 # 映射方式
    reactionsEnabled: 1               # 启用反应
    emitMetadata: 0                   # 发送元数据
    inputPosition: top                # 输入框位置：top / bottom
    theme: preferred_color_scheme     # 主题
    lang: zh-CN                       # 语言

1
2
3
4

---
title: "文章标题"
comments: true                        # 启用评论（默认跟随全局设置）
---

1
2
3
4

---
title: "文章标题"
comments: false                       # 禁用评论
---

1
2
3
4
5
6

menu:
  main:
    - identifier: search
      name: 搜索
      url: /search/
      weight: 20

1
2
3
4

---
title: "搜索"
layout: "search"
---

1
2
3
4
5

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

# 启动开发服务器
hugo server

1
2
3
4
5

# 构建站点并生成索引
hugo && npx pagefind --site public

# 使用 Pagefind 自带服务器预览
npx pagefind --site public --serve

1

hugo --gc --minify && npx pagefind --site public --output-path public/pagefind

1
2
3
4
5
6
7
8

{
  "name": "your-blog",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "pagefind": "^1.4.0"
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

<script>
new PagefindUI({
    element: "#search",
    showSubResults: true,      // 显示子结果
    showImages: false,         // 不显示图片
    autofocus: true,           // 自动聚焦
    translations: {            // 翻译
        placeholder: "搜索文章...",
        zero_results: "没有找到结果"
    }
});
</script>

1
2
3
4

params:
  code:
    chromaStyle: catppuccin-macchiato  # 代码高亮样式
    showCopyButtons: true              # 显示代码块复制按钮

1
2
3
4

markup:
  highlight:
    lineNos: true              # 显示行号
    noClasses: false           # 必须为 false，主题使用 CSS 类名

1
2
3
4

```python
def hello():
    print("Hello, World!")
```

1
2

1: def hello():
2:     print("Hello, World!")

1
2
3
4
5
6

params:
  socialIcons:
    - name: github
      url: https://github.com/yourname
    - name: bilibili
      url: https://space.bilibili.com/xxxxxx

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

params:
  socialIcons:
    - name: bilibili
      url: https://space.bilibili.com/xxxxxx
      hoverImage: /img/bilibili-qr.png
      title: 哔哩哔哩
    - name: wechat
      url: "javascript:void(0);"    # 无跳转链接
      hoverImage: /img/wechat-qr.png
      title: 微信二维码

1

hoverImage: /img/wechat-qr.png

1
2

params:
  ShowShareButtons: true

1
2
3
4
5
6
7
8
9

params:
  ShareButtons:
    - x                  # Twitter/X
    - linkedin           # LinkedIn
    - reddit             # Reddit
    - facebook           # Facebook
    - whatsapp           # WhatsApp
    - telegram           # Telegram
    - ycombinator        # Hacker News

1
2
3
4

---
title: "文章标题"
disableShare: true       # 禁用分享按钮
---

1
2
3
4
5

{{< figure 
  src="/images/photo.jpg"
  link="https://example.com"
  alt="点击跳转外部链接"
>}}

1
2
3
4

params:
  ShowReadingTime: true    # 显示阅读时长
  ShowWordCount: true      # 显示字数统计
  readingSpeed: 200        # 阅读速度（字/分钟）

1
2
3
4
5
6

---
title: "文章标题"
ShowReadingTime: false     # 隐藏阅读时长
ShowWordCount: false       # 隐藏字数统计
hideMeta: true             # 隐藏所有元信息
---

1
2
3
4

params:
  ShowToc: true            # 显示目录（默认 true，不配置也会显示）
  TocOpen: true            # 目录默认展开（默认 true，不配置也会展开）
  TocPosition: auto        # 目录位置：left / right / auto

1
2
3
4

params:
  tocHover: true           # 启用目录悬浮模式
  tocHoverDelay: 200       # 悬浮延迟（毫秒）
  tocHideDelay: 2000       # 隐藏延迟（毫秒）

1
2
3
4
5
6
7

---
title: "文章标题"
ShowToc: true
TocOpen: true
TocPosition: left
tocHover: false
---

1
2

params:
  ShowBreadCrumbs: true    # 显示面包屑导航

1
2

params:
  ShowPostNavLinks: true   # 显示上下篇导航

1
2
3
4

---
title: "文章标题"
ShowPostNavLinks: false    # 隐藏上下篇导航
---

1
2
3
4
5
6

params:
  editPost:
    URL: "https://github.com/user/repo/tree/main/content"
    Text: "编辑"           # 按钮文字
    appendFilePath: true   # 追加文件路径
    disabled: false        # 禁用编辑按钮

1
2
3
4

outputs:
  home:
    - HTML
    - RSS

1
2

params:
  ShowRssButtonInSectionTermList: true

1
2
3

params:
  footer:
    text: "[粤ICP备xxxxxx号](https://beian.miit.gov.cn/)" # 页脚支持 Markdown 文本

1
2
3
4
5
6
7
8
9

params:
  footer:
    badges:
      - url: "https://your-domain-1.com/"
        badge: "https://img.shields.io/badge/your_domain_1-you_like-blue"
        title: "your-domain-1阿巴阿巴阿巴"
      - url: "https://your-domain-2.com/"
        badge: "https://img.shields.io/badge/your_domain_2-you_like-blue"
        title: "your-domain-2阿巴阿巴阿巴"

1
2
3
4
5
6
7
8
9

params:
  # 社交分享预览图 (OpenGraph / X Cards)
  shareImages: ["/img/share.png"]
  
  # 站点默认封面图 (用于列表悬浮预览、搜索缩略图)
  defaultImage: "/img/default-cover.png"

  cover:
    displayDefault: false  # 是否默认在文章顶部显示保底图 (默认 false)

1
2
3

params:
  cover:
    displayDefault: false  # 默认不显示，仅用于悬浮和搜索

1
2
3
4
5

---
cover:
  hidden: true        # 彻底隐藏（列表预览和文章内都不显示）
  hiddenInSingle: true # 仅在文章内隐藏（列表预览仍保留）
---

1
2
3

params:
  description: "站点描述"
  keywords: ["关键词1", "关键词2"]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

params:
  analytics:
    google:
      SiteVerificationTag: "xxxxx"
    bing:
      SiteVerificationTag: "xxxxx"
    yandex:
      SiteVerificationTag: "xxxxx"
    naver:
      SiteVerificationTag: "xxxxx"

1
2
3
4

params:
  analytics:
    baidu:
      hm: "你的百度统计ID"  # 脚本链接 hm.js? 后的 ID 字符串

1
2
3
4
5
6
7

---
title: "文章标题"
description: "文章描述"
keywords: ["关键词1", "关键词2"]
canonicalURL: "https://your-domain.com/post/article/"
robotsNoIndex: false       # 是否禁止索引
---

1
2
3

params:
  defaultTheme: auto              # 默认主题：light / dark / auto
  disableThemeToggle: false       # 禁用主题切换按钮