作者：zyl910
眾所周知，能夠利用doxygen生成pdf文檔——但是，如果其中含有中文的話，那就會遇到一大堆問題無法順利輸出。我花了很長時間摸索，最終找到了讓doxygen順利生成中文pdf的辦法。
系統環境——
1) Mac OS X Lion 10.7.5 + MacTeX-2012 。
2) Windows XP SP3 + CTeX 2.9.2.164 。
一、原理解釋
doxygen本身並不能直接輸出pdf文件，而是生成了latex目錄，其中有一個 makefile 文件。若系統中裝好了pdflatex，可在latex目錄中運行“make”命令來生成pdf文件。
怎樣才能裝好pdflatex呢？mac平台可安裝MacTeX，windows平台可安裝CTeX。
環境裝好之后，當在latex目錄中運行“make”命令來生成pdf文件時會發現——純英文文檔能順利生成pdf；而含有中文時，不能順利生成pdf文件。
對於latex排版，doxygen其實已經做了很多准備，比如——源文件是UTF-8編碼，並默認使用了utf8 package。理論上是支持多國語言的。
可對於中文來說，還需要加載 CJKutf8 package，並配置好CJK環境。這才能順利的使用中文。
二、解決方案
具體步驟——
1) 使用docxygen生成文檔，注意選上 GENERATE_LATEX 、LATEX_OUTPUT、USE_PDFLATEX（最好還選上 PDF_HYPERLINKS）；
2) 用文本編輯器打開docxygen生成的latex目錄中的refman.tex。找到“\begin{document}”這一行，將其修改為——
\usepackage{CJKutf8}
\begin{document}
\begin{CJK}{UTF8}{gbsn}
然后再找到“\end{document}”這一行，將其修改為——
\end{CJK}
\end{document}
保存，關閉。
3) 打開終端，使用cd命令進入latex目錄，然后執行“make”命令。執行完畢后后，該目錄中會出現“refman.pdf”——
我在 mac + MacTeX 環境下make時，能完美生成帶書簽的pdf。
而在 win + CTeX 環境下make時，其中還會彈出一堆錯誤（輸入r再回車，可忽略后續錯誤），但是最終還是能夠生成中文的pdf，可惜一般不能順利的構造好書簽。
參考文獻——
MacTeX: http://www.tug.org/mactex/
CTeX: http://www.ctex.org/
《如何利用doxygen生成pdf文檔》. David(bichenggui), 2009-04-22. http://blog.csdn.net/bichenggui/article/details/4101294
《如何在 Mac OS X 上裝設 LaTeX 以及 CJK 套件 (TeX Live 2007)》. 元智光電所元件物理暨檢測實驗室, 2009-03-06. http://exciton.eo.yzu.edu.tw/~lab/latex/install_cjk.html
《linux latex 中文解決辦法(CJKUTF8)－－超簡單》.learningloong, 2011-08-31. http://learningloong.blog.163.com/blog/static/16230812420117318720817/
《Kile下使用CJK中文字體的簡單方法》. 風臨海岸, 2011-10-10. http://my.opera.com/adoskk/blog/2011/10/10/kile