watch 命令
当您希望在每次文件更改时呈现您的书籍时,watch
命令很有用。
每次更改文件时,您都可以重复发出mdbook build
。
但是使用mdbook watch
将监视您的文件,并在您修改文件时自动触发构建;
这包括重新创建已删除的但在SUMMARY.md
中但仍然提到的文件!
指定目录
watch
命令可以将目录作为参数用作书的根目录而不是当前工作目录。
mdbook watch path/to/book
--open
当您使用--open
(-o
) 选项时,mdbook 将在您的默认 Web 浏览器中打开渲染的书籍。
--dest-dir
--dest-dir
(-d
) 选项允许您更改书籍的输出目录。 相对路径是相对于书的根目录解释的。
如果未指定,它将默认为book.toml
中build.build-dir
键的值,或为 ./book
。
指定排除模式
watch
命令不会自动为book
根目录中的.gitignore
文件中列出的文件触发构建。
.gitignore
文件可能包含gitignore
文档中描述的文件模式。
这对于忽略某些编辑器创建的临时文件很有用。
注意: 仅使用书籍根目录中的.gitignore
文件。 全局的$HOME/.gitignore
或父目录中的.gitignore
文件则不会被使用。