如何使用DO2和HTML帮助编译器生成CHM？

Question

短篇小说：我可以生成一个使用DO2的CHM文件。启动CHM文件时，我注意到Content和Index选项卡确实列出了这些类的页面、名称空间、类和成员。但是，单击这些内容和索引列表中的项不会显示任何内容。

我在一台电脑上使用Windows7Professional SP1，64位.

我使用Doxywizard在代码上运行DOxyVersion1.8.9.1。它正确地生成HTML输出；页面、命名空间、类和成员出现在文档中。

然后，我还想将HTML转换成一个压缩的HTML (CHM)文件。

我从微软网站( htmlhelp.exe https://msdn.microsoft.com/en-us/library/windows/desktop/ms669985(v=vs.85).aspx )下载了MicrosoftHTMLHelpWorks1.31版(即4.74.8703版)。我运行了安装程序。在安装程序进行过程中，出现了一条弹出消息：

这台计算机已经有了较新版本的HTML帮助。

不过，安装已成功完成。而且，hhc.exe程序就在我让它安装的地方。

我现在指定以下相关的DO2设置：

• 向导->输出：
  • 检查HTML
  • “为压缩HTML (.chm)做准备”选项被选中。

​

• 专家-> HTML：
  • GENERATE_HTMLHELP =是
  • CHM_FILE = Foo.chm
  • HHC_LOCATION = C:\Program (X86)\Microsoft\HTML帮助Workshop\hhc.exe

​

当我再次运行DO2时，它报告了一个错误：

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

Foo.chm文件是在预期的地方生成的。但是，如前所述，它缺少了很多内容。

我试着在Doxygen生成的HHP文件上手动运行hhc.exe。它并不表示任何错误。

C:\Program Files (x86)\Microsoft\HTML Help Workshop>hhc c:\test\html\index.hhp
Microsoft HTML Help Compiler 4.74.8702

Compiling c:\test\html\Foo.chm

Compile time: 0 minutes, 3 seconds
292     Topics
3,855   Local links
83      Internet links
0       Graphics

Created c:\test\html\Foo.chm, 259,580 bytes
Compression decreased file by 1,077,915 bytes.

但是，结果是相同的:缺少内容的Foo.chm文件。

后来，我发现我的计算机上安装了另一个HTML帮助车间。但是，hhc.exe是完全相同的版本。所以，这不太可能是问题所在。

您是否可以建议我还可以尝试将所有文档内容显示在CHM文件中呢？

Answer 1

根本的问题是CHM文件位于映射的网络驱动器上。

当我将CHM文件复制到计算机上的物理驱动器时，所有内容都会显示。

Answer 2

当我看到这个问题时( html存在，chm有内容，但该内容不可见)，这是因为windows安全性“阻塞”了chm文件。要查看这是否是您遇到的情况，请尝试以下操作：

1. 在windows中，右键单击生成的.chm文件并选择属性。
2. 在“常规”选项卡上，如果看到“取消阻塞”按钮，请单击该按钮。
3. 关闭对话框并打开.chm文件。

(我没有在本地生成的doxygen .chm文件中遇到这个问题，但我希望从您的描述中可以看出这可能解决您的问题。)

Answer 3

在doxyfile中，将hhc.exe路径放在双引号中，因为它包含空格。

或者更好的是，不要使用带空格的路径。