当我使用多种语言时，Doxygen 会生成空白页面

Question

我在使用多种语言时遇到了问题，但在此 page 和 @albert 帮助我并解决了问题。但是当我这样做时，出现了一个新问题。当我在 Markdown 文件上使用多种语言时，Doxygen 在树视图中生成新的空白页面。例如：

\~turkish
@page Page1 TRPage1
@tableofcontents
\~endturkish

\~english
@page Page1 ENPage1
@tableofcontents
\~endenglish

假设 OUTPUT_LANGUAGE 是土耳其语。它生成带有内容的 TRPage1，但它也生成空的 Page1。当我查看 HTML 目录时，文件名如下所示：

TRPage1 : _t_r_page1
Page1 : md__c_1__users__username__documents__projects__projectname_documentation_doc_pages__pages__page1.html

希望你能理解我。我不想在我的树形视图中看到一个空白页面。

我的 Doxygen 版本是：1.8.17 感谢您的所有帮助。

Answer 1

不顾我的评论，那是关于\~：

我认为目前这是不可能的，我确实记得在 Markdown 块以空行开头以检索第一个非空行以到达页面标题的情况下已经投入了一些精力。可能我们需要一些用于 \~... 设置的构造（以及 \if... 构造）

可能有一些卑鄙的技巧：

\cond turkish
@page Page1 TRPage1
@tableofcontents
\endcond

\cond english
@page Page1 ENPage1
@tableofcontents
\endcond

并在 doxygen 配置文件中设置：

ENABLED_SECTIONS  = english

或

ENABLED_SECTIONS  = turkish

注意\if 看起来它不起作用，因为@page 将立即终止 if 块并稍后在唯一的\endif 上找到。