前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >如何为Dash/Zeal生成c++ 文档: 以abseil文档为例

如何为Dash/Zeal生成c++ 文档: 以abseil文档为例

作者头像
Gxjun
发布2021-12-16 09:59:20
7570
发布2021-12-16 09:59:20
举报
文章被收录于专栏:mlml

目录

1. 软件安装

2 Sample源文件下载:

3. 生成步骤

3.1 使用doxygen生成html文件

3.2 使用docsetutil 生成 dash/Zeal 格式

1. 软件安装:

代码语言:javascript
复制
1.  brew install doxygen
2. brew install swiftdocorg/formulae/docsetutil

2.Sample源文件下载:

代码语言:javascript
复制
   git clone https://github.com/abseil/abseil-cpp.git

3. 生成步骤

3.1 使用doxygen生成html文件

代码语言:javascript
复制
cd ~/icode/abseil-cpp

#生成Doxfile文件
 doxygen -g
 
#修改DoxFile文件 
   #如果生成Dash/Zeal需要的文档需要更改Doxyfile以下文件
   PROJECT_NAME = "Abseil"  #项目名称改为Abseil
   PROJECT_LOGO = ./absl_80px.png  #项目logo
   OUTPUT_DIRECTORY = ./absl  #项目目录
   PROJECT_NUMBER = 1.0.0  #设置版本号
   RECURSIVE = YES  #递归地搜索所有的子目录及源文件
   SOURCE_BROWSER = YES #生成的文档中,把所有的源代码包含在其中
   GENERATE TREEVIEW = ALL #添加一个侧边栏,并以树状结构显示包、类、接口等的关系
   EXTRACT_ALL = YES  各个类或函数没有文档,也要提取信息。必须把这个标记设置为 Yes。
  #创建docset
  GENERATE_DOCSET   = YES
  DISABLE_INDEX     = YES 
  SEARCHENGINE      = NO
  GENERATE_TREEVIEW = NO
  
#note 如果遇到这种错误: epstopdf. Check your TeX installation
将 GENERATE_LATEX = NO #latex格式禁掉

#生成html
  doxygen ./Doxyfile

3.2 使用docsetutil 生成 dash/Zeal 格式

代码语言:javascript
复制
   cd ~/icode/abseil-cpp/html
   make 
  #note 如果在make的时候遇到 make: /usr/bin/docsetutil:命令未找到
  将Makefile文件中的: 第21行改为 docsetutil index $(DOCSET_NAME)即可

最后使用:使用dash加载即可.

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2021-12-14 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档