如何将库的doxygen \主页转换为\页面？

Question

我有一个库，它被文档化为doxygen，它在一个较大的项目中使用。我为我的库提供了一个很好的\主页，当我在更大的项目上运行doxygen时，我希望被降级为一个\页面。是否有一种简单的方法可以做到这一点，而不依赖于do安装的工具呢？举例说明，当在库中单独运行doxygen时，doxygen应该看到：

/**    
\mainpage

\section main_introduction Introduction

The Gen-MC (Generalised Monte-Carlo) simulation tool.
*/

当我在更大的项目中运行doxygen时，它应该看到：

/**    
\page gen_MC_mainpage Gen-MC

\section main_introduction Introduction

The Gen-MC (Generalised Monte-Carlo) simulation tool.
*/

我想我可以使用INPUT_FILTER和perl脚本来完成这个任务，但是我需要让人们安装的工具越多，生成文档的可能性就越小。

Answer 1

这可以使用条件来实现。

/**    
\if USEMAINPAGE
\mainpage
\else
\page gen_MC_mainpage Gen-MC
\endif

\section main_introduction Introduction

The Gen-MC (Generalised Monte-Carlo) simulation tool.
*/

在您的较小项目的Doxyfile中，将USEMAINPAGE添加为启用部分：

ENABLED_SECTIONS       = USEMAINPAGE

if命令获得更多信息。