TimeCrackbot/NewBlog
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
46 Commits 1 Branch 0 Tags
e174138bbfb35a28e38f5ef9476e73406e89db6b
Commit Graph
7 Commits
Author SHA1 Message Date
TimeCrackbot f4a49ef94c feat: 支持 Obsidian 风格 callout，并把脚注文案中文化 
Callout
- 接入 satteri-callouts（HAST 插件），用 Obsidian 语法：
    > [!tip] 标题
    > 内容
    > [!warning]- 默认折叠
  类型名大小写不敏感，支持嵌套、可折叠、标题内联 Markdown。
- 样式没有用它自带的主题 CSS（Obsidian 原版是高饱和蓝/青/紫，还靠
  mix-blend-mode 叠底色，在暖纸底上会发脏），改为新建 src/styles/callouts.css，
  复用主题已有的 --admonitions-color-* token，与 .admonition（免责声明块）
  统一成「3px 左边框 + 彩色标题、无底色」。
- 类型映射：tip/hint→tip，note/info/todo/abstract/summary/tldr→note，
  important/example→important，warning/attention/question/help/faq→warning，
  caution→caution，success/check/done→（新增的）success，
  danger/error/failure/fail/missing/bug→destructive，quote/cite→muted-foreground。
- global.css 补一个 --admonitions-color-success（浅色 oklch(0.62 0.16 150) /
  深色 oklch(0.7 0.18 150)），与 tip(180)/note(250)/important(310) 同明度彩度。

脚注中文化
features.gfm.footnotes 设 label「脚注」、backLabel「返回第 {reference} 条」、
backContent「↑」，替换默认的 Footnotes / Back to reference。

正文
- 周末愉快.md：`::: tip 下周计划`（冒号后有空格，从来不是合法指令，
  一直渲染成普通段落）改成 `> [!tip] 下周计划`，任务列表一并加 `>` 前缀。
- 关于价值感和归属感的思考.md 的 `> [!tip] Tip` 本来就合法，一行未改，
  现在自动变成真 callout。

顺带修
autolink-headings 不再给脚注区那个 sr-only 的「脚注」标题加 # 锚点。

验证
- 两处 callout 均正确渲染；callout 内的图片仍带 data-lightbox-src
  （说明 imageLightbox 与 satteriCallouts 的执行顺序没问题）。
- 临时加了一篇带脚注和折叠 callout 的文章验证：脚注文案、返回链接、
  折叠态 <details>/<summary> 结构都正确，验证后已删除。
- 整页对比基线：37/41 一致，4 处差异中 2 处是本次有意的 callout 生效，
  另 2 处是已知的智能标点引号方向（Sätteri 的结果更正确）。
- pnpm build 41 页 + pagefind 通过。
 2026-09-17 18:01:44 +08:00
TimeCrackbot 5e808a9cd4 feat: 接入 KaTeX 渲染，完成 Sätteri 迁移（Phase 3） 
方案：用现成的 satteri-katex（MDAST 插件，40 行，是 rehype-katex 的移植），
而不是自己写。它跑在 MDAST 阶段，天然绕开下面这个坑。

为什么不能用 HAST 阶段做
Sätteri 把块级公式输出成 <pre><code class="language-math math-display">，
而 expressive-code 过滤所有 <pre>，会把它当成未知语言渲染成带行号的
plaintext 代码块 —— 实测 10 个块级公式全部被吃掉（math-display: 0）。
unified 时期没这问题，是因为 rehype-katex 排在 rehypePlugins 第一位，
先把 <pre><code> 换掉了。satteri-katex 的源码注释里记录的是同一个坑。

插件顺序
satteriKatex() 放在 mdastPlugins 最后：它把 math 节点换成 KaTeX 的 html
节点，若排在 reading-time / excerpt 之前，字数统计会把 KaTeX 标记也算进去。

顺带修掉一个之前漏掉的回归
reading-time / excerpt 原本用 ctx.textContent()，但它只拼接纯 text 节点，
会漏掉代码块、行内代码、公式、图片 alt。实测 LaTeX 那篇字数 830 → 488。
改用 mdast-util-to-string 的 toString()（与迁移前的实现一致），字数完全复原。
之前没发现是因为我的对比脚本只截取了 <article> 区域，而字数在它外面的 header 里。
现改为整页对比。

清理依赖（10 个，已确认无引用）
remark-math / rehype-katex / remark-directive /
remark-github-admonitions-to-directives / remark-sectionize / rehype-slug /
rehype-components / rehype-autolink-headings / @astrojs/markdown-remark /
hastscript / unist-util-visit

