Changeset a4340d1 in sasview for src/sas/guiframe/documentation_window.py

Timestamp:

Feb 17, 2015 10:01:09 AM (9 years ago)

Author:

butler

Branches:

master, ESS_GUI, ESS_GUI_Docs, ESS_GUI_batch_fitting, ESS_GUI_bumps_abstraction, ESS_GUI_iss1116, ESS_GUI_iss879, ESS_GUI_iss959, ESS_GUI_opencl, ESS_GUI_ordering, ESS_GUI_sync_sascalc, costrafo411, magnetic_scatt, release-4.1.1, release-4.1.2, release-4.2.2, release_4.0.1, ticket-1009, ticket-1094-headless, ticket-1242-2d-resolution, ticket-1243, ticket-1249, ticket885, unittest-saveload

Children:

0c4bca6

Parents:

296f290

Message:

Restructure the way the new help documentation gets displayed

1) Make the _onSphinxDocumentation a single line instatiation of
documentation_window passing only the location within the documentation
tree instead of the whol documentation path.

2) Put all the logic in documentation_window to check for 2.9 or higher

3) If lower than 2.9 go to same documentation but open with broswer (no
longer requires a connection)

4) Fix logging string so if the path is not found it fails but sends a
logging string to the log

File:

• src/sas/guiframe/documentation_window.py (modified) (2 diffs)

src/sas/guiframe/documentation_window.py

@@ +1 @@
+import os
+import logging
 import wx
 from wx import Frame
-
+import webbrowser
 wx_supports_html2 = float(wx.__version__[:3]) >= 2.9
 if wx_supports_html2:
@@ -8 +10 @@
     import wx.html as html
 
+   
 class DocumentationWindow(Frame):
     def __init__(self, parent, id, path, title='Help', size=(850, 540)):
         Frame.__init__(self, parent, id, title, size=size)
 
-        if wx_supports_html2:
+        SPHINX_DOC_ENV = "SASVIEW_DOC_PATH"
+        if SPHINX_DOC_ENV in os.environ:
+            docs_path = os.path.join(os.environ[SPHINX_DOC_ENV])
+        else:
+            docs_path = os.path.join(PATH_APP, "..", "..", "doc")
+
+        if (not os.path.exists(docs_path)):
+            print "logging"
+            logging.error("Could not find Sphinx documentation at %s \
+            -- has it been built?", docs_path)
+
+        elif wx_supports_html2:
             # Complete HTML/CSS support!
             self.view = html.WebView.New(self)
-            self.view.LoadURL("file://" + path)
-        else:
-            # This ain't gonna be pretty...
-            self.view = html.HtmlWindow(self, -1, style=wx.NO_BORDER)
-            self.view.LoadPage(path)
+            self.view.LoadURL("file://" + docs_path + '\\' + path)
+            self.Show()
+        else: 
+            #For cases that do not build against current version dependency
+            # Wx 3.0 we provide a webbrowser call - this is particularly for 
+            #Red hat used at SNS for which Wx 3.0 is not available.  This
+            #does not deal with issue of math in docs of course. 
+
+            webbrowser.open_new_tab("file:///" + docs_path + "/" + path)
+
+