Doxygen 配置

最新推荐文章于 2024-05-14 00:04:14 发布
最新推荐文章于 2024-05-14 00:04:14 发布
阅读量3.1k 收藏 1
点赞数 1
文章标签： 文档 html rtf postscript stylesheet output
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/axlrosek/article/details/1557692
版权

Step 1: 创建一个配置文件

Doxygen使用一个配置文件来确定它所有的设置. 每个工程都应该有它自己的配置文件.
一个工程可以只有一个原文件, 也可以是工程中所有原文件的递归扫描得到的原文件的树状视图。
为了简化doxygen 生成配置文件的工作, doxygen 可以为你提供一个模板化的配置文件.
1. 为了创建一个模板化的配置文件，只需要调用doxygen 并从命令行中敲入-g:

doxygen -g <config-file>

其中 <config-file> 是某个模板化的配置文件的文件名. 如果你省略了文件名, doxygen 会为你生成一个默认的Doxyfile 的配置文件. 如果<config-file> 是一个已经存在的文件名, doxygen 在生成配置模板之前，将会生成一个 <config-file>. Bak 备份文件。
2. 如果你使用 - ( 例如：减号) 作为文件名doxygen 将会把你从键盘输入的文字当作配置文件名。
 配置文件有着和Makefile 相似的格式. 主要是：包含了很多的"标志"分配符格式 (tags):
