博客搭建与魔改系列教程导航🚥🚥🚥

这十节分别改哪里
  • 41 ~ 42:友人帐(/link/)的三格式分栏与一键复制申请区
  • 43 ~ 44:关于页(/about/)的名片卡、社交卡片与本站信息面板
  • 45:RSS / Atom 订阅源与浏览器自动发现
  • 46 ~ 47:归档页(/archives/)的卡片栅格、年份吸顶与折叠
  • 48 ~ 49:Twikoo 评论区的主题色皮肤与操作图标间距
  • 50:把上面这些新模块统一挂到「美化设置」的主题色变量上

路径统一用 [Blogroot] 表示博客根目录。所有自定义样式都放在 [Blogroot]\source\css\,脚本放在 [Blogroot]\source\js\,不改主题源码;这样升级 Butterfly 时不会丢。

友人帐:同一份友链信息,三种格式

不同主题的友链格式不一样:Butterfly 系吃 YAML,Volantis 系吃 JSON,还有站点只认表格。与其让别人自己猜,不如在友链页顶部做一个分栏,把三种格式都摆出来。

Butterfly 自带 tabs 标签,不需要额外插件。在 [Blogroot]\source\link\index.md 里写:

文件:[Blogroot]/source/link/index.md | 改法:替换正文里已有的 {% tabs link-format %} 整段(没有就插在页面标题下面);三个标签页里的「站点名称 / yourdomain.com」换成本站信息,标签文字可改。

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
{% tabs link-format %}
<!-- tab butterfly-candy -->
```yml
- name: 站点名称
link: https://yourdomain.com/
avatar: https://yourdomain.com/img/avatar.jpg
descr: 一句话介绍
siteshot: https://image.thum.io/get/allowJPG/wait/20/width/600/crop/950/https://yourdomain.com/
```
<!-- endtab -->
<!-- tab Volantis -->
```json
{
"title": "站点名称",
"screenshot": "https://image.thum.io/get/allowJPG/wait/20/width/600/crop/950/https://yourdomain.com/",
"url": "https://yourdomain.com/",
"avatar": "https://yourdomain.com/img/avatar.jpg",
"description": "一句话介绍"
}
```
<!-- endtab -->
<!-- tab General -->
| 名称 | 数值 |
| --- | --- |
| 站点名称 | 站点名称 |
| 站点链接 | https://yourdomain.com/ |
<!-- endtab -->
{% endtabs %}

几个容易踩的点:

  • {% tabs 分组名 %} 里的分组名只是标识,不能重复;<!-- tab 标签文字 --> 与 <!-- endtab --> 必须成对。
  • 用三个反引号围起来的代码块里,标签会原样显示,不会被 Hexo 执行;正文里要原样显示标签时,才需要用 raw 包裹。
  • 表格那一栏别用太长的链接,手机端会横向溢出。截图地址这种长串,直接单独放一行代码块更稳。

分栏标题另外加一点留白,不要让分栏贴着页面顶部:

文件:[Blogroot]/source/css/custom.css | 改法:追加到文件末尾;文件里已有友人帐样式段(h2.hg-link-title),能找到就替换同名规则,别写两份。

1
2
3
4
5
6
7
8
9
10
#body-wrap.type-link #article-container .hg-link-title {
margin: 1.6rem 0 .4rem;
font-size: 1.25rem;
}

#body-wrap.type-link #article-container .hg-link-sub {
margin-bottom: 1rem;
color: color-mix(in srgb, var(--font-color) 55%, transparent);
font-size: 13px;
}

友人帐:一键复制友链模板

分栏解决的是「本站长什么样」,申请区解决的是「别人怎么把信息给你」。与其让人对着示例手打,不如给两个按钮:一个复制 YAML 模板,一个复制截图地址。

HTML 放在友链页申请区的位置:

文件:[Blogroot]/source/link/index.md | 改法:放在「加入本站友链方式」那段之后、正文末尾;已有 .hg-link-apply 块就整段替换,<script> 的 ?v= 跟着升。

1
2
3
4
5
<div class="hg-link-apply">
<button type="button" data-copy="yaml"><i class="fa-solid fa-circle-plus"></i>复制友链格式</button>
<button type="button" data-copy="shot"><i class="fa-solid fa-circle-plus"></i>复制截图地址</button>
</div>
<script src="/js/link-apply.js?v=1" data-pjax></script>

[Blogroot]\source\js\link-apply.js:

文件:[Blogroot]/source/js/link-apply.js | 改法:已有同名文件,整段替换文件内容;按钮绑定在 init()、剪贴板回落逻辑在 copyText() / legacyCopy(),别拆到别处。

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
(function () {
'use strict';

var TEMPLATES = {
yaml: '- name: #站点名称\n link: #站点链接\n avatar: #站长头像\n descr: #站点描述\n siteshot: #站点截图',
shot: 'https://image.thum.io/get/allowJPG/wait/20/width/600/crop/950/https://<你的域名>/'
};
var TIPS = { yaml: '友链格式已复制', shot: '截图地址已复制' };

function tell(msg) {
if (typeof window.fomalNotify === 'function') {
window.fomalNotify({ type: 'success', message: msg, duration: 2500 });
}
}

function legacyCopy(text, done) {
var ta = document.createElement('textarea');
ta.value = text;
ta.style.cssText = 'position:fixed;top:-1000px;left:0;opacity:0';
document.body.appendChild(ta);
ta.select();
try { document.execCommand('copy'); done(); } catch (e) { /* 保持原样 */ }
document.body.removeChild(ta);
}

function copyText(text, done) {
if (navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(text).then(done, function () { legacyCopy(text, done); });
} else {
legacyCopy(text, done);
}
}

function init() {
var box = document.querySelector('.hg-link-apply');
if (!box || box.getAttribute('data-bound') === '1') return;
box.setAttribute('data-bound', '1');
box.addEventListener('click', function (ev) {
var btn = ev.target.closest('[data-copy]');
if (!btn) return;
var text = TEMPLATES[btn.getAttribute('data-copy')];
if (!text) return;
copyText(text, function () { tell(TIPS[btn.getAttribute('data-copy')] || '已复制'); });
});
}

if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', init);
else init();
})();

