Тэги произвольной формы, ссылающиеся на другой документ в комментариях YARD?
Мне нужно иметь возможность связывать теги (в частности, вездесущие термины) в документе YARD, полученном из кода Ruby, с определением этого тега во внешнем документе. Было бы удивительно, если бы я мог затем дать перекрестные ссылки на эти ссылки.
Я определил следующее @macro:
# @!macro term
# {file:UBIQUITOUS-LANGUAGE.md#${2--1} ${2--1}}
Когда я ссылаюсь на этот макрос, например,
# ...an (@term Entity) representing the contents of the newly-added record...
он не производит никакого вывода, и никакого предупреждения от yardoc синтаксический анализатор.
Помогите?