• (转)Doxygen文档生成工具


      http://blog.csdn.net/lostaway/article/details/6446786

    Doxygen 是一个支持 C/C++,以及其它多种语言的跨平台文档生成工具。如同 JavaDoc, doxygen 直接从源文件中提取符合 doxygen 注释规范的注释,生成文档[1]。 

    1、安装

    1.1 安装 Doxygen 1.7.4(Windows)

    地址:ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.7.4.windows.bin.zip

    1.2 安装 graphviz 2.28.0(Windows)

    地址:http://www.graphviz.org/pub/graphviz/stable/windows/graphviz-2.28.0.msi

    graphviz 是一个由AT&T实验室启动的开源工具包,用于绘制DOT语言脚本描述的图形[2]。Doxygen 使用 graphviz 自动生成类之间和文件之间的调用关系图,如不需要此功能可不安装该工具包。

    1.3 安装 Windows Help Workshop 1.32

    地址:http://download.microsoft.com/download/0/a/9/0a939ef6-e31c-430f-a3df-dfae7960d564/htmlhelp.exe

    这个工具就不多说了,生成 CHM 帮助文档的。 Doxygen 使用它生成 CHM 格式的文档。

    2、配置

    运行 Doxywizard 开始配置

    Doxygen 1.7.4 主界面如下图 1 所示。

    说明:

    Doxygen 工作目录(1:) 就是用来存放配置文件的目录,别无它用。

    选择 wizard 标签下的 Output Topics

    相关配置说明如下图 2 所示。

    选择 wizard 标签下的 Diagrams Topics

    相关配置说明如下图 3 所示。

    如果之前安装了 Graphviz 工具包,就可启用该选项。

    选择 expert 标签下的 Project Topics

    相关配置说明如下图 4 所示。

    说明:编码格式,UTF-8 是首选。

    选择 expert 标签下的 Input Topics

    相关配置说明如下图 5 所示。

     

    说明:

    输入的源文件的编码,要与源文件的编码格式相同。如果源文件不是UTF-8编码最好转一下。

    选择 expert 标签下的 HTML Topics

    相关配置说明如下图 6 所示。

    说明:

    如果在 Wizard 的 Output Topics 中选择了 prepare for compressed HTML (.chm)选项,此处就会要求选择 hhc.exe 程序的位置。在 windows help workshop 安装目录下可以找到 hhc.exe。

    在 Expert 标签中还有超多的选项,需要按自己的要求去定制。个人喜好问题就不再赘述了,大家可以查 doxygen 文档啥的,里面有每个选项的详细介绍。

    选择 Run 标签

    相关配置说明如下图 7 所示。

     点击 Run doxygen 按钮, Doxygen 就会从源代码中抓取符合规范的注释生成你定制的格式的文档。接下来的工作就是学习 doxygen 的注释规范了,参考 《doxygen 快速入门》第 2 节 “常用注释语法”。慢慢的就可以体会到 doxygen 的方便性。

    Doxygen 生成 CHM 文档乱码的问题

    由于 Windows 的默认编码不是 UTF-8, Doxygen 生成的 CHM文件目录和文件标题栏是乱码。一般解决步骤可以参考《doxygen 快速入门》关于解决目录乱码的问题。这里要补充的一点就是,最好将 index.hhc、index.hhk 、index.hhp都转为 UTF-8格式。这样标题栏啥的也不会是乱码了。

    参考

    [1] http://zh.wikipedia.org/wiki/Doxygen Wikipedia-doxygen

    [2] http://zh.wikipedia.org/wiki/Graphviz Wikipedia-graphviz

    [3] http://hi.baidu.com/soulmachine/blog/item/6055ad017a9a1606738da58c.html doxygen 快速入门

    附录

    补充几张效果图:

  • 相关阅读:
    druid连接池的配置和应用
    Maven的Unknow错误
    实践——WebStorm安装(2021/01/30)(更新2021/07/14,添加激活码和习惯设置)
    vue3如何编写挂载DOM的插件
    npm 安装源
    一个node项目的docker镜像制作
    圣女
    基于计算机视觉的车牌识别系统(一)
    vue3 兄弟组件传参mitt
    laravel-admin 加载样式失败
  • 原文地址:https://www.cnblogs.com/andy1202go/p/5459701.html
Copyright © 2020-2023  润新知