qian kong Hexo http://www.bravexist.cn/ All rights reserved 2026, qian kong 浅空碎碎念 一世贪欢的私域 2026-05-04T08:37:41.000Z qian kong 一、Front-matter

Front-matter 是 markdown 文件最上方以 — 分隔的区域，用于指定个别档案的变数。

  • Page Front-matter 用于 页面 配置
  • Post Front-matter 用于 文章页 配置

1.1 Page Front-matter

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
---
title: {{ title }}
date: {{ date }}
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
random:
limit:
  type:
  value:
---

1.2 Post 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
---
title:
date:
updated:
tags:
categories:
keywords:
description:
top_img:
comments:
cover:
toc:
toc_number:
toc_style_simple:
copyright:
copyright_author:
copyright_author_href:
copyright_url:
copyright_info:
mathjax:
katex:
aplayer:
highlight_shrink:
aside:
abcjs:
noticeOutdate:
---

二、菜单栏

2.1 标签页

需同步主题配置 /_config.butterfly.yml 的 menu 配置才能生效。

1
hexo new page tags
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
title: 标签
limit:
  type: null
  value: null
date: 2026-05-04 16:46:47
updated:
type: 'tags'
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
orderby: random
order: 1
random:
1
_config.butterfly.yml
1
2
3
menu:
  ## 2026-0504 添加标签页
  标签: /tags/ || fas fa-tags

2.2 分类页

同理，需同步主题配置 /_config.butterfly.yml 的 menu 配置才能生效。

1
hexo new page categories
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
title: 分类
limit:
  type: null
  value: null
date: 2026-05-04 16:58:36
updated:
type: 'categories'
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
random:

2.3 友情链接

2.3.1 创建页面

1
hexo new page link
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
title: 友链
limit:
  type: null
  value: null
date: 2026-05-04 17:00:52
updated:
type: 'link'
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
random:

2.3.2 数据来源

本地生成

  1. 在 Hexo 根目录中的 source/_data（如果没有 _data 文件夹，请自行创建），创建一个文件 link.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
- class_name: 友情链接
  class_desc: 那些人，那些事
  link_list:
    - name: Hexo
      link: https://hexo.io/zh-cn/
      avatar: https://d33wubrfki0l68.cloudfront.net/6657ba50e702d84afb32fe846bed54fba1a77add/827ae/logo.svg
      descr: 快速、简单且强大的网志框架

- class_name: 网站
  class_desc: 值得推荐的网站
  link_list:
    - name: Youtube
      link: https://www.youtube.com/
      avatar: https://i.loli.net/2020/05/14/9ZkGg8v3azHJfM1.png
      descr: 视频网站
    - name: Weibo
      link: https://www.weibo.com/
      avatar: https://i.loli.net/2020/05/14/TLJBum386vcnI1P.png
      descr: 中国最大社交分享平台
    - name: Twitter
      link: https://twitter.com/
      avatar: https://i.loli.net/2020/05/14/5VyHPQqR6LWF39a.png
      descr: 社交分享平台

2.4 404 页面

主题配置中开启即可

1
2
3
4
error_404:
  ## enable: false
  ## 2026-0504 开启404页面
  enable: true

三、主题配置

  1. 修改 Hexo 的配置文件 _config.yml
1
2
3
## 2026-0504修改语言配置
## language: en
language: zh-CN
  1. 网站资料 _config.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Site
## 2026-0504 修改站点配置
title: 一世贪欢的私域
subtitle: '浅空碎碎念'
description: '记录云原生技术探索、自动化运维实践，以及折腾开源项目的日常碎碎念。'
keywords: 浅空, 博客, 云原生, 运维, Kubernetes, K8s, Docker, 自动化, 开源折腾
author: qian kong
## 2026-0504修改语言配置
## language: en
language: zh-CN
timezone: 'Asia/Shanghai'

# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
## 2026-0504 修改站点配置
url: http://www.bravexist.cn
  1. 导航参数，_config.butterfly.yml
1
2
3
4
5
6
7
8
## 2026-0504 配置导航设置
nav:
  # Navigation bar logo image
  logo: https://img.bravexist.cn/avatar/Logo.png
  display_title: true
  display_post_title: true
  # Whether to fix navigation bar
  fixed: false
  1. 配置目录
1
2
3
4
5
6
7
8
menu:
  # Home: / || fas fa-home
  ## 2026-0504 添加标签页
  ## 图标网站，https://fontawesome.com/search
  标签: /tags/ || fas fa-tags
  分类: /categories/ || fas fa-layer-group
  友链: /link/ || fas fa-link
  瞬间: https://moments.bravexist.cn/ || fas fa-leaf
  1. 代码块
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
## 2026-0504 修改代码块配置
code_blocks:
  # Code block theme: darker / pale night / light / ocean / false
  theme: light
  macStyle: false
  # Code block height limit (unit: px)
  # height_limit: false
  height_limit: 300
  word_wrap: false

  # Toolbar
  copy: true
  language: true
  # true: shrink the code blocks | false: expand the code blocks | none: expand code blocks and hide the button
  shrink: false
  ## fullpage: false
  fullpage: true
  1. 社交媒体
