Doxygen Conditional Markdown Страници

Имам набор от страници за маркиране, които използвам за документиране на моя код в настройка на таблица и използвам @subpage, за да поставя тези страници под страницата на таблицата.

Table.md

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 са настроени правилно и че извежда правилния текст, който искам, проблемът е, че навигационният улей вече не подстраници на тези страници, които имат този тип условна настройка и действителните страници не използват заглавието на връзката за заглавието на страницата, но по-скоро използвайте името на файла като заглавие.

Markdown твърде ли е ограничен в момента с doxygen и трябва да използвам dox страници или настройката не е възможна с това, което искам?


markdown doxygen
person lucasbrendel    schedule 25.06.2014    source източник
comment
Това е добър въпрос (+1). Също така се сблъсквах с редица подобни проблеми със смесица от doxygen и markdown, по-специално с markdown и текст с условно превключване, които не се обработват безпроблемно. Като цяло съм опитвал различни начини за преструктуриране на няколко случая, имах нужда от нещо подобно, докато нещо проработи. Подозирам, че това може да е маркдаун твърде ограничен с doxygen, но очаквам отговорите с интерес.   -  person Cheeseminer    schedule 25.06.2014

Отговори (1)


arrow_upward
0
arrow_downward

Може да искате да преместите условния елемент около подстраницата вътре в таблицата:

| 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