如何为PyQt演示和Qt工具安装Qt文档
我在Windows 7上安装了PyQt，使用的是Python 2.6，当我尝试运行示例时，出现了以下警告：
经过一些研究，我找到了一份可以和Qt Assistant一起使用的Qt4文档，格式是.qch。
请问文档要怎么安装，才能在PyQt4示例中使用，并消除这个警告呢？
我现在用的qt.qch文档是否适用于这个，还是说示例需要特定的文档？如果是的话，在哪里可以下载到呢？
我在网上搜索了一段时间，发现其他人也在问类似的问题，包括在Stack Overflow上，但没有找到对我有用的答案。
2 个回答
很遗憾，下载网站 http://download.qt.io/archive/qt 上似乎没有 .qct 格式的文档。下载的 .tar.gz 和 .zip 格式的文件里包含了 QT 软件的安装程序，但下载文件中的文档文件夹只包含 .html 格式的文档。这种格式和 PyQt 安装中的文档文件夹是一样的。而 .html 格式的文档是 Qt Assistant 读不懂的。此外，PyQt 安装中的文档文件夹里还有一个叫 sphinx 的子文件夹，里面有 .rst 文件，这些文件同样也不能被 Qt Assistant 读取。
.qch 文件必须放在 pyqt 文档文件夹里，才能让示例程序正常工作。如果你在安装 Python 和 PyQt 时接受了默认路径，那么这个文件夹通常是 C:\Python27\Lib\site-packages\PyQt4\doc。
在移动 .qch 文件之前，先打开 Qt Assistant，把之前添加的文档删除掉。然后关闭 Qt Assistant，把所有的 .qch 文件移动到 pyqt 文档文件夹里的一个 qch 文件夹里，比如 C:\Python27\Lib\site-packages\PyQt4\doc\qch。需要的 .qch 文件有 qt.qch、designer.qch 和 linguist.qch。
当你重新打开 Qt Assistant 时，它应该会自动找到所有的文档，并开始重新索引。等这个过程完成后，关闭 Qt Assistant，然后打开 PyQt 示例程序。
有几点重要的事情需要注意：首先，即使文档安装正确，Windows 上也总会出现警告消息框（这其实是个 bug - 启动脚本本可以做必要的检查）。其次，并不是所有的示例都有描述，所以你会在很多地方看到警告 Could not load description. Ensure that the documentation for Qt is built（例如在 Demonstrations\Minehunt 里）。不过，如果你安装得当，Dialogs 部分的所有示例应该都有描述和截图。