说明:

  • navigator.clipboard.writeText 需要在安全上下文(HTTPS 或 localhost)里才可用,HTTP 情况下会自动退回 execCommand('copy')。
  • 提示框复用站内 fomalNotify;如果没有这个函数,复制本身仍然正常,只是不弹提示。
  • 加 data-bound 守卫是为了 pjax 往返时不重复绑定点击事件。
  • 用户站点地址、头像这些模板内容只是「示例文本」,不要把它写成某个真实站点的信息;模板里用占位符,让人自己替换。

关于页:名片卡与社交卡片

关于页第一屏决定别人愿不愿意往下看。做成「头像 + 名字 + 一句话 + 标签」的名片卡,再加一排社交账号卡片,比纯文字友好很多。

名片卡:

文件:[Blogroot]/source/about/index.md | 改法:替换正文开头的 .hg-about-hero 整块;头像路径、名字、徽标文字、三个标签按自己情况改。

1
2
3
4
5
6
7
8
9
10
11
12
<div class="hg-about-hero">
<img class="hg-about-avatar" src="/img/avatar.jpg" alt="站长头像" loading="lazy" decoding="async">
<div class="hg-about-hero-main">
<div class="hg-about-name">你的名字<span class="hg-about-badge">博主</span></div>
<p class="hg-about-bio">一句话介绍自己</p>
<div class="hg-about-tags">
<span>学生</span>
<span>AI 入门</span>
<span>折腾记录</span>
</div>
</div>
</div>

社交卡片统一用一个网格,颜色用各自品牌的色值,图标直接用 FontAwesome:

文件:[Blogroot]/source/about/index.md | 改法:紧跟名片卡之后插入;每个 <a> 是一条社交账号,增删时保持 is-xxx 类名,CSS 里才有对应的品牌色。

1
2
3
4
5
6
7
8
9
10
11
12
<div class="hg-about-social">
<a class="hg-about-sns is-bilibili" href="https://space.bilibili.com/你的UID" target="_blank" rel="noopener">
<i class="fab fa-bilibili"></i>
<span class="hg-about-sns-name">Bilibili</span>
<span class="hg-about-sns-id">你的UID</span>
</a>
<a class="hg-about-sns is-github" href="https://github.com/你的用户名" target="_blank" rel="noopener">
<i class="fab fa-github"></i>
<span class="hg-about-sns-name">GitHub</span>
<span class="hg-about-sns-id">你的用户名</span>
</a>
</div>

对应 CSS 的关键部分:

文件:[Blogroot]/source/css/custom.css | 改法:追加到文件末尾;文件里已有 #body-wrap.type-about 的 .hg-about-hero / .hg-about-social / .hg-about-sns 段,能找到就替换。

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
#body-wrap.type-about #article-container .hg-about-hero {
display: flex;
align-items: center;
gap: 18px;
padding: 22px;
border-radius: 16px;
border: 1px solid color-mix(in srgb, var(--font-color) 8%, transparent);
background: linear-gradient(135deg,
color-mix(in srgb, var(--theme-color, #49b1f5) 10%, transparent), transparent 70%);
}

#body-wrap.type-about #article-container .hg-about-social {
display: grid;
grid-template-columns: repeat(4, minmax(0, 1fr));
gap: 10px;
}

#body-wrap.type-about #article-container .hg-about-sns {
--sns: var(--theme-color, #49b1f5);
display: flex;
align-items: center;
gap: 8px;
padding: 10px 12px;
border-radius: 12px;
border: 1px solid color-mix(in srgb, var(--sns) 22%, transparent);
background: color-mix(in srgb, var(--sns) 6%, transparent);
}

#body-wrap.type-about #article-container .hg-about-sns.is-bilibili { --sns: #fb7299; }
#body-wrap.type-about #article-container .hg-about-sns.is-github { --sns: #6e5494; }

手机端四列会挤成一团。把社交区改成两列,并让每张卡片内部变成「图标 + 名称 / 图标 + ID」的 2×2 小网格,ID 才有地方放:

文件:[Blogroot]/source/css/custom.css | 改法:紧接上一段追加,放在同一个关于页样式区内;媒体查询不要插进别的 @media 里。

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
@media screen and (max-width: 768px) {
#body-wrap.type-about #article-container .hg-about-hero {
flex-direction: column;
text-align: center;
}

#body-wrap.type-about #article-container .hg-about-social {
grid-template-columns: repeat(2, minmax(0, 1fr));
}

