The serve command

serve 命令用于通过 HTTP 服务来预览书籍,默认情况下localhost:3000

mdbook serve

serve 观察 src 目录的变化,对每次变化,都会执行重建与刷新客户端; 还包括重新创建已删除,但仍在 SUMMARY.md里的文件! 一个 websocket 连接用于触发客户端刷新.

注意: serve命令用于测试书籍的 HTML 输出,并不打算成为网站的完整 HTTP 服务器.

指定目录

serve命令可以将目录作为参数,用作本书的根目录,而不是当前工作目录.

mdbook serve path/to/book

Server 选项

serve 默认端口:localhost:3000;或是通过下面命令改变:

mdbook serve path/to/book -p 8000 -n 127.0.0.1 

–open

当你使用--open(-o)标志,mdbook 将在启动服务器后,在您的默认 Web 浏览器中打开该书.

–dest-dir

--dest-dir(-d)选项允许您更改书籍的输出目录。为相对路径,(相对于书籍的根目录)。如果未指定,则默认为book.toml配置的build.build-dir字段, 或者./book目录.

指定排除的模式

watch.gitignore 里的文件,不会触发构建命令。.gitignore 是有匹配模式的文件 gitignore documentation。忽略那些缓存文件就挺有用的。

注意: 只有项目的顶层.gitignore是工作的。 全局的 $HOME/.gitignore or 上级文件夹的.gitignore 都不起作用