以下先貼出我自己做出來的部分效果圖，UI很挫，大家真正使用時可以讓公司UI部門美化下，由于我目前還主要是內網使用，因此沒有去過多考慮UI體驗：

1. 下載ubuntu14.04適用的doxygen源碼。官網當中download選項里面有專門適用ubuntu的版本下載。下下來的源碼包命名格式大致如：doxygen-{doxygen版本號}.src.tar.gz解壓。命令如下：

2. gunzip doxygen-$VERSION.src.tar.gz tar xf doxygen-$VERSION.src.tar

3. 環境檢查，要安裝doxygen，在ubuntu下面需要部分依賴的支持。進入解壓后的目錄里面，里面有個./configure 的shell腳本。 執行命令：sh ./configure 進行安裝環境檢查，里面會列出一些你當前系統已經滿足要求的 和缺少的依賴。在ubuntu下面你 可以簡單的利用 sudo apt-get install xxxx（依賴名稱），來逐個把缺少的依賴都裝上。這步也很快的。

4. 接下去就是、sudo make 和 sudo make install了。 如果在make或者 make install的過程中有提示缺少什么東西的話。sudo apt-get install xxx裝上即可。

5. 完事之后，在命令行下面試試看執行命令：doxygen --version 。 如果出來版本號，說明已經安裝成功。

6. 補充說明：關于make 和 make install。我個人比較喜歡直接make后使用源碼包里面的 xxx/bin/doxygen 命令來生成文檔， 而不去安裝。 因為后期真正使用其來生成文檔的時候會發現我們需要改掉里面很多默認的東西（當然不改也是完全可以的，并非不能用）。 這個時候你可以去找到剛才解壓的源碼包里面xxx/src/ 下面的源碼文件，找到執行對應功能模塊的.cpp文件（c++寫的源碼），你直接可以自己去修改里面的c++文件，然后重新用make編譯。 這樣就可以把doxygen改為任何你自己想要的效果。舉個簡單的例子：doxygen默認檢查你代碼后function都叫做函數。而在api接口中，我更希望一個function叫做一個接口，而不是叫做一個函數。 其他修改類似。

doxygen的使用可以說就是對配置文件的配置，就是說，你只要稍微配置一下配置文件，再執行一下命令： xxxx/doxygen xxxx.conf 就可以生成你想要的文檔（這里doxygen提供了多種格式的文檔，我主要用的是html的，這樣我們可以自己配置一個web服務到這個html上面，就可以再web上面使用文檔了。），doxygen提供了200多個配置項，通過配置文件就已經可以完成豐富的功能了，下面舉一些常用的配置說明：

