Doxygen 使用教程小结

【安装】

1、安装Doxygen

下载地址：http://www.doxygen.nl/download.html

2、安装Graphviz

下载地址：http://www.graphviz.org/download/

graphviz 是一个由AT&T实验室启动的开源工具包，用于绘制DOT语言脚本描述的图形。Doxygen 使用 graphviz 自动生成类之间和文件之间的调用关系图，如不需要此功能可不安装该工具包。

3、安装 Windows Help Workshop

下载地址：https://docs.microsoft.com/zh-cn/previous-versions/windows/desktop/htmlhelp/microsoft-html-help-downloads

Doxygen 使用这个工具可以生成 CHM 格式的文档。

 

【配置】

1、程序代码中的注释符合doxygen风格。

2、使用Doxywizard进行配置

3、使用Doxygen来产生批注文档

---

以下是doxywizard的详细配置图文教程：

说明：1，Doxygen 工作目录，就是用来存放配置文件的目录。4，递归搜索源文件目录需要选上。

 

Wizard 标签下的 Output

doxygen本身不支持直接生成pdf文件，而是提供生成pdf需要的原材料（latex），然后再使用CTeX （下载CTeX ：https://mirrors.tuna.tsinghua.edu.cn/ctex/legacy/2.9/）将latex生成PDF。

生成PDF
（1）CTeX安装完成后打开Texworks软件，再打开latex/refman.tex
（2）在“排版”选项中选择pdfLaTex+MakeIndex+BibTex，最后点击左上角“排版”，即可生成refman.pdf。
 

Wizard 下的 Diagrams

说明：如果选择这个选项之前需要先安装了 Graphviz 工具包。

 

Expert 标签下的 Project

说明：编码格式，UTF-8 是首选。如果需要显示中文则选择GB2312

 

Expert 标签下的 Build

Build页面，这个页面是生成帮助信息中比较关键的配置页面：

EXTRACT_ALL	输出所有的函数，但是private和static函数不属于其管制。
EXTRACT_PRIVATE	输出private函数。
EXTRACT_STATIC	输出static函数。同时还有几个EXTRACT，相应查看文档即可。
HIDE_UNDOC_MEMBERS	那些没有使用doxygen格式描述的文档（函数或类等）就不显示了。当然，如果EXTRACT_ALL被启用，那么这个标志其实是被忽略的。
INTERNAL_DOCS	是否输出注解中的@internal部分。如果没有被启动，那么注解中所有的@internal部分都将在目标帮助中不可见。
CASE_SENSE_NAMES	是否关注大小写名称，注意，如果开启了，那么所有的名称都将被小写。对于C/C++这种字母相关的语言来说，建议永远不要开启。
HIDE_SCOPE_NAMES	域隐藏，建议永远不要开启。
SHOW_INCLUDE_FILES	是否显示包含文件，如果开启，帮助中会专门生成一个页面，里面包含所有包含文件的列表。
INLINE_INFO	如果开启，那么在帮助文档中，inline函数前面会有一个inline修饰词来标明。
SORT_MEMBER_DOCS	如果开启，那么在帮助文档列表显示的时候，函数名称会排序，否则按照解释的顺序显示。
GENERATE_TODOLIST	是否生成TODOLIST页面，如果开启，那么包含在@todo注解中的内容将会单独生成并显示在一个页面中，其他的GENERATE选项同。
SHOW_USED_FILES	是否在函数或类等的帮助中，最下面显示函数或类的来源文件。
SHOW_FILES	是否显示文件列表页面，如果开启，那么帮助中会存在一个一个文件列表索引页面。

 

Expert 标签下的 Input

说明：输入的源文件的编码，要与源文件的编码格式相同。如果源文件不是UTF-8编码最好转一下。

 

expert 标签下的 HTML

说明：

1，CHM_FILE文件名需要加上后缀（xx.chm）。

2，如果在 Wizard 的 Output Topics 中选择了 prepare for compressed HTML (.chm)选项，此处就会要求选择 hhc.exe 程序的位置。在 windows help workshop 安装目录下可以找到 hhc.exe。

3，为了解决DoxyGen生成的CHM文件的左边树目录的中文变成了乱码，CHM_INDEX_ENCODING 中输入GB2312即可。

4，GENERATE_CHI 表示索引文件是否单独输出，建议关闭。否则每次生成两个文件，比较麻烦。

5，TOC_EXPAND 表示是否在索引中列举成员名称以及分组（譬如函数，枚举）名称。

 

选择 Run 标签