astro-starlight-ghpages

这是一个以 Astro Starlight 为核心的文档站模板，目标很明确：把 Starlight 文档站点构建出来并部署到 GitHub Pages，同时验证它作为可复用模板的可行性。仓库本身是一份实践记录，从脚手架初始化、本地预览、生产构建到 GitHub Actions 部署，步骤都写在 README 里，适合想快速了解 Starlight 工作流的开发者对照操作。

内容层面，模板覆盖了 Starlight 默认的落地页与文档页、Markdown/MDX 写作、代码高亮、暗色模式、基础搜索和 i18n 支持，并额外演示了通过社区插件 starlight-blog 添加博客功能，包括插件安装、astro.config.mjs 配置、frontmatter schema 扩展和文章目录约定。搜索在构建后即可用，不需要额外配置索引。

需要留意的地方：README 明确记录了一个已知问题——落地页 Hero 的示例按钮链接没有正确带上 base 路径，点击会 404，而侧边栏同一路由正常，作者推测与 frontmatter 和 Markdown 的链接解析差异有关，尚未解决。另外 Starlight 在文中被描述为早期版本，仓库 star 数很少，许可证状态也标注为待确认。如果打算直接用于正式项目，建议先核对许可证、Starlight 当前版本行为以及 base 路径问题的现状。