Как создать ссылку на встроенное изображение в Doxygen Markdown

Question

Я не смог найти ответа на то, что я ищу на SO (или где-либо еще).У меня есть встроенное изображение в моем файле уценки, которое будет использовано 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 в примере):

# 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

Эта команда помещает невидимый именованный якорь в документацию, к которой вы можете обратиться с помощью команды \ ref.