简介
关于RMarkdown使用时,小编日常会使用的一些有用技巧,当然我也是通过学习谢大大的Rmarkdown-cookbook[1]以及日常使用需求上网搜的解决方案,在此分享给大家。如果大家还有其他什么需求,可以在留言板留言。或者有其他实用技巧也欢迎分享!
1. 修改某些字体颜色
Markdown语法没有用于更改文本颜色的内置方法。我们可以使用HTML和LaTeX语法来更改单词的格式
- 对于HTML,我们可以将文本包装在标记中,并使用CSS设置颜色,例如<span style =“ color:red;”> text </ span>。
- 对于PDF,我们可以使用LaTeX命令
textcolor{}{}
。这需要使用LaTeX软件包xcolor,该软件包已包含在Pandoc的默认LaTeX模板中。
作为更改PDF文本颜色的示例:
代码语言:javascript复制我是textcolor{blue}{庄闪闪}呀!欢迎关注我的textcolor{red}{公众号}:textcolor{blue}{庄闪闪的R语言手册}。
在上面的示例中,第一组花括号包含所需的文本颜色,第二组花括号包含应将此颜色应用到的文本。
2. 更改全文页边距等
在top-level中加入geometry
命令,例如
---
title: "RMarkdown常用技巧"
author:
- 庄闪闪
documentclass: ctexart
geometry: "left=2cm,right=2cm,top=2cm,bottom=2cm"
output:
rticles::ctex:
keep_tex: true
includes:
in_header: columns.tex
fig_caption: yes
number_sections: yes
toc: yes
---
这时的页边距就变成下面这样了:
当然全文字体大小等操作也是这样操作的,在geometry操作即可:
3. 缩进文本
默认情况下,Markdown还将忽略用于缩进的空格。但是,在某些情况下,例如在经文和地址中,我们可能希望保留缩进。在这些情况下,我们可以通过以竖线(|)开头的线来使用线块。换行符和所有前导空格将保留在输出中。例如:
代码语言:javascript复制| When dollars appear it's a sign
| that your code does not quite align
| Ensure that your math
| in xaringan hath
| been placed on a single long line
输出为:
4. 分页
如果想要分页,可以使用newpage
。例如:如果想把目录和正文内容分开,可以在在正文前面加入这个代码
这时输出的结果,目录一个界面,正文另起一页。
5. 控制文本输出的宽度
有时从R代码输出的文本可能太宽。如果输出文档具有固定的页面宽度(例如,PDF文档),则文本输出可能会超过页面的页边距。
R全局选项宽度可用于控制R函数输出的文本宽度,如果默认值太大,则可以尝试使用较小的值。此选项通常表示每行字符的粗略数目。例如:
代码语言:javascript复制```{r}
options(width = 300)
matrix(runif(100), ncol = 20)
```
代码语言:javascript复制```{r}
options(width = 60)
matrix(runif(100), ncol = 20)
```
但是这种方式不一定对所有函数都适用,这是你可以使用其他方式,对于Html(这里不做解释,主要将pdf),可以参见教程[2]。
对于PDF输出,换行比较困难。一种解决方案是使用LaTeX软件包清单,可以通过Pandoc参数--listings启用它。然后,您必须为此软件包设置一个选项,并且可以从外部LaTeX文件中包含设置代码(有关详细信息,请参见第6.1[3]节),例如,
代码语言:javascript复制---
output:
pdf_document:
pandoc_args: --listings
includes:
in_header: preamble.tex
---
在preamble.tex中(建议放到和rmd同一个文件夹),我们设置了Listings包的一个选项:
代码语言:javascript复制lstset{
breaklines=true
}
这是输出的结果,但是其实不是很美观
6. 控制图
这个我在文稿和教程中说的挺清楚了。可见:R沟通|Rmarkdown教程(3),R沟通|Rmarkdown教程(2)一共有两种方式:
方法一:chunck中加入out.width="50%"
代码语言:javascript复制```{r, echo=FALSE, out.width="50%", fig.cap="A nice image."}
knitr::include_graphics("foo/bar.png")
```
方法二:markdown语法设置{width=50%}
代码语言:javascript复制![A nice image.](foo/bar.png){width=50%}
7. 图片对齐
这个我也说过啦!可见:R沟通|Rmarkdown教程(3),R沟通|Rmarkdown教程(2)。如果使用R代码导入图片的话,使用knitr::include_graphics()并结合R chunk中fig.align = 'center'参数进行居中。如果结果不想显示代码块,可在chunck中加入:echo=FALSE
代码语言:javascript复制任何输出形式都适用,推荐使用
knitr::include_graphics()
当然还有另一种方法,不使用代码形式。对于输出为html,你可以使用html语法(不适用于pdf/word)
代码语言:javascript复制center
![](image.png)
center
对于输出pdf/word可以使用以下方式
代码语言:javascript复制<center> ![](image.png) </center>
当然想要文字居中的话,也是这样使用
视频教程可见我的b站,讲的很详细了:号外!Rmarkdown教程全网发布。
8. 代码块
通过块选项 attr.source =“ .numberLines”
将行号添加到源代码块中,或者通过attr.output =“ .numberLines”
将文本输出块添加到文本中,例如,
```{r, attr.source='.numberLines'}
if (TRUE) {
x = 1:10
x 1
}
```
输出结果为:
9. 多列输
这个特别好用!虽然学起来有那么一点困难,具体我再出一期推文,把这个讲清楚。具体可以见这里的教程[4]。类似于排版成这种形式,可以任意排版你想要输出的界面形式。
参考资料
[1]
Rmarkdown-cookbook: https://bookdown.org/yihui/rmarkdown-cookbook/
[2]
教程: https://bookdown.org/yihui/rmarkdown-cookbook/text-width.html
[3]
6.1: https://bookdown.org/yihui/rmarkdown-cookbook/latex-preamble.html#latex-preamble
[4]
教程: https://bookdown.org/yihui/rmarkdown-cookbook/multi-column.html