Мы используем Doxygen для документирования нашего кода C ++ и включаем результаты Doxygen в нашу документацию Sphinx HTML с помощью плагина Breathe. Мы хотим перейти непосредственно к функциям в документации HTML, используя именованные якоря в ссылке HTML, например:
http://path/MyClassDocumentation.html#myFunction(params)
Идея состоит в том, чтобы автоматически переходить к функциям, используя их сигнатуру, которую мы можем получить динамически во время выполнения. Как мы можем создать эти именованные якоря в наших комментариях к C ++ Doxygen? Breathe создает элементы HTML, которые обращаются к функциям, используя свою подпись и сумму md5. Пример:
<span id="my_class_my_function_1a21be2544e55395e0218006fca87a2a82"></span>
Это не полезно, потому что мы не можем перейти к этим идентификаторам во время выполнения, используя сигнатуру функции. Поэтому мы хотим добавить наши собственные именованные якоря, которые должны выглядеть следующим образом:
MyClass::MyFunc(paramList)
Я пытался использовать «\ anchor» в наших комментариях, но, похоже, они игнорируются. Есть ли способ получить именованные якоря, которые мы можем определить в наших комментариях кода C ++? Или есть другой способ добиться этого?
РЕДАКТИРОВАТЬ:
Я думаю, что нам нужно что-то для определения пользовательских постоянных ссылок html, обращающихся к функциям в нашем коде C ++ из комментариев Doxygen.
Задача ещё не решена.
Других решений пока нет …