serve 命令

默认情况下serve命令用于通过HTTP在localhost:3000提供服务来预览一本书：

mdbook serve

serve命令监视书的src目录的变化，为每次变化将重建书籍和刷新客户端； 这包括重新创建已删除但仍然在SUMMARY.md中提到的文件！ websocket连接用于触发客户端刷新。

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

指定目录

The 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文档中描述的文件模式。 这对于忽略某些编辑器创建的临时文件很有用。

注意: 仅使用书籍根目录中的.gitignore文件。 全局的$HOME/.gitignore或 父目录中的.gitignore文件则不会被使用。