Doxygen条件降价页面

时间:2014-06-25 14:40:02

标签: markdown doxygen

我有一组降价页面,用于在表格设置中记录我的代码,并使用@subpage将这些页面放在表格页面下。

Table.md

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

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

Subpage0.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预处理和已启用的部分都设置正确,并且它输出了我想要的正确文本,问题是导航装订线不再包含那些具有此类条件设置的页面,而实际页面则不包含在内。 t使用页面标题的链接标题,而是使用文件名作为标题。

目前使用doxygen标记是否有限,我必须使用dox页面,或者我想要的设置是不可能的?

1 个答案:

答案 0 :(得分:0)

您可能希望围绕表中的子分页移动条件:

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

此方法的缺点:您需要为index0页面提供两个单独的文件:Subpage0_A.mdSubpage0_B.md

是的,这仍然是丑陋的,并不像您正在寻找的最佳解决方案那么好。