第三章——编译发布文档

1. 编译文档

在发布文档前，你需要先在本地预览你写的文档，预览时需要编译你的项目。

以下是 mdbook 的几个重要命令。

mdbook build

该命令用于编译你的 book，前提是你的当前路径就是你的 book 的根目录。

mdbook build -o

该命令在编译完你的 book 后会通过默认浏览器打开预览。

mdbook watch

该命令可以监听你的文件，当有任何文件改动时，mdbook 会自动编译项目，不需要你手动编译。

mdbook watch -o

该命令在监听后会通过默认浏览器打开预览。

2. 发布文档

建议在撰写文档的时候在另一个本地的分支撰写，撰写结束后再 merge 到 main 分支。然后直接 push 到云端就可以了。

git checkout main
git merge your-local-branch
git push origin main

当你把你的提交 push 到云端的时候，CI 会自动识别这个动作，然后自动编译你的项目，最后会自动部署好。