目录
文章目录
- 目录
- 安装
- 配置解析
- Project related configuration options
- Build related configuration options
- Configuration options related to warning and progress messages
- Configuration options related to the input files
- Configuration options related to source browsing
- Configuration options related to the alphabetical class index
- Configuration options related to the HTML output
- Configuration options related to the LaTeX output
- Configuration options related to the RTF output
- Configuration options related to the man page output
- Configuration options related to the XML output
- Configuration options related to the DOCBOOK output
- Configuration options for the AutoGen Definitions output
- Configuration options related to the Perl module output
- Configuration options related to the preprocessor
- Configuration options related to external references
- Configuration options related to the dot tool
- 使用
- 附件
安装
$ yum install -y graphviz
$ yum install -y doxygen*
$ doxygen -s -g doxyconfig
- 1
示例:
# Doxyfile 1.8.5
#---------------------------------------------------------------------------
# Project related configuration options
#---------------------------------------------------------------------------
DOXYFILE_ENCODING = UTF-8
PROJECT_NAME = "l2fwd"
PROJECT_NUMBER =
PROJECT_BRIEF =
PROJECT_LOGO =
OUTPUT_DIRECTORY = ./docs
CREATE_SUBDIRS = YES
OUTPUT_LANGUAGE = Chinese
BRIEF_MEMBER_DESC = YES
REPEAT_BRIEF = YES
ABBREVIATE_BRIEF =
ALWAYS_DETAILED_SEC = YES
INLINE_INHERITED_MEMB = YES
FULL_PATH_NAMES = YES
STRIP_FROM_PATH =
STRIP_FROM_INC_PATH =
SHORT_NAMES = NO
JAVADOC_AUTOBRIEF = NO
QT_AUTOBRIEF = NO
MULTILINE_CPP_IS_BRIEF = NO
INHERIT_DOCS = YES
SEPARATE_MEMBER_PAGES = NO
TAB_SIZE = 4
ALIASES =
TCL_SUBST =
OPTIMIZE_OUTPUT_FOR_C = YES
OPTIMIZE_OUTPUT_JAVA = NO
OPTIMIZE_FOR_FORTRAN = NO
OPTIMIZE_OUTPUT_VHDL = NO
EXTENSION_MAPPING =
MARKDOWN_SUPPORT = YES
AUTOLINK_SUPPORT = YES
BUILTIN_STL_SUPPORT = NO
CPP_CLI_SUPPORT = NO
SIP_SUPPORT = NO
IDL_PROPERTY_SUPPORT = YES
DISTRIBUTE_GROUP_DOC = NO
SUBGROUPING = YES
INLINE_GROUPED_CLASSES = YES
INLINE_SIMPLE_STRUCTS = YES
TYPEDEF_HIDES_STRUCT = NO
LOOKUP_CACHE_SIZE = 0
#---------------------------------------------------------------------------
# Build related configuration options
#---------------------------------------------------------------------------
EXTRACT_ALL = YES
EXTRACT_PRIVATE = YES
EXTRACT_PACKAGE = YES
EXTRACT_STATIC = YES
EXTRACT_LOCAL_CLASSES = YES
EXTRACT_LOCAL_METHODS = YES
EXTRACT_ANON_NSPACES = YES
HIDE_UNDOC_MEMBERS = NO
HIDE_UNDOC_CLASSES = NO
HIDE_FRIEND_COMPOUNDS = NO
HIDE_IN_BODY_DOCS = NO
INTERNAL_DOCS = YES
CASE_SENSE_NAMES = YES
HIDE_SCOPE_NAMES = YES
SHOW_INCLUDE_FILES = YES
FORCE_LOCAL_INCLUDES = YES
INLINE_INFO = YES
SORT_MEMBER_DOCS = YES
SORT_BRIEF_DOCS = NO
SORT_MEMBERS_CTORS_1ST = NO
SORT_GROUP_NAMES = NO
SORT_BY_SCOPE_NAME = NO
STRICT_PROTO_MATCHING = NO
GENERATE_TODOLIST = YES
GENERATE_TESTLIST = YES
GENERATE_BUGLIST = YES
GENERATE_DEPRECATEDLIST= YES
ENABLED_SECTIONS =
MAX_INITIALIZER_LINES = 30
SHOW_USED_FILES = YES
SHOW_FILES = YES
SHOW_NAMESPACES = YES
FILE_VERSION_FILTER =
LAYOUT_FILE =
CITE_BIB_FILES =
#---------------------------------------------------------------------------
# Configuration options related to warning and progress messages
#---------------------------------------------------------------------------
QUIET = NO
WARNINGS = YES
WARN_IF_UNDOCUMENTED = YES
WARN_IF_DOC_ERROR = YES
WARN_NO_PARAMDOC = NO
WARN_FORMAT = "$file:$line: $text"
WARN_LOGFILE =
#---------------------------------------------------------------------------
# Configuration options related to the input files
#---------------------------------------------------------------------------
INPUT = ./ /opt/dpdk-18.08/x86_64-native-linuxapp-gcc/include /opt/dpdk-18.08/x86_64-native-linuxapp-gcc/lib
INPUT_ENCODING = UTF-8
FILE_PATTERNS =
RECURSIVE = YES
EXCLUDE =
EXCLUDE_SYMLINKS = NO
EXCLUDE_PATTERNS =
EXCLUDE_SYMBOLS =
EXAMPLE_PATH =
EXAMPLE_PATTERNS =
EXAMPLE_RECURSIVE = YES
IMAGE_PATH =
INPUT_FILTER =
FILTER_PATTERNS =
FILTER_SOURCE_FILES = NO
FILTER_SOURCE_PATTERNS =
USE_MDFILE_AS_MAINPAGE =
#---------------------------------------------------------------------------
# Configuration options related to source browsing
#---------------------------------------------------------------------------
SOURCE_BROWSER = NO
INLINE_SOURCES = NO
STRIP_CODE_COMMENTS = NO
REFERENCED_BY_RELATION = YES
REFERENCES_RELATION = YES
REFERENCES_LINK_SOURCE = YES
SOURCE_TOOLTIPS = YES
USE_HTAGS = NO
VERBATIM_HEADERS = YES
#---------------------------------------------------------------------------
# Configuration options related to the alphabetical class index
#---------------------------------------------------------------------------
ALPHABETICAL_INDEX = YES
COLS_IN_ALPHA_INDEX = 5
IGNORE_PREFIX =
#---------------------------------------------------------------------------
# Configuration options related to the HTML output
#---------------------------------------------------------------------------
GENERATE_HTML = YES
HTML_OUTPUT = .
HTML_FILE_EXTENSION = .html
HTML_HEADER =
HTML_FOOTER =
HTML_STYLESHEET =
HTML_EXTRA_STYLESHEET =
HTML_EXTRA_FILES =
HTML_COLORSTYLE_HUE = 220
HTML_COLORSTYLE_SAT = 100
HTML_COLORSTYLE_GAMMA = 80
HTML_TIMESTAMP = NO
HTML_DYNAMIC_SECTIONS = NO
HTML_INDEX_NUM_ENTRIES = 100
GENERATE_DOCSET = NO
DOCSET_FEEDNAME = "Doxygen generated docs"
DOCSET_BUNDLE_ID = org.doxygen.Project
DOCSET_PUBLISHER_ID = org.doxygen.Publisher
DOCSET_PUBLISHER_NAME = Publisher
GENERATE_HTMLHELP = NO
CHM_FILE =
HHC_LOCATION =
GENERATE_CHI = NO
CHM_INDEX_ENCODING =
BINARY_TOC = NO
TOC_EXPAND = NO
GENERATE_QHP = NO
QCH_FILE =
QHP_NAMESPACE = org.doxygen.Project
QHP_VIRTUAL_FOLDER = doc
QHP_CUST_FILTER_NAME =
QHP_CUST_FILTER_ATTRS =
QHP_SECT_FILTER_ATTRS =
QHG_LOCATION =
GENERATE_ECLIPSEHELP = NO
ECLIPSE_DOC_ID = org.doxygen.Project
DISABLE_INDEX = NO
GENERATE_TREEVIEW = ALL
ENUM_VALUES_PER_LINE = 4
TREEVIEW_WIDTH = 250
EXT_LINKS_IN_WINDOW = NO
FORMULA_FONTSIZE = 10
FORMULA_TRANSPARENT = YES
USE_MATHJAX = NO
MATHJAX_FORMAT = HTML-CSS
MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
MATHJAX_EXTENSIONS =
MATHJAX_CODEFILE =
SEARCHENGINE = YES
SERVER_BASED_SEARCH = NO
EXTERNAL_SEARCH = NO
SEARCHENGINE_URL =
SEARCHDATA_FILE = searchdata.xml
EXTERNAL_SEARCH_ID =
EXTRA_SEARCH_MAPPINGS =
#---------------------------------------------------------------------------
# Configuration options related to the LaTeX output
#---------------------------------------------------------------------------
GENERATE_LATEX = NO
LATEX_OUTPUT = latex
LATEX_CMD_NAME = latex
MAKEINDEX_CMD_NAME = makeindex
COMPACT_LATEX = NO
PAPER_TYPE = a4
EXTRA_PACKAGES =
LATEX_HEADER =
LATEX_FOOTER =
LATEX_EXTRA_FILES =
PDF_HYPERLINKS = YES
USE_PDFLATEX = YES
LATEX_BATCHMODE = NO
LATEX_HIDE_INDICES = NO
LATEX_SOURCE_CODE = NO
LATEX_BIB_STYLE = plain
#---------------------------------------------------------------------------
# Configuration options related to the RTF output
#---------------------------------------------------------------------------
GENERATE_RTF = NO
RTF_OUTPUT = rtf
COMPACT_RTF = NO
RTF_HYPERLINKS = NO
RTF_STYLESHEET_FILE =
RTF_EXTENSIONS_FILE =
#---------------------------------------------------------------------------
# Configuration options related to the man page output
#---------------------------------------------------------------------------
GENERATE_MAN = NO
MAN_OUTPUT = man
MAN_EXTENSION = .3
MAN_LINKS = NO
#---------------------------------------------------------------------------
# Configuration options related to the XML output
#---------------------------------------------------------------------------
GENERATE_XML = NO
XML_OUTPUT = xml
XML_SCHEMA =
XML_DTD =
XML_PROGRAMLISTING = YES
#---------------------------------------------------------------------------
# Configuration options related to the DOCBOOK output
#---------------------------------------------------------------------------
GENERATE_DOCBOOK = NO
DOCBOOK_OUTPUT = docbook
#---------------------------------------------------------------------------
# Configuration options for the AutoGen Definitions output
#---------------------------------------------------------------------------
GENERATE_AUTOGEN_DEF = NO
#---------------------------------------------------------------------------
# Configuration options related to the Perl module output
#---------------------------------------------------------------------------
GENERATE_PERLMOD = NO
PERLMOD_LATEX = NO
PERLMOD_PRETTY = YES
PERLMOD_MAKEVAR_PREFIX =
#---------------------------------------------------------------------------
# Configuration options related to the preprocessor
#---------------------------------------------------------------------------
ENABLE_PREPROCESSING = YES
MACRO_EXPANSION = NO
EXPAND_ONLY_PREDEF = NO
SEARCH_INCLUDES = YES
INCLUDE_PATH =
INCLUDE_FILE_PATTERNS = *.c *.h
PREDEFINED =
EXPAND_AS_DEFINED =
SKIP_FUNCTION_MACROS = YES
#---------------------------------------------------------------------------
# Configuration options related to external references
#---------------------------------------------------------------------------
TAGFILES =
GENERATE_TAGFILE =
ALLEXTERNALS = NO
EXTERNAL_GROUPS = YES
EXTERNAL_PAGES = YES
PERL_PATH = /usr/bin/perl
#---------------------------------------------------------------------------
# Configuration options related to the dot tool
#---------------------------------------------------------------------------
CLASS_DIAGRAMS = YES
MSCGEN_PATH =
HIDE_UNDOC_RELATIONS = YES
HAVE_DOT = YES
DOT_NUM_THREADS = 2
DOT_FONTNAME = Helvetica
DOT_FONTSIZE = 10
DOT_FONTPATH =
CLASS_GRAPH = YES
COLLABORATION_GRAPH = YES
GROUP_GRAPHS = YES
UML_LOOK = YES
UML_LIMIT_NUM_FIELDS = 10
TEMPLATE_RELATIONS = YES
INCLUDE_GRAPH = YES
INCLUDED_BY_GRAPH = YES
CALL_GRAPH = YES
CALLER_GRAPH = YES
GRAPHICAL_HIERARCHY = YES
DIRECTORY_GRAPH = YES
DOT_IMAGE_FORMAT = png
INTERACTIVE_SVG = YES
DOT_PATH =
DOTFILE_DIRS = ./docs/dots
MSCFILE_DIRS = ./docs/mscs
DOT_GRAPH_MAX_NODES = 50
MAX_DOT_GRAPH_DEPTH = 0
DOT_TRANSPARENT = NO
DOT_MULTI_TARGETS = NO
GENERATE_LEGEND = YES
DOT_CLEANUP = NO
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190
- 191
- 192
- 193
- 194
- 195
- 196
- 197
- 198
- 199
- 200
- 201
- 202
- 203
- 204
- 205
- 206
- 207
- 208
- 209
- 210
- 211
- 212
- 213
- 214
- 215
- 216
- 217
- 218
- 219
- 220
- 221
- 222
- 223
- 224
- 225
- 226
- 227
- 228
- 229
- 230
- 231
- 232
- 233
- 234
- 235
- 236
- 237
- 238
- 239
- 240
- 241
- 242
- 243
- 244
- 245
- 246
- 247
- 248
- 249
- 250
- 251
- 252
- 253
- 254
- 255
- 256
- 257
- 258
- 259
- 260
- 261
- 262
- 263
- 264
- 265
- 266
- 267
- 268
- 269
- 270
- 271
- 272
- 273
- 274
- 275
- 276
- 277
- 278
- 279
- 280
- 281
- 282
- 283
- 284
- 285
- 286
- 287
- 288
- 289
- 290
- 291
- 292
- 293
- 294
- 295
- 296
- 297
- 298
- 299
- 300
- 301
- 302
- 303
- 304
- 305
Project related configuration options
配置项 | 作用 |
---|---|
DOXYFILE_ENCODING | UTF-8,配置文件的编码格式。 |
PROJECT_NAME | 项目名称。 |
PROJECT_NUMBER | 项目的的版本号。 |
PROJECT_BRIEF | 项目的简短描述。 |
PROJECT_LOGO | 项目的 logo。 |
OUTPUT_DIRECTORY | ./docs,输出文档的目录。 |
CREATE_SUBDIRS | YES,是否创建子目录。 |
OUTPUT_LANGUAGE | Chinese,输出文档的语言。 |
BRIEF_MEMBER_DESC | YES,是否在类的简介中包含成员描述。 |
REPEAT_BRIEF | YES,是否在详细描述中重复简介。 |
ABBREVIATE_BRIEF | 对简介进行缩写。 |
ALWAYS_DETAILED_SEC | YES,是否始终在分组中生成详细页面。 |
INLINE_INHERITED_MEMB | YES,是否内联继承成员文档。 |
FULL_PATH_NAMES | YES,是否在文件列表中使用完整的路径名。 |
STRIP_FROM_PATH | 从路径中剥离目录。 |
STRIP_FROM_INC_PATH | 从包含文件的路径中剥离目录。 |
SHORT_NAMES | NO,是否使用短文件名。 |
JAVADOC_AUTOBRIEF | NO,是否使用 JavaDoc 风格的简介。 |
QT_AUTOBRIEF | NO,是否使用 Qt 风格的简介。 |
MULTILINE_CPP_IS_BRIEF | NO,是否允许在 C++ 注释中使用多行简介。 |
INHERIT_DOCS | YES,是否从父类继承文档。 |
SEPARATE_MEMBER_PAGES | NO,是否为每个类的成员生成单独的页面。 |
TAB_SIZE | 4,指定选项卡的宽度。 |
ALIASES | 定义别名。 |
TCL_SUBST | 在 Tcl 脚本中使用的替换。 |
OPTIMIZE_OUTPUT_FOR_C | YES,是否对 C 语言进行优化。 |
OPTIMIZE_OUTPUT_JAVA | NO,是否对 Java 进行优化。 |
OPTIMIZE_FOR_FORTRAN | NO,是否对 Fortran 进行优化。 |
OPTIMIZE_OUTPUT_VHDL | NO,是否对 VHDL 进行优化。 |
EXTENSION_MAPPING | 扩展名映射。 |
MARKDOWN_SUPPORT | YES,是否支持 Markdown。 |
AUTOLINK_SUPPORT | YES,是否自动链接 URL 和电子邮件。 |
BUILTIN_STL_SUPPORT | NO,是否支持 C++ STL 库。 |
CPP_CLI_SUPPORT | NO,是否支持 C++/CLI |
SIP_SUPPORT | NO,是否支持 PyQt 代码。 |
IDL_PROPERTY_SUPPORT | YES,是否支持 IDL 属性。 |
DISTRIBUTE_GROUP_DOC | NO,是否分发分组文档。 |
SUBGROUPING | YES,是否分组子目录。 |
INLINE_GROUPED_CLASSES | YES,是否内联组中的类。 |
INLINE_SIMPLE_STRUCTS | YES,是否内联简单结构体。 |
TYPEDEF_HIDES_STRUCT | NO,是否隐藏 typedef 中的结构体。 |
LOOKUP_CACHE_SIZE | 0,查找缓存大小。 |
Build related configuration options
配置项 | 作用 |
---|---|
EXTRACT_ALL | YES,是否提取所有的实体。 |
EXTRACT_PRIVATE | YES,是否提取私有实体。 |
EXTRACT_PACKAGE | YES,是否提取包/命名空间中的实体。 |
EXTRACT_STATIC | YES,是否提取静态实体。 |
EXTRACT_LOCAL_CLASSES | YES,是否提取局部类的文档。 |
EXTRACT_LOCAL_METHODS | YES,是否提取局部类的文档。 |
EXTRACT_ANON_NSPACES | YES,是否提取匿名命名空间的文档。 |
HIDE_UNDOC_MEMBERS | NO,是否隐藏未被文档化的成员。 |
HIDE_UNDOC_CLASSES | NO,是否隐藏未被文档化的类。 |
HIDE_FRIEND_COMPOUNDS | NO,是否隐藏未被文档化的友元。 |
HIDE_IN_BODY_DOCS | NO,是否隐藏函数/类实现中的文档。 |
INTERNAL_DOCS | YES,是否包括内部文档。 |
CASE_SENSE_NAMES | YES,是否区分名称大小写。 |
HIDE_SCOPE_NAMES | YES,是否隐藏作用域限定符。 |
SHOW_INCLUDE_FILES | YES,是否在文档中显示包含文件。 |
FORCE_LOCAL_INCLUDES | YES,是否强制使用相对路径的本地包含文件。 |
INLINE_INFO | YES,是否提供内联函数的文档。 |
SORT_MEMBER_DOCS | YES,是否按照成员的出现顺序对文档进行排序。 |
SORT_BRIEF_DOCS | NO,是否按照类、函数、成员的简要文档排序。 |
SORT_MEMBERS_CTORS_1ST | NO,是否先将构造函数和析构函数排在成员列表的前面。 |
SORT_GROUP_NAMES | NO,是否按照组名排序。 |
SORT_BY_SCOPE_NAME | NO,是否按照作用域名称排序。 |
STRICT_PROTO_MATCHING | NO,是否对函数参数进行严格的匹配。 |
GENERATE_TODOLIST | YES,是否生成待办事项列表。 |
GENERATE_TESTLIST | YES,是否生成测试列表。 |
GENERATE_BUGLIST | YES,是否生成缺陷列表。 |
GENERATE_DEPRECATEDLIST | YES,是否生成已弃用列表。 |
ENABLED_SECTIONS | |
MAX_INITIALIZER_LINES | 30,初始化器的最大行数。 |
SHOW_USED_FILES | YES,是否在文档中显示已使用的文件。 |
SHOW_FILES | YES,是否在文档中显示所有文件。 |
SHOW_NAMESPACES | YES,是否在文档中显示命名空间。 |
FILE_VERSION_FILTER | 是否启用文件版本过滤器。 |
LAYOUT_FILE | 自定义布局文件的名称。 |
CITE_BIB_FILES |
Configuration options related to warning and progress messages
配置项 | 作用 |
---|---|
QUIET | NO,是否关闭所有警告和错误消息。 |
WARNINGS | YES,是否启用警告消息。 |
WARN_IF_UNDOCUMENTED | YES,是否在文档中生成未文档化的警告。 |
WARN_IF_DOC_ERROR | YES,是否在文档中生成文档错误的警告。 |
WARN_NO_PARAMDOC | NO,是否在函数参数没有文档的情况下生成警告。 |
WARN_FORMAT | “ f i l e : file: file:line: $text”,警告消息的格式。 |
WARN_LOGFILE |
Configuration options related to the input files
配置项 | 作用 |
---|---|
INPUT | ./,一个用空格分隔的模式列表,要处理的输入文件或目录的列表。 |
INPUT_ENCODING | UTF-8,输入文件的字符编码。 |
FILE_PATTERNS | 一个用空格分隔的模式列表,文件名的样式。 |
RECURSIVE | YES,对于指定的文件夹,是否应递归地搜索其子目录。 |
EXCLUDE | 一个用空格分隔的模式列表,指定哪些文件或目录不应包含在输入中。 |
EXCLUDE_SYMLINKS | NO,如果为 YES,则忽略符号链接。否则,将处理它们指向的文件。 |
EXCLUDE_PATTERNS | 一个用空格分隔的模式列表,用于指定哪些文件或目录不应包含在 INPUT 中。默认为空。 |
EXCLUDE_SYMBOLS | 一个用空格分隔的模式列表,用于指定哪些符号(如函数或变量)不应在生成的文档中出现。默认为空。 |
EXAMPLE_PATH | 示例文件的路径。默认为空。 |
EXAMPLE_PATTERNS | 一个用空格分隔的模式列表,指定应该包含哪些示例文件。默认为空。 |
EXAMPLE_RECURSIVE | 对于指定的文件夹,是否应递归地搜索其子目录。默认为 YES。 |
IMAGE_PATH | 包含图片的目录的路径。默认为空。 |
INPUT_FILTER | 一个用于文件过滤的正则表达式。如果文件名与该正则表达式不匹配,则该文件将被忽略。默认为空。 |
FILTER_PATTERNS | 一个用空格分隔的模式列表,用于指定应该过滤哪些文件。默认为空。 |
FILTER_SOURCE_FILES | 如果为 YES,则源文件也会被过滤。否则,只有头文件会被过滤。默认为 NO。 |
FILTER_SOURCE_PATTERNS | :一个用空格分隔的模式列表,指定应该过滤哪些源文件。默认为空。 |
USE_MDFILE_AS_MAINPAGE | 如果为 YES,则将第一个 Markdown 文件视为主页。否则,使用 index.h 或 index.cpp 作为主页。默认为 NO。 |
Configuration options related to source browsing
配置项 | 作用 |
---|---|
SOURCE_BROWSER | NO,如果为 YES,则在生成的 HTML 中包括源代码。默认为 NO。 |
INLINE_SOURCES | NO,如果为 YES,则在 HTML 中包含内联源代码。默认为 NO。 |
STRIP_CODE_COMMENTS | NO,如果为 YES,则从源文件中删除注释。默认为 YES。 |
REFERENCED_BY_RELATION | 如果为 YES,则将 “引用者” 列添加到类的成员列表中。默认为 YES。 |
REFERENCES_RELATION | 如果为 YES,则将“ 参考” 列添加到类的成员列表中。默认为 YES。 |
REFERENCES_LINK_SOURCE | 如果为 YES,则在生成的文档中为每个参考项添加链接。默认为 YES。 |
SOURCE_TOOLTIPS | YES,指示是否应该为 HTML 源代码生成工具提示。 |
USE_HTAGS | NO,指示是否应在 HTML 输出中使用 H 标记,而不是 CSS 样式。 |
VERBATIM_HEADERS | YES,如果设置为 YES,则 Doxygen 将以原样包含文本头文件,否则将按照特定的方式处理。 |
Configuration options related to the alphabetical class index
配置项 | 作用 |
---|---|
ALPHABETICAL_INDEX | YES |
COLS_IN_ALPHA_INDEX | 5 |
IGNORE_PREFIX |
Configuration options related to the HTML output
配置项 | 作用 |
---|---|
GENERATE_HTML | YES |
HTML_OUTPUT | . |
HTML_FILE_EXTENSION | .html |
HTML_HEADER | |
HTML_FOOTER | |
HTML_STYLESHEET | |
HTML_EXTRA_STYLESHEET | |
HTML_EXTRA_FILES | |
HTML_COLORSTYLE_HUE | 220 |
HTML_COLORSTYLE_SAT | 100 |
HTML_COLORSTYLE_GAMMA | 80 |
HTML_TIMESTAMP | NO |
HTML_DYNAMIC_SECTIONS | NO |
HTML_INDEX_NUM_ENTRIES | 100 |
GENERATE_DOCSET | NO |
DOCSET_FEEDNAME | “Doxygen generated docs” |
DOCSET_BUNDLE_ID | org.doxygen.Project |
DOCSET_PUBLISHER_ID | org.doxygen.Publisher |
DOCSET_PUBLISHER_NAME | Publisher |
GENERATE_HTMLHELP | NO |
CHM_FILE | |
HHC_LOCATION | |
GENERATE_CHI | NO |
CHM_INDEX_ENCODING | |
BINARY_TOC | NO |
TOC_EXPAND | NO |
GENERATE_QHP | NO |
QCH_FILE | |
QHP_NAMESPACE | org.doxygen.Project |
QHP_VIRTUAL_FOLDER | doc |
QHP_CUST_FILTER_NAME | |
QHP_CUST_FILTER_ATTRS | |
QHP_SECT_FILTER_ATTRS | |
QHG_LOCATION | |
GENERATE_ECLIPSEHELP | NO |
ECLIPSE_DOC_ID | org.doxygen.Project |
DISABLE_INDEX | NO |
GENERATE_TREEVIEW | ALL |
ENUM_VALUES_PER_LINE | 4 |
TREEVIEW_WIDTH | 250 |
EXT_LINKS_IN_WINDOW | NO |
FORMULA_FONTSIZE | 10 |
FORMULA_TRANSPARENT | YES |
USE_MATHJAX | NO |
MATHJAX_FORMAT | HTML-CSS |
MATHJAX_RELPATH | http://cdn.mathjax.org/mathjax/latest |
MATHJAX_EXTENSIONS | |
MATHJAX_CODEFILE | |
SEARCHENGINE | YES |
SERVER_BASED_SEARCH | NO |
EXTERNAL_SEARCH | NO |
SEARCHENGINE_URL | |
SEARCHDATA_FILE | searchdata.xml |
EXTERNAL_SEARCH_ID | |
EXTRA_SEARCH_MAPPINGS |
Configuration options related to the LaTeX output
配置项 | 作用 |
---|---|
GENERATE_LATEX | NO |
LATEX_OUTPUT | latex |
LATEX_CMD_NAME | latex |
MAKEINDEX_CMD_NAME | makeindex |
COMPACT_LATEX | NO |
PAPER_TYPE | a4 |
EXTRA_PACKAGES | |
LATEX_HEADER | |
LATEX_FOOTER | |
LATEX_EXTRA_FILES | |
PDF_HYPERLINKS | YES |
USE_PDFLATEX | YES |
LATEX_BATCHMODE | NO |
LATEX_HIDE_INDICES | NO |
LATEX_SOURCE_CODE | NO |
LATEX_BIB_STYLE | plain |
Configuration options related to the RTF output
配置项 | 作用 |
---|---|
GENERATE_RTF | NO |
RTF_OUTPUT | rtf |
COMPACT_RTF | NO |
RTF_HYPERLINKS | NO |
RTF_STYLESHEET_FILE | |
RTF_EXTENSIONS_FILE |
Configuration options related to the man page output
配置项 | 作用 |
---|---|
GENERATE_MAN | NO |
MAN_OUTPUT | man |
MAN_EXTENSION | .3 |
MAN_LINKS | NO |
Configuration options related to the XML output
配置项 | 作用 |
---|---|
GENERATE_XML | NO |
XML_OUTPUT | xml |
XML_SCHEMA | |
XML_DTD | |
XML_PROGRAMLISTING | YES |
Configuration options related to the DOCBOOK output
配置项 | 作用 |
---|---|
GENERATE_DOCBOOK | NO |
DOCBOOK_OUTPUT | docbook |
Configuration options for the AutoGen Definitions output
配置项 | 作用 |
---|---|
GENERATE_AUTOGEN_DEF | NO |
Configuration options related to the Perl module output
配置项 | 作用 |
---|---|
GENERATE_PERLMOD | NO |
PERLMOD_LATEX | NO |
PERLMOD_PRETTY | YES |
PERLMOD_MAKEVAR_PREFIX |
Configuration options related to the preprocessor
配置项 | 作用 |
---|---|
ENABLE_PREPROCESSING | YES |
MACRO_EXPANSION | NO |
EXPAND_ONLY_PREDEF | NO |
SEARCH_INCLUDES | YES |
INCLUDE_PATH | |
INCLUDE_FILE_PATTERNS | *.c *.h |
PREDEFINED | |
EXPAND_AS_DEFINED | |
SKIP_FUNCTION_MACROS | YES |
Configuration options related to external references
配置项 | 作用 |
---|---|
TAGFILES | |
GENERATE_TAGFILE | |
ALLEXTERNALS | NO |
EXTERNAL_GROUPS | YES |
EXTERNAL_PAGES | YES |
PERL_PATH | /usr/bin/perl |
Configuration options related to the dot tool
配置项 | 作用 |
---|---|
CLASS_DIAGRAMS | YES,是否生成类图。 |
MSCGEN_PATH | MSCGEN 的路径,MSCGEN 是一种序列图绘制工具。 |
HIDE_UNDOC_RELATIONS | YES,是否隐藏未被文档记录的关系。 |
HAVE_DOT | YES,是否安装了 Graphviz 工具包中的 dot 工具。 |
DOT_NUM_THREADS | 0,dot 工具使用的线程数。 |
DOT_FONTNAME | Helvetica,dot 工具使用的字体名称。 |
DOT_FONTSIZE | 10,dot 工具使用的字体大小。 |
DOT_FONTPATH | dot 工具字体的搜索路径。 |
CLASS_GRAPH | YES,是否生成类图。 |
COLLABORATION_GRAPH | YES,是否生成协作图。 |
GROUP_GRAPHS | YES,是否生成组图。 |
UML_LOOK | YES,是否使用 UML 风格。 |
UML_LIMIT_NUM_FIELDS | 10,生成的类中字段数量的限制。 |
TEMPLATE_RELATIONS | YES,是否生成模板关系。 |
INCLUDE_GRAPH | YES,是否生成包含图。 |
INCLUDED_BY_GRAPH | YES,是否生成被包含图。 |
CALL_GRAPH | YES,是否生成调用图。 |
CALLER_GRAPH | YES,是否生成被调用图。 |
GRAPHICAL_HIERARCHY | YES,是否生成层次结构图。 |
DIRECTORY_GRAPH | YES,是否生成目录图。 |
DOT_IMAGE_FORMAT | png,生成的图像格式。 |
INTERACTIVE_SVG | YES,是否生成可交互的 SVG。 |
DOT_PATH | dot 工具的路径。 |
DOTFILE_DIRS | dot 文件的搜索路径。 |
MSCFILE_DIRS | MSC 文件的搜索路径。 |
DOT_GRAPH_MAX_NODES | 50,生成的图中节点的最大数量。 |
MAX_DOT_GRAPH_DEPTH | 0,生成的图中节点的最大深度。 |
DOT_TRANSPARENT | NO,生成的图像是否透明。 |
DOT_MULTI_TARGETS | NO,生成多个目标图像。 |
GENERATE_LEGEND | YES,是否生成图例。 |
DOT_CLEANUP | NO,是否清除 *.dot 中间文件。 |
使用
$ doxygen doxyconfig
- 1
附件
ChatGPT 写的 MD 格式转换器。
$ config_parser.sh
#!/bin/bash
# 是否需要在下一行添加表头和行末信息
need_table_header=0
need_extra_info=0
# 读取文件
while read line
do
# 如果行以 "#--" 开头,则忽略该行并继续处理下一行
if [[ $line == "#--"* ]]; then
continue
fi
# 如果行以 "# " 开头,则将其替换为 "## " 并打印,同时在行末添加表头和行末信息
if [[ $line == "# "* ]]; then
line="##${line:1}"
echo "$line"
need_table_header=1
need_extra_info=1
continue
fi
# 分割字符串
key="${line%=*}"
value="${line#*=}"
# 如果需要添加表头,则在此行前面添加表头和行末信息
if [ $need_table_header -eq 1 ]; then
echo "| 配置项 | 作用 |"
echo "|:--|:--|"
need_table_header=0
fi
# 输出键值对
echo "| $key | $value |"
# 如果需要添加行末信息,则在此行后面添加行末信息和下一行的表头
if [[ $line == "## "* ]]; then
echo "| 配置项 | 作用 |"
echo "|:--|:--|"
need_extra_info=1
else
need_extra_info=0
fi
done < doxyconfig
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47