doxygen - 如何为 Doxygen 输出设置图标

Question

我正在使用Doxygen自动生成文档。如何为输出指定网站图标（URL 图标）？

Answer 1

在 doxygen 中，可以定义自己的 HTML 头文件，最好基于默认的 HTML 头文件。

要获取默认的 HTML 头文件，语法：

doxygen -w html headerFile footerFile styleSheetFile [configFile]

在 headerFile 的头部插入一行，如：

<link rel="shortcut icon" href="$relpath^my_icon.ico" type="image/x-icon" />

注意：该$relpath^部分是必要的，尤其是在CREATE_SUBDIRS设置的情况下。

此外，在配置文件（Doxyfile）中，您必须设置：

HTML_HEADER            = headerFile
HTML_EXTRA_FILES       += my_icon.ico

当然，关于网站图标的标准限制仍然适用（关于浏览器的支持等）。