php生成pdf中文断码_Rmarkdown导出中文PDF解决方案

Rmarkdown非常适合R语言使用者导出格式漂亮的文档，但是输出中文PDF的过程中会遇到各种麻烦的问题，本文整理了我的经验供大家参考。

总的来说，通过Rmarkdown输出中文版pdf报告，要解决以下两个核心问题：

导出PDF需要配置TeX环境，以下两种方案都可以：

安装TinyTex
安装任一LaTeX套件（TeX LiveCTeXMiKTexMacTeX）

2. PDF中文显示问题，下面两种方案中更推荐后者：

在YAML中写入LaTeX的一些设置；
使用rticles包中的CTeX Documents模板

下面以事件先后顺序为线索详细介绍Rmarkdown输出中文版pdf报告的解决方案。

Rmarkdown导出PDF

首先需要解决的是创建Rmarkdown并导出PDF的问题。

安装好R语言与Rstudio之后，通过菜单栏File >>New File >>R Markdown可以直接在Rstudio上创建一个新的Rmarkdown文档，第一次创建会弹出对话框提示需要安装以下R包，点击Yes即可

再次点击菜单栏File>> New File>> R Markdown，弹出以下对话框点击OK后，可以成功地创建Rmarkdown文件

但是如果要导出PDF，会出现报错pdflatex not found

根据报错需要安装相应的LaTeX环境，此处有多种方案可以选择

安装一个常用的TeX集成编辑环境，如TeX Live，CTeX，MiKTex，MacTeX任选其一即可，安装过程比较漫长；
比较简单的方式是，使用谢益辉大神的开发的TinyTeX包，能很好的兼容Rmarkdown，安装相对比较方便快捷，参考TinyTeX中文文档，直接在Rstudio控制台输入以下命令即可：

install.packages('tinytex')
tinytex::install_tinytex()

一台电脑上同时存在多种TeX环境会产生冲突，因此益辉大神建议安装TinyTex之前需要卸载电脑中的其他 LaTeX 套装（TeX Live 或 MiKTeX 或 MacTeX）。

考虑到后续论文写作需求，我选择了安装目前比较常用的TeX Live。经历了漫长的TeX Live安装并重新启动Rstudio之后，Rmarkdown文件就可以正常导出成PDF了，但还不能显示中文。

PDF中文解决方案

完成上述步骤后，接下来解决中文输出的问题，有两种方案可以选择：

方案一，在原有的Rmarkdown模板基础上，在YAML中加上命令调用LateX的xeCJK包，即把原有的Rmarkdown文件头改成如下格式：

---
title: "中文"
CJKmainfont: Microsoft YaHei
output:pdf_document:includes:header-includes:- usepackage{xeCJK}keep_tex: yeslatex_engine: xelatex
---

上述方法能够解决中文显示的问题，但是原始Rmarkdown模板是基于英文写作习惯设计，如果全篇用中文写作会很奇怪，且模板格式比较单一。

因此强烈安利方案二，谢益辉大神写的Rmarkdown的模板包rticles，里面的CTeX Documents就是支持中文pdf的模板，除此之外还有适用于不同期刊的Rmarkdown模板，通过以下命令即可安装：

install.packages("rticles")

此时再次创建新的Rmarkdown文档，会出现很多新的模板，选择CTeX Document即可

此外，原有CTeX Document模板的页边距较大，可以在YAML中加入geometry选项调节页边距：

---
title: "R语言简介"
author:- PurePlayer
documentclass: ctexart
geometry: "left=2.5cm,right=2cm,top=3cm,bottom=2.5cm"
output:rticles::ctex:fig_caption: yesnumber_sections: yestoc: yes
classoption: "hyperref,"
---

然后就可以导出自动生成目录、页眉、标题序号的PDF了，至此大功告成！