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.gitignore 里的文件,不会触发构建命令。.gitignore 是有匹配模式的文件 gitignore documentation。忽略那些缓存文件就挺有用的。

注意: 只有项目的顶层.gitignore是工作的。 全局的 $HOME/.gitignore or 上级文件夹的.gitignore 都不起作用