#body-wrap.type-about #article-container .hg-about-sns {
display: grid;
grid-template-columns: 34px minmax(0, 1fr);
grid-template-rows: auto auto;
column-gap: 10px;
}

#body-wrap.type-about #article-container .hg-about-sns i {
grid-column: 1;
grid-row: 1 / span 2;
}

#body-wrap.type-about #article-container .hg-about-sns-name {
grid-column: 2;
grid-row: 1;
}

#body-wrap.type-about #article-container .hg-about-sns-id {
grid-column: 2;
grid-row: 2;
}
}

品牌色用 --sns 局部变量覆盖,后面所有派生色都从它算,想加 Gitee、知乎、邮箱时只需要再写一行 --sns 色值。

关于页:本站信息与线路检测

这一块就是关于页底部那张卡:前面显示访客数、运行天数,中间检测本站三个入口的连通性,右边列技术栈,底部读本机参数。

先写结构。注意所有动态值都留一个 — 占位,脚本没跑起来时页面也不难看:

文件:[Blogroot]/source/about/index.md | 改法:放在关于页正文底部,替换已有的 #hg-about-check 整块(连同上面那行 <h2 class="hg-about-check-title">);技术栈里的版本号按自己站点改。

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<h2 class="hg-about-check-title"><i class="fas fa-satellite-dish"></i> 本站信息与线路检测</h2>

<div class="hg-about-check" id="hg-about-check">
<div class="hg-check-live">
<span class="hg-check-dot is-checking" data-hg-dot></span>
<span class="hg-check-text" data-hg-text>正在连接本站…</span>
<span class="hg-check-ms"><b data-hg-ms>—</b><i>ms</i></span>
<button type="button" class="hg-check-retry" data-hg-retry><i class="fas fa-rotate"></i> 重新检测</button>
</div>

<div class="hg-check-metrics">
<div><b id="busuanzi_site_uv">—</b><span>本站访客数</span></div>
<div><b id="busuanzi_site_pv">—</b><span>总访问量</span></div>
<div><b id="busuanzi_today_uv">—</b><span>今日访客</span></div>
<div><b data-hg-days>—</b><span>已运行天数</span></div>
</div>

<div class="hg-check-blocks">
<section class="hg-check-block">
<div class="hg-check-block-title"><i class="fas fa-route"></i> 线路检测</div>
<div class="hg-line-list">
<div class="hg-line-row">
<span class="hg-line-name">主站首页</span>
<span class="hg-line-meta">
<i class="hg-line-dot is-checking" data-hg-line-dot="site"></i>
<b data-hg-line-text="site">检测中</b>
<em data-hg-line-ms="site">—</em>
</span>
</div>
<div class="hg-line-row">
<span class="hg-line-name">评论服务</span>
<span class="hg-line-meta">
<i class="hg-line-dot is-checking" data-hg-line-dot="comment"></i>
<b data-hg-line-text="comment">检测中</b>
<em data-hg-line-ms="comment">—</em>
</span>
</div>
<div class="hg-line-row">
<span class="hg-line-name">RSS 订阅</span>
<span class="hg-line-meta">
<i class="hg-line-dot is-checking" data-hg-line-dot="rss"></i>
<b data-hg-line-text="rss">检测中</b>
<em data-hg-line-ms="rss">—</em>
</span>
</div>
</div>
<div class="hg-line-net">
<span>接入网络 <b data-hg-net="type">—</b></span>
<span>估算带宽 <b data-hg-net="down">—</b></span>
<span>网络 RTT <b data-hg-net="rtt">—</b></span>
</div>
</section>

<section class="hg-check-block">
<div class="hg-check-block-title"><i class="fas fa-layer-group"></i> 技术栈</div>
<div class="hg-stack">
<span>Hexo <b>8.1.2</b></span>
<span>Butterfly <b>5.7.2</b></span>
<span>Twikoo</span>
<span>Nginx</span>
</div>
</section>
</div>

<section class="hg-check-block hg-check-local">
<div class="hg-check-block-title"><i class="fas fa-microchip"></i> 本机实测参数</div>
<div class="hg-local-grid">
<div><span>浏览器</span><b data-hg-local="browser">—</b></div>
<div><span>系统</span><b data-hg-local="os">—</b></div>
<div><span>屏幕</span><b data-hg-local="screen">—</b></div>
<div><span>视口</span><b data-hg-local="viewport">—</b></div>
<div><span>CPU / 内存</span><b data-hg-local="cpu">—</b></div>
<div><span>语言 / 时区</span><b data-hg-local="lang">—</b></div>
<div><span>本页加载</span><b data-hg-local="load">—</b></div>
<div><span>资源请求</span><b data-hg-local="res">—</b></div>
</div>
</section>
</div>

脚本分三块:线路探测、网络信息、本机参数。

线路探测只用同源地址。mode: 'no-cors' 下浏览器不允许读取状态码,所以这里判断的是「请求有没有在超时前结束」,拿到的耗时也足够说明线路通不通:

文件:[Blogroot]/source/js/about-page.js | 改法:已有同名文件,替换文件顶部的 SITE / SITE_ORIGIN / TIMEOUT 常量和 probe() 函数;SITE 改成你自己的域名,必须带结尾斜杠。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
var SITE = 'https://yourdomain.com/';
var SITE_ORIGIN = SITE.replace(/\/$/, '');
var TIMEOUT = 8000;

