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

Question

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

Answer 1

对你的两个问题的简短答案分别是肯定和否定.

理解[R笔记本电脑的关键是,他们不是一个不同类型的文件; 正如文件所说:

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

由于插图是 R Markdown文档(output: rmarkdown::html_vignette在其YAML标题块中),因此它们可以用作R笔记本.

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

再次,文档简洁:

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

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

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

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

我不确定晕影是否可以通过添加两个 output: rmarkdown::html_vignette 和 output: rmarkdown::html_notebook它们的YAML标题块来利用"Notebook文件"功能.我尝试了一下,但它似乎没有用.