例如：
TAGNAME = VALUE or
TAGNAME = VALUE1 VALUE2 ...
在生成文档模板时，你可以使用默认（即：保留大多数的TAGS ）详细信息请看 Configuration 这一章节来获取更多的信息.
如果你不想使用文本编辑工具来编写配置文件, 你应该看看 doxywizard 章节的描述, 它是一个可以用来创建/ 读/ 写doxygen 配置文档的图形化工具，同时它也可以在路径中进行全路径配置来使doxygen 正常工作。
3. 对于一个有很少的原文件和头文件组成的C/C++ 工程来说, 你可以保留 INPUT 标志为"空" ，那么 doxygen 将会在当前路径下搜索原文件.
4. 如果你的工程很大，你应该把你的工程文件的"根目录"放在 INPUT 标志后面, 需要添加到工程中的文件应该放到 FILE_PATTERNS 标志之后( 例如： *.cpp *.h). 至少是匹配了1 项的文件才能被doxygen 程序读入并分析( 如果省略了这项设置，则会使用doxygen 配置列表中的格式).
5.       如果想要递归对原文件树进行分析必须设置 RECURSIVE 标志为 YES.
6.       想在doxygen 中使用更多的自定义规则进行分析，必须使用 EXCLUDE 标志和 EXCLUDE_PATTERNS 标志。
7.       想忽略所有的 test 路径下的文件，使用下面的形式: 
 EXCLUDE_PATTERNS = */test/*
8. 对于C/C++ 文件Doxygen 通常直接进行分析。 如果文件有 .idl或 .odl 扩展名，则doxygen 会把它视为 IDL 文件。
 8.  有.java 扩展名的将被视为Java 文件.
9.  使用 .cs作为扩展名的文件将会 视为C# 文件.
10.  使用.php, .php4扩展名的文件 和用.inc 或 .phtml 扩展名的文件将被视为PHP 原文件.
11.  如果你想用doxygen 为已经存在的工程生成文档。你首先要想象一下你的工程文档最终使用什么样的格式排版，为了实现这样的目标，你必须要设置 EXTRACT_ALL 标志为YES. 然后，doxygen 表现出来的是它知道了所有你的工程文件的配置目标。
 注意：如果设置 EXTRACT_ALL 标志为YES 。则：undocumented members 之类的警告将不会再产生。
12.   使用doxygen 来分析一个现存的源代码的某个部分或全部文件可以更清晰的明白源代码各个功能模块的定义和要实现的功能以及它们之间的交叉参考。
13.   使用Doxygen 生成交叉参考必须设置 SOURCE_BROWSER 标志为 YES 。也可以直接通过设置 INLINE_SOURCES 标志为 YES 来实现把工程的所有源代码包含进文档中。( 这样方便了代码的通览).

Step 2: Running doxygen

To generate the documentation you can now enter: 
doxygen <config-file>
Doxygen 将会在输出路径中创建html, rtf, latex 和/ 或man 路径。 路径和路径中的文件格式是对应的HTML, RTF, 和Unix-Man 格式.
默认的路径是doxygen 的安装路径。可以使用 OUTPUT_DIRECTORY, HTML_OUTPUT, RTF_OUTPUT, LATEX_OUTPUT, 和 MAN_OUTPUT 标志来自定义配置文档的输出路径。如果输出路径不存在doxygen 将会为你创建一个输出路径。
生成的 HTML 可以通过使用浏览器浏览位于html 路径下的 index.html 文件. 如果浏览器支持层叠样式表 (CSS) 那就更棒了。
 生成的 必须要先用 编译器进行编译( 我使用 teTeX 0.9 版本，其中包含了 3.14159). 为了简化编译文档的生成过程，doxygen 在latex 路径下提供了一个Makefile 。在命令行latex路径下敲入 make 将会生成一个refman.dvi文件。 ( 假设你有一个文件叫做make of course). 你可以通过使用xdvi命令来查看这个文件或者使用dvips把它转换成一个后缀是.ps的文件 refman.ps 。
 想实现分成2 页的效果可以使用make ps_2on1 命令。PostScript 文件最终会被发送到PostScript 打印机输出。如果你没有PostScript 打印机，你可以使用ghostscript 命令把PostScript 文件格式转换成你的打印机能够识别的文件格式。如果你已经安装了ghostscript 解释程序，那么可以把文件转换成 PDF 格式，这只需要敲入make pdf ( 或make pdf_2on1) 。
 想生成PDF 文件，你要把 PDF_HYPERLINKS 标志设置成YES 。
 产生的man 页面文件可以通过man 程序来进行查看。但是，你必须确定man 路径有相应的环境变量设置 ( 一般在 MANPATH 环境变量中) 。注意：man 页面文件的格式有一些限制 ，所以有些信息( 像：class 图，交叉参考，公式等) 将会丢失掉。

Step 3: Documenting the sources

尽管源代码编制文档的被作为第3步，但是，在某些新的工程中，这个是作为第1步来做的。 这里，我假设你已经有了一些想用doxygen来对其进行文档化（描述API接口和作用）的源代码。
如 EXTRACT_ALL 选项被设置成NO （默认情况下是NO ）那么doxygen 只会为已经文档化的成员，文件，类和命名空间生成文档。如果你的文档属于这种情况，该怎么办呢？对于成员，类和命名空间有2 种基本的设置：
1.成员，类或命名空间的前面安排一个描述或定义的块儿。对于文件，类和命名空间成员来说，doxygen 允许直接在成员后面安排文档。你可以参考：
  Special documentation blocks 了解更多特殊块儿的设置。
2. 想在任何地方部署特殊的文档块儿（任何的文件或任何的路径）和在文档块中添加一个"结构化"的命令。"结构化"的命令用来设置一个可被编制成文档的链接。 (e.g. a member, class, namespace or file)。请看： Documentation at other places 了解更多的结构化命令的使用方法。
文件只能使用上面2中的方法进行设置，因为没有办法把一个文档块儿放到一个文件的前面。
当然，文件成员（函数，变量，类型定义，define）不需要显示的使用"结构化"命令，只需要把特殊的文档块儿放到文件中的最前面或最后面就可以了。
文档内部的文档块儿在输出为HTML 格式或其他格式输出文件之前进行doxygen 的语法分析：
 它其实是在进行下面的步骤前进行分析：
  • 文档内部的特殊"结构化"命令被执行的时候。请看： Special Commands 章节获取所有的命令参考信息。
  • 如果某行中使用"空格+后面使用1个或多个*号"，或者是很多的"空格"符，则所有的空格和"*"号都会被删除。
  • 所有的"空行"都会被视为"图形分隔符"。这项安排可以使你有"部署自定义图形分隔符"的能力，以产生更具可读性的文档。
  • Doxygen将会为所有已经归档的classes生成链接。
  • 如果在文档中找到符合doxygen文档格式的成员，那么也会为members创建链接。请参考：Automatic link generation获取更多的如何自动化文档链接。
 

Doxygen 使用说明

Doxygen 是一个基于命令行的实用工具。在命令行使用—help可以显示关于各种命令的简短描述。
所有的命令开关都包括前导字符-， 后面跟什么命令（1 个字符或是多个字符）取决于你的选择。
 为了为你的工程产生一个手册，典型的情况---- 你需要经过下面几个步骤：
1.      你想要在你的文档中使用特殊的块状标识 (请参考 Special documentation blocks章节)。
2.      可以通过使用doxygen 中的-g 来创建配置文件(请参考 Configuration章节)： 
doxygen -g <config_file>
3.      你需要针对你的工程编写相应的配置文件。在配置文件中你可以指定输入文件以及很多其它的信息。
4.      通过使用下面的命令来对你配置过的文件产生相应的文档： 
doxygen <config_file>
如果你使用老版本的doxygen 生成过配置文件，你可以通过运行doxygen 中的 -u 命令来对其进行更新。
 
doxygen -u <config_file>
在原来配置文件中的所有信息都会被替换成新的配置文件。所有新版本doxygen中的配置都会使用默认值。但是，你改动前的原来的配置文件中的所有的注释都会被自动删除。
如果你想让产生的文档能够按照某种你自定义的格式进行显示的话。如果你编辑了下面的内容doxygen 能够帮你产生自定义的样式，头部显示内容，脚注形式：
  • 默认的情况下，HTML中会产默认的头部(请查看 HTML_HEADER获得更详细的信息)，默认的脚注 (请查看HTML_FOOTER获得更详细的信息)，默认的样式(请查看HTML_STYLESHEET获得更详细的信息)，需要用到的命令如下：
·       doxygen -w html header.html footer.html stylesheet.css
  • 想要产生 LaTeX 形式的输出格式，你可以创建refman.tex的第1部分 (请查看LATEX_HEADER获得更详细的信息)。同时，也可以在某个文件中加入下面的命令来丰富文档最终的头部显示样式：（下面是默认的2个文件）
·       doxygen -w latex header.tex doxygen.sty
  • 想要产生RTF形式的输出格式, 你可以创建一个默认的样式格式配置文件 (请查看RTF_STYLESHEET_FILE获得更详细的信息)：
·       doxygen -w rtf rtfstyle.cfg
注意 :
  • 如果你不想对配置文件中的每一项都进行编制，你可以使用-s命令。通过与-u同时使用，可以实现在现存文档中增加或排除已存在的配置文件。如果你想向我报告BUG，请使用-s命令。

想要使用doxygen从键盘读/写信息而不是从输入/输出文件读写信息，你需要使用-for命令（后面跟上你想指定的文件名）。

Doxytag 使用说明

Doxytag 是一个基于命令行的小程序。它能够产生标志文件。这些标志文件能够被doxygen使用作为自己的标志文件。这些标志文件能够被用来为产生外部文档产生参考信息。 (例如：那些要被doxygen使用到，但是被包含在输入文件中的部分)。
一个标志文件包含关于这个文件中的classes，成员的相关信息。Doxytag能够直接从HTML文件中抽取这些信息。 这样就有了一个好处，不需要源代码就能够从doxytag中知道源代码到底有什么文件组成，每个文件的组成和它们的功能，以及文件之间的相互关系。
通过在doxygen中进行的配置文件中进行相应的配置，你能够很容易的在GENERATE_TAGFILE 之后放上相应的标志文件名。
关键:
如果你使用标志文件，通过doxygen生成links将会包含dummy（哑元）链接。你必须运行installdox脚本程序把这些dummy链接转化成真实的链接。请参考Installdox usage 章节获取更多的相关信息。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生成的文件放置到什么位置。(请参考 Installdox usage 章节获得更多的信息)。
注意：（不管你移动别人的文档或者是别人移动你的文档）把外部的文档移动到一个不同的路径下面或者改变链接设置，你只需简单的运行脚本就能实现所有连接的同步更新。
点击 here 查看通过doxygen生成的相应的HTML文档和下面的第2个例子。
例2:
使用下面的命令行生成一个标记文档：

doxytag -t qt.tag $QTDIR/doc/html

配置

格式

一个配置文件是一个和Makefile有着类似结构的ASCII 文本文件，默认的配置文件名是Doxyfile。它是经doxygen分析后生成的。这个配置文件以固定的格式包含标记和新行 。配置文件中的设置是"大小写敏感"的。注释可以放在文档中的任何的位置(内部使用的"引号"除外)。注释采用的是以"#"开始的 单行注释形式。
文件中包含了很多"赋值语句"的形式。每条语句主要包含了一个后面跟着一个"="号的标志名TAG_NAME， 然后后面是1个或者多个值。如果相似的标志已经被多次的使用，那么最后使用的标志将会覆盖掉前面使用过的标志。下面列出了所有命令的列表，表中的" +=" 号 可以用来代替"=新值"。如果使用多个命令参数，它们之间是"不能有空格符"出现的。如果某个命令参数需要使用"空格符"，则必须使用""把这个命令参数括起来。写成多行时，必须使用反斜杠 (/)做为该行的结束。环境变量可以通过使用$(ENV_VARIABLE_NAME)进行扩展。
想包含别的配置文件中的相关内容，只需使用下面格式的 @INCLUDE 标志即可：

@INCLUDE = config_file_name

被包含的文件通常先从当前路径搜索。你也可以通过使用路径指定自定义路径中被包含的配置文件。使用命令 @INCLUDE_PATH ，后面跟上被包含的配置文件的具体的路径，如下所示：

@INCLUDE_PATH = my_config_dir

配置选项可以被分成几类。下面给出的命令开关（或者说：配置选项）以字母顺序给出：

 

下面是需要涉及到的配置参数，通过对它们进行具体的设置能够实现想要的自定义效果.......

有些地方翻译的不太合适，请参照相关的链接来了解它所表示的意思........

通过用文本编辑工具打开通过Doxygen生成的配置文件，然后用Ctrl+F来查找相关的"设置词汇"，来进行自定义，得到想要的文档显示格式

配置选项可以被分成几类。下面给出的命令开关（或者说：配置选项）以字母顺序给出：


配置选项可以被分成几类。下面给出的命令开关（或者说：配置选项）以字母顺序给出：

axlrosek
关注
  • 1
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Doxygen 配置详解
skyremember的专栏
03-06 9847
http://shanzy.bokee.com/catalog_2005.html（翻译）Doxygen 配置详解（1）- -   注意：可以任意转载，但请注名出处使用Doxygen文档开发工具时需要进行的配置：可执行文件 doxygen 是原代码分析和生成文档的主要工具. 请看 Doxygen usage 章节来获取更详细的使用帮助. Doxytag可执行文件---仅仅是
Doxygen配置文件
02-24
Doxygen配置文件，含调用、被调用函数图配置等，自动生成chm压缩文件
doxygen注释头文件时，一定得有@file
tumu_C的博客
12-25 385
而且@file后面要和当前的文件名保持一致，否则就出不来文档。那么对于头文件的注释文档是出不来的。其他的有没有不重要。
doxygen 注释规范
布袋和尚
11-08 1819
在你的注释中加入这样的代码。
Windows环境下代码文档生成工具Doxygen使用详细教程
最新发布
小金牛来了
05-14 2154
Windows环境下代码文档生成工具Doxygen使用详细教程
ASPICE SWE3之——C代码生成软件详细设计1 Doxygen配置
gaoxuexidan0307的博客
08-17 877
前面已经单独一篇文章讲了，若想通过Doxygen工具生成C代码的软件详细设计文档，需要C代码注释的格式，并推荐了注释规范，以满足Doxygen工具识别格式，且符合ASPICE对详细设计的内容要求，且尽可能使注释内容简洁并生成报告好看。 本文接下来讲，若想通过Doxygen工具生成C代码的软件详细设计文档，需要下载哪些软件，软件包放在资源中需要自取，Doxygen工具该如何配置，若想生成报告成功需要注意什么。 配置过程经常会因为一些细节问题导致生成报告出现问题，本文的配置亲测有效。.........
【doxygen】doxygen 显示图片
tyustli
06-29 469
这里有一点需要注意，图片路径已经添加到 Doxygen 中，所以这里引用图片的时候直接写图片名称即可，不用写相对路径，和标准的 markdown 语法有所不同。
linux环境下doxygen使用方法
又又的博客
02-22 1147
linux环境下doxygen使用说明
doxygen配置说明[定义].pdf
10-11
《Doxygen配置详解：打造专业软件文档》 Doxygen是一款强大的自动文档生成工具，广泛应用于软件开发领域，它能够从源代码中抽取注释，生成清晰、详细的API文档。本文将详细介绍Doxygen配置中的各项设置，帮助开发者...
doxygen配置及使用手册
03-31
Doxygen可以从C，C++， java等源代码中提取消息来生成帮助文档， API资料等
Doxygen 配置说明
09-02
关于如何使用Doxygen自动文档生成工具，并举例说明
Doxygen 使用总结，生成chm文件，附：配置文件Doxyfile
大叶子的博客
04-09 3771
1.win下载和安装，配置和使用 2.配置文件doxyfile保存及重复使用 3.代码注释 4.linux安装及使用手册
Doxygen使用学习（五）------Doxygen的特殊命令字之"创建连接命令"
冬之晓
08-16 2620
创建连接命令 @addindex (text) 添加1文本到latex索引中 @anchor 放置一个不可见的已命名的anchor(固定点)到文档中，且能使用@ref命令进行引用。 注意：anchor目前只能放置在一个标记成页面(使用@page)或主页(使用@mainpage)的注释块中 @cite 增加一个书籍参考到一个文本和数目参考列表里。 @endlink 终止一个命令@link开始的连
Doxygen(一) - 入门篇
jaystonezl的博客
08-31 644
介绍了Doxygen常用注释标记、注释编写和使用doxywizard的方法。
Doxygen在vs code配置
马上毕业的小菜菜
09-21 435
doxdocgen.generic.paramTemplate”: “@param[in/out]{indent:15}{param}{indent:20}【参数注释】”,//“doxdocgen.generic.briefTemplate”: “@brief{indent:10}{text}【.C描述】”,“doxdocgen.c.setterText”: “Set {name}”,//Get方法（没用）“doxdocgen.generic.authorEmail”: “邮箱”,//命令建议（没用）
ubuntu 使用doxygen生成软件文档[Vscode 配置doxygen插件方法]
weixin_43399515的博客
11-29 1439
ubuntu下使用doxygen生成软件文档, ubuntu下使用Vscode自动生成符合doxygen语法的注释
【Doxygen】Doxygen使用教程（个人总结）
热门推荐
qq_43331089的博客
04-29 2万+
【Doxygen】Doxygen使用教程（个人总结） 简介Doxygen 引言．什么是Doxygen? Doxygen 是一个程序的文件产生工具，可将程序中的特定批注转换成为说明文件。通常我们在写程序时，或多或少都会写上批注，但是对于其它人而言，要直接探索程序里的批注，与打捞铁达尼号同样的辛苦。大部分有用的批注都是属于针对函式，类别等等的说明。所以，如果能依据程序本身的结构，将批注经过处理重新整理成为一个纯粹的参考手册，对于后面利用您的程序代码的人而言将会减少许多的负担。不过，反过来说，整理文件的工作对于您
Doxygen的安装与配置及简单注释规范
奋斗Andy的博客
11-11 9817
最近接触了一款程序 文档生成工具-Doxygen。在网上一搜索原来这么多人知道，打算把它的使用做一个总结，以及其注释的规则。 概述：  Doxygen是一种开源跨平台的，以类似JavaDoc风格描述的文档系统，完全支持C、C++、Java、Objective-C和IDL语言，部分支持PHP、C#。注释的语法与Qt-Doc、KDoc和JavaDoc兼容。Doxgen可以从一套归档源文件开始，
doxygen配置graphviz
09-22
要配置doxygen使用graphviz，您需要完成以下步骤： 1. 首先，您需要安装graphviz软件。您可以从graphviz官方网站（http://www.graphviz.org/Download.php）下载适用于Windows的Stable and development Windows ...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值