1
2
3
4
5
6
## 2026-0504 添加社交媒体
social:
  # fab fa-github: https://github.com/xxxxx || Github || '#24292e'
  fab fa-github: https://github.com/lightsky9627 || Github || '#24292e'
  # fas fa-envelope: mailto:xxxxxx@gmail.com || Email || '#4a7dbe'
  fas fa-envelope: mailto:qiaoxiong9626@gmail.com || Email || '#4a7dbe'
  1. 修改头像
1
2
3
4
5
6
7
8
## 2026-0504 修改头像
# favicon: /img/favicon.png
favicon: https://img.bravexist.cn/avatar/favicon.ico

avatar:
  # img: /img/butterfly-icon.png
  img: https://img.bravexist.cn/2026/05/6e64b686f34d0e367656c1bfa35dc3e8.jpg
  effect: false
  1. 配置首页图片
1
2
## 2026-0504 配置首页图片
index_img: https://img.bravexist.cn/2026/05/d5c01a5bc050bc7da363e1df4ee7807c.jpg
  1. 设置背景图
1
2
3
## 2026-0504 配置首页图片
## background:
background: https://img.bravexist.cn/2026/05/907a4607ead108fffbaee10a601fc43f.png
  1. 添加子标题
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
## 2026-0504 添加子标题，打字机效果。
subtitle:
  # enable: false
  enable: true
  # Typewriter Effect
  effect: true
  # Customize typed.js
  # https://github.com/mattboldt/typed.js/#customization
  typed_option:
  # Source - Call the third-party service API (Chinese only)
  # It will show the source first, then show the content of sub
  # Choose: false/1/2/3
  # false - disable the function
  # 1 - hitokoto.cn
  # 2 - https://api.aa1.cn/doc/yiyan.html
  # 3 - jinrishici.com
  source: false
  # If you close the typewriter effect, the subtitle will only show the first line of sub
  sub:
    - Anything is Nothing !
    - 境随心转。
    - 外力的压迫永远战胜不了内心的渴求。
    - 没有打不到的敌人，没有闯不过的难关。
    - 当你经过七重的孤独，才能够成为真正的强者。
    - 天堂和地狱没有我选择的权利，只有我被选择的命运。
    - Never put off till tomorrow what you can do today
    - 人的欲望，就如同高山滚石一般，一旦开始，就再也停不下来了。
  1. 隐藏章节数
1
2
3
4
5
6
toc:
  post: true
  page: false
  ## 隐藏章节数
  ## number: true
  number: false
  1. 显示编辑文章的按钮
1
2
3
4
5
6
7
## 2026-0504 显示编辑文章的按钮
post_edit:
  ## enable: false
  enable: true
  # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/
  # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/
  url: https://github.com/lightsky9627/www.bravexist.cn/edit/main/source/
  1. 禁用侧边栏公告
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
## 2026-0504 禁用侧边栏公告
aside:
  enable: true
  hide: false
  # Show the button to hide the aside in bottom right button
  button: true
  mobile: true
  # Position: left / right
  position: right
  display:
    archive: true
    tag: true
    category: true
  card_author:
    enable: true
    description:
    button:
      enable: true
      icon: fab fa-github
      text: Follow Me
      link: https://github.com/lightsky9627
  card_announcement:
    enable: false
    ## enable: true
    content: This is my Blog
  1. 开启标签颜色
1
2
3
4
5
6
7
card_tags:
  enable: true
  # If set 0 will show all
  limit: 40
  ## 开启标签颜色
  ## color: false
  color: true
  1. 开启滚动条百分比
1
2
3
## 2026-0504 开启滚动条百分比
# rightside_scroll_percent: false
rightside_scroll_percent: true
  1. 开启图片描述
1
2
3
## 2026-0504 开启图片描述
# photofigcaption: false
photofigcaption: ture
  1. 添加字数统计
1
pnpm install hexo-wordcount --save
1
2
3
4
5
6
7
8
9
10
## 2026-0504 开启字数统计
wordcount:
  # enable: false
  enable: true
  # Display the word count of the article in post meta
  post_wordcount: true
  # Display the time to read the article in post meta
  min2read: true
  # Display the total word count of the website in aside's webinfo
  total_wordcount: true
  1. 添加数学公式支持
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
## 2026-0504 开启数学公式支持
math:
  # Choose: mathjax, katex
  # Leave it empty if you don't need math
  use: katex
  per_page: true
  hide_scrollbar: false

  mathjax:
    # Enable the contextual menu
    enableMenu: true
    # Choose: all / ams / none, This controls whether equations are numbered and how
    tags: none

  katex:
    # Enable the copy KaTeX formula
    ## copy_tex: false
    copy_tex: true

