欢迎使用 Astro Butterfly。这是一个参照 Hexo Butterfly 外观、用 Astro 重新实现的博客主题:页面是纯静态 HTML,脚本只在需要的地方加载。
写一篇文章
文章放在 src/content/posts/ 下,子目录随意组织。也可以用脚本生成:
pnpm new "文章标题" 分类目录它会生成带好 Front Matter 和唯一 abbrlink 的 Markdown 文件,文章地址就是 /posts/<abbrlink>/。
Front Matter
---title: 文章标题 # 必填date: 2024-06-01 10:00:00 # 必填,按 site.timezone 解析updated: 2024-06-02 09:00 # 可选:更新时间会自动跟随 git 提交abbrlink: 1a2b3c4d # 必填,文章 URLtags: [Astro, 前端]categories: [前端, 框架] # 数组表示层级:前端 › 框架cover: /img/covers/2.svg # 列表卡片封面,缺省用 site.defaultCovertop_img: /img/banner.svg # 文章顶部横幅,缺省用封面description: 摘要 # 卡片与搜索引擎摘要,缺省截取正文comments: true # 关闭单篇评论设为 falsedraft: false # 草稿只在 pnpm dev 里出现---从 Hexo 迁移过来?Front Matter 的写法完全兼容,日期格式、abbrlink、comment 字段都能直接读取。参见仓库里的 docs/migrate-from-hexo.md。
常用命令
| 命令 | 作用 |
|---|---|
pnpm dev |
本地开发,默认 http://localhost:4321 |
pnpm build |
构建到 dist/,并生成站内搜索索引 |
pnpm preview |
预览构建结果 |
pnpm check |
类型检查 |
pnpm test / pnpm test:e2e |
单元测试 / 浏览器测试 |
接下来可以看看 Markdown 写作、代码块 和 标签外挂 三篇示例。