←
PDF 497 / 520 Notebooks
→
English · PDF 497
Original PDF page 497
中文 · PDF 497
  • word_document 用于 Microsoft Word 文档(.docx)。
  • odt_document 用于 OpenDocument Text 文档(.odt)。
  • rtf_document 用于富文本格式(.rtf)文档。
  • md_document 用于 Markdown 文档。它本身通常没什么用,但例如当你的公司 CMS 或实验室 wiki 使用 Markdown 时,你可能会用到它。
  • github_document 是 md_document 的一个定制版本,专为在 GitHub 上分享而设计。

请记住,在生成要分享给决策者的文档时,你可以在 setup 代码块中设置全局选项来关闭代码的默认显示:

knitr::opts_chunk$set(echo = FALSE)

对于 html_documents,另一种选择是让代码块默认隐藏,但可以通过点击显示:

output: html_document: code_folding: hide

Notebooks(笔记本)

笔记本(html_notebook)是 html_document 的一种变体。渲染后的输出非常相似,但用途不同。html_document 侧重于与决策者沟通,而笔记本侧重于与其他数据科学家协作。这些不同的用途导致以不同的方式使用 HTML 输出。两种 HTML 输出都包含完整渲染的结果,但笔记本还包含完整的源代码。这意味着你可以通过两种方式使用笔记本生成的 .nb.html 文件:

  • 你可以在网页浏览器中查看它,看到渲染后的输出。与 html_document 不同,这种渲染总是包含生成它的源代码的嵌入副本。
  • 你可以在 RStudio 中编辑它。当你打开一个 .nb.html 文件时,RStudio 会自动重新创建生成它的 .Rmd 文件。将来,你还可以包含支持文件(例如 .csv 数据文件),它们会在需要时被自动提取。