这是部署在 https://insistentwind.github.io/ 的静态博客。site/ 是唯一需要构建和提交的站点源码,推送到 main 后由 GitHub Actions 自动发布。
第一次使用先安装依赖:
cd site
corepack pnpm install以后新建和预览文章只需要:
cd site
corepack pnpm new -- "文章标题" article-slug
corepack pnpm dev脚本会同时创建:
site/src/content/posts/article-slug.md # 文章草稿
site/public/assets/posts/article-slug/ # 这篇文章的图片
完整的写作、图片引用、检查和发布步骤见 BLOG_WORKFLOW.md。
.
├─ site/ # 博客源码,提交到 GitHub
│ ├─ public/assets/posts/<slug>/ # 每篇文章自己的图片
│ ├─ public/emoji/ # 正文 emoji
│ ├─ scripts/new-post.mjs # 草稿生成器
│ └─ src/
│ ├─ content/posts/ # Markdown / MDX 文章
│ ├─ assets/images/ # 壁纸等主题素材
│ ├─ config/ # 站点和主题配置
│ ├─ components/ # 页面组件
│ └─ styles/ # 全站样式
├─ _local/references/ # 本地参考工程,不提交
└─ .github/workflows/ # GitHub Pages 自动发布
_local/ 已被 Git 忽略,当前 Mizuki 参考工程归档在 _local/references/Mizuki/,不会混入博客提交。