TimeCrackbot/NewBlog
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
38 Commits 1 Branch 0 Tags
26e873b9f63eb78a4097fd941490c49d12fe70df
Commit Graph
5 Commits
Author SHA1 Message Date
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