Doxygen的：OpenFOAM 1.7.1文件

Question

的編譯過程中出現錯誤，我試圖生成使用的doxygen 1.6.3以及與OpenFOAM源傳來OpenFOAM 1.7.1源文檔的Doxyfile。不幸的是，有些東西明明在編譯過程中出了問題：

• 的All，應在主頁上顯示Classes，Namespaces等環節不工作。當我點擊它們時沒有任何反應。
• 當我瀏覽到使用標籤類，既繼承圖和協作圖只顯示類本身，沒有別的 - 即使在情況下，我知道，這些圖是相當大的。
• 搜索不起作用。當我在搜索框中輸入內容並按下Enter鍵時，什麼都不會發生。

我看了一下doxygen運行的輸出，雖然它扔了很多警告，但我沒有收到任何錯誤消息。它抱怨：

• 沒有匹配的文件會員上課，運算符和函數，沒有匹配的類成員，沒有唯一匹配類成員，
• 證明，但未聲明或未定義功能，
• 不支持XML/HTML標籤<cloudname>，
• 的許多塊：
  </li>標籤無無匹配<ul>匹配<li>
</ul>標籤 意想不到的結束內部<ul>塊

這些可能已經毀了搜索？我無法編輯所有文件以擺脫警告，但它們太多了。

我已經修改，通過設置輸出文件擴展名html與OpenFOAM傳來的Doxyfile（是php前），並加入行SERVER_BASED_SEARCH = NO，但這並沒有改變任何東西。我這樣做是因爲OpenFOAM開發人員使用的Doxyfile模板是用於doxygen 1.5.3（這就是它在第一行中所說的），並且據我所知，附加搜索選項隨1.6.2一起提供。

什麼可以去錯在這裏？ OpenFOAM開發人員似乎早先成功地生成了文檔，但他們只是不再上網。

如果任何人有OF-1.7.1的鏈接，編譯的在線文檔，我將愉快地使用這些 - 我只是沒有發現任何東西，但最新的版本。

---

我發現了一個指導使用的-2.0.0 doxygen的相關文件（配置，頁眉，...）創建的OF-1.7.1的文件，使用的doxygen 1.7.5.1這裏：http://www.cfd-online.com/Forums/openfoam/78529-building-openfoam1-7-0-source-2.html

我使用的doxygen 1.7.6。1而不是（下載了錯誤的版本，只是與嘗試過），並在的Doxyfile：
INPUT_FILTER = doxyFilt
FILTER_SOURCE_FILES = YES
SHORT_NAMES = NO

我現在所有的標籤和JavaScript的搜索工作，和所有圖表似乎是完成。

Answer 1

我不是太熟悉OpenFOAM，但你可能也想嘗試：

• 使用Doxygen的1.5.3，而不是1.6.3的Doxygen。由於它們的文件中引用了1.5.3，因此它們可能與其源代碼（和實用程序腳本）更兼容。
• 確認doxyFilt在您的路徑中：$WM_PROJECT_DIR/bin。該腳本由doxygen調用，並在源文件被Doxygen使用之前對其進行預處理。

通過以上我可以驗證Classes，Namespace和相關標籤工作正常。

您可能還需要查看位於$WM_PROJECT_DIR/doc/Doxygen/tools的實用程序腳本，因爲它們似乎與識別問題並修復生成的文檔有關。