认识
官网:https://www.doxygen.nl/
文档:https://www.doxygen.nl/manual/index.html
Doxygen (/ˈdɒksidʒən/ DOK-see-jən),其用于 C, C++, Java, Objective-C, Python, IDL 和某些范围的 PHP, C#, D 的文档系统。可以从一组记录的源文件中,生成在线的 class 浏览(HTML 格式)和离线的参考手册(LaTeX 格式)。同时也支持生成 Man 手册、将生成的输出转化为 POstscript、超链接的 PDF、压缩的 HTML。文档直接从源文件中提取,即写在代码中的注释。
“Doxy”: comes from “documentation,” specifically the “docs” part.
“Gen”: comes from “generator.”
组成
命令程序 and 配置文件
doxygen
是一个基于命令行的程序,用于生成配置文件模板,然后用模板生成文档。
使用 doxygen –help 来解释命令行参数。
doxywizard
配置和运行 doxygen 的 GUI 工具。
doxyindexer
使用由 doxygen 生成的搜索数据文件,生成名为 doxysearch.db 的搜索索引文件。
http://www.stack.nl/~dimitri/doxygen/manual/extsearch.html
doxysearch.cgi
用于搜索由 doxygen 索引的数据的 CGI 程序。
性质
- 从代码的注释中,生成文档。
- 使用未注释的源码来:分析源码的结构,获取源码的调用图、继承图、关系图。
- 单纯的创建普通文档。
- 支持的输出格式 HTML、LaTeX、Man pages、Rich Text Format、XML
构建
—— 软件安装
通过包管理器安装(APT、YUM)
# Kali GNU/Linux Rolling apt-get install doxygen doxygen-gui # Doxygen 手册 apt-get install doxygen-doc
通过源码编译安装(Linux)
参考 BLFS/Doxygen-1.8.11 站点,以获取编译安装的详细过程。
参考
Wikipedia / Doxygen: https://en.wikipedia.org/wiki/Doxygen
Homepage: http://www.stack.nl/~dimitri/doxygen/
Doxygen Manual: http://www.stack.nl/~dimitri/doxygen/manual/index.html
Github Repo: https://github.com/doxygen/doxygen
BLFS/Doxygen-1.8.11