使用doxygen和CTEX生成pdf文档
之前一直使用doxygen生成HTML格式代码文档,在电脑上阅读没有问题,前几日领导提出打印要求,于是考虑生成PDF文档。
在网上翻看了很多文章,发现可以使用doxygen和CTEX生成pdf文档,于是将过程整理如下,由于本人新接触CTEX,对其了解有限,这里只描述我的操作步骤,对CTEX感兴趣的童鞋可google查找学习。
一、使用doxygen生成LaTeX文档,具体过程可参照http://blog.csdn.net/yichi7758/article/details/8782770 ,之后记得勾选LaTeX选项,生成tex文件。
二、使用CTEX自带的WinEdt工具打开refman.tex文件,这里是安装文件下载地址:http://ftp.ctex.org/pub/tex/systems/ctex/2.9/CTeX_2.9.2.164_Full.exe
三、如果你的注释完全采用英文,那么直接点击就可以生成pdf文档了,但是如果你的文档中包含中文,那么恭喜你,你将有一大堆的错误问题需要解决
问题1、编译执行过程中中止,并要求你输入,请先输入r,即不顾一切的执行下去,先生成文档并从结果判断其它问题。
问题2、生成的文档中中文无法显示,此时需要 在 “\begin{document}”之前增加xeCJK支持,如下:
\usepackage{xeCJK} \setCJKmainfont{AR PL UKai CN} \begin{document}
AR PL UKai CN为文档字体,也可以设置为其它字体,如:{Microsoft YaHei}%微软雅黑,{Adobe Song Std}%宋体
此时生成的pdf文档应该可以支持中文了。
问题3、xelatex编译的时候会报出:
! LaTeX Error: Command \nobreakspace unavailable in encoding T1.
【解决方案】
这个错误是由 xunicode 造成的,xunicode对空格进行了重定义,可以把其定义改为原始定义即可,
\DeclareRobustCommand\nobreakspace{\leavevmode\nobreak\ }
问题4、! Package hyperref Error: Wrong DVI mode driver option `ps2pdf',
(hyperref) because XeTeX is running.
这个问题据说是由于XeLaTeX不支持ps2pdf造成的,但是由于我们需要UTF-8编码支持不得不选用XeLaTeX,好在我再使用r命令强制运行后也没发现文档有什么问题,因此暂且搁置,希望各路大神看到后可以指点小弟我。