如何为PyQt演示和Qt工具安装Qt文档

Question

我使用python 2.6在Windows 7上安装了PyQt，在尝试执行演示时，我收到了以下警告：

经过一些研究，我可以获得与Qt助手一起使用的.qch格式的Qt4文档副本。

如何安装文档以便在PyQt4演示中获取并消除警告？

我使用Qt Assistant的qt.qch文档是否对此有效，或者有一个特定的演示文档。如果是，可以从哪里下载？

我一直在网上搜索一段时间，并发现其他人也在问这些相同或类似的问题，但对我来说却毫无用处。

Answer 1

.qch文件必须位于pyqt文档文件夹中才能使演示正常工作。如果在安装python和pyqt时接受了默认路径，则可能是C:\Python27\Lib\site-packages\PyQt4\doc。

在移动.qch文件之前，请打开Qt Assistant并删除之前添加的文档。然后关闭Qt Assistant并将所有.qch文件移动到pyqt doc文件夹中的qch文件夹中：例如C:\Python27\Lib\site-packages\PyQt4\doc\qch。所需的.qch文件为qt.qch，designer.qch和linguist.qch。

当您重新打开Qt Assistant时，它应自动查找所有文档并开始重新编制索引。完成后，关闭Qt助手并打开PyQt演示。

有几个重要的事项要注意：首先，即使文档已正确安装，警告消息框也将始终显示在Windows上（这确实是一个错误 - 启动脚本可以轻松进行必要的检查）。其次，并非所有演示都有描述，因此您仍会在许多地方看到警告Could not load description. Ensure that the documentation for Qt is built（例如Demonstrations \ Minehunt）。但是，如果您已正确安装，则“对话”部分中的所有演示都应包含说明和屏幕截图。

Answer 2

不幸的是，下载网站http://download.qt.io/archive/qt似乎没有.qct格式的文档。 .tar.gz和.zip格式的下载包含QT软件的安装程序，但下载文件中的doc文件夹仅包含.html格式的文档。这与PyQt安装中的doc文件夹格式相同。 Qt Assistant无法读取.html格式。 PyQt安装还在doc文件夹中包含一个名为sphinx的子文件夹，其中包含.rst文件，Qt Assistant也无法读取这些文件