这十节分别改哪里
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 , 1 fr)); 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 , 1 fr)); } #body-wrap .type-about #article-container .hg-about-sns { display : grid; grid-template-columns : 34px minmax (0 , 1 fr); 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 ) { });
?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 , 1 fr)); 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 , 1 fr)); gap : 8px ; } @media screen and (max-width : 768px ) { #body-wrap .type-about #article-container .hg-check-blocks { grid-template-columns : 1 fr; } #body-wrap .type-about #article-container .hg-local-grid { grid-template-columns : repeat (2 , minmax (0 , 1 fr)); } }
这个面板会发起对本站的请求,也会读取浏览器本机参数。上线前记得同步改隐私政策:写清楚只探测本站自己的入口、不向第三方发送数据;本机参数只在浏览器里计算和展示,不上传、不存储。别人访问你的站点时,这些探测请求也会进入服务器访问日志,隐私政策里的日志条款需要涵盖。
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 , 1 fr)); 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 );
需要注意三件事:
文字对比度 :主题色只用于图标、边框、强调数字。正文和标题不要直接用满饱和的主题色,压深或用主题自带的 --font-color。
暗色模式 :[data-theme="dark"] 下要把压深色换成提亮色(主题色混白),否则深底上会看不清。
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。按下面五步走一遍再上传:
生成 :在博客根目录执行 hexo generate(也可以 npm run build)。最后一行是 Generated 才算通过;改过 scripts/ 下的构建脚本必须重新生成,否则构建期过滤器不生效。
本地预览 :执行 hexo server,打开 http://localhost:4000。重点看 /link/ 的三个格式标签页与两个复制按钮、/about/ 的名片卡与线路检测面板、/archives/ 的年份网格与吸顶、文章页评论区配色。
强制刷新或清缓存 :Ctrl + F5 硬刷新;如果开过 Service Worker,再到 F12 → Application → Service Workers 点 Update 或 Unregister,否则 custom.css、twikoo.css、archive-page.css 仍是缓存里的旧文件。改过 CSS 记得同步升 _config.butterfly.yml 里的 ?v= 版本号。
F12 检查 404 :Console 不能有 404 或 Uncaught;Network 里确认 link-apply.js、about-page.js、archive-page.js、atom.xml 都是 200。打开 /atom.xml 能显示且是合法 XML,说明订阅源和 BOM 都正常。
部署 :把 public/ 按原来的托管方式上线——Nginx 覆盖站点根目录、GitHub Pages 推 gh-pages 分支、Vercel 重新部署,或 hexo deploy(_config.yml 里配了 deploy 才可用)。上线后关掉浏览器缓存再访问一次,确认线上和本地一致。
这篇把第 41 ~ 50 个魔改写完了。下一篇继续按「每 10 ~ 20 个魔改一篇」的节奏,新内容会单独开《hexo魔改教程(五)》,本篇不再追加。