doxygen - 您如何订购 Doxygen 自定义页面

Question

我在 Doxygen 中创建了许多自定义页面。我想自定义主菜单中页面的顺序。下面是我当前导航菜单的图片。我想更改顺序，首先是概述，第二是安装，第三是介绍，等等。有没有办法做到这一点？

Answer 1

经过一番调查，似乎 Doxygen 目前不支持以自定义(或任何)方式对页面进行排序。

正如@Toby 提到的，当前确保 Doxygen 中所需页面顺序的方法是确保以相同顺序解析页面条件 (\page)。例如，您可以通过手动指定文件来实现所需的顺序，例如:

INPUT = Developers.dox \
        Hive_Training.dox \
        Installation.dox \
        Introduction.dox \
        Models.dox \
        Overview.dox \
        Users.dox \
        Files.dox

这一点都不理想，但它有效。我发现，如果您希望在 Doxygen 配置文件中使用目录路径进行维护，您可以创建一个“页面顺序”文件，以便在任何其他内容之前先进行解析。例如:

INPUT += PageOrder.dox
INPUT += ../my_module_1/content/
INPUT += ../my_module_2/content/

然后将所有页面引用添加到 PageOrder.dox 中文件:

\page developers Developers
\page hive_training Hive Training
\page installation Installation
\page introduction Introduction
\page models Models
\page overview Overview
\page users Users
\page files Files

这又是不理想的；但是，您的维护过程现在驻留在单页订单文件中(而不是接触一 (1) 个或多个 Doxygen 配置文件)。