使用Doxygen，如何生成包含子項目鏈接到我的項目中所有.dox文件的頁面？

Question

我有一個只包含主頁鏈接的\ mainpage。 但是，我想在最終輸出文檔中包含所有頁面鏈接到.dox文件的頁面。

我知道這可以通過使用外部腳本來解析.dox文件並聚合所有頁面變量名稱來完成。但是有沒有一個配置字段爲我做到這一點？

Answer 1

您可以使用xrefitem +別名來完成您要查找的內容。

如果你不熟悉xrefitem，你可以用它創建列表，然後在這裏是一個參考：http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdxrefitem

所以，如果你是以下行添加到您的Doxyfile

ALIASES += page_list{3} = "\xrefitem page_list \"\" \"List of Secondary Pages\" \3 \page \1 \2 " 

然後，您可以取代您每次使用\頁面命令

\page_list{page_name, Page Title, Some brief description} 

現在在每個頁面頂部的地方，你會看到一個：（其中超鏈接頁面列表）和簡要說明。您可以將{3}更改爲{2}並在命令中刪除\ 2，並且您將不再在每個頁面的頂部看到該簡要說明，但是您將不再在列表中看到簡要說明。

我不知道如何抑制顯示：。據對\ xrefitem文檔

In case parameter "(heading)" is the empty string no heading is generated 

但無論如何，我希望這可以讓你更近一點。