# 部署指南

构建结果是普通静态文件，可以部署到 GitHub Pages、对象存储、CDN、Nginx 或 Caddy。

```bash
moon run --target native cmd/main -- check docs
moon run --target native cmd/main -- build docs
```

只需要发布配置中 `build-dir` 对应的目录。`.moonbook-manifest` 用于后续增量构建，可以保留，但浏览器不会使用它。

## CI 建议

1. 使用最新稳定 MoonBit 工具链；当前最低验收版本为编译器 `v0.10.9`，CI 会记录实际版本；
2. 运行 `moon check --target all` 和 `moon test --target all`；
3. 运行 `moonbook check`，依靠非零退出码阻断错误文档；
4. 构建站点并验证首页、主题和搜索索引存在；
5. 上传输出目录。

仓库中的 `.github/workflows/check.yml` 在 Ubuntu 和 macOS 执行全后端测试、Native CLI 与两个示例站验证，在 Windows 执行 wasm、wasm-gc 和 JavaScript 三个可移植后端测试。Windows Native CLI 不在当前发布承诺范围内。