Astro博客

BlogPage — Astro 博客模板

作者 Vncntvx

基于 AstroPaper 深度定制的 Astro 博客主题，面向中英双语写作，内置中文社交平台、Giscus 评论、KaTeX 数学排版与 Pagefind 站内搜索。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图

桌面端首页1 / 2

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-11查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 [lang] 路由的中英双语 i18n 系统，翻译文案以 YAML 文件维护

内置知乎、微博、B站、掘金、CSDN 等中文平台图标与微博、QQ、微信分享入口

支持 KaTeX 数学公式渲染与包含 CJK 字符的阅读时间估算

集成 Giscus（GitHub Discussions）评论与 Pagefind 静态全文搜索

使用 satori 与 @resvg/resvg-js 为文章生成动态 OG 分享图

文章底部可选 CC 版权卡片，内容集合 schema 定义在 content.config.ts

模板详细介绍

BlogPage 是 Wenjie Xu 的个人博客仓库，基于 AstroPaper 模板深度定制，使用 Astro 构建，样式采用 Tailwind CSS，评论组件使用 React。站点通过 [lang] 动态路由实现中英双语，文章分别放在 src/data/blog/en 与 src/data/blog/zh 下，界面文案由 src/data/i18n 中的 YAML 翻译文件提供，并支持手动切换语言。

内容能力方面，主题内置 KaTeX 数学公式渲染（remark-math + rehype-katex）、支持 CJK 字符的阅读时间估算、文章底部可选的 CC 版权卡片、基于 satori 与 @resvg/resvg-js 的动态 OG 图片生成，以及 Pagefind 静态全文搜索。评论使用基于 GitHub Discussions 的 Giscus。社交与分享针对中文平台做了适配，包括知乎、微博、B站、掘金、CSDN 等图标，以及分享到微博、QQ、微信的入口。

使用限制：仓库是作者个人博客的定制版本，站点信息、社交链接、Giscus 配置等集中在 src/config.ts 与 src/constants.ts，需要按自己的站点替换；包管理使用 Bun，构建命令会执行类型检查、构建与搜索索引生成。演示图片、字体、图标等第三方素材的许可需单独核对，代码本身采用 MIT 许可。

Astro博客

适合你的项目吗？

适用场景

需要同时发布中英文文章的个人技术博客
写作内容包含 LaTeX 数学公式，需要 KaTeX 渲染
希望读者通过 GitHub 账号在文章下评论（Giscus）
面向中文读者，需要微博、QQ、微信等分享入口与国内平台图标
希望静态站内具备全文搜索，而不依赖外部搜索服务

适合人群

熟悉 Astro 与 Markdown 内容集合、愿意自行修改配置的开发者
使用 Bun 作为包管理器的项目
以中英双语写作、面向中文社交平台传播的个人博客作者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
使用 Bun 安装依赖并运行：bun install、bun run dev（localhost:4321）、bun run build、bun run preview
2
构建流程包含类型检查、构建与 Pagefind 搜索索引生成
3
站点信息与社交链接集中在 src/config.ts 和 src/constants.ts，需替换为自有站点配置
4
Giscus 评论需要自行配置对应的 GitHub Discussions 仓库参数
5
文章放在 src/data/blog 下的 en 与 zh 目录，界面翻译在 src/data/i18n 的 YAML 文件中

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
评论功能依赖 Giscus，需要自行配置对应的 GitHub Discussions 仓库参数，属于外部服务依赖。
包管理器使用 Bun，安装与构建命令均基于 Bun，需要本地具备 Bun 环境。
项目基于 AstroPaper（MIT License）开发，使用时需保留对原作者 Sat Naing 及其贡献者的致谢与许可声明。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

- **Giscus 评论** — 基于 GitHub Discussions 的评论系统
README 原文