验证（与 unified() 基线整页对比，41 页）
- 39 页语义完全一致；2 页只剩智能标点在中文/emoji 旁的引号方向差异
  （Sätteri 的结果更正确：把开引号排成 “ 而不是 ”）。
- LaTeX 页：class="katex" 76、katex-display 10，与基线完全一致；
  块级公式不再被 expressive-code 吞掉。
- 字数/阅读时长与基线逐篇一致（830/4、1042/5、416/2）。
- pnpm build 41 页 + pagefind 通过；astro check 仍是 1 error/0 warnings
  （原有 footer.astro 报错，与本次无关）。
 2026-09-17 17:52:56 +08:00
TimeCrackbot 26e873b9f6 refactor: Markdown 管线迁移到 Sätteri（Phase 1 + Phase 2） 
把 markdown.processor 从 unified() 换成 Astro 7 的默认管线 satteri()，
并把原来 12 个 remark/rehype 插件逐一移植到 Sätteri 的 MDAST/HAST 插件模型。

内置能力直接替代（零代码）
- remark-math      → features.math
- remark-directive → 未启用（见下）
- rehype-slug      → satteriHeadingIdsPlugin()

新增 src/plugins/satteri/（6 个插件，约 200 行）
- reading-time.mjs    after 钩子写 ctx.data.astro.frontmatter.minutes/words
- excerpt.mjs         取第一段写 frontmatter.excerpt
- shift-headings.mjs  工厂按 fileURL 判断，只对 posts 下的文章生效
- sectionize.mjs      remark-sectionize 的等价实现（递归分组 + data.hName）
- autolink-headings.mjs  标题锚点，输出与 rehype-autolink-headings 逐字一致
- image-lightbox.mjs  上一版 rehype 图片灯箱的 HAST 版

删除（已迁移或本就无效）
- remark-reading-time / remark-excerpt / remark-shift-headings /
  remark-directive-rehype / rehype-component-admonition /
  rehype-image-lightbox —— 共 6 个旧插件文件
- 未启用 features.directive：内容里的 `::: tip`（冒号后有空格）和
  `> [!tip] Tip` 在迁移前后都渲染成普通段落/引用，属于死语法；
  保持现状以免升级顺手把它激活。

行为对齐
- smartPunctuation: { dashes: false } —— Astro 的 unified 管线会把直引号
  排成弯引号但不转换 ---，Sätteri 默认会转，显式关掉 dashes 才能逐字一致。

验证（与 unified() 构建逐页对比，41 页）
- 正文 HTML 完全一致 35 页；把 HTML 实体和表格对齐写法归一化后，
  只剩 3 页有差异：1 页是 KaTeX 尚未迁移（见下），2 页是中文/emoji 旁的
  引号方向（Sätteri 的结果更正确）。
- meta description 仍由 excerpt 正确生成；阅读时长与基线一致。
- astro check：1 error / 0 warnings，与迁移前完全相同（原有 footer.astro 报错）。
- pnpm build 41 页通过；dev server 正常。

尚未迁移
- KaTeX：Sätteri 的 math 只负责解析，不渲染。数学公式目前落成
  <code class="language-math">，是可见的回归，Phase 3 处理。
- package.json 里 remark-*/rehype-* 依赖暂未清理，等 Phase 3 确定后再收。
 2026-09-17 17:38:37 +08:00
TimeCrackbot c1643ae95d feat: 文章正文图片支持灯箱；删除未使用的 GitHub Card 插件 
灯箱
- 相册页原本已有一套无依赖灯箱（事件委托 + ClientRouter 友好），
  但它写在 gallery/[album].astro 里，只有相册页能用。
  现抽成 src/components/ImageLightbox.astro，挂到 BaseLayout，全站可用。
- 新增 src/plugins/rehype-image-lightbox.mjs：给正文里的 <img> 注入
  data-lightbox-src。跳过链接内的图片（点击应跳转）和显式标记
  data-lightbox-ignore 的图片。
- 顺带让灯箱大图继承原图的 alt 文本（原先固定为空）。
- 正文图片加 cursor: zoom-in 提示。

清理
- 删除 src/plugins/rehype-component-github-card.mjs（165 行）及其在
  rehypeComponents 里的 github 映射：内容里从未使用过 ::github 指令。

