当前位置: 首页 > news >正文

高仿做的好点的网站智慧团建信息系统网站

高仿做的好点的网站,智慧团建信息系统网站,制作企业网站的步骤,做网站需要的费用目录 目录 1 软件介绍 2 Doxygen软件下载方法 3 Doxygen软件配置方法 4 标准注释描述 4.1 块注释 和 特殊描述字符 4.1.1 函数描述示例 4.1.2结构体数组变量示例 特别注意: 4.2单行注释 4.2.1 单个变量注释示例 特别注意: 4.2.2对于枚举变量…

目录

目录

1 软件介绍

2 Doxygen软件下载方法

3 Doxygen软件配置方法

4 标准注释描述

4.1 块注释 和 特殊描述字符

4.1.1 函数描述示例

4.1.2结构体数组变量示例

特别注意:

4.2单行注释

4.2.1 单个变量注释示例

特别注意:

4.2.2对于枚举变量描述示例

4.3 markdown语法使用及效果

4.4 类图 & 流程图调用关系生成方法


1 软件介绍

Doxygen是通过注释过的源代码文件来生成文档的工具,常用的语言例如C、Objective-C、C#、PHP、Java、Python、IDL等。它可以从一组有文档的源文件生成在线文档浏览器(HTML格式)和/或离线参考手册(LaTeX格式)。它还支持生成 RTF(MS-Word)、PostScript、超链接 PDF、压缩 HTML、DocBook 和 Unix 手册页的输出。文档直接从源代码中提取,这使得保持文档与源代码的一致性变得更加容易。可以配置 Doxygen 从未文档化的源文件中提取代码结构。这对于在大型源代码分发中快速找到方向非常有用。Doxygen 还可以通过包含依赖图、继承图和协作图来可视化各个元素之间的关系,所有这些都会自动生成。

Doxygen是开源软件,遵循GUN开源协议,因此生成的文档是从其生产中使用的输入派生的衍生作品;他们不受此许可证的影响。

开源Github网址:GitHub - doxygen/doxygen: Official doxygen git repository

Doxygen官网:Doxygen homepage

2 Doxygen软件下载方法

软件下载网站参照官网:Doxygen download

可以在不同系统上下载不同版本安装包,默认安装即可。

3 Doxygen软件配置方法

安装后在安装目录下可以看到 doxygen\bin\doxywizard.exe 程序

点击打开后可以看到运对应的GUI界面

首先填写 Project信息

然后填写模式信息

选择输出文档模式

关于生成类图的选项

选择 Expert 可以配置更多内容,例如在input中可以追加中文源码分析,鼠标悬停在各个选项上时有更详细的解释

上述内容配置好后,可以点击file或者ctrl+s保存配置。开发上各个域或模块情况不一样,每部分作业可以按照自己的需求定制化配置进行保存,开发者导入配置文件后标准化注释后直接导出文件即可。

进入Run界面,点击Run doxygen开始生成相关文档,点击 Show HTML output,可以查看生成的文档内容

4 标准注释描述

4.1 块注释 和 特殊描述字符

 标准注释方法可以参照 官方文档中Special Commands章节

下载连接:https://www.doxygen.nl/files/doxygen_manual-1.12.0.pdf.zip

常用的commands例如

commonds

含义

brief

函数简要说明

copyright

版权所有声明

author

作者描述

data

日期描述

version

版本描述

param

参数描述

showdata

版本日期描述

return

返回值描述

note

注解提示信息

important

重要提示信息

code \endcode

示例代码

warning

警告提示信息

todo

代办事项提示信息

bug

Bug提示信息

可以描述的内容很多例如:函数、变量、类型定义、枚举、枚举值、宏定义都可以进行相关描述

4.1.1 函数描述示例

这些Special Commands 使用位置要和需要注释说明的函数放到一起,同时整体注释使用如下方式进行

/*!
* @[Special Commands]
*/

 例如:

或者

/*!
* \[Special Commands]
*/

例如:

然后使用Doxygen生成文档此部分效果如下:

如果有需要也可以更改Doxygen配置生成其他语言效果

4.1.2结构体数组变量示例

代码:

效果展示:

特别注意:

这里值得注意的是上述描述中因为有 @todo 相关描述所以最终会在生成产物中todo list中体现相关信息如下:

4.2单行注释

(PS:更详细的内容参照

https://www.doxygen.nl/files/doxygen_manual-1.12.0.pdf.zip 中 Documenting the code 章节)

可以使用 /// 或 //!   

同时也可以在注释后再使用 @[Special Commands]的方式进行额外标注

4.2.1 单个变量注释示例

对于单个变量,往往会采用单行注释方法进行描述

效果如下:

特别注意:

上述注释方法需要将注释放到变量前使用,如果想要注释放到变量后使用

可以使用如下三种方法

效果展示:

4.2.2对于枚举变量描述示例

代码:

文档生成效果:

 

4.3 markdown语法使用及效果

TODO

4.4 类图 & 流程图调用关系生成方法

TODO

http://www.yayakq.cn/news/373602/

相关文章:

  • 常用来做网站首页的是国家企业网查询
  • 排名好的宜昌网站建设广东省建设注册中心网站
  • 快递物流网站建设开发具备哪些功能中国商标注册网官方网站
  • 以投资思维做网站推广排名seo
  • 网站备案都审核什么资料关于网络营销的论文
  • 甘州区住房和城乡建设局网站南通网站建设培训
  • 盐城网站建设hx1818网站系统管理员
  • 厦门市建设局报表网站建设网站的要点
  • 海南做网站找谁设计企业展厅公司
  • 长宁哪里有做网站优化比较好网站做邮箱吗
  • 网站建设的广告投入百度搜索引擎提交入口
  • 淘宝客返利网站建设网站建设功能设计
  • 上海企业建站步骤局门户网站建设工作汇报
  • 国外网站在国内备案小纯洁网站开发
  • 怎么建立一个网站广告常德seo
  • iis添加asp网站遂宁公司做网站
  • 电子商务的网站建设要求步骤制作壁纸的软件
  • 网站服务器参数云星穹铁道网页版入口
  • 做网页兼职网站有哪些dedecms网站信息统计
  • 嘉兴制作手机网站天津企业建网站
  • 湖南网站建设磐石网络阿里网站官网入口
  • 漳州 做网站Wordpress做APP后端
  • 电商网站建设 平台在国外建网站方便吗
  • 葫芦岛公司做网站红色网站呢
  • 建设银行河南分行网站临沂医院网站建设
  • 购买网站做网页游戏windows优化大师是自带的吗
  • 何做百度推广网站沧州建设厅官方网站
  • 微信公众号私自建设电影网站ipv6改造 网站怎么做6
  • 免费做链接的网站网站建设公司业务培训
  • 网站的创新点有哪些哪一些网站可以开户做百度广告