Astro-Yi主题配置和写作技巧
内容提要
本文介绍了Astro开源博客主题Astro-Yi的配置方法，包括网站基本信息、评论系统（支持waline和giscus）、友情链接和赞助系统的设置。用户可通过修改配置文件src/consts.ts来定制博客内容，并提供Markdown文档编写规范和动态页面创建方法，同时讲解了如何加载本地图片和使用图床服务。
延伸解读
评论系统选择：giscus 与 waline 的权衡
Astro-Yi 支持 giscus 和 waline 两种评论系统。giscus 基于 GitHub Discussions，配置简单，适合希望快速启用评论的博客；waline 则提供更丰富的功能，如页面浏览量统计、表情反应和评论管理，且更方便迁移。选择时需考虑：若博客主要面向 GitHub 用户，giscus 是轻量之选；若需要独立的数据控制和更多互动功能，waline 更合适。注意，waline 需要自行部署服务端，而 giscus 只需配置仓库信息。
Markdown 写作：frontmatter 的灵活运用
在 Astro-Yi 中，每篇博客的 Markdown 文件都需要 frontmatter，但除 title 和 date 外，其他属性均为可选。你可以通过 tags、category、sticky 等属性来组织内容，例如设置 sticky 权重实现置顶，或使用 slug 自定义永久链接。对于动态页面，仅需 date 即可发布。这种灵活性降低了写作门槛，同时保留了扩展性。建议根据内容类型合理使用属性，如技术文章可添加 tags 便于检索，而动态则保持简洁。
图片管理：本地存储与图床方案
文章介绍了两种图片管理方式：本地存储和图床。本地图片需放在 /public/images 目录下，并使用绝对路径引用，如 。这种方式简单直接，适合图片量不大的博客。若图片较多或希望减少仓库体积，可使用图床，例如华为云对象存储配合 PicGo 插件上传。图床能提升加载速度并方便管理，但需注意配置成本和潜在的链接失效风险。根据实际需求选择合适方案。
部署与配置的注意事项
配置 Astro-Yi 时，需特别注意 baseUrl 的设置：若使用 GitHub Pages 部署，必须填入仓库名称（以 / 开头），否则资源路径可能错误。此外，评论系统的启用需在 consts.ts 中设置 enable: true 并选择类型。赞助系统也需配置二维码图片路径。这些细节直接影响网站功能，建议在部署前仔细检查配置文件，避免因遗漏导致功能异常。
Q&A
如何配置Astro-Yi主题的基本信息？
在src/consts.ts文件中，必须填写网站标题、图标、作者、头像、描述和网址等基本信息。
Astro-Yi主题支持哪些评论系统？
Astro-Yi主题支持waline和giscus评论系统，waline适合迁移，giscus更简单。
如何在Astro-Yi中添加友情链接？
在src/consts.ts文件中配置友情链接，包括博客名称、地址、头像和描述。
Astro-Yi主题的Markdown文档规范是什么？
使用Astro博客时，Markdown文档需遵循GitHub的写作规范，并在文档头部添加frontmatter信息。
如何在Astro-Yi中加载本地图片？
将图片放在/public/images目录下，并在Markdown中使用绝对路径引用，如/images/xx.png。
Astro-Yi主题的赞助系统如何配置？
在src/consts.ts中配置赞助系统，包括开启/关闭选项、提示信息和二维码地址。
