从具有以 "."开头的父文件夹的文件夹运行时，Doxygen 无法运行 html 帮助编译器，hhc.exe 错误 HHC5010

Question

我在 Windows 上使用 Conan 包管理器来创建包。创建包的 conan 命令将文件复制到 %USERPROFILE%\.conan(或 C:\Users\xxxxxxx\.conan)中的文件夹。然后从这个位置构建一个 Visual Studio 项目并最终调用 doxygen.exe 以在构建后命令中创建一个 .chm 帮助文件。 doxygen 命令失败:

error : failed to run html help compiler on index.hhp

进一步调查显示 doxygen 执行的 hhc.exe 命令失败:

C:\Users\xxxxxxx\.conan\data\Module\1.0.0\user\channel\build\524dc97e4a3dd1f774ea3897f9e4faf26c5457d2\Documentation>"C:/Program Files (x86)/HTML Help Workshop/hhc.exe" html\index.hhp

HHC5010: Error: Cannot open "C:\Users\xxxxxxx\data\Module\1.0.0\user\channel\build\524dc97e4a3dd1f774ea3897f9e4faf26c5457d2\Documentation\html\Module.chm". Compilation stopped.

仔细检查会发现错误消息中缺少 .conan"文件夹。果然，当 index.hpp 所在的文件夹的父文件夹以“.”开头时，我确认 hhc.exe 失败。

尝试解决此问题:

• 将 Doxyfile 设置 OUTPUT_DIRECTORY 更改为“$(TMP)/DoxygenModule”可解决错误，但会在另一个位置创建 .chm 文件，这是我不喜欢的。
• 导航到“.conan”文件夹的 8DOT3 名称，即“CONAN~1”，运行 hhc.exe 命令成功，但不幸的是我无法让柯南使用这个 8DOT3 路径来创建包裹。例如。 C:\Users\xxxxxxx\CONAN~1\...

我可以接受使用 %TMP% 文件夹，但更愿意在当前文件夹中生成 .chm。有人有什么想法吗？

HTML Help Workshop v1.31 安装在我机器上的 C:\Program Files (x86)\HTML Help Workshop，可能来自 Visual Studio 安装(不确定)。我也尝试使用从 Microsoft 网站 (v1.30) 下载的版本，但没有任何区别。

其他信息:柯南1.18.0版，Doxygen 1.8.14版，Windows 10 1809版

Answer 1

不幸的是，这不是解决方案，但这是 hhc.exe 中的已知限制，请参阅:https://social.msdn.microsoft.com/Forums/en-US/0681145c-223b-498c-b7bf-be83209cbf4e/issue-with-html-workshop-in-a-windows-container?forum=visualstudiogeneral

HTML Help 1.x command line compiler hhc.exe cannot compile CHM file to folder whose full path contains folder name starting with dot. If you have that problem, you probably specified output path with folder starting with dot, e.g. "d:\My files.NET\documentation". You can use dots in folder names but not at the beginning.

编辑 2019-11-15:我刚刚将提议的补丁推送到 github(拉取请求 7402，https://github.com/doxygen/doxygen/pull/7402)。这个提议的补丁在 doxygen 内部从当前目录更改为简称当前目录，但仅用于 HTML 帮助编译。

编辑 2019-11-16:代码已经集成在github上的master版本中。