Страницы условной уценки Doxygen

У меня есть набор страниц уценки, которые я использую для документирования своего кода в настройке таблицы, и использую @subpage для размещения этих страниц под страницей таблицы.

Табл.мд

Code Table
==========

| Name            | Description |
|-----------------|-------------|
| @subpage index0 |             |
| @subpage index1 |             |
| @subpage index2 |             |
| @subpage index3 |             |

Подстраница0.md

000 - Table Element {#index0}
===================

И т. д. для других страниц

Затем в документации, выводимой из doxygen, ссылки @subpage будут заменены текстовым заголовком страницы, то есть «000 — элемент таблицы». Кроме того, ссылка на файл будет подстраницей под ссылкой Code Table в навигационном желобе.

Моя проблема в том, что теперь я хочу взять те же файлы, но добавить условия на основе кода, который я создаю. Вот как я изменил один из файлов.

@if BUILD_A
000 - Table Element {#index0}
===================
@elseif BUILD_B
000 - New Table Element {#index0}
===================
@endif

Мои разделы предварительной обработки и включения doxygen настроены правильно и выводят правильный текст, который я хочу, проблема в том, что навигационный желоб больше не содержит подстраницы на тех страницах, которые имеют этот тип условной настройки, а фактические страницы не используют заголовок ссылки для заголовка страницы, а лучше используйте имя файла в качестве заголовка.

Является ли уценка слишком ограниченной в настоящее время с doxygen, и мне приходится использовать страницы dox, или настройка невозможна с тем, что я хочу?


person lucasbrendel    schedule 25.06.2014    source источник
comment
Хороший вопрос (+1). Я также столкнулся с рядом подобных проблем с сочетанием doxygen и уценки, в частности, с уценкой и текстом с условным переключением, которые не обрабатывались без проблем. Обычно я пробовал различные способы реструктуризации нескольких случаев, когда мне нужно было что-то подобное, пока что-то не сработало. Я подозреваю, что это может быть уценка слишком ограничена doxygen, но я с интересом жду ответов.   -  person Cheeseminer    schedule 25.06.2014


Ответы (1)


Возможно, вы захотите переместить условное выражение по подстранице внутри таблицы:

| Name | Description |
|------|-------------|
| @if BUILD_A @subpage index0_A @elseif BUILD_B @subpage index0_B @endif | ... |
| ... | ... |

Недостаток этого подхода: вам потребуется два отдельных файла для страницы index0: Subpage0_A.md и Subpage0_B.md.

Да, это все еще некрасиво и не так красиво, как оптимальное решение, которое вы ищете.

person Torbjörn    schedule 25.07.2016