path - 如何在 Doxygen 配置中使用相对路径名

Question

我的 doxygen 在我的/utils 目录中，而我的源代码在根目录中的另一个目录中( /code_with_doxygen )，我怎么能为此创建一个相对路径名，因为它位于一个存储库中，该存储库将位于其他计算机的不同位置.我无法记录整个根目录，因为我不想要目录 /code_without_doxygen也建。

项目树如下所示:

root
    utils
    code
        code_with_doxygen
        code_without_doxygen
    documentation

现在我有设置，但这似乎不起作用:

FULL_PATH_NAMES        = YES
STRIP_FROM_PATH        = ../

我似乎无法弄清楚: Relative files paths in doxygen-generated documentation

Answer 1

相对路径取决于您执行 doxygen 的目录。例如，如果您有以下项目树:

+ project_root
     + documentation
         + config
             - doxyfile
         + pictures
         + output
         - run_doxygen.bat
     + code
         + code_with_doxygen
         + code_without_doxygen

在这种情况下，所有相对路径的根都位于“documentation”文件夹中，因为您正在从该文件夹运行脚本“run_doxygen.bat”。所以你会设置 INPUT在“doxyfile”中标记为

INPUT = ./../code

和 OUTPUT_DIRECTORY在 doxyfile 中标记为

OUTPUT_DIRECTORY = ./output

误导性的是，即使 doxyfile 在子文件夹“config”中，路径也不是相对于 doxyfile 的位置，因为路径是相对于调用 doxygen 的位置。在这种情况下，它是文件夹“documentation”，因为这是调用 doxygen 的脚本的位置。