Chinese-English bilingual i18n system based on [lang] routing, with translation copy maintained in YAML files
AstroBlog
BlogPage — Astro Blog Template
By Vncntvx
An Astro blog theme deeply customized from AstroPaper, aimed at Chinese-English bilingual writing, with built-in Chinese social platforms, Giscus comments, KaTeX math typesetting and Pagefind site search.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-11View source
What stands out
A quick read of the recorded project description.
Built-in icons for Chinese platforms such as Zhihu, Weibo, Bilibili, Juejin, and CSDN, plus sharing entry points for Weibo, QQ, and WeChat
Supports KaTeX math formula rendering and reading time estimation that includes CJK characters
Integrates Giscus (GitHub Discussions) comments and Pagefind static full-text search
Uses satori and @resvg/resvg-js to generate dynamic OG share images for articles
Optional CC copyright card at the bottom of articles; content collection schema is defined in content.config.ts
Template Details
BlogPage is Wenjie Xu's personal blog repository, deeply customized from the AstroPaper template, built with Astro, styled with Tailwind CSS, and using React for the comment component. The site implements Chinese-English bilingualism through [lang] dynamic routing, with articles placed under src/data/blog/en and src/data/blog/zh respectively; interface copy is provided by YAML translation files in src/data/i18n, and manual language switching is supported.
In terms of content capabilities, the theme includes KaTeX math formula rendering (remark-math + rehype-katex), reading time estimation that supports CJK characters, an optional CC copyright card at the bottom of articles, dynamic OG image generation based on satori and @resvg/resvg-js, and Pagefind static full-text search. Comments use Giscus based on GitHub Discussions. Social and sharing features are adapted for Chinese platforms, including icons for Zhihu, Weibo, Bilibili, Juejin, CSDN, etc., as well as entry points for sharing to Weibo, QQ, and WeChat.
Usage limitations: the repository is a customized version of the author's personal blog; site information, social links, Giscus configuration, etc. are centralized in src/config.ts and src/constants.ts and need to be replaced for your own site; package management uses Bun, and the build command performs type checking, building, and search index generation. The licenses of third-party assets such as demo images, fonts, and icons need to be checked separately; the code itself is under the MIT license.
AstroBlog
Is it right for your project?
Use Cases
- Personal technical blogs that need to publish both Chinese and English articles
- Writing that contains LaTeX math formulas and requires KaTeX rendering
- Wanting readers to comment on articles through GitHub accounts (Giscus)
- Aimed at Chinese readers, needing sharing entry points such as Weibo, QQ, and WeChat and icons for domestic platforms
- Wanting full-text search within a static site without relying on external search services
Suitable For
- Developers familiar with Astro and Markdown content collections who are willing to modify configuration themselves
- Projects using Bun as the package manager
- Personal blog authors who write in Chinese and English and distribute to Chinese social platforms
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Install dependencies and run with Bun: bun install, bun run dev (localhost:4321), bun run build, bun run preview
- 2
The build process includes type checking, building, and Pagefind search index generation
- 3
Site information and social links are centralized in src/config.ts and src/constants.ts and need to be replaced with your own site configuration
- 4
Giscus comments require configuring the corresponding GitHub Discussions repository parameters yourself
- 5
Articles are placed in the en and zh directories under src/data/blog, and interface translations are in YAML files under src/data/i18n
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets need to be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
- The comment feature depends on Giscus and requires configuring the corresponding GitHub Discussions repository parameters yourself; it is an external service dependency.
- The package manager uses Bun; installation and build commands are all based on Bun, so a local Bun environment is required.
- The project is developed based on AstroPaper (MIT License); when using it, you must retain acknowledgment and license notices for the original author Sat Naing and contributors.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
- **Giscus 评论** — 基于 GitHub Discussions 的评论系统
Original README
| 包管理 | [Bun](https://bun.sh/) |
Original README
https://github.com/Vncntvx/BlogPage/blob/main/LICENSEhttps://github.com/Vncntvx/BlogPage/blob/main/README.md本项目基于 [AstroPaper](https://github.com/satnaing/astro-paper)（MIT License）开发，感谢 [Sat Naing](https://satnaing.dev) 及其贡献者。
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-11. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 80 / 100
- Technologies
- Astro
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-10-11
- Screenshot last checked
- 2026-10-11
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: codex-user-requested-batch-review-20261017 · 2026-10-16
Inspect the recorded source material
SHA-256: ea3534d32f73b9fa08aaae12169e96f2f52e0e54a453b43ca495e1334aed7382
2026-10-11T12:21:39.539Z
Source file / repository# 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)
Explore similar templates
Compare previews and descriptions within the same stack and category.
astrowind
AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.
Astro · Blog
astro-paper
An Astro blog theme with Markdown/MDX content, Tailwind styling and Pagefind search. Search is a feature of the blog, rather than a separate tool-site product.
Astro · Blog
fuwari
Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.
Astro · Blog
Firefly
Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.
Astro · Blog
astro-theme-cactus
An Astro blog and notes starter with Markdown/MDX content, Tailwind styling and Pagefind search. Its main purpose is publishing posts and notes.
Astro · Blog
astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio