Linux下doxygen、graphviz生成chm文档

72 阅读 0 评论 48 点赞

我是靠谱客的博主甜蜜凉面，最近开发中收集的这篇文章主要介绍Linux下doxygen、graphviz生成chm文档，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

本文记录的是在Puppy圣诞版（4.0）上安装doxygen1.63、graphviz2.22.2、HTML Help Workshop（v4.74）的过程。

本机的Gcc版本为：

# gcc --version
gcc (GCC) 4.2.2

到官网去下载，网页上只有最新版的下载，老版本的没有下载链接

下个1.8.10，然后解压，进入目录后 ./configure，make 出错，是个语法错误，我认为是Gcc版本低的原因。

看了一下常用的PT1.4中的Doxfile文件，是使用Doxygen 1.4.3版本产生的，我也没有必要使用最新版的。

上网上搜了一下老版本的Doxygen，根本找不到链接。

看了一下官网上的下载链接，ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.10.linux.bin.tar.gz

把后面的文件名去掉，ftp://ftp.stack.nl/pub/users/dimitri/ ，再把此网址在Firefox上的地址栏中“粘贴并转到”，看到了所有版本的下载画面

找一个低版本的1.5.8, make 后安装成功，依次试验高版本，发现本机支持的最高版本是1.6.3。

graphviz的过程基本上是一样的。

网站上显示的是最新版的，所有版本的下载只要把最后的文件名去掉就可以打开。

从2.20开始编译，找不到GD库，./configure --help后，./configure --with-libgd=no --with-mylibgd=yes可以屏蔽本机的GD库，使用Graphviz自己的库。

make 成功了，本机支持最高版本的是Graphviz2.22.2，再高的版本编译不成功。

HTML Help Workshop（v4.74）直接使用Wine不能安装，在WinXP下安装后，把文件夹拷贝到 /root/.wine/drive_c/Progame Files就行了，删除/root/.wine/drive_c/windows/system32/中的 itircl.dll itss.dll，将XP中对应的二个文件拷贝到root/.wine/drive_c/windows/system32，并且删除/usr/share/lib/itss.dll.so,使用regsvr32 root/.wine/drive_c/windows/system32/itss.dll,regsvr32 root/.wine/drive_c/windows/system32/itirc.dll,注册这两个控件。使用下面的脚本能正确编译hhp到chm。

#! /bin/sh
export DISPLAY=:0.0
export WINEDLLOVERRIDES="itss=n,b"
wine /root/.wine/drive_c/Program Files/HTML Help Workshop/hhc.exe index.hhp >a.txt

测试上述软件都能正常工作时，将下面的文本保存到/bin/Doxygen.linux,Doxygen配置文件如下：

DOXYFILE_ENCODING      = UTF-8
OUTPUT_LANGUAGE        = Chinese
OPTIMIZE_OUTPUT_FOR_C = YES
CHM_INDEX_ENCODING     = GBK
PROJECT_NAME           = "My Project"
CREATE_SUBDIRS         = YES
RECURSIVE              = YES
EXAMPLE_RECURSIVE      = YES
GENERATE_AUTOGEN_DEF   = YES
SOURCE_BROWSER         = YES
INLINE_SOURCES         = YES
GENERATE_LATEX         = NO
MACRO_EXPANSION        = YES
GENERATE_HTMLHELP      = YES
#GENERATE_RTF           = YES
HAVE_DOT               = YES
UML_LOOK               = YES
TEMPLATE_RELATIONS     = YES
CALL_GRAPH             = YES
CALLER_GRAPH           = YES
DOT_GRAPH_MAX_NODES    = 200
DOT_TRANSPARENT        = YES
DOT_MULTI_TARGETS      = YES
DISTRIBUTE_GROUP_DOC   = YES
INCLUDE_FILE_PATTERNS = *.c *.cpp *.h *.txt *.dox
REFERENCES_RELATION    = YES

编写自动生成帮助的脚本如下：

#! /bin/sh
regsvr32 /root/.wine/drive_c/windows/system32/itss.dll
regsvr32 /root/.wine/drive_c/windows/system32/itircl.dll
rm -rf /usr/lib/wine/itss.dll.so
if [ -f Doxyfile ]; then
    echo "file CMakeLists.txt is ok"
else
    ln -sf /bin/Doxyfile.linux Doxyfile
fi
if [ -n "$1" ]; then
    doxygen $1
else
    doxygen
fi
if [ -L Doxyfile ]; then
    rm Doxyfile
fi
cd html
export DISPLAY=:0.0
export WINEDLLOVERRIDES="itss=n,b"
wine /root/.wine/drive_c/Program Files/HTML Help Workshop/hhc.exe index.hhp >a.txt
read -p "Press any key to continue." var
exit 0