astro-theme-typefolio — Astro 作品集模板

Typefolio 是一个以内容为先的 Astro 个人站点模板，目标用户是研究者、开发者和技术写作者。它没有做成产品化的重型外壳，而是保留长文阅读、新闻时间线、轻量项目展示和相册这几条发布路径，其余部分做了减法。技术栈为 Astro 5、Tailwind CSS 4、TypeScript 5，包管理使用 pnpm workspace，内容通过 Astro Content Collections 管理 Markdown 与 MDX。

写作侧的能力比较完整：TL;DR 摘要块、KaTeX 数学公式、自动反向链接、Admonitions 卡片、Expressive Code 代码块、GitHub 卡片，以及基于 Giscus 的评论。站点层面自带 RSS、sitemap、robots.txt、web manifest、Satori 生成 OG 图，并用 Pagefind 做静态搜索。相册以目录形式组织，索引页按横向图片轨道展示，支持本地图片优化和 GLightbox 查看大图。另有中英文本地字体、pangu 自动处理中英文间距，以及用于研究、写作、发布和项目动态的新闻时间线。

需要留意的是，搜索索引依赖先执行 pnpm build 再执行 pnpm blogbuild，开发服务器下不会反映真实搜索行为；Giscus 需要自行准备公开仓库、开启 Discussions 并安装应用，否则评论不可用。README 的 TODO 中仍列出 OG 图优化、图标管线、搜索样式、新闻页面和 Typst 简历生成等未完成项，说明部分能力尚在演进。上线前应核对 siteConfig.url、站点元信息、字体资源与许可证状态。