验证：构建 41 页通过；文章页正文图片 4/4 带上 data-lightbox-src，
相册页 5 个触发元素不受影响；灯箱脚本按页内联（2.8KB 压缩后）；
正文渲染文本与线上基线一致，无回归。
 2026-09-17 17:29:23 +08:00
TimeCrackbot 738fe3175e chore: 升级 Astro 5.16.5 → 7.3.3 
依赖
- astro 5 → 7.3.3，@astrojs/{mdx,react,rss,sitemap,check}、astro-expressive-code
  与 @swup/astro 同步升到最新
- 新增 @astrojs/markdown-remark（Astro 7 默认改用 Sätteri 处理器，
  本项目依赖大量 remark/rehype 插件，故显式固定回 unified 管线）

内容集合迁移到 Content Layer API（Astro 6 已移除旧 API）
- src/content/config.ts → src/content.config.ts，三个集合改用 glob() loader
- z 改从 astro/zod 导入
- 所有 entry.slug → entry.id；entry.render() → render(entry)

Astro 7 兼容
- 修复 bookshelf-content.astro 里多行 {/* */} 注释导致的 Rust 编译器
  "Unterminated regular expression"
- 删除该文件里一处多余的 </div>（旧 Go 编译器会静默纠正，新编译器不会）
- global.css: @import "tailwindcss" → "tailwindcss/index.css"
  （Vite 8 不再解析裸包名的 style 条件）
- astro.config.mjs 显式设置 compressHTML: true，保持 v6 的空白处理行为

验证：构建 41 页通过；与线上（Astro 5 构建）对比 39 个 URL 无一丢失，
仅新增新文章 DIY-computer 的 2 个 URL；逐页渲染文本与线上一致；
pnpm build 与 dev server 均正常。
 2026-09-17 17:14:08 +08:00
dsh 9c0851fd12 修复 pnpm dev 启动刷红：Sketch.astro 脚本误识别 + .pnpm-store 撑爆 inotify 
两个独立问题叠在一起，用户看到的只是第一个（扫描失败会中止启动，
第二个来不及暴露）。

1) Sketch.astro 的 frontmatter 里出现字面量的 script 开标签
   Astro 编译器靠扫描源码文本收集内联脚本，分不清真标签和字符串/注释。
   原代码用模板字符串拼 iframe 里的 resize 脚本，那个字面量开标签被当成
   组件脚本抽出来交给 Vite，里面的 ${JSON.stringify(...)} 直接报
   `Expected "}" but found "{"`，dev 依赖扫描失败、整个 /src 刷红。
   -> 改成 "\x3Cscript>" / "\x3C/script>" 拼接。
   注意闭标签原本写作 <\/script> 所以没被误判，只有开标签要处理。
   修完第一版又把解释写进注释、注释里带了字面量开标签，于是换了条错误
   （`Unexpected "。"`）继续报；这次注释也改成不带字面量的写法。

2) .pnpm-store 被 Vite 的 watcher 一起监听
   项目根目录下的 .pnpm-store 是 pnpm 内容寻址仓库（54269 个文件 / 672MB，
   已被 .gitignore 忽略），Vite 默认 watch 项目根，直接撑爆 inotify
   （max_user_watches = 65536），启动后无限刷
   `ENOSPC: System limit for number of file watchers reached`。
   -> astro.config.mjs 加 vite.server.watch.ignored: ["**/.pnpm-store/**"]。

顺带：package.json 加 "type": "module"，消掉 Node 对
src/plugins/*.js 的 MODULE_TYPELESS_PACKAGE_JSON 警告（两个文件本来就是 ESM）。

验证
- 删掉 node_modules/.vite 强制重新做依赖扫描后启动 pnpm dev：
  ERROR 0 / Failed to scan 0 / ENOSPC 0，ready in 496ms
  /、/bookshelf/、/bookshelf/books/ 均 200
- pnpm build 退出码 0，MODULE_TYPELESS 警告 0
- 仅剩 [WARN] glob-loader 提示 src/content/studies 为空，属预期
- 操作指南补了这条 FAQ，说明两个原因和"注释里也不能写"这个坑
 2026-09-15 12:22:44 +08:00
dsh 6f4cc13a20 初始提交：时之刃的小站 
基于 VermilionVoid（朱墨留白）主题的个人博客。
- 站点配置集中在 src/data/site.ts 与 src/data/profile.ts
- 30 篇文章、8 条偶得、相册
- 评论使用自托管 twikoo
- 部署走 deploy.sh（rsync 到树莓派 + 云服务器）
 2026-09-14 20:44:12 +08:00