​卸载 marked 插件

1
2
3
4
5
pnpm un hexo-renderer-marked --save # 如果有安装这个的话，卸载
pnpm un hexo-renderer-kramed --save # 如果有安装这个的话，卸载

pnpm i hexo-renderer-markdown-it --save # 需要安装这个渲染插件
pnpm install katex @renbaoshuo/markdown-it-katex #需要安装这个katex插件

​在 hexo 的根目录的 _config.yml 中配置（追加配置）

1
2
3
markdown:
  plugins:
    - '@renbaoshuo/markdown-it-katex'
  1. 设置评论区，提前准备 waline
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
## 2026-0504 开启 Waline 评论区
comments:
  # Up to two comments system, the first will be shown as default
  # Leave it empty if you don't need comments
  # Choose: Disqus/Disqusjs/Livere/Gitalk/Valine/Waline/Utterances/Facebook Comments/Twikoo/Giscus/Remark42/Artalk
  # Format of two comments system : Disqus,Waline
  use: Waline
  # Display the comment name next to the button
  text: true
  # Lazyload: The comment system will be load when comment element enters the browser's viewport.
  # If you set it to true, the comment count will be invalid
  lazyload: false
  # Display comment count in post's top_img
  ## 在文章顶部显示评论数
  ## count: false
  count: true
  # Display comment count in Home Page
  # 在首页文章卡片显示评论数
  ## card_post_count: false
  card_post_count: true
1
2
3
4
5
6
7
8
9
## 2026-0504 开启 Waline 评论区
waline:
  serverURL: https://waline.bravexist.cn
  bg:
  # Use Waline pageview count as the page view count
  ## 显示文章阅读数
  # pageview: false
  pageview: true
  option:
  1. 添加 Google 分析
1
2
3
4
5
6
# https://analytics.google.com/analytics/web/
# 不要开，否则一直加载不了。就会卡。
## google_analytics: G-WLQLLMB07B

# https://www.cloudflare.com/zh-tw/web-analytics/
cloudflare_analytics: 8a7eb89a66aa4f41b9f0ec101b0a45c0
  1. 开启大图模式
1
2
3
## 20260504 大图模式
# lightbox:
lightbox: fancybox
  1. Mermaid
1
2
3
4
5
6
7
8
## 20260504 开启Mermaid
mermaid:
  # enable: false
  enable: true
  # Write Mermaid diagrams using code blocks
  # code_write: false
  code_write: true
  # built-in themes: default / forest / dark / neutral

​需要同步修改 hexo 的配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
highlight:
  line_number: true
  auto_detect: false
  tab_replace: ''
  wrap: true
  hljs: false
  ## 20260504 开启Mermaid
  exclude_languages: ['mermaid']
prismjs:
  preprocess: true
  line_number: true
  tab_replace: ''
  ## 20260504 开启Mermaid
  exclude_languages: ['mermaid']
  1. 开启复制弹窗
1
2
3
4
5
6
7
8
snackbar:
  ## 2026-0504 开启复制弹窗
  ## enable: false
  enable: true
  position: bottom-left
  # The background color of Toast Notification in light mode and dark mode
  bg_light: '#49b1f5'
  bg_dark: '#1f1f1f'

四、插件

可以把链接 permalink 转为数字的插件，配置容易，生成时自动转为数字。

1
pnpm install hexo-abbrlink --save

修改根配置文件，_config.yml

1
2
3
4
5
6
7
8
9
10
11
12
## 2026-0504 修改站点配置
url: http://www.bravexist.cn
##  permalink: :year/:month/:day/:title/
permalink: posts/:abbrlink.html
permalink_defaults:
pretty_urls:
  trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
  trailing_html: true # Set to false to remove trailing '.html' from permalinks

abbrlink:
  alg: crc32 #算法选项：crc16丨crc32
  rep: hex #输出进制：dec为十进制，hex为十六进制

4.2 hexo-generator-feed

添加 RSS 功能

1
pnpm add hexo-generator-feed

打开 Hexo 根目录下的 _config.yml，在最底部添加以下配置：

1
2
3
4
5
6
7
8
9
10
11
# RSS 订阅配置 (hexo-generator-feed)
# 2026-0504
feed:
  type: atom          # 推荐使用 atom 格式，比老式的 rss2 规范更好
  path: atom.xml      # 生成的文件名，以后你的订阅地址就是 域名/atom.xml
  limit: 20           # 订阅源里最多展示最近的几篇文章 (0 代表展示所有)
  hub:
  content: true       # 是否在 RSS 中包含文章正文内容
  content_limit: 140  # 摘要截断长度 (如果 content 设为 false，这里生效)
  content_limit_delim: ' '
  order_by: -date     # 按照日期倒序排列

