5.2 预览单个章节

当书籍项目的大小很大时,构建整本书可能会很慢。有两件事会影响一本书的构建速度:R 代码块的计算以及使用 Pandoc 将 Markdown 转换为其他格式的过程。前者可以通过使用 chunk 选项 cache = TRUEknitr 中启用缓存来改进,但创作者并没有什么办法能使后者更快。不过,你可以选择使用 bookdown 中的 preview_chapter() 函数一次只编译一个章节,通常这比编译整本书要快得多。只有传递到 preview_chapter() 的 Rmd 文件才会被编译。

当你只关注当前章节时,预览当前章节会很有帮助,因为可以在添加更多内容或修改章节时立即看到实际输出。尽管预览功能适用于所有输出格式,但我们建议你预览 HTML 输出。

预览单个章节的一个缺点是,对其他章节的交叉引用将不起作用,因为在这种情况下,bookdown 对其他章节一无所知。这对于速度的提高来说是一个相当小的代价。由于预览章节只会呈现该特定章节的输出,因此不应期望其他章节的内容也能正确呈现。例如,当你导航到其他章节时,实际上你正在查看该章节的旧输出(甚至可能不存在该章节的输出)。