相对于Doxygen的QHG_LOCATION路径是什么？ [英] What is the QHG_LOCATION path relative to for doxygen?

问题描述

当将 QHG_LOCATION 设置为绝对路径时，可以在html和qch中创建有效的doxygen文档。如果我将qhelpgenerator及其DLL放入当前目录 ./ 并设置 QHG_LOCATION = qhelpgenerator ，它也可以工作。但是我不知道如何将qhelpgenerator放入子目录 qt / bin / qhelpgenerator 并让doxygen找到它。总是说

 错误：无法在index.qhp 
 上运行qhelpgenerator 

这意味着它找不到qhelpgenerator。

所以问题是：如果我想要 QHG_LOCATION 作为相对路径，它相对于哪个目录？它既不是相对于 ./ 也不是相对于html输出目录。

解决方案

可以通过输出执行的外部命令来调试问题：
doxygen -d extcmd 并在doxygen外部手动执行给定命令。 / p>

从 QHG_LOCATION 的文档中：

QHG_LOCATION标记可用于指定Qt的qhelpgenerator的位置。如果非空的
doxygen将尝试在生成的.qhp文件上运行qhelpgenerator。

并从 QCH_FILE ：

如果指定了QHG_LOCATION标记，则可以使用QCH_FILE标记来指定
的文件名，生成的.qch文件。指定的路径是相对于HTML输出文件夹的。

When I set QHG_LOCATION to be an absolute path, I can create a valid doxygen documentation in html and qch. If I put qhelpgenerator and its DLLs into the current directory ./ and set QHG_LOCATION=qhelpgenerator, it also works. But I cannot figure out how to put the qhelpgenerator into a subdirectory qt/bin/qhelpgenerator and have doxygen find it. It always says

error: failed to run qhelpgenerator on index.qhp

which means that it could not find qhelpgenerator.

So the question is: If I want QHG_LOCATION to be a relative path, what directory is it relative to? It is neither relative to ./ nor to the html output directory.

解决方案

Debugging the problem can be done by outputting the external commands executed: doxygen -d extcmd and execute the given command 'by hand' outside of doxygen.

From the documentation of QHG_LOCATION:

The QHG_LOCATION tag can be used to specify the location of Qt's qhelpgenerator. If nonempty doxygen will try to run qhelpgenerator on the generated .qhp file.

and from the documenattion of QCH_FILE:

If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify the file name of the resulting .qch file. The path specified is relative to the HTML output folder.

这篇关于相对于Doxygen的QHG_LOCATION路径是什么？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！