最近将博客从 Hugo 迁移到了 Astro，并选择了 astro-lhasa 做为博客主题，我还对该主题做了一些修改（修改后的主题在 zhijunio/astro-lhasa ）。此文主要记录修改了哪些内容，方便以后查询。

如何统计

为了和 achuanya/astro-lhasa 做对比总结修改了哪些内容，我实际执行过的命令是这些：

  1. 看本仓库的远程和分支
cd astro-lhasa && git remote -v && git branch -a && git status --short
  1. 看最近几次提交
git log --oneline -5
  1. 添加上游并拉取
git remote add upstream https://github.com/achuanya/astro-lhasa.git 2>/dev/null
git fetch upstream main 2>&1
  1. 和上游的差异统计（文件与行数）
git diff upstream/main --stat
  1. 和上游的差异文件列表（含 A/M/D 状态）
git diff upstream/main --name-status
  1. 看几个关键文件的 diff
git diff upstream/main -- src/content.config.ts | head -120
git diff upstream/main -- src/config.ts | head -150
git diff upstream/main -- astro.config.ts | head -80
git diff upstream/main -- src/utils/getPath.ts | head -100
git diff upstream/main -- src/pages/rss.xml.ts | head -80
git diff upstream/main --stat -- src/layouts/PostDetails.astro src/components/Header.astro
  1. 确认当前页面结构
find src/pages -name "*.astro" -o -name "*.ts" -o -name "*.md" 2>/dev/null | sort
ls -la src/pages/posts 2>/dev/null || echo "No posts dir"

主题修改汇总

与上游 achuanya/astro-lhasa 对比后的主题修改汇总（基于 git diff upstream/main）。

一、内容与路由

1. 文章存放位置

  • 上游：文章在项目根目录 posts/ 下，按子目录分类（如 posts/life/、posts/technology/）。
  • 当前：改为 Astro Content Collections，长文在 content/posts/tech/，周回顾在 content/posts/review/（原 weekly/）；集合仍命名为 posts。

2. 文章 URL 格式

  • 上游：路径为 /posts/分类/slug（目录结构即 URL）。
  • 当前：统一为 /posts/{slug}（由 frontmatter slug 决定）。旧式 /posts/YYYY/MM/DD/slug 与 /briefs/* 经 public/_redirects 301 到 /posts/{slug}。

3. 分类与列表

  • 上游：使用 config.ts 中的 categoryOrder 对分类排序，并有独立分类页。
  • 当前（2026 极简）：已移除分类页与 Card 列表；首页混排博客/周报，/posts 仅长文；工具逻辑集中在 src/utils/postUtils.ts。

4. 已删除的页面与功能

  • 删除页面：
    • src/pages/feeds/index.astro（订阅/Feeds 页）
    • src/pages/guestbook.astro（留言板）
    • src/pages/about.md、src/pages/favorites.md（原 Markdown 页面）
  • 新增/迁移：
    • 关于：src/pages/about.astro 读取 content/about.md 渲染。
  • 配置：移除 feedsPerIndex、feedsPerPage 等 Feeds 相关配置。

5. 新增页面与资源

  • src/pages/running.astro：跑步/数据页，使用 public/data/running.json。
  • content/pages/about.md：关于的正文内容。
  • public/_headers：自定义响应头（如部署用）。
  • public/data/running.json：跑步数据。

二、配置与构建

1. 站点与作者信息（src/config.ts）

  • website：https://blog.lhasa.icu → https://blog.zhijun.io
  • author：lhasa → zhijunio
  • profile：https://github.com/achuanya → https://github.com/zhijunio
  • title：游钓四方 → ZhiJun Blog
  • description：改为技术向描述（Java、Spring、MicroServices 等）。
  • timezone：Asia/Taipei → Asia/Shanghai
  • icp：移除备案号（设为空字符串）。
  • postPerIndex：10 → 8。
  • genDescriptionMaxLines：30 → 3。
  • Stats 链接：指向 stats.zhijun.io/blog.zhijun.io。
  • imageConfig：当前使用 CDN_ORIGIN（https://cos.zhijun.io）作为图片 CDN；生产环境 /images/ 走 CDN，开发环境同源。
  • 移除：displayOptions（如评论数等）、Feeds 相关配置。

2. Astro 与集成（astro.config.ts）

  • 图片与构建：
    • 新增 astro-mermaid：支持 Mermaid 图表（mermaid frontmatter）。
    • 新增 @critters-rs/astro：关键 CSS 内联。
    • minify：启用 CSS minify 并开启 errorRecovery: true。
  • Expressive Code：
    • wrap：false → true。
    • overridesByLang 增加 gradle,java 的 frame: "none"。
  • Vite：当前 optimizeDeps.include 主要保留 mermaid、dayjs、lodash.kebabcase、markdown-it 等实际使用项。

3. 内容 Schema（src/content.config.ts）

  • 路径：glob 匹配 content/posts/**/*.{md,mdx}（tech/、review/ 等子目录仅分类）。
  • frontmatter：含 slug（必填）、mermaid、math 等；URL 与 public/images/{slug}/ 配图目录一致。

