静态站点可在CI增加PostBuild环节，进行图片压缩、CSS/JS 压缩合并等流程,以优化网站性能表现。本文主要记录使用ESBuild & minify-html编写PostBuild脚本，实现以下目标：

• 构建尽量快
• 压缩器能识别现代CSS/JS 语法
• 满足以上前提下，尽可能压缩产物体积
• 在CSS/JS文件名中添加Hash后缀，避免缓存版本混乱问题

bun link^[1]可以极大简化调试Library/Blog主题的工作，通过将本地库链接到项目中，避免频繁发布和安装包的繁琐过程。

Shiki提供比 highlight.js 更准确的代码高亮效果；以 console.log("hello") 为例，Shiki 高亮器按语义将其拆分为 6 个 <span> 元素，并为其添加内联样式（e.g. color，font-style and CSS 变量^[1]），以实现颜色^[2]以及字体^[3]的多主题适配

const code = await codeToHtml('console.log("hello")', {  lang: "javascript",  themes: { light: "min-light", dark: "nord" },});

<code>  <span class="line">    <span style="color:#1976D2;--shiki-dark:#D8DEE9">console</span>    <span style="color:#6F42C1;--shiki-dark:#ECEFF4">.</span>    <span style="color:#6F42C1;--shiki-dark:#88C0D0">log</span>    <span style="color:#24292EFF;--shiki-dark:#D8DEE9FF">(</span>    <span style="color:#22863A;--shiki-dark:#ECEFF4">"</span>    <span style="color:#22863A;--shiki-dark:#A3BE8C">hello</span>    <span style="color:#22863A;--shiki-dark:#ECEFF4">"</span>    <span style="color:#24292EFF;--shiki-dark:#D8DEE9FF">)</span>  </span></code>

<code>  <span class="line">    <span class="_sk_p7ztx5">console</span>    <span class="_sk_8gyisu">.</span>    <span class="_sk_18gpmt">log</span>    <span class="_sk_23aifj space">(</span>    <span class="_sk_23aifj">"</span>    <span class="_sk_8gyisu">hello</span>    <span class="_sk_18gpmt">""</span>    <span class="_sk_p7ztx5 space">)</span>  </span></code>

上面的示例输出中，HTML 体积尚可接受，一是代码量很小，此外是仅应用了 min-light 和 nord 两种主题，且这两个主题仅在实例代码中嵌入了 color 属性以及 --shiki-dark 变量；

当这些条件不满足时，输出的 HTML 体积会大幅增加。例如个人博客中包含一些长代码片段，同时应用了 catppuccin-latte, catppuccin-mocha, tokyo-night, nord, tokyo-night 5 种主题，输出的 HTML 就略显臃肿；下文将记录如何使用 styleToClass Transformer 来优化 Shiki 高亮器的输出。

于25/11/20和25/11/21期间开发了 markdown-it-inline-code 项目，用于高亮行内代码。本文包括效果预览，使用方法，以及部分开发历程。

先展示一下预览效果

- **Plain**: `printf("Hello, World")`- **Python**: `{python} print("Hello, World")`- **JavaScript**: `{javascript} console.log("Hello, World")`- **HTML**: `{html} <h1>Hello, World!</h1>`- **Rust** `{rust} fn main() { println!("Hello, World!"); }`- **Shell**: `{shell} echo "Hello, World!"`

本文介绍如何利用 CSS 变量（Variables）与 :where 选择器实现博客多主题管理，包括个人处理 Shiki 代码高亮主题切换、页面闪烁（FOUC）的方案

最近写markdown比较爱用footnote^[1]，点击后可在网页中使用跳转。

Here's a simple footnote,[^1] and here's a longer one.[^bignote][^1]: This is the first footnote.[^bignote]: Here's one with multiple paragraphs and code.    Indent paragraphs to include them in the footnote.    `{ my code }`    Add as many paragraphs as you like.

但默认行为并不友好。跳转后内容经常被博客顶部的固定导航栏遮挡住，无法看到跳转后的内容。本文记录优化方案

在 macOS 上使用 Sketchybar 进行状态栏自定义时，可以使用 FelixKratz/SbarLua 提供的API与SketchyBar进行交互:

local wifi = SBAR.add("wifi", "item")wifi:set({ label = "My Wife" })

但该模块由 C 编写，编译后是二进制文件 sketchybar.so，Lua 语言服务器(Lua LS) 无法像读取Lua文件那样对其分析，因此无法其提供的API进行补全，类型提示

本文记录如何让IDE支持识别 Sketchybar 模块的类型，适用于 VSCode,Neovim,JetBrains IDEs