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 文件则不会被使用。