watch command is useful when you want your book to be rendered on every
file change. You could repeatedly issue
mdbook build every time a file is
changed. But using
mdbook watch once will watch your files and will trigger a
build automatically whenever you modify a file.
watch command can take a directory as an argument to use as the book's
root instead of the current working directory.
mdbook watch path/to/book
When you use the
-o) option, mdbook will open the rendered book in
your default web browser.
-d) option allows you to change the output directory for the
book. Relative paths are interpreted relative to the book's root directory. If
not specified it will default to the value of the
build.build-dir key in
book.toml, or to
watch command will not automatically trigger a build for files listed in
.gitignore file in the book root directory. The
.gitignore file may
contain file patterns described in the gitignore
documentation. This can be useful for
ignoring temporary files created by some editors.
.gitignore from book root directory is used. Global
.gitignore files in parent directories are not used.