Pandoc PDF 中文

最近终于又决定（^_^）使用reStructuredText写文档了，输出PDF时的中文问题必须要解决下。

安装环境

sudo apt install texlive texlive-latex-extra texlive-latex-recommended texlive-xetex pandoc

非Debian或Windows请自行google之

LaTeX中文

这个PDF的中文问题，其实就是LaTeX的中文问题，因为所有的PDF生成方式，都是先生成TeX和LaTeX文件的。

在XeTeX问世之前，在TeX里搞中文是一件比较费劲的事，好在XeTeX已经存在很多年了，XeTeX解决了Unicode和字体问题，但是排出来的中文断行，标点处理上还不太好，于是国人就写了xeCJK这个宏包，概括一下，XeTeX+xeCJK之后，TeX中写中文就和写英文差不多友好了。

在linux-wiki.cn上有一篇写LaTeX中文的文章，略微有一点老，不过大意是没有变化，我把那的代码粘贴到这里

\documentclass[11pt]{article}
\usepackage[BoldFont,SlantFont,CJKsetspaces,CJKchecksingle]{xeCJK}
\setCJKmainfont[BoldFont=SimHei]{SimSun}
\setCJKmonofont{SimSun}% 设置缺省中文字体
\parindent 2em   %段首缩进
 
\begin{document}
\section{举例}
\begin{verbatim}
标点。
\end{verbatim}
 
汉字Chinese数学$x=y$空格
\end{document}

根据xeCJK的文档，我认为以上的代码需要改成现在这个形式，如果文档是正确的话

\documentclass[11pt]{article}
\usepackage[AutoFakeBold=true,AutoFakeSlant=true,CJKspace=true,CheckSingle=true,PunctStyle=kaiming]{xeCJK}
\setCJKmainfont[BoldFont=SimHei]{SimSun}
\setCJKmonofont{SimSun}% 设置缺省中文字体
\parindent 2em   %段首缩进
 
\begin{document}
\section{举例}
\begin{verbatim}
标点。
\end{verbatim}
 
汉字Chinese数学$x=y$空格
\end{document}

注：xeCJK现在是CTeX-kit中的一员，在Github上有仓库

Pandoc的LaTeX

pandoc可以转换很多格式，其中就包含reST，使用xelatex转换为PDF的命令行，基本格式为

pandoc -t latex --latex-engine=xelatex -s -o xxx.pdf xxx.rst

直接执行这条命令，当然是不好使的，因为没有使用xeCJK，也未指定中文字体。

pandoc在转换latex的时候，会使用一个默认的模板文件，这个模板文件可以使用如下命令查看

pandoc -D latex

我们当然可以使用自己的模板，具体参考pandoc文档，不过我发现如果要求不高，默认的模板也是可以输出中文的，需要定义两个variable，我们这里直接使用命令行的方式传递变量值

pandoc -t latex --latex-engine=xelatex -s -VCJKoptions=BoldFont="SimHei" -VCJKmainfont="SimSun" -o xxx.pdf xxx.rst

今天就到这里，后面继续研究使用rst2pdf和sphinx来将reST文档转换为PDF