doxygen: вертикальное выравнивание имен параметров / параметров шаблона - PullRequest
1 голос
/ 27 января 2020

Я документирую некоторый код C ++, используя doxygen (версия 1.8.13). Когда я документирую параметры функции / параметры шаблона, я получаю следующий результат:

/*!
 * ...
 * @tparam Field The field to be decoded.
 * @tparam Container The container representing the binary string.\n
 * A valid container type must meet the following requirements:
 *  - define the member alias \c value_type, which must have size 1 B;
 *  - define a member function \c at(), accepting an integer index and
 *    returning a reference to the element at the specified index.
 * ...
 */

enter image description here

Вместо этого мне хотелось бы, чтобы имена параметров выровнены по вертикали сверху с соответствующим описанием, как на следующем рисунке:

enter image description here

Если это возможно, я хотел бы указать выравнивание один раз для всех функций (например, через файл Doxyfile или файл DoxygenLayout).

После поиска в Интернете мне не удалось найти какую-либо документацию о том, как установить вертикальное выравнивание имен параметров в Doxygen. Кто-нибудь может мне помочь?

Заранее спасибо.

1 Ответ

1 голос
/ 27 января 2020

Вы можете использовать HTML_EXTRA_STYLESHEET , чтобы изменить выравнивание параметров шаблона:

table.tparams td.paramname { vertical-align: text-top; }
...