文章目录
- 写在前面
- R Markdown与R Notebook简介
- 主要区别
- 基本使用
- R Markdown
- R Notebook
- 使用技巧
- 参考
写在前面
最近学习R语言,在使用集成开发环境R Studio时,经常会用到两类文件,那就是R Markdown文件和R Notebook文件,作为初学者的我一开始并不太理解,虽然了解Markdown的基础语法,但在使用时还是不免困惑,二者的区别和主要用途分别是什么呢?在一段时间的使用之后,我逐渐熟悉了二者的操作,有了一些经验,下面具体说说。
环境:
Windows10
R-x64-4.0.2
R Studio 1.3.959
R Markdown与R Notebook简介
- YAML渲染参数:设定导出时候的一些参数,如是否添加目录,可以在齿轮图标中进行设置。
- Markdown标记&文本:采用Markdown语法。
- R语言代码块:选择Insert插入代码块,可以设定代码块的标题,以及设置是否显示warning信息等的参数。
分别对应图1中的1,2,3。
主要区别
这一区别使得
而
基本使用
R Markdown在使用时需要安装一些程序包,下面附上命令:
1 2 3 4 | install.packages("rmarkdown") # 写rmarkdown必需的包 install.packages("knitr") # 导出文件必需的包 install.packages("tinytex") # TeX的轻量级发行版,用于PDF文件的导出 install.packages("rticles") # 配合中文导出PDF,有很多不同的文档模板可供使用 |
R Markdown
-
文档写作
对于R Markdown来说,由于其继承了markdown编辑器的优点,所以只要掌握基本的Markdown语法就能写出漂亮的文档了,如果需要插入公式的话直接采用dollar符号就可以,并且R Studio下的R Markdown支持数学公式的实时预览,称得上是R界的Typora啊!
题头的YAML参数可以选择手动修改,不过初学者还是建议使用图1中的齿轮图标下拉菜单的最后一行进行修改。
1
2
3
4
5
6
7
8
9
10
11
12---
title: "Example"
author: "Tom"
date: "2020/6/10"
output:
pdf_document:
toc: yes
latex_engine: xelatex
word_document:
toc: yes
keep_md: yes
---上面是我的一些设置,
toc 表示是否设置目录。关于具体的一些编码配置请看这里。对于R 代码块,需要配置的参数就很随意了,有兴趣的话可以看看knitr选项。
-
保存&导出
因为导出牵涉到的东西比较多(只导出Word的话很方便,导出PDF还牵扯到一个中文编码的问题),如果你的电脑没安装过
TeXlive 或者其他的LaTeX 套件,直接安装谢益辉开发的Tinytex 就OK,如果有问题点这里;如果安装过,最好全部卸载,鉴于我的老电脑性能问题,我还是导出word吧??。下面贴上一张导出PDF的图片,很美,可惜我不能写中文上去。
R Notebook
直接使用
使用技巧
由于R Notebook的语法也是基于R Markdown的,所以在此主要介绍R Markdown的一些使用技巧。
-
设置列表的数据时候,尽量使用
with 而不是attach 。因为在多个程序段运行时,可能会在不同的列表中出现相同的变量名,这样在knitr 逐行运行并生成文件时会导致报错。 -
使用一些R Studio常见的快捷键,会让你书写R Markdown报告事半功倍:
- 注释/取消注释当前行(代码块):
Ctrl+Shift+C ; - 插入代码块:
Ctrl+Alt+I ; - 运行光标所在行的代码:
Ctrl+Enter ; - 运行当前光标所在行的代码块:
Ctrl+Shift+Enter 。
- 注释/取消注释当前行(代码块):
参考
[1] R Markdown 简介
[2] 《R数据科学》——R Markdown的摸索