星期四, 十二月 14, 2006
因为实在是很不喜欢写文档,不得不在cygwin下使用doxygen,不过我要说,对doxygen的尝试绝对是值得的.它将影响我以后写代码的方式.Doxygen生成了我非常满意的html格式的文档,而且中文的显示也没有任何问题.
然后,既然默认生成了一份latex格式的源文件,我尝试用其生成文档的pdf格式.在cygwin下使用自动安装的方式安装tetex也非常的轻松,下 载了大约50M的源文件以后,很快,tetex安装好了,生成dvi文件和pdf文件也没有问题,顺便说一下,doxygen已经生成好了 Makefile,只需要make就可以生成dvi格式的文件,要生成pdf格式的文件需要用make pdf.
不过,pdf里面的中文是乱码.cygwin并不会安装cjk宏包,从网上下载了cjk宏包修改了refman.tex源文件以后,安装中文字体却始终无 法成功,算了,不再浪费时间了.尝试在已经安装好tex环境的机器上编译修改后的pdf,是没有问题的,中文都可以很好的显示.Doxygen真是个好东 西.
不过,生成的没有链接的PDF几乎没有任何实际使用价值,(除了炫耀).生成的网页虽好,要打包到别的地方就有点不太方便,上网找了一下,发现了一篇文章:
Howto generate the documentation in Windows Help file format
大概步骤如下:
1: Download the Microsoft HTML Help Workshop here: Microsoft MSDN page (the 'Download Htmlhelp.exe' link)
2: Install above program.
3: Edit the doxygen configuration file
如法试之,果然成功,一个非常漂亮干净的chm文件就这样诞生了.
一点小小的不爽的地方是:明明hhc执行成功了,doxygen却说其执行失败了.有点不爽,上网查原因也差不到.还好我需要的都能得到.也就行了,以后再说吧 因为实在是很不喜欢写文档,不得不在cygwin下使用doxygen,不过我要说,对doxygen的尝试绝对是值得的.它将影响我以后写代码的方式.Doxygen生成了我非常满意的html格式的文档,而且中文的显示也没有任何问题.
然后,既然默认生成了一份latex格式的源文件,我尝试用其生成文档的pdf格式.在cygwin下使用自动安装的方式安装tetex 也非常的轻松,下载了大约50M的源文件以后,很快,tetex安装好了,生成dvi文件和pdf文件也没有问题,顺便说一下,doxygen已经生成好 了Makefile,只需要make就可以生成dvi格式的文件,要生成pdf格式的文件需要用make pdf.
不过,pdf里面的中文是乱码.cygwin并不会安装cjk宏包,从网上下载了cjk宏包修改了refman.tex源文件以后,安装中文字体却始终无 法成功,算了,不再浪费时间了.尝试在已经安装好tex环境的机器上编译修改后的pdf,是没有问题的,中文都可以很好的显示.Doxygen真是个好东 西.
不过,生成的没有链接的PDF几乎没有任何实际使用价值,(除了炫耀).生成的网页虽好,要打包到别的地方就有点不太方便,上网找了一下,发现了一篇文章:
Howto generate the documentation in Windows Help file format
大概步骤如下:
1: Download the Microsoft HTML Help Workshop here: Microsoft MSDN page (the 'Download Htmlhelp.exe' link)
2: Install above program.
3: Edit the doxygen configuration file
如法试之,果然成功,一个非常漂亮干净的chm文件就这样诞生了.
一点小小的不爽的地方是:明明hhc执行成功了,doxygen却说其执行失败了.有点不爽,上网查原因也差不到.还好我需要的都能得到.也就行了,以后再说吧 ¶ 11:43 上午
然后,既然默认生成了一份latex格式的源文件,我尝试用其生成文档的pdf格式.在cygwin下使用自动安装的方式安装tetex也非常的轻松,下 载了大约50M的源文件以后,很快,tetex安装好了,生成dvi文件和pdf文件也没有问题,顺便说一下,doxygen已经生成好了 Makefile,只需要make就可以生成dvi格式的文件,要生成pdf格式的文件需要用make pdf.
不过,pdf里面的中文是乱码.cygwin并不会安装cjk宏包,从网上下载了cjk宏包修改了refman.tex源文件以后,安装中文字体却始终无 法成功,算了,不再浪费时间了.尝试在已经安装好tex环境的机器上编译修改后的pdf,是没有问题的,中文都可以很好的显示.Doxygen真是个好东 西.
不过,生成的没有链接的PDF几乎没有任何实际使用价值,(除了炫耀).生成的网页虽好,要打包到别的地方就有点不太方便,上网找了一下,发现了一篇文章:
Howto generate the documentation in Windows Help file format
大概步骤如下:
1: Download the Microsoft HTML Help Workshop here: Microsoft MSDN page (the 'Download Htmlhelp.exe' link)
2: Install above program.
3: Edit the doxygen configuration file
GENERATE_HTMLHELP = NO --> GENERATE_HTMLHELP = YES
BINARY_TOC = NO --> BINARY_TOC = YES
TOC_EXPAND = NO --> TOC_EXPAND = YES
HHC_LOCATION = --> HHC_LOCATION = "{path to MS HTML Help
Workshop}hhc.exe"
如法试之,果然成功,一个非常漂亮干净的chm文件就这样诞生了.
一点小小的不爽的地方是:明明hhc执行成功了,doxygen却说其执行失败了.有点不爽,上网查原因也差不到.还好我需要的都能得到.也就行了,以后再说吧 因为实在是很不喜欢写文档,不得不在cygwin下使用doxygen,不过我要说,对doxygen的尝试绝对是值得的.它将影响我以后写代码的方式.Doxygen生成了我非常满意的html格式的文档,而且中文的显示也没有任何问题.
然后,既然默认生成了一份latex格式的源文件,我尝试用其生成文档的pdf格式.在cygwin下使用自动安装的方式安装tetex 也非常的轻松,下载了大约50M的源文件以后,很快,tetex安装好了,生成dvi文件和pdf文件也没有问题,顺便说一下,doxygen已经生成好 了Makefile,只需要make就可以生成dvi格式的文件,要生成pdf格式的文件需要用make pdf.
不过,pdf里面的中文是乱码.cygwin并不会安装cjk宏包,从网上下载了cjk宏包修改了refman.tex源文件以后,安装中文字体却始终无 法成功,算了,不再浪费时间了.尝试在已经安装好tex环境的机器上编译修改后的pdf,是没有问题的,中文都可以很好的显示.Doxygen真是个好东 西.
不过,生成的没有链接的PDF几乎没有任何实际使用价值,(除了炫耀).生成的网页虽好,要打包到别的地方就有点不太方便,上网找了一下,发现了一篇文章:
Howto generate the documentation in Windows Help file format
大概步骤如下:
1: Download the Microsoft HTML Help Workshop here: Microsoft MSDN page (the 'Download Htmlhelp.exe' link)
2: Install above program.
3: Edit the doxygen configuration file
GENERATE_HTMLHELP = NO --> GENERATE_HTMLHELP = YES
BINARY_TOC = NO --> BINARY_TOC = YES
TOC_EXPAND = NO --> TOC_EXPAND = YES
HHC_LOCATION = --> HHC_LOCATION = "{path to MS HTML Help
Workshop}hhc.exe"
如法试之,果然成功,一个非常漂亮干净的chm文件就这样诞生了.
一点小小的不爽的地方是:明明hhc执行成功了,doxygen却说其执行失败了.有点不爽,上网查原因也差不到.还好我需要的都能得到.也就行了,以后再说吧 ¶ 11:43 上午