打开 Butterfly 主题的配置文件 _config.butterfly.yml，搜索 rss: 配置项，把它修改为刚才配置的路径：

1
2
3
4
5
6
7
8
9
10
11
12
menu:
  # Home: / || fas fa-home
  ## 2026-0504 添加标签页
  ## 图标网站，https://fontawesome.com/search
  标签: /tags/ || fas fa-tags
  分类: /categories/ || fas fa-layer-group
  友链: /link/ || fas fa-link
  瞬间: https://moments.bravexist.cn/ || fas fa-leaf
  RSS: /atom.xml || fas fa-square-rss

## 追加
rss: /atom.xml
]]> http://www.bravexist.cn/posts/1d5b40f4.html 2026-05-04T08:37:41.000Z 对hexo做一些必备的配置。 Hexo详细配置 2026-05-04T08:37:41.000Z qian kong Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1
$ hexo new "My New Post"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

]]> http://www.bravexist.cn/posts/4a17b156.html 2026-05-03T16:00:00.000Z 默认 hello world 文章。 Hello World 2026-05-03T16:00:00.000Z qian kong Hexo博客部署记录

Hexo是一个基于Node.js的静态网站生成器，主要用于创建博客和文档网站。

一、安装环境

已经6202年了，推荐 scoop 安装。

  1. nodejs官网

https://nodejs.org/zh-cn

  1. git官网

https://git-scm.com/

  1. 验证
1
2
3
4
node -v
npm -v
pnpm -v
git --version
1
2
3
4
5
6
7
8
9
10
11
node -v
v24.15.0

npm -v
11.12.1

pnpm -v
10.33.2

git --version
git version 2.54.0.windows.1

二、安装Hexo

  1. 全局安装Hexo
1
npm install -g hexo-cli
  1. 初始化站点
1
2
hexo init www.bravexist.cn
cd www.bravexist.cn
  1. 安装依赖
1
pnpm install

三、生成静态文件并启动本地服务器

  1. 清理旧文件
1
hexo clean
  1. 生成静态文件,可简写 hexo g
1
hexo generate
  1. 启动预览，默认 http://localhost:4000，,可简写 hexo s
1
hexo server

四、写文章

Hexo 默认文章都在 source/_posts/ 下。
创建一篇文章：

1
hexo new post "Hexo博客部署记录"

五、推送到Github

新建一个仓库

1
https://github.com/username/www.example.com.git
1
2
3
4
5
6
7
8
git config --global user.name "YourName"
git config --global user.email "YourEmail@example.com"
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/username/my-blog.git
git push -u origin main

六、修改主题

这里使用 Butterfly

  1. 安装主题
1
git submodule add -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
  1. 修改配置文件 _config.yml
1
theme: butterfly
  1. 安装插件
1
pnpm install hexo-renderer-pug hexo-renderer-stylus --save
  1. 创建主题配置文件，复制_config.yml 的内容
1
_config.butterfly.yml

七、手动bat上传github

push.bat

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
45
46
47
48
49
50
51
52
53
54
@echo off
:: 设置编码为 UTF-8，防止中文乱码
chcp 65001 >nul
title Auto Git Push Tool
color 0A

echo =======================================================
echo        正在准备推送到 GitHub ...
echo =======================================================
echo.

:: 1. 查看当前状态
echo [1/3] 查看变更状态 (git status)
git status
echo.

:: 2. 添加所有文件
echo [2/3] 添加文件到暂存区 (git add .)
git add .
echo.

:: 3. 提交更改
:: 获取用户输入，如果直接回车，则使用默认时间戳
set "msg="
set /p "msg=请输入 Commit 信息 (直接回车默认使用当前时间): "

if "%msg%"=="" (
    set "msg=Auto update: %date% %time%"
)

echo.
echo [3/3] 正在提交并推送... 
echo Commit 信息: "%msg%"
echo.

git commit -m "%msg%"
echo.

:: 4. 推送到远程仓库
echo 正在推送到 GitHub，请稍候...
git push

echo.
echo =======================================================
if %errorlevel% == 0 (
    echo [SUCCESS] 推送成功！
) else (
    echo [ERROR] 推送失败，请检查上方报错信息。
    color 0C
)
echo =======================================================

:: 暂停，让你看一眼结果，按任意键关闭
pause

八、部署到Edgeone

Edgeone

选择GitHub仓库，选择Hexo构建，绑定自定义域名。

九、参考文献

]]> http://www.bravexist.cn/posts/be7484f1.html 2025-12-03T16:00:00.000Z 记录Hexo部署过程。初体验，没有任何额外的配置。 Hexo博客部署记录 2026-05-03T16:00:00.000Z