Doxygen：如何在所有输出格式的主页上嵌入图像？

Question

我在 Ubuntu 14.04 上使用 Doxygen 1.8.6 从 C/C++ 头文件生成 API 文档。

我有一个 Markdown 格式的主页（文件mainpage.md），并想在该页面中嵌入一张图片（文件logo.png）。

目前，我正在为 HTML 输出工作，具有以下目录结构：

工作 ├── 主页.md ├── 资源 │   └── logo.png └── html └── index.html

mainpage.md中的markdown嵌入图片的方式是：

![The Logo](../resources/logo.png)

这可行，但这取决于 HTML 输出目录比工作目录低一级的事实，并且 (fwiw) 与包含该引用的 mainpage.md 文件的位置不同步。

我不得不承认我没有尝试过其他输出格式会发生什么 （预期格式是：HTML、通过 LaTex 的 PDF、手册页、Eclipse 帮助），但是 他们可能会以不同的方式工作。它们的输出目录和对图像文件的引用。

我的问题是：

1. 上述其他输出格式是否适用于此降价参考？

2. 是否有更多与输出格式无关的方法来从主页 markdown 引用图像文件？

安迪

Answer 1

不幸的是，您需要多个图像命令才能完成这项工作。 Latex 需要兼容 pdf 的图像类型，网络浏览器通常需要不同的图像类型等，因此必须多次发出 image command 以指定每种格式的图像文件

\image html logo.png
\image latex logo.eps

支持以下格式：html、latex、docbook 和 rtf。

如果您将图像放在图像文件夹中并在configuration 中指定其位置，则可以使用较短的路径：

IMAGE_PATH     = my_image_dir