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.tomlbuild.build-dir键的值,或为 ./book

指定排除模式

watch命令不会自动为book根目录中的.gitignore文件中列出的文件触发构建。 .gitignore文件可能包含gitignore文档中描述的文件模式。 这对于忽略某些编辑器创建的临时文件很有用。

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