Doxygen wizard

本文介绍DoxygenGUI前端工具的配置步骤,包括工作路径设置、项目信息输入、源代码路径指定及文档输出目录选择。涵盖从项目基本信息如名称、版本、图标到源代码抽取模式、输出格式(HTML、LaTeX、Manpages等)、图表生成等方面的详细指南。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Doxygen GUI fontend为Doxygen的界面操作工具。本篇为wizard项的界面翻译。
project部分

step1 :

Specify the working directory from which doxygen will run

设置doxygen的工作路径

step2 :

Configure doxygen using the Wizard and/or Expert tab, then switch to the Run tab to generate the documentation

使用Wizard和/或Expert配置doxygen,切换到Run生成文档

Wizard

Topics

Project
  • Provide some information about the project you are documenting
    • Project name 项目名称
    • Project synopsis 项目概要
    • Project version or id 项目版本
    • Project logo 项目图标
  • Specify the directory to scan for source code
    • Source code directory 源代码路径
    • Scan recursively 是否递归扫描
  • Specify the directory where doxygen should put the generated documentation
    • Destination directory 输出路径
      Mode部分
Mode
  • Select the desired extraction mode 选择代码抽取模式
    • Documented entities only 仅记录的实体
    • All Entities 所有实体
    • Include cross-referenced source code in the output 在输出中包括交叉引用的源代码*
  • Select programmin langguage to optimize the results for
    • C++
    • C++/CLI
    • Java or C#
    • C or PHP
    • Fortan
    • VHDL
      output部分
Output
  • Select the output format(s) to generate 选择生成的格式
    • HTML
      • plain HTML 纯HTML格式
      • with navigation panel 加入导航面板
      • prepare for compressed HTML(.chm) 添加CHM文件支持
      • With search function 增加搜索框
        • Change color 更改配色方案
    • LaTeX
      • as intermediate format for hyperlinked PDF 超链接PDF的中间格式
      • as intermediate format for PDF PDF的中间格式
      • as intermediate format for PostScript PostScript的中间格式
  • Man pages 手册页
  • Rich Text Format(RTF) 富文本格式
  • XML
    diagrams部分
Diagrams
  • Diagrams to generate
    • No diagrams 无图模式
    • Use built-in class diagram generator 使用Doxygen内置的图引擎
    • Use dot tool from the GraphViz package 使用GraphViz包
    • Dot graphs to generate
      • Class diagrams 类
      • Collaboration diagrams 协作关系图
      • Overall Class hierarchy 整体类层次结构
      • Include dependency graphs 包括依赖关系图
      • Included by dependency graphs 由依赖关系图包含
      • Call graphs 调用图
      • Called by graphs 由图调用
### 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、付费专栏及课程。

余额充值