分类：
2012-09-20 08:45:28
原文地址：Doxygen 配置详解 作者：iibull
doxygen -g
文档中的HTML标志被解释和转换成相应的输出。请看：章节获取更多的关于HTML标志的使用信息。
Doxygen 是一个基于命令行的实用工具。在命令行使用—help可以显示关于各种命令的简短描述。
所有的命令开关都包括前导字符-， 后面跟什么命令（1个字符或是多个字符）取决于你的选择。
为了为你的工程产生一个手册，典型的情况----你需要经过下面几个步骤：
1. 你想要在你的文档中使用特殊的块状标识 (请参考Special documentation blocks章节)。
2. 可以通过使用doxygen 中的-g 来创建配置文件(请参考章节)：
3. 你需要针对你的工程编写相应的配置文件。在配置文件中你可以指定输入文件以及很多其它的信息。
4. 通过使用下面的命令来对你配置过的文件产生相应的文档：
如果你使用老版本的doxygen生成过配置文件，你可以通过运行doxygen 中的 -u 命令来对其进行更新。
在原来配置文件中的所有信息都会被替换成新的配置文件。所有新版本doxygen中的配置都会使用默认值。但是，你改动前的原来的配置文件中的所有的注释都会被自动删除。
如果你想让产生的文档能够按照某种你自定义的格式进行显示的话。如果你编辑了下面的内容doxygen 能够帮你产生自定义的样式，头部显示内容，脚注形式：
注意:
Doxytag 使用说明
Doxytag 是一个基于命令行的小程序。它能够产生标志文件。这些标志文件能够被使用作为自己的标志文件。这些标志文件能够被用来为产生外部文档产生参考信息。 (例如：那些要被doxygen使用到，但是被包含在输入文件中的部分)。
一个标志文件包含关于这个文件中的classes，成员的相关信息。Doxytag能够直接从HTML文件中抽取这些信息。 这样就有了一个好处，不需要源代码就能够从doxytag中知道源代码到底有什么文件组成，每个文件的组成和它们的功能，以及文件之间的相互关系。
通过在doxygen中进行的配置文件中进行相应的配置，你能够很容易的在 之后放上相应的标志文件名。
关键:
如果你使用标志文件，通过doxygen生成links将会包含dummy（哑元）链接。你必须运行installdox脚本程序把这些dummy链接转化成真实的链接。请参考 章节获取更多的相关信息。Dummy链接看起来好象是没什么用处的，但实际上它非常的有用---如果你想要把外部文档移动到任何位置的的时候你会发现它很有用。只要你运行着installdox，文档不需要通过doxygen进行重新生成。
注意:
因为，通常要在HTML文档中形成某种特定的结构，但是，通过doxygen生成的HTML文件中只有HTML或者是按照字母排序的classes视图形式。Doxytag只能读取HTML格式。
Doxytag能够为一个在HTML目录下的所有的HTML文件建立标志。如果没有没有进行设置，Doxytag将从当前路径读取所有的扩展名为html的文件。 如果使用 doxytag中的-t命令就能生成一个标志文件。
例 1:
假如下面列出的出现在examples目录下的example.cpp文件，以特殊块儿显示的文件形式，没有它的源文件。那么你就很幸运了，可以通过软件包中包含的分配器可以过doxygen生成包含HTML文档的文档形式显示的文件。
/** A Test class.
* More details about this class.
*/
class Test
{
public:
/** An example member function.
* More details about this function.
*/
void example();
};
void Test::example() {}
/** /example example_test.cpp
* This is an example of how to use the Test class.
* More details about this example.
*/
你只用使用下面的命令从HTML文件创建一个标志文件就能达到分析源文件由哪些部分组成，各个部分都是什么功能，以及它们之间有什么联系：
doxytag -t example.tag example/html
上面的examples是HTML文档原始的路径。这样，你就能在你自己的代码块儿中使用上面的标志文件了，如下所示照葫芦画瓢即可：
/*! A class that is inherited from the external class Test.
*/
class Tag : public Test
{
public:
/*! an overloaded member. */
void example();
};
Doxygen能够为你的文档提供包含上所有指定过的链接选项。因为标志文件不能确定文档定位在哪里，你必须通过运行installdox脚本程序确定doxygen生成的文件放置到什么位置。(请参考 章节获得更多的信息)。
注意：（不管你移动别人的文档或者是别人移动你的文档）把外部的文档移动到一个不同的路径下面或者改变链接设置，你只需简单的运行脚本就能实现所有连接的同步更新。
点击 查看通过doxygen生成的相应的HTML文档和下面的第2个例子。
例2:
使用下面的命令行生成一个标记文档：
doxytag -t qt.tag $QTDIR/doc/html
使用Doxygen文档开发工具时需要进行的配置：
可执行文件 doxygen 是原代码分析和生成文档的主要工具. 请看 章节来获取更详细的使用帮助.
Doxytag可执行文件---仅仅是用来实现帮助程序员生成不需要看原代码就能了解工程部署信息的doxygen文档的参考文档( 例如：那些使用doxygen生成的文档).请看 章节来获得更多的使用帮助.
配置
格式
一个配置文件是一个和Makefile有着类似结构的ASCII 文本文件，默认的配置文件名是Doxyfile。它是经doxygen分析后生成的。这个配置文件以固定的格式包含标记和新行 。配置文件中的设置是"大小写敏感"的。注释可以放在文档中的任何的位置(内部使用的"引号"除外)。注释采用的是以"#"开始的 单行注释形式。
文
件中包含了很多"赋值语句"的形式。每条语句主要包含了一个后面跟着一个"="号的标志名TAG_NAME，
然后后面是1个或者多个值。如果相似的标志已经被多次的使用，那么最后使用的标志将会覆盖掉前面使用过的标志。下面列出了所有命令的列表，表中的"
+=" 号
可以用来代替"=新值"。如果使用多个命令参数，它们之间是"不能有空格符"出现的。如果某个命令参数需要使用"空格符"，则必须使用""把这个命令参数
括起来。写成多行时，必须使用反斜杠 (/)做为该行的结束。环境变量可以通过使用$(ENV_VARIABLE_NAME)进行扩展。
想包含别的配置文件中的相关内容，只需使用下面格式的 @INCLUDE 标志即可：
@INCLUDE = config_file_name
被包含的文件通常先从当前路径搜索。你也可以通过使用路径指定自定义路径中被包含的配置文件。使用命令 @INCLUDE_PATH ，后面跟上被包含的配置文件的具体的路径，如下所示：
@INCLUDE_PATH = my_config_dir
置选项可以被分成几类。下面给出的命令开关（或者说：配置选项）以字母顺序给出：
配置选项可以被分成几类。下面给出的命令开关（或者说：配置选项）以字母顺序给出：
//简短摘要
//别名
//所有外部文档
//字母顺序索引
//详细描述部分
//二进制操作
//简短的成员描述
//调用到的图
//检测的范例的名字
//CHM格式文件
//类-表
//类-图
//相互调用关系图
//以列形式显示的字母顺序的索引
//压缩的LATEX文档
//压缩的RTF文档
//创建一个"子目录"
//文档的详细头部
//目录图
//禁用INDEX
//禁用文档成组显示
DOT_IMAGE_FORMAT //点阵图形
//多个DOT目标
//DOT路径设置
//DOT转换设置
//DOTFILE 列表显示
//允许"预处理"指令
//每行的枚举值
//允许分段显示
//例子路径
//例子用的文件格式（*.cpp, *.h , *.java等）
EXAMPLE_RECURSIVE //例子递归
//可执行文件
//可执行文件格式（*.exe, *.dll等）
//可执行的SYMLINKS
//规定的扩展
//预定义扩展
//使用到的外部的文件
//使用到的外部插件包
//提取所有
//提取所有本地类
//提取所有本地方法
//提取所有private
//提取所有static
//文件路径
//文件版本控制
//控制格式（主版本：第1次版本：第2次版本号）
//原文件的版本控制
//全路径名
//生成自动定义文件形式
//生成BUG列表
//生成"希腊字母"
//生成"评估"列表
//生成HTML
//生成HTMLHELP
//生成LATEX
//生成图例
//生成MAN文件
//生成Perl脚本
//生成RTF
//生成标志文件
//生成TESTLIST
//生成TODOLIST
//生成树状视图显示
//生成XML
//继承图表
//组-图
//隐藏DOT
//隐藏位置
//隐藏"复合的"友员类型
//隐藏文档的主体
//隐藏"作用域"名
//隐藏"未归档"的所有CLASS
//隐藏"未归档"的所有的成员
//隐藏"未归档"的关系
//HTML文档中成员对齐方式
//HTML脚注设置
//HTML头部设置
//HTML输出设置
//HTML样式设置
//忽略哪些前缀
IMAGE_PATH //图片的路径设置
//包含-图
//头文件包含的路径
//文档的继承关系
//内联信息
//通过"继承"得到的内联成员
//内联部分的源代码
//输入设置
//能够接受的输入文件的扩展名格式设置（重要）
//内部文档
//JAVADOC工具生成的文档的"自动摘要"
//LATEX匹配方式
//LATEX 命令名
//LATEX 头部
//LATEX内部隐藏的包含
//LATEX输出
//宏展开设置（重要）
//MAKEINDEX命令索引
//MAN扩展
//MAN 链接设置
//MAN输出设置
//DOT图的最大深度
//DOT图的最大高度
//DOT图的最大宽度
//最大初始化行
//多 个CPP文件的简短描述
//对C采用的优化设置
//对JAVA采用的优化设置
//输出路径设置（重要）
//输出语言设置（重要）
//纸张类型
//PDF格式超链接设置（重要）
//perl路径设置
//perlmod LATEX
// perlmod PRETTY（漂亮/相当）
//perlmod MAKE文件版本 PREFIX
//预先定义（重要）
//工程名（重要）
//工程的组成成员（重要）
//静态量设置（重要）
RECURSIVE //递归和循环
//交叉参考（重要）
//交叉参考的关系
//重新设置"简短说明"为打开状态
//RTF展开文件
//RTF超链接
//RTF输出设置
//RTF样式文件
//搜索时需要包含什么（重要）
//搜索引擎设定（重要）
//使短文件名生效
//显示目录
//显示包含文件（一般NO，否则太大）
//显示被用到的文件（一般YES）
//跳过函数中的宏（重要），菜鸟最好别跳
//文档的简短摘要
//成员的简短描述
//原文件浏览路径
//排除哪些条码形式注释（重要）
//排除哪些头文件包含的注释（重要）
//排除哪些条码路径设置
//子组设置（重要）
//TAB符SIZE设置（重要）
//标志文件
//模板关系设置（重要）
//TOC扩展
//树状图显示的宽度设置（重要）
//UML外观设置（重要）
//使用windows系统的编码形式（重要）
//VERBATIM头部（头文件）
//警告格式指定（重要）
//如果文档出错则显示警告
WARN_IF_UNDOCUMENTED //如果是未归档文件则显示警告
//警告日志文件设置
//无参数文档警告形式设定
//警告设置（重要）
//XML文件类型定义（重要）
//XML输出设置（重要）
//XML程序列表（重要）
//XML模式设置（重要）
