Doxygen 和长类名

the*_*ine 5 c++ doxygen

我有一个不错的 C++ 项目,其中广泛使用模板编程,但这并不是重点。关键是我的一些类名(带有所有模板参数)变得很长。我使用 Doxygen 作为文档。

这通常不会成为问题,但最近我注意到类列表不可读,因为类名太长而无法在屏幕上显示。

有没有办法让 Doxygen 将类列表中的类名分成更多行?也许有一种方法可以在保留通用模板类的同时从类列表中隐藏模板类的特化?有更好的解决方案吗?

通过将类隐藏在命名空间中,然后立即将此命名空间导入全局命名空间,我设法找到了一个愚蠢的解决方法,这样这些类的名称就不会出现在列表中,除非单击命名空间或详细信息级别为增加。明显的缺点是这些类现在没有出现在列表中(其中一些非常重要,我希望它们在那里)。

我还可以删除以下样式:

.directory td.entry {
    white-space: nowrap;
}
Run Code Online (Sandbox Code Playgroud)

这可以通过保存以下内容来完成:

.directory td.entry {
    white-space: normal;
}
Run Code Online (Sandbox Code Playgroud)

asmodify.css并在HTML_EXTRA_STYLESHEET. 然而,有更多的自动换行标签(例如flex-wrap),因此可能需要额外的编辑。

the*_*ine 3

最后我还是修改了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 */
}
Run Code Online (Sandbox Code Playgroud)

我将其保存为doxygen_modify.css并指定了它的路径HTML_EXTRA_STYLESHEET(请注意,如果named doxygen.css,它将不会自动重命名,而是将被主样式表替换 - 因此您将看不到任何更改)。