c++ - 无法生成 Doxygen 图

Question

我正在尝试使用 Doxygen 绘制交互图, 使用外部 Mscgen公用事业。

这是源文件:

/// test.h

/** Interaction diagram.
 * Test.
 *  \msc "Test interaction diagram"
 *      A,B,C;
 *      B->C;
 *      A<-B;
 *  \endmsc
*/

class A {};

class B {};

class C {};

我安装了 mscgen.exe 可执行文件，并在环境变量中设置了它的路径。

当运行 Doxygen 时，从它的日志中，这是我得到的所有与交互图相关的信息:“正在搜索 msc 文件...”。

最终的 Doxygen 输出包含一个用于缺失交互图的占位符和“测试交互图”标签。

我一定是在 Doxyfile 文件中遗漏了什么。如何让 Doxygen 调用 mscgen.exe 可执行文件？

查看生成的 PNG 文件，缺少 Doxygen 正在寻找的文件，所以我想 mscgen.exe 根本没有运行。

这是 Doxygen 生成的 HTML 代码块:

<div align="center">
<img src="../../msc_inline_mscgraph_1.png" alt="msc_inline_mscgraph_1" border="0" usemap="#msc_inline_mscgraph_1.map">
<map name="msc_inline_mscgraph_1.map" id="msc_inline_mscgraph_1.map"></map>
<div class="caption">
Test interaction diagram</div>
</div>

Answer 1

尝试删除标题。我在 Windows 上遇到了同样的问题。我手边没有其他平台可以比较结果，看看它是否是 Windows 独有的问题。当我这样做时:

@msc "hello, world"
   a, b;
   a => b;
@endmsc

图形不会生成。如果我删除标题，如下所示:

@msc
   a, b;
   a => b;
@endmsc

图形生成，但没有标题。当出现标题时，我看到错误:

error: failed to open map file path-on-my-local-computer-redacted/docs/html/inline_mscgraph_2.msc.map for inclusion in the docs!

有趣的是，当没有标题时也不会生成文件——不同之处在于 Doxygen 似乎并不关心 map 文件是否存在。我没有看到控制 map 文件生成的明显选项。

抱歉，在最初的问题几个月后，我只给出了部分答案。我来到这里谷歌搜索相同问题的答案，希望这至少能让其他人得到没有字幕的序列图。