
写文档是一件非常冗杂的事情有些机构聘请一个或多个专课件.ppt
18页Doxygen简介简介马秋梅05/06/15写文档是一件非常冗杂的事情有些机构聘请一个或多个专Doxygen 的来历的来历l写文档是一件非常冗杂的事情有些机构聘请一个或多个专门人员来处理整个工作描述文档l一个Java开发者突发奇想,“如果我们设计一个可以根据我们的源文件注释来产生文档的工具,那会怎样呢?”,于是JavaDoc就诞生了l那么C++编程者怎么办?还要继续进行这种冗杂的工作吗?这时候Doxygen的出现解决了这个难题 写文档是一件非常冗杂的事情有些机构聘请一个或多个专Doxygen 是什么?是什么?lDoxygen的词根来源于Document(文档)和Oxygen(氧气),是一种适合C风格语言(如C++、C、IDL、Java甚至包括C#和PHP)的、跨平台的、开放源码的、基于命令行的代码文档产生器lDoxygen由荷兰人Dimitri van Heesch.开发,并且在GNU公共许可证(GPL)下发布,目前已经成为各主要的Linux发行版的附带组件l众多重量级的软件项目(如KDE,Qt、ACE库等)都选用Doxygen作为其编档工具生成项目文档 写文档是一件非常冗杂的事情有些机构聘请一个或多个专Doxygen可以做什么?可以做什么?一、可以从一套文档化的源代码中,生成一份可浏览的文档(HTML格式)或离线参考手册(LATEX格式)。
还可以生成RTF(MS-Word)、PS、PDF以及Unix man pages等格式的文档二、可以从没有文档化的源代码中抽取代码结构这一点对于快速理清大型的源代码包的脉络很有帮助还可以通过自动生成的依赖图,继承图,协作图来将不同元素之间的关系可视化(分析他人的代码(没有注释或者注释很糟糕)来得到原作者的设计思路、实现方法,这样自己就可以根据需要进行相应的修改三、可以“滥用”doxygen来创建普通的文档(杀鸡使用宰牛刀了)写文档是一件非常冗杂的事情有些机构聘请一个或多个专Doxygen工作流程图工作流程图写文档是一件非常冗杂的事情有些机构聘请一个或多个专lDoxygen使用了一个基于文本的配置文件,你可以在配置文件中设定大量的选项来控制Doxygen的行为配置文件的格式与一般的配置文件相似,是由名称/值对组成的ASCII码,由doxygen命令来解析有两种方式可以创建和修改配置文件: 1、Doxygen可以在命令行方式下加上参数-g自动创建 模板文件,然后你就可以修改这个配置文件 2、也可以使用Doxygen提供的辅助工具Doxywizard。
Doxywizard是Doxygen的GUI前台,用户可以通过 它来读写配置文件,省却了手工配置的麻烦如何使用如何使用Doxygen??写文档是一件非常冗杂的事情有些机构聘请一个或多个专如何生成如何生成Doxygen配置文件?配置文件?(一)l>doxygen –g
lINCLUDE_GRAPH = YES (为每个归档文件创建一幅包含依赖图)lCOLLABORATION_GRAPH = YES(会为每个归档类或结构绘制基类 继承关系图和使用关系图)lCALL_GRAPH = YES(会为每个函数显示一幅直接或间接调用关系图)lGRAPHICAL_HIERARCHY = YES(将会绘制一个图形表示的类 图结构)写文档是一件非常冗杂的事情有些机构聘请一个或多个专lSOURCE_BROWSER = YESlSHOW_INCLUDE_FILES = YESl = *.cxx *.hlRECURSIVE = YESlALPHABETICAL_INDEX = YESlGENERATE_HTML = YESlGENERATE_LATEX = YESlPDF_HYPERLINKS = NOlEtc .写文档是一件非常冗杂的事情有些机构聘请一个或多个专如何生成如何生成Doxygen配置文件?配置文件?(二) >doxywizard写文档是一件非常冗杂的事情有些机构聘请一个或多个专如何生成需要的文档?如何生成需要的文档?l>doxygen Doxyfile 生成用户定制的文档。
写文档是一件非常冗杂的事情有些机构聘请一个或多个专如何使用浏览器浏览生成的文档?如何使用浏览器浏览生成的文档?l把生成的html目录下的文件拷贝到自己根目录下的public_html目录下,就大功告成了写文档是一件非常冗杂的事情有些机构聘请一个或多个专实例实例写文档是一件非常冗杂的事情有些机构聘请一个或多个专写文档是一件非常冗杂的事情有些机构聘请一个或多个专写文档是一件非常冗杂的事情有些机构聘请一个或多个专写文档是一件非常冗杂的事情有些机构聘请一个或多个专写文档是一件非常冗杂的事情有些机构聘请一个或多个专抛砖引玉,谢谢大家!抛砖引玉,谢谢大家!写文档是一件非常冗杂的事情有些机构聘请一个或多个专。