function probe(url, method) {
return new Promise(function (resolve) {
var ctrl = typeof AbortController === 'function' ? new AbortController() : null;
var timer = ctrl ? setTimeout(function () { ctrl.abort(); }, TIMEOUT) : null;
var started = performance.now();
fetch(url, {
method: method || 'GET',
mode: 'no-cors',
cache: 'no-store',
signal: ctrl ? ctrl.signal : undefined
}).then(function () {
resolve({ ok: true, ms: Math.round(performance.now() - started) });
}).catch(function (err) {
resolve({ ok: false, ms: null, timeout: !!(err && err.name === 'AbortError') });
}).then(function () {
if (timer) clearTimeout(timer);
});
});
}

三个探测地址分别是首页、评论服务路径和 atom.xml。第三个用 HEAD,不下载正文:

文件:[Blogroot]/source/js/about-page.js | 改法:放在 runChecks() 里,替换三路并发探测那一段;评论服务路径 /twikoo/ 按你实际的接口前缀改。

1
2
3
4
5
6
7
8
var stamp = '?hgcheck=' + Date.now();
Promise.all([
probe(SITE + stamp, 'GET'),
probe(SITE_ORIGIN + '/twikoo/' + stamp, 'GET'),
probe(SITE_ORIGIN + '/atom.xml' + stamp, 'HEAD')
]).then(function (res) {
// res[0] / res[1] / res[2] 分别是 { ok, ms, timeout }
});

?hgcheck=时间戳 是为了绕过缓存,避免测到 CDN 或浏览器缓存里的旧结果。超过 2500ms 显示「较慢」,失败和超时分开提示。

网络信息读 Network Information API,读不到就显示「浏览器不支持」,不要报错:

文件:[Blogroot]/source/js/about-page.js | 改法:整段替换已有的 fillNet() 函数;setText() 是文件里已有的辅助函数,直接复用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
function fillNet(box) {
var c = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
if (!c) {
setText(box, '[data-hg-net="type"]', '浏览器不支持');
return;
}
var map = { wifi: 'Wi-Fi', cellular: '蜂窝', ethernet: '有线', none: '离线', unknown: '未知' };
var parts = [];
if (map[c.type]) parts.push(map[c.type]);
if (c.effectiveType) parts.push(String(c.effectiveType).toUpperCase());
setText(box, '[data-hg-net="type"]', parts.join(' · ') || '未知');
setText(box, '[data-hg-net="down"]', typeof c.downlink === 'number' ? c.downlink + ' Mbps' : '—');
setText(box, '[data-hg-net="rtt"]', typeof c.rtt === 'number' ? c.rtt + ' ms' : '—');
}

本机参数全部来自浏览器本地接口,只写进 DOM,不发请求:

文件:[Blogroot]/source/js/about-page.js | 改法:整段替换已有的 fillLocal() 函数;它调用的 browserOf() / osOf() 就写在同一文件里,不必另建文件。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
function fillLocal(box) {
var ua = navigator.userAgent || '';
var cores = navigator.hardwareConcurrency;
var mem = navigator.deviceMemory;
var tz = '';
try { tz = Intl.DateTimeFormat().resolvedOptions().timeZone || ''; } catch (e) {}

var load = '—';
try {
var nav = performance.getEntriesByType('navigation')[0];
if (nav) {
var end = nav.loadEventEnd || nav.domContentLoadedEventEnd || performance.now();
load = Math.max(0, Math.round(end - nav.startTime)) + ' ms';
}
} catch (e) {}

setText(box, '[data-hg-local="browser"]', browserOf(ua));
setText(box, '[data-hg-local="os"]', osOf(ua));
setText(box, '[data-hg-local="screen"]', screen.width + '×' + screen.height);
setText(box, '[data-hg-local="viewport"]', innerWidth + '×' + innerHeight);
setText(box, '[data-hg-local="cpu"]', (cores ? cores + ' 核' : '—') + ' / ' + (mem ? mem + ' GB' : '—'));
setText(box, '[data-hg-local="lang"]', (navigator.language || '—') + (tz ? ' / ' + tz : ''));
setText(box, '[data-hg-local="load"]', load);
}

browserOf / osOf 就是几段 UA 正则,按 Edge、Opera、Firefox、Chrome、Safari 的顺序匹配(顺序不能反,Chrome 的 UA 里也带 Safari)。devicePixelRatio、资源请求数同理,能读到就显示,读不到就保持 —。

运行天数按建站日期算,不用请求接口:

文件:[Blogroot]/source/js/about-page.js | 改法:改文件顶部的 SITE_BIRTH 常量,换成自己的建站时间(带时区偏移的 ISO 字符串最稳)。

1
2
var SITE_BIRTH = new Date('2024-05-20T14:11:00+08:00').getTime();
var days = Math.floor((Date.now() - SITE_BIRTH) / 86400000);

最后是初始化和 pjax 守卫:

文件:[Blogroot]/source/js/about-page.js | 改法:替换文件末尾的 init() 和启动段(document.readyState 判断),保留已有的 pjax:complete 监听。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
function init() {
var box = document.getElementById('hg-about-check');
if (!box || box.getAttribute('data-bound') === '1') return;
box.setAttribute('data-bound', '1');

box.addEventListener('click', function (ev) {
if (ev.target.closest('[data-hg-retry]')) runChecks(box);
});

fillLocal(box);
runChecks(box);
}

