Doxygen генерирует пустые страницы, когда я использую несколько языков

Question

У меня была проблема с несколькими языками, но на этой странице и @albert помогите мне, и я решил проблему. Но когда я это сделал, возникла новая проблема. Когда я использую несколько языков в файлах уценки, Doxygen генерирует новую пустую страницу в виде дерева. Например:

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

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

Допустим, OUTPUT_LANGUAGE - это Turki sh. Он генерирует 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

Не смотря на мой комментарий, который был о \~:

Я думаю, что на данный момент это невозможно, я помню, что были приложены некоторые усилия в случае, когда уценка Блок начинался с пустых строк, чтобы получить первую непустую строку, чтобы добраться до заголовка страницы. Вероятно, нам понадобится некоторая конструкция для \ ~ ... настроек (и \ 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.