Windows 系统使用 R markdown 和 LaTeX 生成中文 PDF 的基本配置

时间:2024-05-22 09:57:53

之前已经介绍了 Linux 系统中使用 R markdown 和 LaTeX 生成中文 PDF 的基本配置,顺便介绍一下 Windows 系统中的基本配置。

准备工作

安装 CTeX

Windows 系统建议安装 CTeX。进入网站下载页面 http://www.ctex.org/CTeXDownload,选择镜像,下载完整版 CTeX,如 CTeX-xxx-Full.exe(xxx 是版本号)。双击运行安装程序,按默认设置至安装结束。

注意:必须下载完整版!

注意:安装程序在某些情况下可能覆盖 path 环境变量,原因不明。请在安装前注意备份 path 环境变量。

安装 R

进入 CRAN(https://cran.r-project.org/mirrors.html),选择一个镜像,比如中科大(https://mirrors.ustc.edu.cn/CRAN/)。点击 Download R for Windows,新页面中再点击 base,在新页面中点击 Download R xxx for Windows 即可,其中 xxx 表示 R 的版本。双击运行安装。

安装 RStudio

进入 RStudio 的下载页面 https://www.rstudio.com/products/rstudio/download/,点击下载 Windows 系统的安装包。双击运行安装程序,按默认设置至安装结束。

RStudio 基本配置

安装 rmarkdown

使用 R markdown 需要先安装 R 包 rmarkdownknitrcaTools,命令为 install.packages(c('rmarkdown', 'knitr', 'caTools'))

设置默认编码方式为 UTF-8

  1. 打开 RStudio,选择菜单 Tools -> Global Options...
  2. Option 界面选择 code 选项卡,然后主窗口选择 Saving 选项卡。
  3. 点击 Default text encoding: 下方的 Change 按钮,在弹出的窗口中选择 UTF-8
  4. 点击 OK 保存并退出。
    Windows 系统使用 R markdown 和 LaTeX 生成中文 PDF 的基本配置

设置编译引擎

  1. 打开 RStudio,选择菜单 Tools -> Global Options...
  2. Option 界面选择 Sweave 选项卡。
  3. Typeset LaTeX into PDF using: 这一项右侧的下拉菜单中选择 XeLaTeX,保存退出。
    Windows 系统使用 R markdown 和 LaTeX 生成中文 PDF 的基本配置

生成 pdf

  • 新建纯文本,输入以下内容,以 UTF-8 编码保存为文件 test_pdf_zh.Rmd

      ---
      title: "R markdown 和 CTeX 生成 pdf"
      output: 
        pdf_document:
          includes:
    	      in_header: header.tex
          latex_engine: xelatex
      ---
    
      # R Markdown 和 CTeX
    
      Context
    
      # 中文标题
    
      中文内容
    
  • 准备 header.tex,文件以 UTF-8 编码

    A. 使用默认设置

      \usepackage{ctex}
    

    B. 自定义字体

      \usepackage{ctex}
      \setmainfont{Times New Roman} % 设置英文字体
      \setCJKmainfont{宋体}		% 设置中文字体
    
  • 点击 Knit,或者运行命令 render('test_pdf_zh.Rmd') 生成 pdf。
    Windows 系统使用 R markdown 和 LaTeX 生成中文 PDF 的基本配置

  • 查看结果文件 test_pdf_zh.pdf
    Windows 系统使用 R markdown 和 LaTeX 生成中文 PDF 的基本配置