document.addEventListener('pjax:complete', init);
if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', init);
else init();

样式上,整张卡沿用关于页的圆角卡片语言,线路状态用三个小圆点表示:

文件:[Blogroot]/source/css/custom.css | 改法:追加到文件末尾;已有 .hg-check-blocks / .hg-check-block / .hg-local-grid 段就替换,手机端那条媒体查询一并放进关于页样式区。

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
#body-wrap.type-about #article-container .hg-check-blocks {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 12px;
margin-top: 14px;
}

#body-wrap.type-about #article-container .hg-check-block {
padding: 12px 14px;
border: 1px solid color-mix(in srgb, var(--font-color) 8%, transparent);
border-radius: 12px;
background: color-mix(in srgb, var(--font-color) 3.5%, transparent);
}

#body-wrap.type-about #article-container .hg-local-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
gap: 8px;
}

@media screen and (max-width: 768px) {
#body-wrap.type-about #article-container .hg-check-blocks {
grid-template-columns: 1fr;
}
#body-wrap.type-about #article-container .hg-local-grid {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
}

这个面板会发起对本站的请求,也会读取浏览器本机参数。上线前记得同步改隐私政策:写清楚只探测本站自己的入口、不向第三方发送数据;本机参数只在浏览器里计算和展示,不上传、不存储。别人访问你的站点时,这些探测请求也会进入服务器访问日志,隐私政策里的日志条款需要涵盖。

RSS / Atom 订阅源与自动发现

Butterfly 不自带订阅源,需要 hexo-generator-feed:

执行位置:博客根目录终端 | 作用:安装订阅源生成插件 hexo-generator-feed,装完才会有 atom.xml;package.json 里已列出该依赖的话可跳过。

1
npm install hexo-generator-feed --save

在 [Blogroot]\_config.yml 里加:

文件:[Blogroot]/_config.yml | 改法:作为顶层键 feed: 追加到文件末尾(放在 #魔改 区之前更清楚);全文只能有一个 feed:,已有同名键就只核对子项,不要重复写第二份。

1
2
3
4
5
6
7
8
feed:
type: atom
path: atom.xml
limit: 20
content: true
content_limit: 140
content_limit_delim: ' '
order_by: -date
  • limit: 20 只输出最近 20 篇,避免文件随文章数量无限变大。
  • content: true 会把正文塞进订阅源,阅读器里能直接看全文,但 atom.xml 体积会明显变大;只想给摘要就改成 false。
  • 生成后访问 /atom.xml,能打开且是合法 XML 就说明成功。

再让浏览器和阅读器自动发现订阅源。_config.butterfly.yml 的 inject.head 加一行:

文件:[Blogroot]/_config.butterfly.yml | 改法:放在 inject.head 列表里作为一项,缩进与其它 <link> 对齐(四空格 -);title 换成你的站点名,别加到 inject.bottom。

1
2
3
inject:
head:
- <link rel="alternate" type="application/atom+xml" title="你的站点名" href="/atom.xml">

最后在关于页或页脚放一个复制按钮,方便别人订阅:

文件:[Blogroot]/source/js/about-page.js | 改法:copyText() 和 legacyCopy() 文件里已有,不用重写;只需在 init() 的点击监听里补一句 copyText(SITE_ORIGIN + '/atom.xml', ...),按钮写成 <button type="button" data-hg-copy-rss>复制订阅地址</button>,放进关于页正文即可。

1
2
3
4
5
6
7
8
function copyText(text, done) {
if (navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(text).then(done, function () { legacyCopy(text, done); });
} else {
legacyCopy(text, done);
}
}
copyText(location.origin + '/atom.xml', function () { tell('RSS 订阅地址已复制'); });

文章加密:hexo-blog-encrypt

站内有一篇笔记用 front matter 的 password: 加密,靠 hexo-blog-encrypt 输出密码框。不装插件时 password 会被忽略,正文直接明文输出。

执行位置:博客根目录终端 | 作用:安装文章加密插件;已经按基础教程的插件清单装过就跳过。

1
npm install hexo-blog-encrypt --save

文件:[Blogroot]/_config.yml | 改法:在文件末尾新增顶层 encrypt: 段;tags 用于按标签批量加密,单篇加密直接在文章 front matter 写 password:,同一篇不要两种方式同时用。

1
2
3
4
5
6
7
8
encrypt:
abstract: 有东西被加密了, 请输入密码查看.
message: 您好, 这里需要密码.
tags:
- {name: 加密, password: 你的密码}
theme: blink
wrong_pass_message: 抱歉, 这个密码看着不太对, 请再试试.
wrong_hash_message: 抱歉, 这个文章不能被校验, 不过您还是能看看解密后的内容.

文件:[Blogroot]/source/_posts/你的文章.md | 改法:在 front matter 的 --- 之间加一行 password:,值是明文密码;只想按标签加密时给文章加 tags: [加密],不写 password。

1
2
3
4
5
---
title: 我的笔记
date: 2026-11-23 10:00:00
password: 你的密码
---

归档页:时间轴改卡片栅格

主题默认的归档是「一条竖线 + 一串圆点」,文章一多就像卷轴。改造思路是:不动主题模板,只在浏览器里把已经渲染好的 DOM 重新排,所以不需要改 Pug,也不会影响分类页和标签页。

脚本先做两个守卫,任何一个不成立就直接退出,页面保持原生样子:

文件:[Blogroot]/source/js/archive-page.js | 改法:已有同名文件,对应文件里 init() 开头的两道守卫,按这段替换;归档脚本就是这一个文件,由 _config.butterfly.yml 的 inject.bottom 引入。

1
2
3
4
5
6
7
8
9
10
11
12
function init() {
var root = document.getElementById('archive');
if (!root) return;
if (root.querySelectorAll('.article-sort').length !== 1) return;

var list = root.querySelector('.article-sort');
var items = [].slice.call(list.querySelectorAll('.article-sort-item'));
var cards = items.filter(function (n) { return n.className.indexOf('year') === -1; });
if (!cards.length) return;

root.classList.add('ar-ready');
}
  • 只认 #archive:归档页、按年归档、按月归档都是这个根,分类页 / 标签页不是。
  • items 里混着主题生成的年份标题,过滤掉 year 类名剩下的才是文章卡片。
  • #archive 加上 ar-ready 之后,自定义 CSS 才生效;这就是「渐进增强」,脚本没加载时页面不会坏。

然后把卡片按年份分组,每组生成一个 section.ar-year,里面放一个标题条和一张卡片网格:

文件:[Blogroot]/source/js/archive-page.js | 改法:放在同一个 init() 里,替换按年份分组的循环;建节点建议改用文件里已有的 el(tag, cls, text) 辅助函数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
var grouped = {};
cards.forEach(function (node) {
var y = node.getAttribute('data-year') || '其他';
(grouped[y] = grouped[y] || []).push(node);
});

Object.keys(grouped).sort(function (a, b) { return b - a; }).forEach(function (year) {
var nodes = grouped[year];
var sec = document.createElement('section');
sec.className = 'ar-year';

var label = document.createElement('div');
label.className = 'ar-year-label';
label.innerHTML = '<span class="ar-year-num">' + year + '</span>' +
'<span class="ar-year-count">' + nodes.length + ' 篇</span>';

var grid = document.createElement('div');
grid.className = 'ar-cards';
nodes.forEach(function (n) { grid.appendChild(n); });

sec.appendChild(label);
sec.appendChild(grid);
list.appendChild(sec);
});

卡片网格的样式:

文件:[Blogroot]/source/css/archive-page.css | 改法:追加到文件末尾;已有 .ar-cards 段就替换。归档样式单独放在这个文件里(由 inject.head 引入),不要写到 custom.css。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
#archive.ar-ready .ar-cards {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
gap: 14px;
}

