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

时间:2015-06-16 09:15:58

标签: html image markdown doxygen

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

我有一个标记格式的主页(文件mainpage.md),并希望将图像(文件logo.png)嵌入到该页面中。

目前,我已经开始使用HTML输出,具有以下目录结构:

    work
    ├── mainpage.md
    ├── resources
    │   └── logo.png
    └── html
        └── index.html

mainpage.md嵌入图片的降价方式为:

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

这有效,但它取决于HTML输出目录是从工作目录向下一级的事实,而(fwiw)与包含该引用的mainpage.md文件的位置不同步。

我必须承认我没有尝试其他输出格式会发生什么 (预期的格式是:HTML,PDF,通过LaTex,手册页,Eclipse帮助),但是 他们可能会以不同的方式工作w.r.t.他们的输出目录和对图像文件的引用。

我的问题是:

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

  2. 是否有更多与输出格式无关的方法来引用主页标记中的图像文件?

  3. 安迪

1 个答案:

答案 0 :(得分:6)

不幸的是,您需要多个图像命令才能使其正常工作。 Latex将需要兼容pdf的图像类型,Web浏览器通常需要不同的图像类型等,因此必须多次发出image command以指定每种格式的图像文件

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

支持以下格式:html,latex,docbook和rtf。

如果您将图片放在图片文件夹中并在configuration中指定它的位置,则可以使用较短的路径:

IMAGE_PATH     = my_image_dir