https://www.jianshu.com/p/7df62865c3ed

 --简书

Microsoft的Office软件在办公软件领域占有绝对的主导地位，几乎每个职场人士都必须掌握Word，Excel和PPT的使用。对于R用户来说，用来处理表格的Excel早就可以弃之不用，但是在撰写报告的时候还是离不开Word和PPT。尽管我们也可以利用kniter和Rmarkdown 等软件包自动生成报告，但它们更擅长生成HTML格式的文档（网页形式），在生成Word和PPT文档的时候功能有限，并不是很好用。

如果你的老板或者客户更喜欢阅读Word和PPT，而你又想利用R语言来自动生成报告，提高工作效率和可重复性，那么今天介绍的ReporteRs包将会是你的最佳选择。

ReporteRs的主页：

 

webpage.png

1. 安装ReporteRs

   1.1 查看你的系统中是否已经安装Java（在终端中输入 java -version），如果没有，请安装Java（version>=1.6），具体方法请百度
   1.2 在系统中安装cairo（以Ubuntu为例）： sudo apt-get install libcairo2-dev
   1.3 在RStudio里安装 rJava 软件包： install.packages('rJava')
   1.4 在RStudio里安装ReporteRs软件包： install.packages('ReporteRs')
   1.5 运行ReporteRs网站首页上的一段示例代码，如果能顺利地生成 my_first_doc.docx 文档就表明安装成功，可以开始正式学习ReporteRs了
    

   

   my_first_doc.png

2. ReporteRs 的精髓： FlexTable

   在Word中添加格式化的表格是最繁琐的工作，我使用过的其他R软件包都不能完美地解决我遇到的所有问题，而ReporteRs的FlexTable让我有种相见恨晚的感觉，我觉得它是ReporteRs的精髓所在。
   FlexTable的表格模型如下：
    

   

   table_model.png

   （1）灰色的部分是表头，多行表头在实际工作中经常会遇到，FlexTable 给出了完美的解决方案

   （2）深蓝色表示的是表格的数据部分，“合并单元格”或者“对单元格/数字标注颜色”也是经常会遇到的问题，用其他软件包很难实现，而FlexTable也考虑到了
   （3）浅蓝色部分是表格的脚注，同样也考虑了多行的情况
   由于篇幅有限，下面我只从ReporteRs网站上挑选几个FlexTable的例子，感兴趣的读者可以到网站上查看完整的代码。
   手中的数据是这样的：
    

   

   flextable_1.png
   基本款的FlexTable是这样的：
    

   

   flextable_2.png
   常用的三线表是这样轻松生成的：
    

   

   flextable_3.png

   合并单元格终于有了完美的解决方法：

    

   

   flextable_4.png
   改变某个单元格的背景色也是如此轻松：
    

   

   flextable_5.png
   上面的例子略显丑陋，在文档中经常出现的还是这样的配色：
    

   

   flextable_6.png
   轻松添加表头，让表格更加容易阅读：
    

   

   flextable_7.png

3. 创建Word文档（.docx）或PPT文档（.pptx）大致可分为以下3个步骤：

   （1）创建docx或pptx对象（可以使用 template file）
   （2）将R程序的输出（text， table， plots）添加到对象中（对于pptx文档要先在对象中添加一个silde）
   （3）将对象写入文件

4. ReporteRs 函数

   熟练掌握ReporteRs的函数是创建自动化报告的基础，我建议大家边学习变实践。我将ReporteRs的函数做了归类（见下图），可以方便大家记忆。当遇到函数参数设置的问题时，别忘记查看ReporteRs的文档。
    

   

   functions.png

5. 模板的使用

   真正要想做到报告的自动化生成，模板的使用是必不可少的。只要将文档的静态内容和格式定义好，写成一个模板，ReporteRs就可以把R程序产生的新的结果按照文档要求的格式插入到模板的指定位置中。具体方法如下：
   （1）在Word文档中的某个位置插入书签（bookmarks），书签就相当与文档中的一个有名称的位置。注意，这部分操作是在Word软件中进行的，具体方法可以百度，或者查看下面的链接：
   （2）只要把书签名赋给bookmark参数，addFlexTable, addPlot, addParagraph和addImage函数就可以将文档中的书签替换成相应的图表或文字。

作者：Rapp

链接：https://www.jianshu.com/p/7df62865c3ed

來源：简书

著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。