The serve command

serve 命令可以在本地建立一个web服务器 通过 localhost:3000访问预览你的图书

mdbook serve

serve命令将监控书籍src目录 内容的更改,随时重建书籍并为每个更改刷新客户端;这包括 重新创建SUMMARY.md中仍然提到的已删除文件!并通过 websocket 连接用于触发客户端刷新。

注意: serve命令用于测试书籍的 HTML 输出,而不是 旨在成为网站的完整HTTP服务器。

指定目录

serve命令可以指定目录作为参数用作书籍 根目录而不是当前工作目录。

mdbook serve path/to/book

Server options

serve主机名默认为“localhost”,端口默认为“3000”。可以在命令行上指定任一选项:

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

--open

当您使用--open-o)选项时,mdbook将在重构后,打开 您的默认网络浏览器。

--dest-dir

--dest-dir (-d) 选项,允许您改变您的图书输出路径。注意如果是相对路径,则相对的是图书的根目录。如果没有指定 --dest-dir (-d),则 --dest-dir (-d)的路径是在book.toml指定的,一般是 ./book

Specify exclude patterns

serve命令不会自动触发 书籍根目录中.gitignore文件中包含的文件。.gitignore文件可以参考 gitignore documentation.。这对于 忽略某些编辑者创建的临时文件是有帮助的。

注意:只有在图书根目录的.gitignore是有效的。全局变量指定的$HOME/.gitignore 或者上一级目录的.gitignore文件都是无效的。