Doxygen

doxygen

说明

Doxygen ,是一个从C++源代码注释生成文档的标准的工具。也支持其他流程语言,例如:C,java,python,VHDL等。

可以从以下三个方面取得帮助:

  • 生成一个在线文档(HTML)或者/并且生成一个离线参考手册(Latex)。还支持生成输入RTF,超链接PDF,压缩HTML和Unix参考手册。

  • 你可以配置doxygen,可以从没有注释的源文件中抽取代码结构。这个在大型源码工程中是非常有帮助的。

  • 还可以使用doxygen生成普通文档。

使用

  • 现在ubuntu上安装doxygen

  • doxygen -g Doxygen.config
    Configuration file 'Doxygen.config' created.
    ​
    Now edit the configuration file and enter
    ​
      doxygen Doxygen.config
    ​
    to generate the documentation for your project
    • 生成了config文件,然后可以编辑config文件。

    • 修改:

      EXTRACT_ALL            = YES
      EXTRACT_PRIVATE        = YES
      EXTRACT_STATIC         = YES
      HAVE_DOT               = YES,这个配置假设dot工具是可得到的,工具是Graphviz,默认就是YES,所以系统中需要安装Graphviz
      UML_LOOK               = YES
      DOT_PATH               = /usr/bin/graphml2gv
      RECURSIVE              = YES
  • doxygen Doxygen.config
    • 会在当前目录下生成html和latex目录

    • 打开html/index.html

plantUML

  • 从官网上下载plantuml.jar,放到本地/bin目录下

  • 设置Doxygen.config

    PLANTUML_JAR_PATH      = /home/fyl/bin/plantuml.jar
  • 代码中,要有使用plantUML描述流程的语言。然后就可以生成对应的UML图了。

### Doxygen 使用指南 #### 安装 Doxygen 对于不同操作系统的安装方式如下: - **Windows**: 可访问 Doxygen 官方网站下载页面,获取适用于 Windows 的可执行安装文件并按照提示完成安装过程[^2]。 - **Linux**: 利用包管理器来简化这一流程。例如,在基于 Debian 或 Ubuntu 的发行版上可以运行命令 `apt-get install doxygen` 来自动处理依赖关系并安装最新版本的 Doxygen。 - **macOS**: 用户可以通过 Homebrew 这样的软件包管理系统轻松安装 Doxygen,只需一条简单的终端指令即可实现:`brew install doxygen`。 #### 配置 Wizard 为了帮助初次使用者快速入门,Doxywizard 提供了一个图形化的向导界面用于创建和编辑配置文件。启动程序后可以选择新建项目或者打开已有项目的设置来进行调整。通过这个工具能够更直观地理解各个选项的意义及其作用范围[^1]。 #### 基本使用方法 一旦成功安装好 Doxygen 并设置了必要的环境变量(如果有的话),就可以开始利用它来自动生成文档了。通常情况下,只需要编写带有特定格式注释标记的源码片段,之后借助于之前提到过的配置文件指定输出目标以及样式模板等参数,最后调用命令行下的 doxygen 工具指明该配置文件的位置就能触发整个构建过程。 ```bash doxygen path/to/your/configfile ``` 上述命令会读取给定路径处存在的 .cfg 文件,并依据其中定义好的规则解析关联起来的所有代码库资源进而生产相应的 HTML、LaTeX 等形式的技术资料集合。 #### 安装 Graphviz (可选) 虽然不是强制性的组件之一,但是安装 Graphviz 后可以让生成出来的图表更加美观且功能更为强大。特别是当涉及到类继承结构图或是函数调用关系网络展示的时候尤为明显。同样遵循对应平台上的常规做法去部署此附加件即可获得更好的用户体验。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值