• 利用命令xxx/doxygen -g 就會在當前目錄下面產生一個默認配置文件 doxygen.conf。打開默認配置文件，你會發現里面每一個配置項都是 配置名 配置值 這樣的key-value格式，如果你有一定的英文功底的話，配置基本上就不是什么問題了。
• 配置的詳細說明請參考：http://www.stack.nl/~dimitri/doxygen/manual/config.html
• ABBREVIATE_BRIEF //簡短摘要
• ALIASES //別名
• ALLEXTERNALS//所有外部文檔
• ALPHABETICAL_INDEX//字母順序索引
• ALWAYS_DETAILED_SEC//詳細描述部分
• BINARY_TOC//二進制操作
• BRIEF_MEMBER_DESC//簡短的成員描述
• CALL_GRAPH//調用到的圖
• CASE_SENSE_NAMES//檢測的范例的名字
• CHM_FILE//CHM格式文件
• CLASS_DIAGRAMS//類-表
• CLASS_GRAPH //類-圖
• DOT_PATH //DOT路徑設置
• DOT_TRANSPARENT //DOT轉換設置
• DOTFILE_DIRS //DOTFILE 列表顯示
• ENABLE_
• ENUM_VALUES_PER_LINE //每行的枚舉值
• ENABLED_SECTIONS//允許分段顯示
• EXAMPLE_PATH //例子路徑
• EXAMPLE_PATTERNS//例子用的文件格式（*.cpp, *.h , *.java等）
• EXAMPLE_RECURSIVE //例子遞歸
• COLLABORATION_GRAPH //相互調用關系圖
• COLS_IN_ALPHA_INDEX//以列形式顯示的字母順序的索引
• COMPACT_LATEX//壓縮的LATEX文檔
• COMPACT_RTF//壓縮的RTF文檔
• CREATE_SUBDIRS//創建一個"子目錄"
• DETAILS_AT_TOP//文檔的詳細頭部
• DIRECTORY_GRAPH //目錄圖
• DISABLE_INDEX //禁用INDEX
• DISTRIBUTE_GROUP_DOC//禁用文檔成組顯示
• DOT_IMAGE_FORMAT//點陣圖形
• DOT_MULTI_TARGETS//多個DOT目標
• EXCLUDE //可執行文件
• EXCLUDE_PATTERNS//可執行文件格式（*.exe, *.dll等）
• EXCLUDE_SYMLINKS //可執行的SYMLINKS
• EXPAND_AS_DEFINED //規定的擴展
• EXPAND_ONLY_PREDEF//預定義擴展
• EXTERNAL_GROUPS //使用到的外部的文件
• EXTRA_PACKAGES //使用到的外部插件包
• EXTRACT_ALL //提取所有
• EXTRACT_LOCAL_CLASSES //提取所有本地類
• EXTRACT_LOCAL_METHODS//提取所有本地方法
• EXTRACT_PRIVATE //提取所有private
• EXTRACT_STATIC //提取所有static
• FILE_PATTERNS //文件路徑
• FILE_VERSION_FILTER //文件版本控制
• FILTER_PATTERNS //控制格式（主版本：第1次版本：第2次版本號）
• FILTER_SOURCE_FILES //原文件的版本控制
• FULL_PATH_NAMES //全路徑名
• GENERATE_AUTOGEN_DEF //生成自動定義文件形式
• GENERATE_BUGLIST //生成BUG列表
• GENERATE_CHI //生成"希臘字母"
• GENERATE_DEPRECIATEDLIST//生成"評估"列表
• GENERATE_HTML //生成HTML
• GENERATE_HTMLHELP //生成HTMLHELP
• GENERATE_LATEX //生成LATEX
• GENERATE_LEGEND //生成圖例
• GENERATE_MAN //生成MAN文件
• GENERATE_PERLMOD //生成Perl腳本
• GENERATE_RTF //生成RTF
• GENERATE_TAGFILE //生成標志文件
• GENERATE_TESTLIST //生成TESTLIST
• GENERATE_TODOLIST //生成TODOLIST
• GENERATE_TREEVIEW //生成樹狀視圖顯示
• GENERATE_xml //生成XML
• GRAPHICAL_HIERARCHY //繼承圖表
• GROUP_GRAPHS //組-圖
• HAVE_DOT //隱藏DOT
• HHC_LOCATION //隱藏位置
• HIDE_FRIEND_COMPOUNDS//隱藏"復合的"友員類型
• HIDE_IN_BODY_DOCS //隱藏文檔的主體
• HIDE_SCOPE_NAMES //隱藏"作用域"名
• HIDE_UNDOC_CLASSES //隱藏"未歸檔"的所有CLASS
• HIDE_UNDOC_MEMBERS //隱藏"未歸檔"的所有的成員
• HIDE_UNDOC_RELATIONS//隱藏"未歸檔"的關系
• HTML_ALIGN_MEMBERS //HTML文檔中成員對齊方式
• HTML_FOOTER //HTML腳注設置
• HTML_HEADER //HTML頭部設置
• HTML_OUTPUT //HTML輸出設置
• HTML_STYLESHEET //HTML樣式設置
• IGNORE_PREFIX //忽略哪些前綴
• IMAGE_PATH //圖片的路徑設置
• INCLUDE_GRAPH //包含-圖
• INCLUDE_PATH //頭文件包含的路徑
• INHERIT_DOCS //文檔的繼承關系
• INLINE_INFO //內聯信
• INLINE_INHERITED_MEMB//通過"繼承"得到的內聯成員
• INLINE_SOURCES //內聯部分的源代碼
• INPUT //輸入設置
• INPUT_FILTER //能夠接受的輸入文件的擴展名格式設置（重要）
• INTERNAL_DOCS //內部文檔
• JAVADOC_AUTOBRIEF //JAVADOC工具生成的文檔的"自動摘要"
• LATEX_BATCHMODE //LATEX匹配方式
• LATEX_CMD_NAME //LATEX 命令名
• LATEX_HEADER //LATEX 頭部
• LATEX_HIDE_INDICES //LATEX內部隱藏的包含
• LATEX_OUTPUT //LATEX輸出
• MACRO_EXPANSION //宏展開設置（重要）
• MAKEINDEX_CMD_NAME //MAKEINDEX命令索引
• MAN_EXTENSION //MAN擴展
• MAN_LINKS //MAN 鏈接設置
• MAN_OUTPUT //MAN輸出設置
• MAX_DOT_GRAPH_DEPTH//DOT圖的最大深度
• MAX_DOT_GRAPH_HEIGHT //DOT圖的最大高度
• MAX_DOT_GRAPH_WIDTH //DOT圖的最大寬度
• MAX_INITIALIZER_LINES //最大初始化行
• MULTILINE_CPP_IS_BRIEF //多 個CPP文件的簡短描述
• MULTILINE_CPP_IS_BRIEF //多 個CPP文件的簡短描述
• OPTIMIZE_OUTPUT_FOR_C //對C采用的優化設置
• OPTIMIZE_OUTPUT_JAVA//對JAVA采用的優化設置
• OUTPUT_DIRECTORY //輸出路徑設置（重要）
• OUTPUT_LANGUAGE //輸出語言設置（重要）
• PAPER_TYPE //紙張類型
• PDF_HYPERLINKS //PDF格式超鏈接設置（重要）
• PERL_PATH //perl路徑設置
• PERLMOD_LATEX //perlmod LATEX
• PERLMOD_PRETTY // perlmod PRETTY（漂亮/相當）
• PERLMOD_MAKEVAR_PREFIX//perlmod MAKE文件版本 PREFIX
• PREDEFINED //預先定義（重要）
• PROJECT_NAME //工程名（重要）
• PROJECT_NUMBER //工程的組成成員（重要）
• QUIET //靜態量設置（重要）
• RECURSIVE //遞歸和循環
• REFERENCED_BY_RELATION//交叉參考（重要）
• REFERENCES_RELATION //交叉參考的關系
• REPEAT_BRIEF //重新設置"簡短說明"為打開狀態
• RTF_EXTENSIONS_FILE //RTF展開文件
• RTF_HYPERLINKS //RTF超鏈接
• RTF_OUTPUT //RTF輸出設置
• RTF_STYLESHEET_FILE //RTF樣式文件
• SEARCH_INCLUDES //搜索時需要包含什么（重要）
• SEARCHENGINE //搜索引擎設定（重要）
• SHORT_NAMES //使短文件名生效
• SHOW_DIRECTORIES //顯示目錄
• SHOW_INCLUDE_FILES //顯示包含文件（一般NO，否則太大）
• SHOW_USED_FILES //顯示被用到的文件（一般YES）
• SKIP_FUNCTION_MACROS //跳過函數中的宏（重要），菜鳥最好別跳
• SORT_BRIEF_DOCS //文檔的簡短摘要
• SORT_MEMBER_DOCS //成員的簡短描述
• SOURCE_BROWSER //原文件瀏覽路徑
• STRIP_CODE_COMMENTS//排除哪些條碼形式注釋（重要）
• STRIP_FROM_INC_PATH //排除哪些頭文件包含的注釋（重要）
• STRIP_FROM_PATH //排除哪些條碼路徑設置
• SUBGROUPING //子組設置（重要）
• TAB_SIZE //TAB符SIZE設置（重要）
• TAGFILES //標志文件
• TEMPLATE_RELATIONS //模板關系設置（重要）
• TOC_EXPAND //TOC擴展
• TREEVIEW_WIDTH //樹狀圖顯示的寬度設置（重要）
• UML_LOOK //UML外觀設置（重要）
• USE_WINDOWS_ENCODING//使用windows系統的編碼形式（重要）
• VERBATIM_HEADERS //VERBATIM頭部（頭文件）
• WARN_FORMAT //警告格式指定（重要）
• WARN_IF_DOC_ERROR //如果文檔出錯則顯示警告
• WARN_IF_UNDOCUMENTED//如果是未歸檔文件則顯示警告
• WARN_LOGFILE //警告日志文件設置
• WARN_NO_PARAMDOC //無參數文檔警告形式設定
• WARNINGS //警告設置（重要）
• XML_DTD //XML文件類型定義（重要）
• XML_OUTPUT //XML輸出設置（重要）
• XML_PROGRAMLISTING //XML程序列表（重要）

• XML_SCHEMA //XML模式設置（重要）

1. 下面是我所用到的常用注釋的書寫要求，其他的更多請參考：http://www.stack.nl/~dimitri/doxy