【发布时间】:2013-09-14 16:52:34
【问题描述】:
我正在更新一些 Doxygen 文档,当 Doxygen 为文档生成代码块时,当代码被 \code 和 \endcode 标签包围时,它不再将代码放入块中。
原文:
新:
文档最初是使用 1.6.1 生成的,而新文档使用的是 1.8.1.2。由于版本不同,我现在是否必须使用markdown 语法来生成正确的代码块,还是可以继续使用\code 标签?
【问题讨论】:
我正在更新一些 Doxygen 文档,当 Doxygen 为文档生成代码块时,当代码被 \code 和 \endcode 标签包围时,它不再将代码放入块中。
原文:
新:
文档最初是使用 1.6.1 生成的,而新文档使用的是 1.8.1.2。由于版本不同,我现在是否必须使用markdown 语法来生成正确的代码块,还是可以继续使用\code 标签?
【问题讨论】:
不,\code..\endcode 仍然像往常一样工作。
问题是您使用自定义页面标题或样式表(即HTML_STYLESHEET 或HTML_HEADER 在配置文件中不为空)并且较新版本的 doxygen 开始使用不同的 CSS 标签来设置代码样式块,而您的样式表中缺少这些。
Doxygen 最近引入了一个HTML_EXTRA_STYLESHEET 选项,您可以使用它来否决原始样式表的部分内容。我建议使用该选项而不是 HTML_STYLESHEET。
【讨论】:
HTML_STYLESHEET 不是空的,所以我只是将其更改为 HTML_EXTRA_STYLESHEET 并且它起作用了。