/
About

zhi

纸，极简单栏博客主题

简介

zhi 是一个极简单栏博客主题：干净、快速、为阅读而设计。

内容以 Markdown 写作，支持暗色模式、代码高亮、RSS 与沉浸式阅读，适合作为个人写作与轻量内容发布的起点。

主题已开源维护，如果你有改进建议或想一起完善，欢迎创建 Issue交流。

技术栈

Astro 静态站点生成器
TypeScript 类型安全
Markdown/MDX 内容写作
Prism 代码高亮
Sharp 图片优化

常见问题

在 src/content/blog/ 目录下创建 .md 或 .mdx 文件，填写 frontmatter 字段即可。
支持 title、description、date、updatedDate、heroImage、draft、abbrlink、badge、tags、archive 等字段，详见文章字段说明。
设置 draft: true 可完全隐藏文章；设置 archive: false 可在归档页面隐藏。
支持 Vercel、Netlify、Cloudflare Pages、GitHub Pages 等平台，连接 GitHub 仓库即可自动部署。
修改 src/styles/ 目录下的样式文件，或在 src/consts.ts 中修改站点配置。
支持提示框（note/tip/info/warning）、Pullquote、图片灯箱、多图排版等扩展语法。
常见原因：1. Node.js 版本过低，建议使用 Node 18+；2. 依赖安装失败，尝试删除 node_modules 和 package-lock.json 后重新安装；3. 环境变量未设置，部署时需配置 SITE_URL；4. 构建命令错误，确保使用 npm run build，输出目录为 dist。

Stay passionate, keep making progress.