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文件都是无效的。