#archive.ar-ready .ar-card {
border: 1px solid color-mix(in srgb, var(--font-color) 10%, transparent);
border-radius: 14px;
background: color-mix(in srgb, var(--card-bg) 76%, transparent);
transition: transform .2s ease, box-shadow .2s ease;
}

#archive.ar-ready .ar-card:hover {
transform: translateY(-2px);
box-shadow: 0 10px 24px -12px rgba(7, 17, 27, .28);
}

主题原来的竖线和圆点要关掉,否则会和新卡片叠在一起:

文件:[Blogroot]/source/css/archive-page.css | 改法:紧接上一段追加,放在归档样式区内;这段是关掉主题原生竖线和圆点,不能漏。

1
2
3
4
5
6
7
8
9
10
#archive.ar-ready .article-sort {
margin: 0;
padding: 0;
border-left: 0;
}

#archive.ar-ready .article-sort-item::before {
content: none;
display: none;
}

如果想在卡片上显示分类和阅读时长,可以在构建期用一个小脚本把文章的元数据写成 JSON 塞进页面(本站是 scripts/archive-index.js 生成 #ar-index)。脚本里读不到这份数据也能正常排版,只是卡片少两个标签,属于可降级项。

归档页:年份吸顶与折叠

卡片铺开以后,滚动时很容易不知道自己在哪一年。给每个年份标题做吸顶,再加一个顶部年份导航,长列表就好翻了。

吸顶本身只需要 position: sticky,难点在偏移量:主题导航栏滚过一定距离后会变成 fixed,高度也会变。所以偏移量不要写死,用 CSS 变量:

文件:[Blogroot]/source/css/archive-page.css | 改法:追加到文件末尾;吸顶、年份导航、折叠三组规则集中在这个文件,别分散到 custom.css。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
#archive.ar-ready {
--ar-nav-h: 0px;
--ar-bar-h: 0px;
}

#archive.ar-ready .ar-year-label {
position: sticky;
top: calc(var(--ar-nav-h) + var(--ar-bar-h) + 8px);
z-index: 3;
padding: 8px 0;
}

#archive.ar-ready .ar-year-label.is-stuck {
border-bottom: 1px solid color-mix(in srgb, var(--theme-color, #49b1f5) 35%, transparent);
}

--ar-nav-h 由 JS 实测导航栏高度写进去,--ar-bar-h 是顶部年份导航条的高度。滚动时用 IntersectionObserver 或滚动位置判断当前年份,给对应的标题加 .is-stuck:

文件:[Blogroot]/source/js/archive-page.js | 改法:整段替换已有的 setActive() 函数;sections 是 { year, label, sec } 数组,由上面的年份分组生成。

1
2
3
4
5
function setActive(year) {
sections.forEach(function (ref) {
ref.label.classList.toggle('is-stuck', ref.year === year);
});
}

折叠按钮放在年份标题右侧,点击给 section 加 collapsed,CSS 负责收起:

文件:[Blogroot]/source/css/archive-page.css | 改法:紧跟上面的吸顶规则追加;.collapsed 由 openSection() 里的折叠按钮切换。

1
2
3
4
5
6
7
8
9
10
11
#archive.ar-ready .ar-year.collapsed .ar-cards {
display: none;
}

