我可以使用R笔记本作为R包装晕影吗?

时间:2017-04-03 18:00:24

标签: r rstudio r-markdown rnotebook

我知道我可以使用Rmd来构建包装小插图,但想知道R笔记本是否可以更具体地制作包装小插图。如果是这样,我需要将R笔记本作为包装短片写出来吗?我正在使用最新版本的RStudio和devtools来编写此软件包。

1 个答案:

答案 0 :(得分:5)

你的两个问题的简短回答分别是肯定和否定。

理解R笔记本的关键是它们不是文件的;正如documentation所说:

  

任何R Markdown文档都可以用作笔记本

由于插图 R Markdown文档(在YAML标题栏中有output: rmarkdown::html_vignette),因此可以将它们用作R笔记本。

因此,如果R笔记本不是一种不同的文件,它们是什么?

同样,文档简洁:

  

因此,可以将笔记本视为R Markdown文档的特殊执行模式

换句话说,它只是将交互更改为文件。这些变化主要与使代码开发过程更具交互性和动态性有关。也许最重要的是:

  • 交互式代码执行:您可以根据需要执行行或块(与整个R Markdown文档的批处理模式呈现相比)
  • 嵌入代码输出:您可以在文件的文本编辑缓冲区中看到交互式编码会话的结果,并在运行,更改和重新运行时更新这些结果代码。
  • 笔记本文件:这有点复杂,并不一定与小插曲相关,但值得一提。当您在YAML标头块中保存.Rmd output: rmarkdown::html_notebook个文件时,在同一目录中创建另一个文件,其文件扩展名为.nb.html 。这个“Notebook文件”存储所有代码块的输出,保存时保留的状态。这有两个原因有用。首先,当您重新打开相关的.Rmd文件时,这些输出会被重新加载,您无需重新运行任何代码即可查看(尽管这也是以其他输出类型的隐藏方式处理的)。其次,您可以直接在任何Web浏览器中打开这些.nb.html文件,它们将显示笔记本状态的呈现.html版本。此功能使它们对共享很有用,并且每次要查看未完成笔记本的中间状态时,“随时随地”自然保存您需要点击knit

在RStudio中进行编辑时,所有.Rmd文档都被视为R笔记本(无论他们的output:字段说明了什么),因此您无需执行任何操作,也不会影响您的小插图构建过程

我不确定晕影是否可以通过将 {em> output: rmarkdown::html_vignette output: rmarkdown::html_notebook添加到其中来充分利用“Notebook文件”功能YAML标题块。我试一试,但似乎没有用。