我在Ubuntu 14.04上使用Doxygen 1.8.6从C/C++头文件生成API文档.
我有一个标记格式的主页(文件mainpage.md),并希望将图像(file logo.png)嵌入到该页面中.
work ├── mainpage.md ├── resources │ └── logo.png └── html └── index.html
mainpage.md中的markdown嵌入图像的方式是:
![The logo](../resources/logo.png)
这可行,但它取决于HTML输出目录是从工作目录向下一级的事实,而(fwiw)与包含该引用的mainpage.md文件的位置不同步.
我不得不承认我没有尝试其他输出格式会发生什么
(预期的格式是:HTML,PDF,通过LaTex,手册页,Eclipse帮助),但是
他们可能会以不同的方式工作w.r.t.他们的输出目录和对图像文件的引用.
我的问题是:
>上述其他输出格式是否适用于此降价参考?
>是否有更多输出格式不可知的方式从主页标记中引用图像文件?
安迪
解决方法
不幸的是,您需要多个图像命令才能使其工作. Latex将需要兼容pdf的图像类型,Web浏览器通常需要不同的图像类型等,因此必须多次发出
image command以指定每种格式的图像文件
\image html logo.png \image latex logo.eps
支持以下格式:html,latex,docbook和rtf.
如果将图像放在图像文件夹中并在configuration中指定它的位置,则可以使用较短的路径:
IMAGE_PATH = my_image_dir