#archive.ar-ready .ar-year-toggle svg {
transition: transform .2s ease;
}

#archive.ar-ready .ar-year.collapsed .ar-year-toggle svg {
transform: rotate(-90deg);
}

如果希望刷新后记住哪些年份是收起的,把状态写进 localStorage:

文件:[Blogroot]/source/js/archive-page.js | 改法:替换已有的 readCollapsed() / writeCollapsed() 两个函数(同一处 localStorage 读写),键名 ar-collapsed 保持全文一致。

1
2
3
4
5
6
7
function readCollapsed() {
try { return JSON.parse(localStorage.getItem('ar-collapsed')) || []; } catch (e) { return []; }
}

function writeCollapsed(arr) {
localStorage.setItem('ar-collapsed', JSON.stringify(arr));
}

顶部年份导航条用 position: sticky 挂在年份标题上方,点击跳转时记得留出导航高度的 scroll-margin-top,否则标题会被导航盖住:

文件:[Blogroot]/source/css/archive-page.css | 改法:追加到吸顶规则附近(同属 .ar-year 定位),不要放进媒体查询里。

1
2
3
#archive.ar-ready .ar-year {
scroll-margin-top: calc(var(--ar-nav-h) + var(--ar-bar-h) + 16px);
}

手机端把年份导航的横向滚动条隐藏掉,只留可滑动的手感:

文件:[Blogroot]/source/css/archive-page.css | 改法:追加到文件末尾;这条只隐藏滚动条,滑动手感不变。

1
2
3
4
5
6
7
8
#archive.ar-ready .ar-nav-track {
overflow-x: auto;
scrollbar-width: none;
}

#archive.ar-ready .ar-nav-track::-webkit-scrollbar {
display: none;
}

Twikoo 评论区:跟随主题色的皮肤

Twikoo 的默认样式是灰色系,和站点主题色脱节。做法是准备一份 twikoo.css,所有颜色从 --theme-color 派生,这样在「美化设置」里换主题色,评论区会跟着变,不用重新生成。

变量层:

文件:[Blogroot]/source/css/twikoo.css | 改法:替换文件开头 #twikoo { ... } 的变量层(第 13 行附近);后面的 --tk-accent-faint / --tk-accent-wash / 阴影变量保留,别一起删掉。

1
2
3
4
5
6
7
8
9
#twikoo {
--tk-accent: var(--theme-color, #49b1f5);
--tk-accent-strong: color-mix(in srgb, var(--tk-accent) 62%, #000);
--tk-accent-deep: color-mix(in srgb, var(--tk-accent) 78%, #000);
--tk-accent-soft: color-mix(in srgb, var(--tk-accent) 10%, transparent);
--tk-accent-line: color-mix(in srgb, var(--tk-accent) 30%, transparent);
--tk-radius-card: 14px;
--tk-radius-field: 10px;
}
  • --tk-accent-strong 是「主题色压深」后的文字色。满饱和的主题色放在白底上对比度通常不够,直接用会又亮又糊;压深到 62% 后大约能到 5:1。
  • --tk-accent-deep 给博主回复的气泡用,比普通回复再深一档。
  • 所有透明底都用 color-mix(..., transparent),亮色和暗色模式共用同一套变量。

按钮和计数:

文件:[Blogroot]/source/css/twikoo.css | 改法:追加到变量层之后(按钮与计数规则放一起);这些变量只在本文件定义,别在 custom.css 里重复定义。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
#twikoo .tk-comments-count {
color: var(--tk-accent-strong);
font-variant-numeric: tabular-nums;
}

#twikoo .tk-submit .tk-btn {
border-color: var(--tk-accent);
background: var(--tk-accent);
border-radius: var(--tk-radius-field);
}

#twikoo .tk-submit .tk-btn:hover {
background: var(--tk-accent-deep);
}

博主回复和普通回复要能一眼分开:

文件:[Blogroot]/source/css/twikoo.css | 改法:追加到文件末尾(博主回复样式区);tk-master 是 Twikoo 自己加的类,不需要在页面里手写。

1
2
3
4
5
6
7
8
#twikoo .tk-comment.tk-master .tk-content {
background: var(--tk-accent-soft);
border: 1px solid var(--tk-accent-line);
}

#twikoo .tk-comment.tk-master .tk-avatar {
border: 2px solid var(--tk-accent);
}

暗色模式单独处理一遍文字和图标,避免在深底上继续用压深色:

文件:[Blogroot]/source/css/twikoo.css | 改法:追加到文件末尾;暗色覆盖统一放最后,靠 [data-theme="dark"] 提权,别塞进 @media (prefers-color-scheme)。

1
2
3
4
5
6
7
8
9
[data-theme="dark"] #twikoo .tk-comments-count {
color: color-mix(in srgb, var(--tk-accent) 55%, #fff);
}

