2015-06-27 42 views
4

我有一個不錯的C++項目,其中廣泛使用模板編程,但這不是重點。關鍵是我的一些類名(包含所有的模板參數)會變得很長。我使用Doxygen進行文檔編制。Doxygen和長類名稱

這通常不會成爲問題,但最近我發現班級列表是不可讀的,因爲長的班級名稱使得它太寬而無法放在屏幕上。

有沒有辦法讓班級列表中的Doxygen中斷類名更多行?有沒有一種方法可以在保留通用模板類的同時從類列表中隱藏模板類的特化?有更好的解決方案嗎?

我設法找到一個愚蠢的解決辦法隱藏在名稱空間的類,然後立即將此名稱空間導入全局名稱空間,以便這些類的名稱不會出現在列表中,除非名稱空間單擊或細節級別增加。顯而易見的缺點是,這些類現在不在列表中(其中一些相當重要,我希望它們在那裏)。

我還可以刪除以下樣式:

.directory td.entry { 
    white-space: nowrap; 
} 

這可以通過保存該這樣做:

.directory td.entry { 
    white-space: normal; 
} 

modify.cssHTML_EXTRA_STYLESHEET下指定它。然而,有更多的換行標籤(例如flex-wrap),所以可能需要額外的編輯。

回答

1

最後,我去修改了CSS。我最終使用:

.directory td.entry { 
    white-space: normal; 
    /*width: 50%;*/ /* does not work, makes "Related Pages" look bad */ 
    min-width: 512px; /* better, unless you have a 640x480 screen */ 
} 

我救了這是doxygen_modify.cssHTML_EXTRA_STYLESHEET(注意,如果命名爲doxygen.css,也不會被自動重命名,而是將通過主樣式表來代替指定的路徑,以它 - 因此你不會看到任何改變)。