什么是相对于doxygen的QHG_LOCATION路径?

时间:2018-04-10 10:05:50

标签: qt doxygen

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

error: failed to run qhelpgenerator on index.qhp

这意味着找不到qhelpgenerator。

所以问题是:如果我希望QHG_LOCATION成为相对路径,它相对于哪个目录?它既不与./相关,也不与html输出目录相关。

2 个答案:

答案 0 :(得分:2)

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

来自QHG_LOCATION的文档:

  

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

并且来自QCH_FILE

的文件
  

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

答案 1 :(得分:0)

实际上,QHG_LOCATIONQCH_FILE都必须相对于HTML输出目录。此外,您必须在Windows上使用反斜杠\作为目录分隔符。在doxyfile的其余部分中支持正斜杠但不在此处。

我发现这两个问题都很烦人,但事实就是如此。

感谢albert提供的有用评论!