[data-theme="dark"] #twikoo .tk-comments-actions .tk-icon,
[data-theme="dark"] #twikoo .tk-comments-actions .tk-icon svg {
color: color-mix(in srgb, var(--tk-accent) 55%, #fff);
stroke: color-mix(in srgb, var(--tk-accent) 55%, #fff);
}

最后在 _config.butterfly.yml 的 inject.head 引入:

文件:[Blogroot]/_config.butterfly.yml | 改法:加到 inject.head 列表里作为一项(与其它 <link> 同级缩进);已有 /css/twikoo.css 这行就只升 ?v= 版本号,不要添加第二行。

1
2
3
inject:
head:
- <link rel="stylesheet" href="/css/twikoo.css?v=1">

选择器统一用 #twikoo 提权,因为 Twikoo 运行时会向页面注入自己的样式,同权重时谁后加载谁生效,加一个 id 最稳。

评论区标题与操作图标的间距

Twikoo 的评论表单下面紧跟「评论总数 + 搜索 / 刷新 / 齿轮」这一排,默认两者之间没有间距,三个图标几乎贴着输入框。这是纯视觉问题,加一条上边距就行:

文件:[Blogroot]/source/css/twikoo.css | 改法:替换已有的 #twikoo .tk-comments-title 规则(第 45 行附近);只想改间距就只动 margin-top,字号那两行可以不写。

1
2
3
4
5
#twikoo .tk-comments-title {
margin-top: 26px;
font-size: 1.15rem;
letter-spacing: 0.01em;
}

26px 是实测值:桌面端和手机端都能拉开,又不会把评论区切得太散。顺手把标题字号从默认值提到 1.15rem,和文章小标题的层级对齐。

如果只想让间距生效、不想动字号,单独留 margin-top 即可。改完记得升 twikoo.css 的 ?v= 版本号,否则浏览器会继续用旧缓存。

让新模块跟着「美化设置」换色

前面几节的样式之所以能跟着主题色变,是因为遵守了同一条约定:颜色只从 CSS 变量派生,不写死十六进制。

基础色来自美化面板写入的 --theme-color,所有模块都用它做兜底:

说明:示意内容,不需要单独建文件。这是约定示例:实际使用时把它写在对应模块自己的选择器里(比如 #twikoo { --accent: ... }、#archive.ar-ready { --ar-... }),不要裸放在 CSS 顶层。

1
--accent: var(--theme-color, #49b1f5);

浅底、边框、阴影这类派生色统一用 color-mix() 算,不另外维护一份色板:

说明:示意内容,不需要修改。演示派生色怎么算,落地时把它们写进 custom.css / twikoo.css / archive-page.css 里对应模块的选择器中。

1
2
3
--accent-soft: color-mix(in srgb, var(--accent) 10%, transparent);
--accent-line: color-mix(in srgb, var(--accent) 30%, transparent);
--accent-strong: color-mix(in srgb, var(--accent) 62%, #000);

需要注意三件事:

  1. 文字对比度:主题色只用于图标、边框、强调数字。正文和标题不要直接用满饱和的主题色,压深或用主题自带的 --font-color。
  2. 暗色模式:[data-theme="dark"] 下要把压深色换成提亮色(主题色混白),否则深底上会看不清。
  3. color-mix 兼容性:现代浏览器都支持;如果站点要兼容很老的浏览器,给每个变量先写一个普通色值兜底,再写 color-mix 覆盖。

新模块挂进来之前,先检查它有没有写死颜色。比如归档卡片的背景用的是 color-mix(in srgb, var(--card-bg) 76%, transparent),所以美化面板调整卡片透明度时,归档卡片会一起变;如果写成 #fff,就永远是白色。

改完怎么验证与部署

十节的改动分别落在 source/link/、source/about/ 两个页面,source/css/ 下的 custom.css、twikoo.css、archive-page.css,source/js/ 下的几个脚本,以及 _config.yml / _config.butterfly.yml。按下面五步走一遍再上传:

  1. 生成:在博客根目录执行 hexo generate(也可以 npm run build)。最后一行是 Generated 才算通过;改过 scripts/ 下的构建脚本必须重新生成,否则构建期过滤器不生效。
  2. 本地预览:执行 hexo server,打开 http://localhost:4000。重点看 /link/ 的三个格式标签页与两个复制按钮、/about/ 的名片卡与线路检测面板、/archives/ 的年份网格与吸顶、文章页评论区配色。
  3. 强制刷新或清缓存:Ctrl + F5 硬刷新;如果开过 Service Worker,再到 F12 → Application → Service Workers 点 Update 或 Unregister,否则 custom.css、twikoo.css、archive-page.css 仍是缓存里的旧文件。改过 CSS 记得同步升 _config.butterfly.yml 里的 ?v= 版本号。
  4. F12 检查 404:Console 不能有 404 或 Uncaught;Network 里确认 link-apply.js、about-page.js、archive-page.js、atom.xml 都是 200。打开 /atom.xml 能显示且是合法 XML,说明订阅源和 BOM 都正常。
  5. 部署:把 public/ 按原来的托管方式上线——Nginx 覆盖站点根目录、GitHub Pages 推 gh-pages 分支、Vercel 重新部署,或 hexo deploy(_config.yml 里配了 deploy 才可用)。上线后关掉浏览器缓存再访问一次,确认线上和本地一致。

这篇把第 41 ~ 50 个魔改写完了。下一篇继续按「每 10 ~ 20 个魔改一篇」的节奏,新内容会单独开《hexo魔改教程(五)》,本篇不再追加。