c – Doxygen和长级名称

2023年7月17日 260次阅读

我有一个很好的C项目,模板编程被广泛使用,但这不是重点.关键是我的一些类名(包含所有模板参数)变得很长.我用Doxygen作为文档.

这通常不是问题,但最近我注意到类列表是不可读的,因为长类名称太宽而不适合屏幕.

有没有办法让类列表中的类的Doxygen中断名称更多行？是否有一种方法可以在保留常规模板类的同时隐藏类列表中模板类的特化？有更好的解决方案吗？

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

我还可以删除以下样式：

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

这可以通过保存这个来完成：

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

作为modify.css并在HTML_EXTRA_STYLESHEET下指定它.然而,有更多的自动换行标签(例如flex-wrap),因此可能需要额外的编辑.

最佳答案 最后,我去修改了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.css并在HTML_EXTRA_STYLESHEET中指定了它的路径(请注意,如果命名为doxygen.css,它将不会自动重命名,而是将被主样式表替换 – 因此您将看不到任何更改) .

点赞