如何在 doxygen markdown 中创建嵌入图像的链接

Question

对于我在 SO（或其他任何地方）上寻找的内容，我找不到任何答案。我的 markdown 文件中有一个嵌入图像，供 doxygen 使用，如下所示：

# 2. Example Markdown {#exMd}

This is a test to show an image

![imgDef]

[imgDef]: @ref SettingsValidationCollaborationDiagram.jpg "Diagram Caption"

## Some Other Section

This is a test to put a link to the image above.  See [here](@ref imgDef)

请参阅下面的屏幕截图了解我想要发生的事情：

如果我单击此处，它将带我到页面中原始图像可见的部分。我想不出一种方法来制作锚点，或者其他一些机制来创建可以链接到图像附近的东西。

显然，现有代码会导致我出错，但我不知道如何插入指向图像的链接，而不仅仅是在该位置嵌入图像。

Answer 1

据我所知，无法以这种方式链接到图像。 这表示有可能通过\anchor 命令（在示例中我在 HTML cmets 中放置了一些额外的 cmets）：

# 2. Example Markdown {#exMd}

This is a test to show an image

\anchor imgDef <!-- added line -->
![imgDef]

[imgDef]: SettingsValidationCollaborationDiagram.jpg "Diagram Caption" <!-- no need for the @ref here -->

## Some Other Section

This is a test to put a link to the image above.  See [here](@ref imgDef)

基于注释的一个小补充，来自文档：

\锚点

此命令将一个不可见的命名锚点放入文档中，您可以使用 \ref 命令参考。