目錄

1. 軟體安裝

2Sample原始檔下載：

3.生成步驟

3.1使用doxygen生成html檔案

3.2使用docsetutil 生成 dash/Zeal 格式

1. 軟體安裝：

1.  brew install doxygen
2. brew install swiftdocorg/formulae/docsetutil

2.Sample原始檔下載：

   git clone https://github.com/abseil/abseil-cpp.git

3.生成步驟

3.1使用doxygen生成html檔案

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 格式

   cd ~/icode/abseil-cpp/html
   make 
  #note 如果在make的時候遇到 make: /usr/bin/docsetutil：命令未找到
  將Makefile檔案中的： 第21行改為 docsetutil index $(DOCSET_NAME)即可

最後使用：使用dash載入即可.