一款文档生成工具:Doxygen生成

程序员的很多文档，特别是有代码的文档，绝大部分都是由一款文档生成工具【Doxygen】生成什么是Doxygen?Doxygen 是一个程序的文件产生工具，可将程序中的特定批注转换成为说明文件通常我们在写程序时，或多或少都会写上批注，但是对于其它人而言，要直接探索程序里的批注，与打捞铁达尼号同样的辛苦。

大部分有用的批注都是属于针对函式，类别等等的说明所以，如果能依据程序本身的结构，将批注经过处理重新整理成为一个纯粹的参考手册，对于后面利用你的程序代码的人而言将会减少许多的负担不过，反过来说，整理文件的工作对于你来说，就是沉重的负担。

简而言之，Doxgen就是大名鼎鼎的文档生成工具，而且是免费开源的，它使用非常方便，能提取C++，Java，Objective-C，Python，IDL，PHP，C#等语言的注释，从而生成文档Doxygen 的使用可分为两大部分。

首先是特定格式的批注撰写，第二便是利用Doxygen的工具来生成文档生成文档使用教程1、安装在Linux下可以通过apt install doxygen安装命令行工具，然后用apt install doxygen-gui安装图形界面。

对Linux用户来说，命令行工具可以通过doxygen命令运行，而图形界面可以通过doxywizard命令运行Windows 用户的下载地址：http://www.doxygen.nl/download

.html2、基本使用图形工具的基本使用如下图所示，有非常多的配置选项，这里我们只填入必要的配置，其它配置都用默认值。

doxywizard使用步骤

doxywizard使用步骤工作目录如下：复制. ├──out └── src └── math.h其中复制math.h代码如下：复制/*! file math.h *//*! 用于求一个角度的sin值，输入是字符串以便同时支持弧度制和角度制表示 li 弧度制用

pi表示，例如：2pi表示一圈、0.5pi表示直角 li 角度制用d结尾，例如：360d表示一圈、90d表示直角 li 输入也可以是数值，例如：输入3.14159大约表示180度 param a 用弧度制或角度制表示都行，字符串必须用�表示结束 param[out] res 是输出

参数，用于保存sin运算的结果 eturn 错误码，0表示成功，其它表示失败 odo 在xxx的情况下存在BUG，预计下一版本修复 */intsin(char*a,double*res);Doxygen生成的HTML会放到

复制out目录下，生成的HTML如下图所示。

HTML界面3、保存配置上面我们配置了一些选项，也成功生成了HTML文档。我们希望下次代码改动后能够继续沿用上次配置，那么我们可以把这些配置保存成Doxyfile文件，如下图所示。

保存Doxyfile配置文件4、命令行运行Doxygen有了配置文件后我们完全可以通过命令行来生成API文档，假设配置文件名为Doxyfile，那么我们只需要执行doxygen /path/to/Doxyfile即可生成API文档。

通过命令行生成文档有许多好处，其中最主要的好处就是：能够集成到持续集成之类的自动化系统中为代码编写注释1.什么样的注释会被Doxygen识别？Doxygen能识别这几种风格的注释：复制/** * ... 。

text ... *//*! * ... text ... */////// ... text .../////!//!... text ...//!文件的开头必须有文件注释，否则该文件不会被识别：复制

/*! file math.h */2.注释怎么写这里建议参考官网例子https://www.doxygen.nl/manual/doxygen_usage.html为其它编程语言生成注释Doxygen主要支持。

C语言，其它语法跟C差不多的语言（如：C++/C#/PHP/Java）也能够支持，我们称这类语言为「C语系语言」而哪些跟C语法差异较大的语言叫做「非C语系语言」对于大多非C语系语言，Doxygen都是支持的，Doxygen原生支持这些语言：IDL、Java、Javascript、C#、C、C++、D、PHP、Objective-C、Python、F。

ortran、VHDL万一项目需要的语言（例如：Lua）Doxygen官方并不支持，那么只能自行编写「第三方语言扩展」来支持了1.Doxygen官方支持的语言见下图，文件名符合FILE_PATTERNS都会被处理。

其中包括了.c、.h、.py等等

如果我们的扩展名并不在FILE_PATTERNS内，那么可以加上去例如我们项目下的所有.ccc文件，其实是C语言代码（这很奇葩，举个例子而已）那我们可以编辑Doxyfile配置文件满足这一需求，需要2个步骤。

(1) 在FILE_PATTERNS中添加*.ccc，如下图：

(2) 在EXTENSION_MAPPING中添加映射规则ccc=C，如下图，语法是ext=language，其中language可以取的值有：IDL、Java、Javascript、C#、C、C++、D、PHP、Objective-C、Python、Fortran、VHDL。

2.Doxygen官方不支持的语言以Lua语言为例，它的代码是长这样的：复制-- file lmath.h 复制--[[复制 用于求一个角度的sin值，输入是字符串以便同时支持弧度制和角度制表示复制

li 弧度制用pi表示，例如：2pi表示一圈、0.5pi表示直角复制 li 角度制用d结尾，例如：360d表示一圈、90d表示直角复制 li 输入也可以是数值，例如：输入3.14159大约表示180度

复制 param a 字符串类型，表示角度，用弧度制或角度制表示都行复制 eturn 返回sin运算的结果 复制 odo 在xxx的情况下存在BUG，预计下一版本修复复制--]]复制

function sin(a)复制 return 1.123复制end可以看到Lua的语法既不像C也不像Python。 审核编辑 ：李倩

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。