认识MarkDown
MarkDown是一种轻量级的【标记语言】,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。,Markdown 的语法十分简单。常用的标记符号也不超过十个,对于大学里掌握了多门语言的我们来说,这种不需要思维,仅仅是对需要不同格式的文本前添加一些符号,简直是小case好吗?学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
(这是我自己独立完成的第一篇MarkDown,高兴的不得了)
今天要介绍的内容,就是Rstudio 中对RMarkDown功能的应用。说白了,MarkDown不过是安装在R内的一个小功能,本周数据可视化课程,由王志刚老师引入,我也对这个编辑器和相关语法产生了浓厚的兴趣。经过两天的学习,自己也迷上了这种编译方法,清爽的页面显示,感觉整个文章都高大上了起来,对于word,wps之外的世界,这是我第一次这么喜欢一款网页文本编辑器。
一、准备工作
-安装R
-安装Rstudio(请确保你的版本越新越好,这个和IPHONE不一样,不存在升级版本变砖的情况)
-想查看版本号请使用>version命令
-按照下面图示做好你的前期准备工作
从这里开始,我们就可以运行Rstudio里的MarkDown了
由于Rstudio的基础安装包在首次解压安装时不自带rmarkdown的packages,所以我们需要根据提示完成下载工作。(rmarkdown类似于ggplot2的packages,需要去相关的CRAN下载,这一步需要联网
)
其中,黄色部分是提示你现在缺少的包你可以选择“Yes”在线安装,也可以在”Console”中键入install.packages( “包名” )命令安装
例如这里需要安装黄色标记的包,,就类似于学习R第一课里的下载、安装包的过程,代码如下(以图片缺少内容为例):
install.packages( c(“htmltools”,”caTools”,”bitops”,”rmarkdown”) )
准备工作的操作图片参考了 ^-馒头-^ 的 博客园
这里表示感谢
二、错误排查
如果你已经完成了上面的步骤,那么我们不可避免的会遇到一些错误,结合网络上大大们的铺垫,集中反馈的多为以下几类问题:
1.第一次点选Knit PDF(或Knit HTML)报错
Knit PDF : pandoc document conversion failed with error 43
可以通过安装 github 上最新的版本解决:
install.packages(“devtools”)
如果以前没有安装 devtools 包
devtools::install_github(“rstudio/rmarkdown”)
2.文档中出现中文(尤其是PDF格式下)
这个在很多的MarkDown介绍中都明确表示了不建议在PDF文档中使用中文,但在博主自己的尝试和简书·Yusheng的RStudio 中的 R Markdown介绍下,基本解决了这个问题。
! Package inputenc Error: Unicode char \u8:年 not set up for use with LaTeX.
Try running pandoc with –latex-engine=xelatex.
可以看到,明显提示中出现了ERROR的报错。我们尝试以下两种方法~
(1)LaTex 引擎改为 xelatex
操作步骤如图
(2)MarkDown编辑框中,在文档头信息中加入以下代码
output:
pdf_document:
latex_engine: xelatex
以上两步其实原理是一样的,只是菜单栏设置和代码编辑的区别,大家根据个人习惯自己选择。完成后就可以正常输出为 PDF 文档了,但是会发现所有的中文全部都是空白,这个主要是 LaTex 的配置问题,中文需要中文字体来渲染,可以通过在文件头中引入 LaTex 文件进行配置。
outputs:
pdf_document:
includes:
in_header: header.tex
latex_engine: xelatex
其中 header.tex 可以是:
\usepackage{xeCJK}
\setCJKmainfont{楷体} % 字体可以更换
\setmainfont{Georgia} % 設定英文字型
\setromanfont{Georgia} % 字型
\setmonofont{Courier New}
更多详细配置可以参考官方文档
三、语法规范
安装并调试完成后,就可以开始用markdown写上一行行漂亮的代码了