Markdown Doxygen：如何制作整个文件；内部；？

我想将我的文档的整个页面设置为“内部”，以便只有当

Internal\u DOCS=YES

时才会生成该页面。我对本文档的大容量文本使用了降价格式，因此所有这些文件都是.md扩展名，这不会有什么区别

如果我在源文本文件的

@page

部分中应用此选项，则以下操作与预期一样有效，因为页面的所有证据都会从输出中消失：

@internal
@page hidden_page Blah Blah
Text is here.    
@endinternal

然而，我的一些页面相当长，我已经将它们分解成一个单独的文件

# Page Title

Extensive text here.

第一行标记标题使用页面标题的文件名停止Doxygen

问题是，如果我这样做

@internal
# Page Title

Extensive text here.
@endinternal

文本主体被适当隐藏，但输出中仍然存在（空白）页面，将文件名显示为页面标题

<>颠倒顶部行的顺序并没有什么区别——它只是意味着空白页的标题不同。

我在Doxygen手册的相关部分找不到任何内容。我用的是1.8.5

一种不可取的解决方案是将分离的页面“解压”回始终可见的页面，并使用顶部描述的技术。然而，有相当多的这样的页面

---

是否有人知道如何使整个文件完全内部化，或者有任何其他方法可以做到这一点？

我在涉及页面的地方使用@internal没有太多成功，因此我成功使用的方法是使用@if和启用的部分，请参阅。我已经用python文件测试了以下内容，尽管这确实会产生一些警告，但我认为它可以满足您的需要

## @if COND1
# @file cond_file.py Conditional File
#
# Conditional documentation.
#
# @page conditional_page Conditional Page
#
# This page will only exist if COND1 is set.
#
# @endif

如果希望文档中包含该部分，只需将以下内容添加到doxygen配置文件中：

ENABLED_SECTIONS = COND1

---

这是一个合理的方法，所以+1，谢谢你看这个老问题。然而，在尝试之后，我仍然在生成空白页，这正是我得到的代码< >内部< /代码>。在这方面，Doxygen处理Markdown和Python的方式可能有所不同。理想的情况是，如果减价页面“编译”为空，则完全没有减价页面。+bounty。这并不是一个完整的解决方案，但我感谢您的贡献；这比其他任何人提供的都多，所以谢谢。