「Doxygen」- 文档生成工具 | Documentation Generator

认识

官网: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