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