1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
# -*- coding: iso-8859-1 -*-
# Copyright (C) 2009 Bastian Kleineidam
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
from .. import configuration
from PyQt4 import QtCore, QtGui, QtHelp
class HelpWindow (QtGui.QDialog):
"""A custom help display dialog."""
def __init__ (self, parent, qhcpath):
"""Initialize dialog and load qhc help project from given path."""
super(HelpWindow, self).__init__(parent)
self.engine = QtHelp.QHelpEngine(qhcpath, self)
self.engine.setupData()
self.setWindowTitle(u"%s Help" % configuration.AppName)
self.build_ui()
def build_ui (self):
"""Build UI for the help window."""
splitter = QtGui.QSplitter()
splitter.setOrientation(QtCore.Qt.Vertical)
self.browser = HelpBrowser(splitter, self.engine)
tree = self.engine.contentWidget()
tree.setExpandsOnDoubleClick(False)
splitter.addWidget(tree)
splitter.addWidget(self.browser)
splitter.setSizes((70, 530))
hlayout = QtGui.QHBoxLayout()
hlayout.addWidget(splitter)
self.setLayout(hlayout)
self.resize(800, 600)
self.connect(self.engine.contentWidget(),
QtCore.SIGNAL("linkActivated(QUrl)"),
self.browser, QtCore.SLOT("setSource(QUrl)"))
def showDocumentation (self, url):
"""Show given URL in help browser."""
self.browser.setSource(url)
self.show()
class HelpBrowser (QtGui.QTextBrowser):
"""A QTextBrowser that can handle qthelp:// URLs."""
def __init__ (self, parent, engine):
"""Initialize and store given HelpEngine instance."""
super(HelpBrowser, self).__init__(parent)
self.engine = engine
def setSource (self, url):
if url.scheme() == "http":
import webbrowser
webbrowser.open(str(url.toString()))
else:
QtGui.QTextBrowser.setSource(self, url)
def loadResource (self, rtype, url):
"""Handle qthelp:// URLs, load content from help engine."""
if url.scheme() == "qthelp":
return QtCore.QVariant(self.engine.fileData(url))
return QtGui.QTextBrowser.loadResource(self, rtype, url)
|
