天天看点

使用Doxygen生成C#帮助文档

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t0">一 什么是Doxygen</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t1">二 准备软件</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t2">1 doxygen</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t3">2 graphviz</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t4">3 Microsoft HTML Help Workshop</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t5">三 C注释</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t6">四 配置</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t7">1 Doxygen工作目录</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t8">2 Wizard 向导</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t9">      421 Project 项目</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t10">      422 Mode 模式</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t11">      423 Output 输出</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t12">      424 Diagrams 图表</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t13">3 Export 导出</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t14">      431 Project  项目</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t15">      432 Build 构建</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t16">      433 Input 输入</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t17">      434 Index 索引</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t18">      435 HTML</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t19">      436 Dot</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t20">五Run 运行</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t21">六HTML效果图</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t22">七CHM效果图</a>

<a href="http://www.cnblogs.com/zhaoqingqing/p/3842236.html#t23">八提醒</a>

Doxygen 是一个程序的文件产生工具,可将程序中的特定批注转换成为说明文件。通常我们在写程序时,或多或少都会写上批注,但是对于其它人而言,要直接探索程序里的批注,与打捞铁达尼号同样的辛苦。大部分有用的批注都是属于针对函式,类别等等的说明。所以,如果能依据程序本身的结构,将批注经过处理重新整理成为一个纯粹的参考手册,对于后面利用您的程序代码的人而言将会减少许多的负担。不过,反过来说,整理文件的工作对于您来说,就是沉重的负担。

Doxygen 就是在您写批注时,稍微按照一些它所制订的规则。接着,他就可以帮您产生出漂亮的文档了。

因此,Doxygen 的使用可分为两大部分。首先是特定格式的批注撰写,第二便是利用Doxygen的工具来产生文档。

使用Doxygen生成C#帮助文档

注:这个软件不是必需的,如果需要使用更强大的功能比如类继承体系图等则需要安装此软件配置使用,需要安装Java环境

使用Doxygen生成C#帮助文档

chm文件制作工具

三个软件

使用Doxygen生成C#帮助文档

请选择一个已存在的非中文路径的文件夹,如下图:

使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档

将With search function的钩去掉

使用Doxygen生成C#帮助文档

plain HTML,为下图一,with navigation panel为下图二

使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档

(Use built-in class diagram generator)将使用内置的生成功能生成每个类的类图,只有一个类是不为生成的。

如果需要更加大的功能比如类继承体系图请选择第三项(Use dot tool from the GraphViz package)需要安GraphViz。

OUTPUT_LANGUAGE选择chinese TAB_SIZE是Tab的长度

使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档

默认是会生成public方法,这里也选择EXTRACT_ALL。它保证输出所有public方法及project方法,EXTRACT_STATIC是生成静态方法。

使用Doxygen生成C#帮助文档

Input为输入目录,支持多个目录,我们可以放入项目目录和include目录,下面的Exclude是忽略目录与文件,可自行添加。

使用Doxygen生成C#帮助文档

选择ALPHABETICAL_INDEX,类中将有一个组合类型索引项。

使用Doxygen生成C#帮助文档

生成的索引如下图所示

使用Doxygen生成C#帮助文档

如果你之前选择了(prepare form compressed HTML(.chm))这里抽GENERATE_HTMLHELP项会是选择状态,它下面的CHM_FILE填写你的CHM文档的名字(要加上.chm)。HHC_LOCATION则选择你的HTML Help WorkShop安装目录下的HHC程序,一般会在C:/Program Files (x86)/HTML Help Workshop/hhc.exe。选择TOC_EXPAND会生成左边的树目录。

使用Doxygen生成C#帮助文档

如果你选用内置的生成功能(Use build-in class diagram generator)此时CLASS_DIAGRAMS会是选择状态,而HAV_DOT是未选择状态,如果你选择用GraphViz的dot工具生成(Use dot tool from the GraphViz package)情况则相反,请你选择上CLASS_DIAGRAMS。此时你需要设置下面的DOT_PATH为GraphViz的安装目录,否则将无法生成。

另外以下选项选择则生成对应的图,不选择则不生成。

CLASS_GRAPHS                   类图

COLLABORATION_GRAPH      协作图

GROUP_GRAPHS                   组图

UML_LOOK                           是否UML外观

INCLUDE_GRAPH                   include

INCLUDED BY GRAPH             被include

CALL_GRAPH                        调用

CALLER_GRAPH                    被调用

DIRECTORY_GRAPH               目录图

GRAPHICAL_HIERARCHY        继承体系图

使用Doxygen生成C#帮助文档

配置好后中进入Run选项卡单击 Run Doxygen 即开始生成,等待生成完毕后点击 “Show HTML output”

使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档
使用Doxygen生成C#帮助文档

提醒一下,如果是WIN8的操作系统,建议设置dot的兼容性,并以管理员身份运行,否则一直会弹出dot停止运行的警告框

使用Doxygen生成C#帮助文档

本文转自赵青青博客园博客,原文链接:http://www.cnblogs.com/zhaoqingqing/p/3842236.html,如需转载请自行联系原作者