4. 依赖与脚本（package.json、pnpm-lock.yaml）

  • 依赖变更与上述集成一致（如 mermaid、critters 等加入）；pnpm-lock.yaml 有大量变更。

三、布局与组件

1. 文章详情（PostDetails.astro）

  • 文章标题与发布日期移出 <main>，放在 Header 与 main 之间的独立 <section>。
  • 其余结构（正文、标签、上一篇/下一篇、评论）保留在 main 内。

2. 主布局（Layout.astro）

  • 结构、样式或脚本有调整（约 176 行变更），与上述页面和配置变更一致。

3. 组件

  • Header.astro、Footer.astro、YearProgress.astro：导航、页脚与年度进度。
  • 已移除：Card.astro、Tag.astro、Artalk；评论改为 Giscus（PostDetails.astro）。

四、样式

1. 正文排版（src/styles/typography.css）

  • h3：移除 prose-h3:italic，h3 不再斜体。
  • 标题颜色：移除 prose-headings:!text-accent，h1–h6 不单独设 color，继承正文颜色。
  • 行高：.prose 增加 !leading-relaxed，增大行间距。

2. 全局样式（src/styles/global.css）

  • 约 105 行变更，与布局、侧边栏、TOC、代码块等样式相关。

3. 字体（src/styles/fonts.css）

  • 小范围调整（约 3 行）。

五、RSS 与工具函数

1. RSS（src/pages/rss.xml.ts）

  • 内容：输出摘要（优先 <!-- more --> 前内容，否则正文提要），使用 getDescription(body)。
  • 实现：使用 @astrojs/rss + PostUtils；pubDate 为 data.date；link 为 /posts/{slug}。
  • 条数：最近 10 篇；排除 draft 与未到发布时间的内容。

2. 工具函数

  • src/utils/postUtils.ts：文章过滤/排序、getPath、摘要、getAllBlogLike、ArticleTime、LLMs 文案等。
  • src/utils/blogImages/：配图目录注入、CDN URL、rehype 懒加载等。

六、删除的仓库级文件与内容

  • .github：删除 CODE_OF_CONDUCT、CONTRIBUTING、FUNDING、ISSUE_TEMPLATE、PULL_REQUEST_TEMPLATE；保留并修改了 workflows/ci.yml。
  • .claude：删除 settings.local.json。
  • .mcp.json：删除。
  • docs：删除 redirect.conf、reverse-proxy.conf。
  • posts/：删除上游全部示例/原博客文章（约 120+ 篇，含 life、technology、outdoors、photo、book、startup、annual-reviews 等），当前博客内容在 content/posts/tech/ 与 content/posts/review/。
  • public：删除 feeds.js、dev.svg、astro-lhasa-lighthouse-score.svg、astro-lhasa-v1-thumbnail.svg、 assets/forrest-gump-quote.webp；修改 favicon、apple-touch-icon、_redirects、lazy-list.js、tocbot、toggle-theme.js 等。

总结

总结一下，我的 zhijunio/astro-lhasa 主题，对原主题做了以下改动：

  • 删除订阅、留言、日志等页面；收藏页面改为链接页面
  • 修改 css 样式，以适应宽屏（web 端，主体部分 960px）；修改文章主题色为蓝色；代码库支持自动换行；调整了导航菜单
  • RSS 保留最近 10 篇非草稿文章；仅输出摘要
  • 文章链接为 /posts/{slug} 格式（旧 dated URL 重定向保留）
  • 首页默认 10 条，客户端分页加载更多
  • 添加对 Mermaid 图表 的支持
  • 参考zdyxry.github.io ，添加跑步页面（该页面样式同样做了一些调整）。跑步数据使用 get_keep_data.py 从 Keep 读取跑步数据并生成与 Garmin 脚本兼容的 running.json。