写书时有时需要一些自动化测试.例如The Rust Programming Book使用了许多可能过时的代码示例。因此能够自动测试这些代码示例对他们来说非常重要.
mdBook 支持test将运行,书中所有可用测试的命令。目前只支持 rustdoc 测试但未来可能会扩展.
rustdoc 不会测试,包含ignore属性的代码块:
rustdoc 也不会测试,指定了除 Rust 之外的语言的代码块:
rustdoc不会测试,没有指定语言的代码块:
test命令可以将目录作为参数,用作本书的根目录,而不是当前工作目录.
--dest-dir
--dest-dir(-d)选项允许您更改书籍的输出目录。为相对路径,(相对于书籍的根目录)。如果未指定则默认为book.toml配置的build.build-dir字段 或者./book目录.