常见问题

基础问题

如何修改站点标题？

编辑 src/layouts/DocsLayout.astro 文件中的 <title> 标签。

如何添加新文档？

在 docs/ 目录下创建 .mdx 文件，参考 _template.mdx 模板。

如何自定义主题？

修改 src/styles/variables.css 中的 CSS 变量。

部署相关

部署到 Cloudflare Pages 失败？

1. 检查构建命令是否为 npm run build
2. 确认输出目录设置为 dist
3. 检查 Node.js 版本是否为 18+

环境变量如何设置？

在 Cloudflare Dashboard 的 Pages 项目设置中添加环境变量。

搜索相关

搜索功能不工作？

1. 确认已运行 npm run build（Pagefind 在构建时生成索引）
2. 开发模式使用客户端搜索，生产模式使用 Pagefind

提示

如遇其他问题，请在项目 Issues 中反馈。