Hexo博客管理
前言
博客搭好了,但怎么改标题、加图标、管理分类标签?本文以当前博客为例,讲解 Hexo + Fluid 的目录结构和常用配置。
一、常用命令速查
以下命令都在博客根目录下执行。
| 作用 | 命令 |
|---|---|
| 新建文章 | hexo new "文章标题" |
| 新建独立页面 | hexo new page "页面名" |
| 新建草稿 | hexo new draft "标题" |
| 发布草稿 | hexo publish "标题" |
| 启动本地预览 | hexo server |
| 指定端口预览 | hexo server -p 4001 |
| 生成静态文件 | hexo generate |
| 生成并部署 | hexo generate -d |
| 仅部署(需先生成) | hexo deploy |
| 清理缓存和旧文件 | hexo clean |
| 强制全量重建 | hexo generate -f |
| 列出所有文章 | hexo list post |
| 查看版本 | hexo version |
本地预览启动后访问 http://localhost:4000,按 Ctrl+C 停止。
hexo deploy 不会自动生成文件,必须先 hexo generate 再 hexo deploy;hexo generate -d(可简写 hexo g -d)一步完成生成加部署,日常发帖用这条即可。
hexo generate 默认增量构建,只重新生成改动过的文章以及受影响的归档、分类、标签页,日常发一两篇不会慢。真正会触发全量重建的是 hexo clean——它删除缓存 db.json 和 public/,下次生成只能从头来。只在换主题、大改配置或升级后输出异常时才跑 hexo clean,平时不要加。
写完一篇文章的标准流程:hexo new "标题" 新建 → 编辑 source/_posts/ 下对应的 md → hexo generate -d 发布。
推送
main会自动部署(2026-11-09 起):.github/workflows/circle.yml已去掉push.paths白名单,任何推送到main的改动(文章、CSS、主题配置、动态)都会触发 Actions:抓一次友链 RSS →npx hexo generate -d→ 把站点推到gh-pages。因此只git push也能上线,本地hexo generate -d依旧可用;两者别同时跑,避免互相覆盖gh-pages。自动部署同样要经历下面的 Pages / CDN 延迟。工作流写回数据的提交带[skip ci],配合 job 级if判断,不会自触发死循环。详见「十九、自动部署与静态资源版本号」。
线上生效有延迟,别误判成没部署成功(2026-11-02 实测):
hexo deploy只是把public/推到gh-pages,之后 GitHub Pages 还要构建 1–2 分钟,这段时间新增的文件路径会一直 404;构建完成后,Cloudflare 上还有Cache-Control: max-age=600(10 分钟)的整页缓存。
- 页面缓存可尝试带随机查询串:
curl -s "https://blog.zuiges.com/archives/?cb=$RANDOM",否则可能拿到十分钟前的旧页面。2026-11-10 实测更正:随机串未必绕得开,Fastly 层会返回x-cache: HIT且Age持续增长,最长仍需等max-age=600过期。要立刻判断部署是否成功,应直接读gh-pages分支原文件(不经过 Pages 构建与 CDN):https://raw.githubusercontent.com/zuige66/hexo/gh-pages/links/index.html。- 新增图片即使带查询串也可能先被 CDN 记一次 404(负缓存),现象是「文字已经更新、图片仍然 404」,通常 5 分钟左右自愈,不需要重新部署。
- 判断是否真的推上去了,看
git ls-remote origin gh-pages的 commit 与本地npx hexo deploy输出的 hash 是否一致,而不是看浏览器。
二、项目结构
1 | |
两个核心配置文件:
| 文件 | 作用 |
|---|---|
_config.yml |
站点名称、URL、作者、语言等全局设置 |
_config.fluid.yml |
导航栏、颜色、字体、页面布局等主题设置 |
三、修改站点信息
编辑根目录 _config.yml:
1 | |
修改后执行 hexo clean && hexo deploy 生效。
四、首页配置
编辑 _config.fluid.yml 的 index 部分:
1 | |
五、添加 GitHub 图标
在 _config.fluid.yml 的 about 部分配置关于页的社交图标:
1 | |
如果想在导航栏也显示 GitHub 图标,修改 navbar 部分:
1 | |
六、管理分类
创建分类页
source/categories/index.md 已存在,内容为:
1 | |
给文章添加分类
在文章的 front-matter 中指定:
1 | |
一个文章可以属于多个分类。如果分类不存在,Hexo 会自动创建。
分类页配置
1 | |
七、管理标签
创建标签页
source/tags/index.md 内容为:
1 | |
给文章添加标签
1 | |
标签云配置
1 | |
八、写新文章
1 | |
在 source/_posts/ 下生成 文章标题.md,编辑后用一条命令生成并部署:
1 | |
文章 front-matter 完整示例:
1 | |
九、关于页
编辑 source/about/index.md:
1 | |
十、自定义样式
如需修改颜色、字体等细节,可创建自定义 CSS 文件。
在 _config.fluid.yml 中指定:
1 | |
然后在 source/css/custom.css 中编写样式:
1 | |
自定义 CSS / JS 的版本号已自动化:
custom_css/custom_js里写的?v=1只是占位,构建时会按文件内容 hash 自动替换,不必手动递增。见「十九、自动部署与静态资源版本号」。
十一、颜色主题
1 | |
十二、常用配置速查
| 需求 | 操作 |
|---|---|
| 改站点标题 | _config.yml → title |
| 改首页副标题 | _config.fluid.yml → index.slogan.text |
| 加 GitHub 图标 | _config.fluid.yml → about.icons |
| 加新分类 | 文章 front-matter 里加 categories |
| 加新标签 | 文章 front-matter 里加 tags |
| 改导航栏 | _config.fluid.yml → navbar.menu |
| 改颜色 | _config.fluid.yml → color |
| 改字体 | _config.fluid.yml → font |
| 改悬停、浮起与搜索高亮动效 | source/css/site-motion.css + source/js/hover-intent.js(悬停滤波,见下) |
| 改站内搜索定位效果 | themes/fluid/source/js/local-search.js 与 source/js/site-interactions.js |
悬浮幅度与速度(2026-11-18 二次调整):zuige 觉得默认浮起太夸张,所有位移与 scale 幅度已统一减半(卡片 -7px→-3.5px、按钮 -3px→-1.5px、scale 1.06→1.03 等);随后又反馈”放上去过一会才浮起”,于是进入延迟 80ms→0、CSS
transform过渡时长全部减半(320→160、240→120ms 等)。现在从鼠标放上到浮到位约 50ms。调幅度/速度时只改数值,别把.is-hovered改回:hover。
悬停浮起的滤波红线(2026-11-18 新增):卡片/按钮的
:hover { transform: translateY(-Npx) }会产生几何反馈环——鼠标停在元素下边缘 → 元素上浮脱离鼠标 → hover 失效下沉 → 鼠标又进入,无限抖动。现在位移统一由source/js/hover-intent.js加的.is-hovered类驱动(进入零延迟、离开延迟 140ms,离开时还复查指针是否在扩展 12px 的命中区内)。防抖靠的是离开延迟+容差,不是进入延迟——别为了”滤快速掠过”把进入延迟加回去,那会直接造成放上去迟钝;真要滤误碰也只能给个位数毫秒。键盘可达靠:focus-visible直接驱动位移,与 JS 并存,两者缺一不可。hover-intent.js用 document 事件委托,软导航换页重建 DOM 后无需重绑;仅精确指针(鼠标)启用,触屏与 reduced-motion 自动跳过。新增需要浮起的元素时,要同时在hover-intent.js的LIFT_SELECTOR和 CSS 的.is-hovered选择器里登记,否则不会有鼠标浮起效果。
十三、管理友链
友链配置在 _config.fluid.yml 的 links.items,每条是一个对象,字段如下:
title:站点名称intro:一句话简介link:站点地址avatar:头像地址rss:对方订阅源地址,可选;填写后该友链卡片右上角显示 RSS 图标
1 | |
rss 字段非空时,友链卡片右上角出现 RSS 图标,点击跳转到对方订阅源。图标渲染依赖两处改动:themes/fluid/layout/links.ejs(卡片内增加 RSS 链接)与 source/css/site-motion.css(.link-rss 定位样式)。主题升级后需重新应用这两处。友链页本体位于 source/links/index.md,一般无需改动。
十四、友链朋友圈(动态聚合)
友链页 /links/ 在友链头像与简介下方、「我的友链信息」上方,把每位友链的最新文章以卡片形式聚合展示,无需自建后端。原理:定时抓取各友链的 RSS,生成一份静态 JSON,友链页的脚本拉取该 JSON 渲染卡片。
- 数据源:
circle-feeds.json(仓库根目录),只列带rss的友链,每项含name/link/rss/avatar。 - 生成器:
tools/circle_fetch.py,纯标准库实现,运行后写出两份文件:circle-archive.json(仓库根目录,入库、不进.gitignore):累积归档,每次运行按文章 URL 去重合并新文章,每人上限 100 篇、跨运行一直留存,是「朋友圈一直存在」的来源。source/circle/circle.json(已作为基线数据入库,部署后地址为/circle/circle.json):展示用扁平数据,取全部文章按时间倒序前 60 条。入库是为了保证任何一次干净检出 /hexo deploy都带这份数据,不再出现「朋友圈空白」。
- 渲染:
source/js/circle-feed.js由themes/fluid/layout/links.ejs在友链卡片之后引入,拉取/circle/circle.json后一篇文章一张小卡片:标题在上,左下角圆形头像 + 站点名,右下角日期;卡片样式在source/css/site-motion.css的#circle-feed/.feed-card段(CSS Grid 排布,避免重叠)。 - 自动化:
.github/workflows/circle.yml每天 UTC 22:17 定时运行,也可在 Actions 页手动触发;任何推送到main的改动都会触发一次「抓 RSS →hexo generate -d→ 写回归档」。每次运行把circle-archive.json与source/circle/circle.json提交回main,归档跨运行持续累积;提交信息带[skip ci],配合 job 级if防止自触发循环。
红线:定时抓取曾「一天都没跑过」(2026-11-09 排查)。查 GitHub Actions 的 12 次运行记录,全部是
push/workflow_dispatch,没有一次schedule;线上circle.json的generated停在 2026-10-19。根因是仓库把gh-pages设成了默认分支(Pages 源分支),而circle.yml只存在于main——GitHub 的定时cron只在默认分支生效。修法:GitHub → Settings → Branches 把默认分支改回main;GitHub Pages 仍从gh-pages分支部署,与默认分支互不影响,改完次日 UTC 22:17 起自动生效。在改默认分支之前,每次 push 仍会刷新数据,只是不保证「每天」。另一个旧坑:早期
push.paths白名单只列circle-feeds.json、tools/circle_fetch.py等,改文章 / CSS / 主题配置不会触发自动部署,线上像是「一直不更新」——该白名单已删除。
新增一个友链的动态:在 circle-feeds.json 加一项(填上对方 RSS 地址)即可,其余由流水线自动完成。本地预览可用 bash tools/deploy-circle.sh 一键抓数据并部署。
十五、首页侧栏吸顶(粘性侧边栏)
首页左栏(个人卡片、统计、发文记录、分类、标签、最近文章)在下滑时会跟着一起滚走。用 粘性侧边栏(sticky sidebar) 可以让它滚到某个位置后锁住不动,之后只有右栏的文章列表继续滚动。
技术上靠 CSS 的 position: sticky——它跟 position: fixed 不同:fixed 是一开始就钉死在窗口,sticky 是「没滚到之前正常跟着走,滚到了才吸住」,正好是想要的效果。
当前实现
锁定点定在**「分类」卡片**:左栏上半部分(个人卡片、统计、发文记录)先跟着页面往上滚并自然消失,等「分类」卡片升到固定导航栏下方时,从「分类」开始往下的整块锁死,之后只有右栏继续滚。
实现方式是纯 CSS 容器吸附,不依赖 JS——早期用 JS 动态算 top,但在 iPad Safari 上会因工具栏收展导致锁定点漂移,已被弃用:
| 文件 | 作用 |
|---|---|
themes/fluid/layout/index.ejs |
把「分类」「部分标签」「最近文章」三个 <section> 整体包进 <div class="home-side-sticky">;上半部分(个人卡片/统计/发文记录)留在容器外,走正常流自然滚走 |
source/css/home-sidebar.css |
.home-sidebar { align-self: stretch }(拉满 Grid 行高,sticky 子元素才有整页高度可钉);.home-side-sticky { position: sticky; top: 76px; max-height: calc(100vh - 76px - 16px); overflow-y: auto; },top 是常数,不靠 JS |
_config.fluid.yml |
custom_css 里登记 home-sidebar.css;?v=N 只是占位,构建时按内容 hash 自动替换(见十九) |
原理:.home-side-sticky 的 top: 76px 是固定值(76 ≈ 导航栏高度 + 间距),它的上边缘就是锁定位置——也就是「分类」卡片的顶部。上半部分卡片不在容器里,所以会先滚走;容器本身是 sticky,等上边缘碰到 76px 处就锁住。top 是常数,iPad 上也不会漂移。内容若高于视口,仅容器内部滚动(overflow-y: auto),不影响已滚走的上半栏——这与「整体吸顶 + 内部滚动」的坑不同(旧法会把上半栏卷进内部视口,看起来像消失)。
红线:.home-sidebar 必须拉满 Grid 行高(Grid 默认 align-items: stretch,或显式给 .home-sidebar 写 align-self: stretch)。曾误设 align-items: start,导致 .home-sidebar 只有「自身内容高」,sticky 子元素只能在父级范围内钉一小段、父级底一到就整条滚走,表现成「完全不吸顶」。要点:sticky 子元素的钉住范围 = 父容器高度 − 自身高度 − top,父容器不高就钉不住。
调整锁定位置
- 想让锁定时离导航栏更远/更近:改 home-sidebar.css 里 .home-side-sticky 的 top: 76px(值越大贴导航栏越紧、越晚吸住;值越小越早吸住)。注意它同时是容器上边缘与导航栏的间距,也是视口可用高度扣减项。
- 想换成别的卡片作为锁定点(比如从「标签」开始锁):在 index.ejs 里把 <div class="home-side-sticky"> 的起始位置挪到那个 <section> 之前即可(容器上边缘 = 锁定点)。
- 想改成「一滚到顶就整体吸住」:把 <div class="home-side-sticky"> 移到侧栏最上面(包住个人卡片),并把 top 设小即可。
- 手机端(≤767px)左栏在 home-sidebar.css 里 display: none 隐藏,容器 sticky 自然不生效。
十六、首页侧栏卡片
首页左栏的卡片内容由 themes/fluid/layout/index.ejs 生成。
| 卡片 | 规则 |
|---|---|
| 分类 | 显示前 3 个(按文章数排序),其余收进「展开全部」按钮,按钮固定在列表下方 |
| 部分标签 | 标题就叫「部分标签」,最多显示 5 个:出现次数多的优先,次数相同按首字母排(中文按拼音),完整列表在 /tags/ 页 |
「展开全部 / 收起全部」是一个 <button class="home-more-toggle">(不再是 <details>——部分浏览器不支持在 <details> 内部用 flex 重排,会把「收起全部」渲染到列表上面)。点击逻辑在 source/js/site-interactions.js 里用事件委托实现,软导航换页后依然有效;箭头样式在 source/css/home-sidebar.css 的 .home-more-toggle 段。
想调整标签显示数量:改 index.ejs 顶部的 tagLimit;想改排序规则:改 tagItems 的比较函数。
十七、动态(Moments)板块
「动态」用来发短句、牢骚、随手记;「文章」则是成篇的正式内容。二者本质相同(都是 Markdown 内容),区别在于长度与语气,而不是技术形态。
设计上不新增独立板块与路由:动态挂在已有归档页 /archives/ 内,顶部新增一个胶囊切换按钮,在「文章归档」与「动态」两个视图之间切换。
17.1 数据:写在独立数据文件里
动态内容放在 source/_data/moments.yml(列表,Hexo 会自动载入为 site.data.moments):
1 | |
| 字段 | 说明 |
|---|---|
date |
必填,建议加英文单引号写成字符串,格式 YYYY-MM-DD HH:mm。时间不能省——模板固定按 YYYY-MM-DD HH:mm 输出,只写日期会显示成 00:00 |
content |
必填,正文,支持 Markdown 与 HTML(含图片语法) |
images |
选填,配图轮播(见 17.6)。写了它就不要再在 content 里写 ![](),否则同一张图出现两次 |
- 新增一条:复制模板放到列表最前面(模板渲染时按
date倒序,新的在上)。 - 配图:
content里写即可,图片文件放source/img/下(可建子目录)。卡片样式已适配——.moment-content img { max-width: 100%; border-radius: .35rem },超宽图会自动缩到卡片宽度、不再溢出。- 图片会随
hexo deploy一起推到gh-pages,无需外部图床。 - 侧栏「最新动态」预览卡是纯文本(
momentPlain()抽掉标记),所以配图的动态在侧栏只显示文字,图只在归档页/首页动态视图里出现。
- 图片会随
- 选数据文件而非「文章 +
moment: true标记」,是为了不污染文章归档的统计口径与分页——动态数不计入「共计 N 篇文章」,也不会挤占归档分页。
发一条动态的完整流程(没有后台,就是改文件 + git):
1 | |
只 commit 不部署 → 线上不变;只部署不 commit → 源码会丢。线上还有 Pages 构建 1–2 分钟 + Cloudflare 页面缓存 10 分钟的延迟,验证时给 URL 加随机查询串。
17.2 渲染:复用归档页的 partial
渲染逻辑在 themes/fluid/layout/_partials/archive-list.ejs。该 partial 同时被归档页 / 分类页 / 标签页复用,因此用 params.key === 'archive' 判断,只在归档页挂载切换控件与动态时间线。
两个视图的 DOM 会一次性渲染(archive-panel-posts / archive-panel-moments),切换只是显隐,不重新请求数据。
17.3 样式与交互
| 文件 | 职责 |
|---|---|
source/css/moments.css |
胶囊切换按钮 + 时间线卡片流(左侧竖线与节点圆点),配色沿用主题 CSS 变量,已覆盖深色模式与移动端 |
source/js/moments.js |
切换显隐、同步 URL hash(#moments,用 replaceState 不污染前进/后退历史);通过按钮的 data-tabs-group 区分归档页与首页两组,独立切换 |
关键坑:软导航换入 #board 后内联 <script> 不会执行,所以这里用 document 级事件委托绑定点击,并监听 soft-nav.js 派发的 softnav:loaded 事件重新初始化——否则从其他页面软导航进归档页后,切换按钮会失效。
红线(2026-11-19 补):banner 里的文章元信息必须随软导航整块增删。 文章页 banner 的作者/日期/字数/阅读时长由
banner.ejs在is_post()时渲染(现包在#banner-post-meta容器里),首页没有;而 banner 在#board之外,软导航只换#board不会动它。于是「文章页 → 软导航回首页」时,上一篇文章的「11k 字 / 93 分钟」会残留在首页 banner 上。修法:soft-nav.js的syncBannerChrome()里按目标页有无#banner-post-meta做增/删/替换(与滚动箭头同一套逻辑)。改动banner.ejs结构后必须回归测这条。
红线(2026-10-20 补):软导航「只换
#board.innerHTML」的假设只在「同类 layout 页面间」成立。本博客is_post文章页的#board外层是col-lg-8>#board-ctn(窄列),非文章页是.container.nopadding-x-md(全宽)。从文章页(整页加载)点导航软导航回首页时,只换 innerHTML 会让首页内容残留塞进文章页窄列、整页变窄。因此soft-nav.js换正文前必须连#board的外层父链一起同步(把#board节点整体移入目标页外层容器并replaceChild替换旧外层)。改soft-nav.js后无需手改版本号,scripts/asset-version.js会按内容 hash 自动更新(见十九)。
17.4 资源注入与文案
- CSS / JS 需登记在
_config.fluid.yml的custom_css/custom_js列表里;?v=N只是占位符,改动后不必手动递增,scripts/asset-version.js会按文件内容 hash 自动替换(见十九)。 - 统计文案在
source/_data/languages/zh-CN.yml的moments.post_total(「共计 %d 条动态」)。
17.5 首页切换与侧栏预览
归档页与首页右栏各有一组居中的胶囊切换按钮(文章 / 动态),视觉与逻辑完全一致:
| 位置 | 面板 ID | 说明 |
|---|---|---|
归档页 /archives/ |
archive-panel-posts / archive-panel-moments |
按钮文案「文章归档 / 动态」 |
首页右栏 .home-post-list |
home-panel-posts / home-panel-moments |
按钮文案「文章 / 动态」,动态视图展示全部动态 |
两处按钮通过 data-tabs-group(archive / home)区分,moments.js 按组独立切换,互不干扰;URL hash 统一同步 #moments(replaceState,不污染前进/后退历史),因此 /archives/#moments 与 /#moments 都可作为深链分享。
首页侧栏(热力图下方)另有 .home-moment-card「最新动态」卡片作预览:最近 3 条纯文本单行截断,鼠标悬浮(title)看全文,底部「查看全部动态 →」指向 /archives/#moments。移动端(≤767px).home-sidebar 整体隐藏,该卡片不显示,右栏切换仍在。
- 居中实现:
.archive-tabs(胶囊底板)是inline-flex,外包一层.archive-tabs-wrap { text-align: center }——不能给.archive-tabs直接设margin: 0 auto(inline 元素水平 auto 无效),也不能改成占满宽度的 flex(胶囊底色会撑满整行)。 - 改动展示条数:编辑
index.ejs顶部的sideMomentLimit(侧栏)。 - 侧栏列表复用既有的
.home-recent-list样式(自带单行 ellipsis),动态过长不会撑破卡片。
提醒:
moments.css改动后无需手动 bump,但它必须先登记在custom_css里,否则页面根本不会引用这个文件;版本号由构建脚本自动注入(见十九)。
17.6 多图轮播(2026-11-18 新增)
一条动态塞四五张图时,竖着排会把卡片拉得很长,所以加了轮播:一次显示一张,左右箭头 / 底部圆点 / 触摸滑动切换,计数在右下,点图可看原图。数据用独立的 images 字段而不是 content 里的 ![](),这样「图」和「文」的职责分开,侧栏纯文本预览也不会被图片标记污染。
| 文件 | 职责 |
|---|---|
themes/fluid/layout/_partials/moment-carousel.ejs |
渲染轮播结构,归档页与首页动态视图共用同一份,保证两处一致 |
source/css/moments.css 的「动态配图轮播」段 |
容器、箭头、圆点、计数栏、灯箱 |
source/js/moments.js 末尾的 IIFE |
切换、循环、圆点跳转、触摸滑动、灯箱开关 |
设计取舍
- 图片用
contain(等宽等高内居中)而不是cover:长截图(如 1260×2800 的应用商店页)缩到 182×404 也不丢内容,看不清的字靠点图放大。 - 容器固定高度(桌面 420px / 手机 260px),换图时卡片不跳动。
- 圆点和计数放在图片下方的独立栏,不叠在图上。叠图方案试过两次都不行:深色图片上深色胶囊糊成一片,浅色图片上白点直接消失;改成独立栏后两种主题都稳。
红线一:幻灯片里的图必须手动摘掉懒加载属性。 Fluid 的
img-lazyload.js给每张图挂srcset=loading.gif lazyload,靠 IntersectionObserver 等到「可见」才摘。轮播里除第一张外全是display:none,永远等不到回调——不处理的话切到第 2 张会一直显示 loading.gif。moments.js的initCarousels()里对每张图removeAttribute('srcset')/removeAttribute('lazyload'),别删。
红线二:改主题模板后要
rm -f db.json再 generate。 只加?cb=之外最容易踩的是「产物没变」:Hexo 增量构建对themes/下 layout 的改动不一定失效缓存,实测改完 partial 直接hexo generate,产物里仍是旧结构(grep moment-carousel-bar为 0)。改_partials/*.ejs、index.ejs这类模板时,一律rm -f db.json && npx hexo generate。
红线三:轮播箭头必须用
margin-top垂直居中,不能用transform: translateY(-50%)。 后者会被site-motion.css的全局button.is-hovered { transform: translateY(-3px) scale(1.06) }整个覆盖——鼠标一碰箭头就从居中位置猛地下沉半个身位,移开又弹回,看起来像严重抖动。现在.moment-carousel-btn用margin-top: -1.125rem(高度 2.25rem 的一半)居中,并在site-motion.css里对该类显式transform: none。改全局按钮位移规则时,务必回归测试轮播箭头的 hover 位置。
验收清单(用无头浏览器真实点击,不看源码猜)
| 检查项 | 期望 |
|---|---|
各幻灯片的 img 是否还有 lazyload / srcset |
都是 false |
每张图 naturalWidth |
> 0(真加载,不是占位图) |
| 第 1 张点「上一张」 | 回到最后一张(循环) |
点圆点 / 箭头后 data-index 与计数 |
同步 |
| 点图 | 灯箱打开、body 锁定滚动;ESC 或点背景关闭 |
| 暗色模式 | 引用块与正文同色(实测 rgb(196,198,201) on rgb(24,28,39),≈10:1) |
验证脚本的坑:无头 Chrome(软件渲染)连续 Page.captureScreenshot 几次后会卡死,尤其切到超高图片时。稳妥做法是一次导航只截一张图,或在 Nav 后用 Network.setCacheDisabled + ?cb= 避免拿到旧的 HTML/CSS。
十八、隐藏文章(仅归档可见)
有些内容(如文献整理、草稿碎片)不想挤占首页,但又希望保留在归档、分类、标签里随时可查。给文章 front-matter 加一行 home: false 即可:
1 | |
效果:
| 位置 | 是否出现 |
|---|---|
| 首页文章列表 | ❌ 不出现 |
| 侧栏「最近文章」 | ❌ 不出现 |
RSS / Atom 订阅(atom.xml) |
❌ 不出现 |
| 归档页 / 分类页 / 标签页 | ✅ 正常出现 |
| 文章独立页(直接访问 URL) | ✅ 可访问 |
实现由两处改动组成,二者配合才完整:
| 文件 | 作用 |
|---|---|
scripts/exclude-home.js |
核心。在 before_generate 阶段改写 Fluid 主题提供的 index_posts(首页数据源),在分页之前剔除 home: false 的文章,因此首页不会留空位、页码也不会错位;RSS 生成器在此外包一层同样过滤 |
themes/fluid/layout/index.ejs |
首页侧栏「最近文章」由 site.posts 渲染,脚本里额外 .filter(p => p.home !== false) 把它也排除 |
红线(2026-10-24 定):不要把隐藏逻辑写进「替换 index 生成器」——Fluid 主题自己也在
themes/fluid/scripts/generators/pages.js注册了index生成器,且加载顺序晚于站点scripts/,会覆盖你的注册。正确做法是在before_generate阶段改写index_posts这个数据源(优先级用20,晚于主题的post-filter默认10),让主题的生成器在已被过滤的数据上做分页。主题自带的
archive: true标记只隐藏首页、仍会出现在 RSS 与侧栏「最近文章」,与本机制的home: false(全隐藏)不同,别混用。
已知次要泄漏(按需再拓展):home: false 的文章仍会出现在「另一篇文章页的上一篇/下一篇导航」与本地搜索索引 local-search.xml 中——这两处由 Hexo 核心按全部文章顺序生成,不在上述三处过滤范围内。若需要彻底只进归档,再单独处理 post 生成器的 prev/next 与 search 生成器即可。
文件名别用下划线开头:Hexo 默认把 _ 开头的文件当私有/include 文件、不参与渲染。隐藏文章用普通文件名(如 2026-10-24-literature-xxx.md),只靠 front-matter 的 home: false 控制可见性。
十九、自动部署与静态资源版本号(2026-11-09)
19.1 「改了没生效 / 数据不更新」的四层原因
这是排查 2026-11-09 那次「朋友圈停在 10-19、CSS 时灵时不灵」时理清的链路,四层叠加,按这个顺序看:
| 层 | 原因 | 现状 |
|---|---|---|
| 触发 | 旧工作流 push.paths 白名单只有 circle-feeds.json 等,改文章 / CSS / 主题配置不会触发自动部署 |
白名单已删除,推送 main 即部署 |
| 定时 | 仓库默认分支是 gh-pages,schedule cron 只在默认分支生效,朋友圈数据 21 天没刷新 |
需在 GitHub 改默认分支,见 19.4 |
| 缓存破坏 | ?v=N 靠手改,忘 bump 则 URL 不变;Cloudflare 静态资源 max-age=14400(4h),浏览器也用旧副本 |
已改为按内容 hash 自动注入,见 19.3 |
| 生效延迟 | Pages 构建 1–2 分钟 + CF 页面 max-age=600、CSS max-age=14400 |
无法消除,验证时给 URL 加随机查询串 |
19.2 工作流:推送即部署
.github/workflows/circle.yml 的三个触发口:
| 触发 | 行为 |
|---|---|
push 到 main |
抓 RSS → npx hexo generate -d 部署到 gh-pages → 写回数据 |
schedule 每天 UTC 22:17 |
同上,保证没推送的日子也刷新朋友圈(需默认分支为 main) |
workflow_dispatch |
Actions 页手动跑一次 |
写回 circle.json 的提交信息带 [skip ci],job 上还有 if 判断兜底,避免「Actions 提交 → 又触发 Actions」的死循环。
红线(2026-11-12 实测):日常发文章只
git push origin main,不要本地npx hexo deploy。推送
main会立刻触发 Actions 走完整链路(抓 RSS →hexo generate -d→ 回写数据),本地再 deploy 一次必然要force update覆盖它,实测会出现连锁反应:
gh-pages上出现+ xxx...yyy HEAD -> gh-pages (forced update),等于把 Actions 刚抓的新鲜circle.json换成本地几小时前的旧数据。- Actions 回写
[skip ci]提交会抢占main,导致紧接着的git push origin main报non-fast-forward;解法是git fetch && git rebase origin/main(有未提交改动先git stash push -- <文件>)。本地
hexo deploy只剩两个正当用途:调试产物、Actions 挂了时的应急。用之前先确认没有正在跑的 workflow。
19.3 CSS / JS 版本号自动化
scripts/asset-version.js 在 after_render:html 阶段,把 HTML 里站内 /css/、/js/ 资源的 ?v=任意值 替换成该文件内容的 md5 前 10 位。内容不变则 URL 不变(缓存照常命中),内容一变则 URL 自动变,_config.fluid.yml 里的 ?v=19 从此只是占位符。
红线:别改回
after_generate。 Hexo 8 的generate顺序是load()→_generate()(其中触发before_generate/after_generate)→firstGenerate()才写盘。在after_generate里改public/的旧 HTML,随后会被重新写盘覆盖,实测「脚本日志显示重写了 85 个文件,但产物依旧是旧版本号」。after_render:html返回的字符串才是最终写盘内容。
为什么增量生成也不用删
db.json:writeFile()用渲染结果的 sha1 和 Cache 里的旧 hash 比较。CSS 内容一变,每个页面渲染出的 HTML 里?v=都跟着变 → hash 不同 → 所有页面自动重写,因此绕开了「主题配置变化不触发重渲染」的老坑,也不需要hexo clean。
边界:只处理 href / src 属性里以 /css/、/js/ 开头的站内 .css / .js;CDN 外链、图片 ?v=2、APK 直链 ?v=48、头像 ?v=4、circle.json 的按小时破坏符都原样保留;并保留 Hexo js() / css() helper 生成的 ?v=19.css 查询串后缀。新增自定义 CSS / JS 仍需登记进 custom_css / custom_js,否则页面不会引用它。
验证:
1 | |
19.4 一次性设置:把默认分支改回 main
这一步要在 GitHub 网页操作,本地命令行(无 gh CLI / 无 API token)代劳不了:
- 仓库 → Settings → Branches → Default branch 切到
main。 - Settings → Pages 保持
Deploy from a branch=gh-pages/root,不要改。Pages 源分支与默认分支是两回事,切换后站点照常访问。 - 次日 UTC 22:17(北京时间 06:17)起,每天自动抓取一次;可在 Actions 页看运行记录的
event是否出现schedule。 - 改完就保持
main,不要再切回gh-pages。 Pages 的「部署分支」和仓库的「默认分支」是两套独立设置:前者决定站点读哪份静态文件,后者决定 clone / PR 基准以及定时任务在哪条分支上跑。切回去不会让站点有任何变化,只会让schedule再次失效、朋友圈重新停更。 - 自检:
git ls-remote --symref origin HEAD应返回ref: refs/heads/main HEAD;若仍是gh-pages,说明网页上的修改没保存成功(选完下拉后还要点 Update 并在弹窗里确认)。
二十、数学公式与 LaTeX(2026-11-12)
本站用 hexo-renderer-marked 渲染 Markdown,而 marked 不认 LaTeX。直接写 $...$ / $$...$$ 会被当成普通 Markdown 处理:x_1 变成 x<em>1</em>、\begin{cases} 里的 \\ 少一个反斜杠、* 被当斜体——等 MathJax 拿到时公式已经碎了。
20.1 三层配合,缺一不可
| 层 | 位置 | 作用 |
|---|---|---|
| 保护 | scripts/math-protect.js |
before_post_render 阶段把公式换成纯字母数字占位符($$...$$),marked 渲染完再换回原始 LaTeX 并把 < > & 转义成实体,浏览器解析后 textContent 恰好是原公式 |
| 渲染 | _config.fluid.yml 的 post.math |
enable: true + specific: true,只有在 front-matter 写 math: true 的文章才加载 MathJax,旧文章零开销 |
| 开关 | 文章 front-matter | math: true |
占位符必须纯字母数字——含 $ \ _ * { } 任一个都会被 Markdown / Nunjucks 二次处理。
20.2 目录锚点红线:别用 GitHub 风格的 slug
手写目录 [标题](#锚点) 时,锚点必须和 marked 生成的 id 完全一致。marked 的标题 id 会保留中文标点与全角括号,只把空格和 ASCII 标点(+ / 等)换掉;GitHub 的习惯是删掉所有标点,两者不一致会点了没反应。
| 标题 | marked 生成的 id | GitHub 风格(会失效) |
|---|---|---|
## 2. 恒定电流场中,为什么电流不能中断 |
2-恒定电流场中,为什么电流不能中断 |
2-恒定电流场中为什么电流不能中断 |
## 7. 能量 & 能量密度:静电场 & 磁场 |
7-能量-能量密度:静电场-磁场 |
7-能量--能量密度静电场--磁场 |
可靠做法:先 npx hexo generate,再从产物里读真实 id 回填 href(grep -o '<h2 id="[^"]*"'),并做一次比对:
1 | |
20.3 右侧目录点击后被拉回顶部:popstate 红线(2026-11-18 修)
现象:文章页点右侧目录,跳一下就被拉回顶部,或点了没反应。
根因不是目录本身,而是 hash 变化也会触发 popstate:soft-nav.js 的 popstate 处理里原本 POST_RE.test(pathname) 对文章页为真就 window.location.reload(),于是「点目录 → tocbot 滚动成功 → hash 变化触发 popstate → 整页重载 → 滚动回 0」。
修法:在 soft-nav.js 模块级维护 lastKey = pathname + search(不含 hash),每次软导航 pushState 后更新它;popstate 开头判断 if (locKey() === lastKey) return——纯 hash 变化(锚点跳转)直接放行,不 reload、不走软导航,交给浏览器原生锚点滚动。
红线:以后改
soft-nav.js的 popstate 逻辑,务必回归测试「文章页点右侧目录」——hash 变化与真正的前进/后退在这个事件里是无法靠 event 对象区分的,只能靠 pathname+search 快照比对。
20.4 右侧目录当前项:蓝色卡片 + 跳转落在视口 1/3 + 容器跟随(2026-11-19 修)
需求:右侧目录用淡蓝卡片标出当前阅读位置,卡片不随 hover 浮起;点击跳转后目标标题停在视口上 1/3、下面留 2/3 正文,且卡片要跟页面一起到位、不能慢半拍;页面下滑时目录自动跟随,越过 1/3 后蓝色卡片连续钉在「侧栏 1/3」处,但文章刚打开时顶部不要空一大块;并且侧栏本身能独立上下滚动(滚轮停在侧栏上只滚目录)。
三处改动,缺一不可:
source/css/site-motion.css新增#toc-body .tocbot-link.tocbot-active-link:淡蓝底 + 蓝字 + 1px 内描边,transform: none !important压掉.is-hovered的横移和:active的位移;深色模式另设更浓的底色。必须用#toc-body抬高精度——否则和后面@media (hover)里的.tocbot-link.is-hovered同优先级,后定义者会赢。themes/fluid/layout/_partials/post/toc.ejs:1
2
3
4var readOffset = Math.round(window.innerHeight / 3);
// ...
headingsOffset : -boardTop + readOffset,
scrollSmoothOffset : -readOffset,
红线:
headingsOffset里的-boardTop绝不能删。
tocbot 4.x 判定 active 时拿heading.offsetTop(相对文章容器,实测 2215)和文档scrollTop(实测 2513)比较,两者基准差一个boardTop(容器到文档顶的距离,约 598)。Fluid 原本的-boardTop就是补偿它,使高亮边界落在视口 top≈10px。若直接把headingsOffset换成readOffset,高亮会整整错位一节(实测点「三」亮「四」)。
正确做法是在原补偿上加readOffset,把高亮边界从视口顶部平移到 1/3;scrollSmoothOffset是独立配置,只管点击落点,取负值(目标滚动位置 = 标题文档位置 + offset,负 1/3 视口高度才能让标题停在距顶 1/3 处)。
整栏当滚动容器(2026-11-19 第二轮重写,当前线上方案)。
source/css/site-motion.css在@media (min-width: 992px)内让aside.sidebar自己滚:1
2
3
4
5
6
7aside.sidebar {
box-sizing: border-box;
max-height: calc(100vh - 2rem - 1rem); /* 扣掉 sticky top 2rem + 底部留 1rem */
overflow-y: auto;
scrollbar-width: thin; /* 细滚动条,别抢戏 */
}
aside.sidebar .toc-body { max-height: none; overflow: visible; } /* 内层不再滚,避免双滚动条 */JS(
toc.ejs,window.tocbot.init()之后):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
39var tocBody = document.getElementById('toc-body');
var tocPanel = tocBody ? tocBody.closest('aside.sidebar') : null;
if (tocPanel && getComputedStyle(tocPanel).overflowY !== 'auto') { tocPanel = null; } // CSS 不生效时退回
var tocScroller = tocPanel || tocBody;
// 元素相对「滚动容器内容顶」的绝对位置 —— 该值在滚动/缓动过程中恒定,
// 所以不会读到中间态、不会来回跳。
var tocAbs = function (el) {
var pr = tocScroller.getBoundingClientRect(), er = el.getBoundingClientRect();
return (er.top - pr.top) + tocScroller.scrollTop;
};
var ensureTocSpacers = function () {
var items = tocBody.querySelectorAll('li.toc-list-item');
var stale = tocBody.querySelector('.toc-spacer-top'); // 旧版本残留,删掉
if (stale) { stale.parentNode.removeChild(stale); }
var bot = /* 确保 .toc-spacer-bottom 存在 */;
bot.style.height = '0px'; // 先清零再量,避免累加误差
var h = tocScroller.clientHeight; // 参照的是「整栏可视高」
if (tocScroller.scrollHeight <= h + 4) { return; } // 目录没溢出:不垫空白、不跟随
// 只垫底部:末项也要能落到 1/3。顶部不垫,否则开头一大块空白。
bot.style.height = Math.max(0, Math.round(tocAbs(last) + h * 2 / 3 - tocScroller.scrollHeight)) + 'px';
};
var tocTarget = null, tocRaf = 0;
var tocStep = function () { // 唯一写 scrollTop 的地方
var cur = tocScroller.scrollTop, d = tocTarget - cur;
if (Math.abs(d) < 0.5) { tocScroller.scrollTop = tocTarget; tocTarget = null; tocRaf = 0; return; }
tocScroller.scrollTop = cur + d * 0.22; // 每帧逼近 22%
tocRaf = requestAnimationFrame(tocStep);
};
var tocUpdate = function () { // active 一变立刻算目标并起缓动
var want = tocAbs(active) - tocScroller.clientHeight / 3;
tocTarget = Math.max(0, Math.min(want, tocScroller.scrollHeight - tocScroller.clientHeight));
if (!tocRaf) { tocRaf = requestAnimationFrame(tocStep); }
};
// 主驱动:MutationObserver 看 active 类;兜底:window scroll rAF 节流再校一次
// 用户滚侧栏:wheel / touchstart → 取消目标,自动跟随立刻让位
// resize → ensureTocSpacers() + tocUpdate()
关键点①:跟随的参照物是「能看到的整栏」,不是
.toc-body那个小框。 旧版让.toc-body(max-height:75vh)自己滚,1/3 只能按它算,观感上卡片落到屏幕约 41%;而且它本身不是吸顶元素,页面滚起来它是被动跟着走。改成整栏滚动后,1/3 就是「你眼睛看到的侧栏 1/3」,且整栏是position:sticky常驻的。也顺带满足了「侧栏可以单独滑动」——鼠标停在侧栏上滚轮只滚目录,不带动正文。
关键点②:抽搐的真凶是「等待」,不是「跳动」。 上一版用「active 稳定 180ms + 10% 死区」防抖,逻辑上很合理,但用户感知是「滚动时它故意不动,停下才猛地滑一下」——就是这个一卡一卡。现在去掉死区、去掉 settle 延时:active 一换就立即以 22%/帧缓动过去,平滑完全交给缓动本身。tocAbs()在滚动中恒定(er.top与scrollTop反向抵消),所以不会像offsetTop那样读到中间态产生目标横跳。
关键点③:只在列表底部垫白,顶部不垫。 最后一章 scrollTop 顶到 scrollHeight 上限,没有底部垫白物理上到不了 1/3,所以底部垫到「末项能落在 h/3」。顶部故意不垫(2026-11-19 改,用户:「刚开始的时候可以不要留白这么多吗」)——早期版本为了「第一项也停在 1/3」在顶部垫了h/3 - 首项位置(实测 108px),结果文章一打开,「目录」标题和第一条之间空出一大块,很难看。去掉顶部垫白后靠 clamp 天然衔接:前几项目标算出来是负数 →Math.max(0, …)归零 → 列表不动、高亮往下走,等某条自然越过 1/3 才开始滚,全程连续无跳变(实测 ratio 从 0.13 平滑升到 0.34)。
先清零再量,否则多次 resize 后高度会累加跑飞。spacer 插在列表内部而非给.toc-body加 padding(后者box-sizing:content-box,padding 会把盒子撑到 ~1.7 倍)。tocbot.refresh()重建内容会冲掉 spacer,registerRefreshCallback里要重插;同时要顺手删掉可能残留的.toc-spacer-top(旧版本会插)。
点击跳转的卡片动效单独走时间轴(2026-11-19 第三次补,用户:「点击跳转时蓝色卡片动效偏慢」):
1
2
3
4
5
6
7
8
9
10
11// 点击时目标已确定,不必等 tocbot 在平滑滚动结束后才改 active
tocBody.addEventListener('click', function (e) {
var a = e.target.closest('a.tocbot-link'); if (!a) return;
var max = tocScroller.scrollHeight - tocScroller.clientHeight;
if (max <= 0) return;
var to = Math.max(0, Math.min(tocAbs(a) - tocScroller.clientHeight / 3, max));
tocPinnedHref = a.getAttribute('href'); // 上锁:飞行途中别被 scroll 兜底抢
tocPinTimer = setTimeout(releaseTocPin, 1200); // 安全阀
tocTweenTo(to, 320); // 固定时长 + easeOutCubic
});
// tocUpdate() 开头:pinned 且 active 还没追上被点项 → 直接 return1
2
3
4
5
6
7
8
9
10
11var tocTweenTo = function (to, dur) {
var from = tocScroller.scrollTop, t0 = performance.now();
tocTarget = null;
if (tocRaf) { cancelAnimationFrame(tocRaf); tocRaf = 0; }
var step = function (now) {
var k = Math.min(1, (now - t0) / dur), e = 1 - Math.pow(1 - k, 3); // easeOutCubic
tocScroller.scrollTop = from + (to - from) * e;
if (k < 1) { tocTweenRaf = requestAnimationFrame(step); } else { tocScroller.scrollTop = to; tocTweenRaf = 0; }
};
tocTweenRaf = requestAnimationFrame(step);
};
关键点④:点击「偏慢」是两段延迟叠加。 无头逐帧实测(改前):页面
420–450ms滚到位,但卡片454–495ms才开始动,再花400–800ms滑完,总耗时0.85–1.26s。两个原因:① tocbot 在整个平滑滚动期间只改一次 active(跳到终点才改),而我们的目标是从 active 算的,所以那 420ms 卡片完全空等;② 每帧 22% 的指数缓动尾巴很长(1120px 要走 27 帧,最后几十 px 拖 200ms+)。对策:点击时直接用被点链接算目标 + 固定时长easeOutCubic,改后卡片274–290ms到位(页面还在滚的途中就到),总耗时降到0.48–0.49s。
关键点⑤:必须有 pin(上锁),否则会被 scroll 兜底拽回去。 飞行途中 active 还停在旧项,window scroll每帧兜底调用tocUpdate()会按旧 active 算目标、把卡片往回拽。所以点击时记下href,tocUpdate()发现「pinned 且当前 active ≠ 被点项」就直接 return,等 active 追上再解锁(另有 1.2s 安全阀 + 用户 wheel 时立即解锁)。锁释放后重算的目标与 tween 终点重合(差 0),不会二次回弹。
实测验收(1440×900 无头 Chrome,长文 hexo-customize-guide,45 个目录项):
- 结构:
panelH=652 / panelScrollH=1711 / overflowY=auto / boxSizing=border-box,tocBodyOverflow=visible(内层确实不再滚),只垫底部 spacer(hasSpacer-top=false)。 - 点「三、修改站点信息」:标题
top=300(= 900/3),active 正好是「三」,transform:none,背景rgba(48,169,222,.14);鼠标停在 active 项上transform仍为none(不浮起)。 - 全篇扫描(页面滚动 f=0→1 取 9 个采样点):
f=0时首章「前言」ratio 0.16(贴近目录标题,不再空一大块),f=0.1升到0.32,f≥0.25起稳定在0.34直到末章「总结」,scrollTop0→1057 单调增长,无越界回弹。前段 0.16→0.34 是连续爬升(clamp 归零导致),不是跳变。 - 顶部留白(
engineering-electromagnetic-field-review,60 个目录项,栏高 624):首项距侧栏顶 208px → 80px,省掉 128px 空白。 - 连续跟手验证(60px/帧模拟滚轮,逐帧记录侧栏
scrollTop):最大单帧跳变 28px、最长「完全不动」连续帧数 26 帧(≈0.43s,且发生在页面刚开始滚、active 还没切的阶段),全程平滑推进,判定 PASS——不再有「停很久再猛跳」。 - 点击动效验证(点第 4 / 23 / 43 项,逐帧采样):页面
424–441ms到位,卡片274–290ms到位(改前821–1161ms),停稳后ratio仍是0.333,无二次回弹;中距那次目标本来就在 1/3,卡片位移 600px 也在 283ms 内完成。 - 无头测试注意:① CDN 库(baomitu 的 jquery/tocbot 等)在无头沙箱里加载失败,需用 CDP
Fetch拦截全部请求(本地127.0.0.1放行、其它外链回空 200)——只拦*baomitu.com*不够,busuanzi那个统计脚本卡在<head>里会让解析器停在 body 之前(readyState永远loading、document.body为null、目录项数 0);② 别用window.scrollTo瞬间跳 1.8 万像素测——会触发「前言→十六→十七」非真实三连跳,要按 60px/帧渐进滚动模拟真实滚轮。 - 部署红线:改完 EJS/CSS 只在本地
hexo generate不够,线上看不到——必须git commit+git push origin main让 Actions 部署到 gh-pages。用户「还是没跟随」的头号原因就是只本地生成没 push。
附带发现:tocbot 4.20.1 实际没给 active 的
<li>加is-active-li类,主题里那条左侧蓝竖条本来就visibility:hidden、不会显示。CSS 里仍留一条display:none兜底,防止将来版本加上类后与卡片重复。
20.5 验收标准
| 检查项 | 期望 |
|---|---|
页面残留 CMCMATHPROTECT |
0(有残留说明 after_post_render 没跑到) |
正文残留 $$ 原文 |
0(用浏览器 innerText 数,不是数 HTML 源码) |
mjx-container 数量 |
与公式条数一致(MathJax 排版产物) |
| 目录锚点 | 全部能命中 h2 id |
| 点右侧目录后 | 页面滚到目标标题且不回顶(无整页 reload) |
| 目录当前项 | 淡蓝卡片、蓝字,hover 时不浮起 |
| 目录跳转落点 | 目标标题 top ≈ 视口高度/3,active 与点击项一致 |
| 侧栏可独立滚动 | 鼠标在右侧栏上滚滚轮,只滚目录不动正文;侧栏有细滚动条,max-height 铺满一屏、吸顶不跑 |
| 目录跟随 | 蓝色卡片连续跟手:前段贴近目录标题(ratio 从 0.13/0.16 连续爬升),越过 1/3 后稳定钉在「整栏可视高」1/3 处直到末章(ratio 0.34),滚动中不顿不跳;开头不留大片空白;改动已 push 部署(非仅本地 generate) |
| 点击跳转 | 卡片约 300ms 内到位,与页面平滑滚动几乎同时收尾,不出现「页面停了卡片还在溜」 |
| 主页 banner | 从文章页软导航回首页后,banner 不再残留「字数 / 阅读时长」 |
总结
核心就两个文件:
_config.yml管全局设置_config.fluid.yml管主题样式
改完配置可以本地执行 hexo generate -d,也可以直接 git push origin main 交给 Actions 自动部署(见十九)。日常命令见开头「一、常用命令速查」。