如何在 doxygen markdown 中创建 link 到嵌入图像

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)

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

如果我点击这里，它会把我带到页面的原始图像可见的部分。我想不出制作锚点的方法，或其他机制来创建我可以 link 靠近图像的东西。

显然，现有代码会导致我出错，但我不知道如何将 link 插入到不只是在该位置嵌入图像的图像中。

Answer 1

据我所知，link 不可能以这种方式处理图像。这表示有可能通过 \anchor 命令（我在示例中的 HTML 注释中放置了一些额外的注释）：

# 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)

根据文档中的评论进行的少量补充：

\anchor

This command places an invisible, named anchor into the documentation to which you can refer with the \ref command.

如何在 doxygen markdown 中创建 link 到嵌入图像

How to create link to an embedded image in doxygen markdown

markdown

doxygen