| 包管理 | [Bun](https://bun.sh/) |
README 原文

本项目基于 [AstroPaper](https://github.com/satnaing/astro-paper)（MIT License）开发，感谢 [Sat Naing](https://satnaing.dev) 及其贡献者。
README 原文

https://github.com/Vncntvx/BlogPage/blob/main/LICENSE https://github.com/Vncntvx/BlogPage/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-11。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 80 / 100
技术栈: Astro
网站类型: 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-10-11
截图检查日期: 2026-10-11

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: codex-user-requested-batch-review-20261017 · 2026-10-16

查看当时使用的来源资料

SHA-256: ea3534d32f73b9fa08aaae12169e96f2f52e0e54a453b43ca495e1334aed7382

2026-10-11T12:21:39.539Z

来源文件 / 仓库

# Blog

Wenjie Xu 的个人博客，基于 [AstroPaper](https://github.com/satnaing/astro-paper) 模板深度定制。

**线上地址**: [blog.wenjiexu.site](https://blog.wenjiexu.site/)

## 定制特性

- **中英双语** — 完整的 i18n 系统，支持手动路由与语言切换
- **中文社交平台** — 知乎、微博、B站、掘金、CSDN 等，含对应图标
- **中文分享** — 支持分享到微博、QQ、微信等平台
- **Giscus 评论** — 基于 GitHub Discussions 的评论系统
- **KaTeX 数学排版** — 文章内 LaTeX 公式渲染
- **CC 版权卡片** — 文章底部可选的 Creative Commons 许可声明
- **动态 OG 图片** — 自动为每篇文章生成社交分享图
- **Pagefind 搜索** — 静态站内全文搜索
- **阅读时间估算** — 支持 CJK 字符的阅读时长计算

## 技术栈

| 层级   | 技术                                        |
| ------ | ------------------------------------------- |
| 框架   | [Astro](https://astro.build/)               |
| 样式   | [Tailwind CSS v4](https://tailwindcss.com/) |
| 交互   | [React](https://react.dev/)（评论组件）     |
| 数学   | remark-math + rehype-katex                  |
| 搜索   | [Pagefind](https://pagefind.app/)           |
| 评论   | [Giscus](https://giscus.app/)               |
| OG 图  | satori + @resvg/resvg-js                    |
| 包管理 | [Bun](https://bun.sh/)                      |

## 本地运行

```bash
# 安装依赖
bun install

# 启动开发服务器
bun run dev

# 构建生产版本
bun run build

# 预览构建结果
bun run preview
```

## 项目结构

```text
/
├── public/              # 静态资源
├── src/
│   ├── assets/          # 图标、图片
│   ├── components/      # Astro & React 组件
│   ├── data/
│   │   ├── blog/        # 博客文章（en/ zh/）
│   │   ├── i18n/        # 翻译文件（YAML）
│   │   ├── about/       # 关于页内容
│   │   └── index/       # 首页内容
│   ├── i18n/            # 国际化配置与工具
│   ├── layouts/         # 页面布局
│   ├── pages/           # 路由页面
│   │   └── [lang]/      # 多语言路由
│   ├── styles/          # 全局样式
│   ├── utils/           # 工具函数
│   ├── config.ts        # 站点配置
│   ├── constants.ts     # 社交/分享平台元数据
│   └── content.config.ts # 内容集合 schema
└── astro.config.ts
```

## 常用命令

| 命令              | 说明                              |
| ----------------- | --------------------------------- |
| `bun run dev`     | 启动开发服务器 (`localhost:4321`) |
| `bun run build`   | 类型检查 + 构建 + 生成搜索索引    |
| `bun run preview` | 本地预览构建结果                  |
| `bun run format`  | Prettier 格式化                   |
| `bun run lint`    | ESLint 检查                       |

## 致谢

本项目基于 [AstroPaper](https://github.com/satnaing/astro-paper)（MIT License）开发，感谢 [Sat Naing](https://satnaing.dev) 及其贡献者。

## License

[MIT](LICENSE)

反馈内容错误