R markdwon 代码块选项说明:

R markdwon 代码块选项说明:




代码块选项

读者可以在 https://yihui.org/knitr/options/ 查看所有代码块选项,这里列出一些重要选项和它们的取值类型。第 @ref(#chunk-options) 节展示了更多例子。

  • eval: 是否运行该代码块

  • echo: 是否显示代码块内容

  • results:如何处理代码块和运行结果

    •         'hide': 隐藏代码块的运行结果。results = 'hide' 加上 echo = FALSE 等价于 include = FALSE
    •         'asis': 将运行结果直接插入文档,不添加其他容器元素。默认情况下,knitr 在生成 .md 文件时会将代码的文字输出在放在 Markdown 的代码块 ``` 中
    •         'markup' 默认设置
  • include: 是否显示代码块和运行结果,include = FALSE 等价于 echo = FALSE 和 results = 'hide'

  • error:是否允许代码块包含错误代码。默认情况下,只要一个代码块运行失败,整个 R Markdown 文档就无法编译成功。当想要展示错误的代码写法时,可以用 error = TRUE 或 eval = FALSE

  • message 和 warning: 是否显示代码块可能输出的提示和警告

  • collapse: 为 true 时,在输出文档中将代码块和运行结果放置在同一个块级元素中

  • fig.width 和 fig.height: 调整代码块生成图形时图形设备 (graphical device) 的大小。 kntir 首先通过图形设备将图片存储为文件 (例如 png, jpg),随后在输出文档中引用这些文件。默认情况下 fig.width = 7, fig.height = 5。两个类似的选项是 out.width 和 out.height, 通常取值为百分比,表示图片占据一页的比例。例如, out.height = '80%' 表示图片占据容器高度的 80%。

  • fig.cap: 图片的标题

  • fig.align: 图片的对齐方式,有三种取值

    •         "left": 靠左对齐
    •         "center" 居中对齐 (本书的设置)
    •         "right": 靠右对齐
  • cache: 是否缓存代码块的运行结果。如果代码块涉及复杂的计算,cache = TRUE 可以让 knitr 把运行结果保存为 .rds 文件,并在下次编译时略过计算过程,直接读取 .rds 节省时间。只有代码块的内容发生变化时,knitr 才会重新计算并更新 .rds 文件。有时 knitr 的缓存机制会让人难以预测代码是否重新运行,只推荐必要时使用。


参考:https://cosname.github.io/rmarkdown-guide/rmarkdown-base.html

  • 发表于 2024-06-08 15:25
  • 阅读 ( 655 )
  • 分类:R

0 条评论

请先 登录 后评论
omicsgene
omicsgene

生物信息

702 篇文章

作家榜 »

  1. omicsgene 702 文章
  2. 安生水 351 文章
  3. Daitoue 167 文章
  4. 生物女学霸 120 文章
  5. xun 82 文章
  6. rzx 78 文章
  7. 红橙子 78 文章
  8. CORNERSTONE 72 文章