build 命令

build 命令用于渲染书籍:

mdbook build

它将尝试解析您的SUMMARY.md文件以了解您的书的结构并获取相应的文件。 请注意在 SUMMARY.md 中提到但不存在的文件将会自动创建。

为方便起见,渲染的输出将保持与源相同的目录结构。 大量的books在渲染时将保持结构化。

指定目录

build命令可以将目录作为参数用作书的根目录而不是当前工作目录。

mdbook build path/to/book

--open

当您使用--open (-o) 标志时,mdbook 在构建后, 将在你默认的网页浏览器中打开渲染的书籍。

--dest-dir

--dest-dir (-d) 选项允许您更改书籍的输出目录。 相对路径是相对于书的根目录解释的。 如果未指定,它将默认为book.tomlbuild.build-dir 键的值,或为 ./book

注意:: build 命令将所有文件(不包括扩展名为 .md 的文件)从源目录复制到build目录中。