doxygen 的安裝、配置、編譯及使用(從源代碼到文檔)

1. 什么是 doxygen

下面是 doxygen 主頁上的一段說明文字

Source code documentation generator tool

Doxygen is a documentation system for C++,

C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors),

Fortran, VHDL, PHP, C#, and to some extent D.

簡單地說，doxygen 能夠自動分析源代碼并從源代碼中抽取相應的注釋，整理成文檔。

它的好處是源代碼與文檔同步，易于維護

下面以Fedora 10 和 doxygen 1.5.8 為例來說明其安裝和使用

2. 安裝

a. 下載源代碼

b. 下載用戶手冊

這里面的內容很詳細，從下載、編譯、安裝、使用都寫得很清楚

c. 編譯

這是linux下標準的安裝方式

首先用tar命令 解壓源代碼，然而用cd命令進入解壓后的文件夾，

運行./configure --help 查看配置

運行 ./configure --enable-langs --with-doxywizard --with-doxyapp進行配置

編譯 make

安裝 make install

3. 使用

doxygen

生成文檔的基本方式是先生成一個配置文件，告訴doxygen如何去生成文檔，然后讓doxygen生成文檔。由于doxygen的配置文件選項有很多，

因此我們通常是讓doxygen先生成一個默認的配置文件，再修改其中的一些選項，生成自己的配置文件。

a. 生成默認配置文件

首先用 cd命令，進入 源代碼所在的文件夾

然后運行 doxygen -g命令，生成 默認的配置文件

因為沒有指定配置文件的文件名，因此生成的默認配置文件 自動命名為 Doxyfile

b. 修改配置選項

用任何一種文本編輯器，打開 Doxyfile 文件

下面是一些配置選項及說明

RECURSIVE = YES?? 這可以讓doxygen從配置文件所在的文件夾開始，遞歸地搜索所有的子目錄及源文件

SOURCE BROWSER = YES 這會在最后生成的文檔中，把所有的源代碼包含在其中

INLINE SOURCES ＝ YES 這會把函數的實現部分的代碼包含在每個函數的說明部分，可以方便地查看函數的實現方式，但會讓整個文檔顯得有些凌亂，故不推薦使用

GENERATE TREEVIEW ＝ ALL 這會在HTML文檔中，添加一個側邊欄，并以樹狀結構顯示包、類、接口等的關系

GENERATE_LATEX = NO 這個設置將導致doxygen不生成pdf文檔，不太喜歡pdf文檔，把它關了吧

c. 生成文檔

運行 doxygen Doxyfile 命令，生成文檔

d. 查看文檔

在 html 文件夾下，找到index.html文件，用瀏覽器，打開它，就可以查看生成的文檔了 ^_)^

總結

以上是生活随笔為你收集整理的doxygen生成html文件,doxygen 的安装、配置、编译及使用(从源代码到文档)的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。