Doxygen 生成中文 Latex 文档

如今已经离不开 Mac 了，寒假的时候好好研究了一下Latex，终于在 Mac 能够熟练使用 MacTex 的各种生成方法了。

造轮子的时候，通常会遇到写文档的麻烦，了解到有 Doxygen 这个工具，还可以生成 Latex 的 pdf 文档，果断用了它。

但是似乎并不能直接根据代码生成中文文档，这就很讨厌了。

原因在于 doxygen 本身并不能直接输出 pdf 文件，而是生成 latex 目录，利用 makefile 来生成pdf文件。幸运的是，对于 latex 排版，doxygen 其实已经做了很多准备，保存的源文件是UTF-8编码，并默认使用了utf8 package。因此是支持多国语言的。

但是对于中文来说，还需要加载 CJKutf8 package，并配置好CJK环境。这才能顺利的使用中文。

所以解决方法其实很简单：

使用docxygen生成文档，注意选上 GENERATE_LATEX 、LATEX_OUTPUT、USE_PDFLATEX（最好还选上 PDF_HYPERLINKS）； 用文本编辑器打开 docxygen 生成的 latex 目录中的 refman.tex。找到“\begin{document}”这一行，将其修改为

1
2
3
4
5
6
7
8

\usepackage{CJKutf8} 
\begin{document}
\begin{CJK}{UTF8}{gbsn} 
[/code]
再找到“\end{document}”这一行，将其修改为
[code lang="latex"]
\end{CJK} 
\end{document}

保存，输入make，完成编译。