←
PDF 456 / 520 Chunk Options
→
English · PDF 456
Original PDF page 456
中文 · PDF 456
  • 你可以建立缓存代码块的网络,以避免每次运行时重复执行昂贵的计算。稍后会详细介绍。

有一个特殊的代码块名称具有特殊行为:setup。当你处于笔记本模式时,名为 setup 的代码块会在任何其他代码运行之前自动运行一次。

代码块选项

代码块的输出可以通过选项进行自定义,选项是提供给代码块头部的参数。knitr 提供了近 60 个选项,可用于自定义你的代码块。这里我们将介绍你最常用到的最重要的代码块选项。你可以在 http://yihui.name/knitr/options/ 查看完整列表。

最重要的一组选项控制你的代码块是否被执行,以及在最终报告中插入什么结果:

  • eval = FALSE 阻止代码被求值。(显然,如果代码没有运行,就不会生成任何结果。)这对于展示示例代码,或者在不逐行注释的情况下禁用大段代码非常有用。
  • include = FALSE 会运行代码,但不会在最终文档中显示代码或结果。这适用于你不想让其弄乱报告的设置代码。
  • echo = FALSE 阻止代码(但不包括结果)出现在最终文件中。当你撰写的报告面向不想看到底层 R 代码的读者时,可以使用此选项。
  • message = FALSE 或 warning = FALSE 阻止消息或警告出现在最终文件中。
  • results = 'hide' 隐藏打印输出;fig.show = 'hide' 隐藏图形。
  • error = TRUE 使渲染即使在代码返回错误时也能继续进行。你很少会希望在报告的最终版本中包含这个选项,但如果你需要调试 .Rmd 内部究竟发生了什么,它会非常有用。如果你在教授 R 并且想故意包含一个错误,它也很有用。默认值 error = FALSE 会导致只要文档中存在一个错误,编织就会失败。