Changeset 227:50c3ae93007d for src

Timestamp:

06/05/12 18:20:01 (12 years ago)

Author:

István Váradi <ivaradi@…>

Branch:

default

Phase:

public

Message:

Added a Help menu with the manual and the about dialog

Location:

src/mlx

Files:

• gui/common.py (modified) (4 diffs)
• gui/gui.py (modified) (7 diffs)
• i18n.py (modified) (8 diffs)

src/mlx/gui/common.py

@@ -60 +60 @@
     WEIGHT_BOLD = pango.WEIGHT_BOLD
 
+    pixbuf_new_from_file = gdk.pixbuf_new_from_file
+
     def text2unicode(text):
         """Convert the given text, returned by a Gtk widget, to Unicode."""
@@ -67 +69 @@
     pygobject = True
     from gi.repository import Gdk as gdk
+    from gi.repository import GdkPixbuf as gdkPixbuf
     from gi.repository import Gtk as gtk
     from gi.repository import GObject as gobject
@@ -109 +112 @@
     WEIGHT_BOLD = pango.Weight.BOLD
 
+    pixbuf_new_from_file = gdkPixbuf.Pixbuf.new_from_file
+
     import codecs
     _utf8Decoder = codecs.getdecoder("utf-8")
@@ -208 +213 @@
 #------------------------------------------------------------------------------
 
-WINDOW_TITLE_BASE = "MAVA Logger X " + _const.VERSION
+PROGRAM_NAME = "MAVA Logger X"
+
+WINDOW_TITLE_BASE = PROGRAM_NAME + " " + _const.VERSION
 
 #------------------------------------------------------------------------------

src/mlx/gui/gui.py

@@ -1 +1 @@
 # The main file for the GUI
+# -*- coding: utf-8 -*-
 
 from statusicon import StatusIcon
@@ -21 +22 @@
 import mlx.web as web
 import mlx.singleton as singleton
-from  mlx.i18n import xstr
+from  mlx.i18n import xstr, getLanguage
 from mlx.pirep import PIREP
 
@@ -28 +29 @@
 import sys
 import datetime
+import webbrowser
 
 #------------------------------------------------------------------------------
@@ -33 +35 @@
 class GUI(fs.ConnectionListener):
     """The main GUI class."""
+    _authors = [ ("Váradi", "István", "prog_test"),
+                 ("Galyassy", "Tamás", "negotiation"),
+                 ("Petrovszki", "Gábor", "test"),
+                 ("Zsebényi-Loksa", "Gergely", "test"),
+                 ("Kurják", "Ákos", "test"),
+                 ("Radó", "Iván", "test") ]
+
     def __init__(self, programDirectory, config):
         """Construct the GUI."""
@@ -158 +167 @@
         self._pilotHotkeyIndex = None
         self._checklistHotkeyIndex = None
+
+        self._aboutDialog = None
 
     @property
@@ -872 +883 @@
         showDebugMenuItem.connect("toggled", self._toggleDebugLog)
         viewMenu.append(showDebugMenuItem)
+
+        helpMenuItem = gtk.MenuItem(xstr("menu_help"))
+        helpMenu = gtk.Menu()
+        helpMenuItem.set_submenu(helpMenu)
+        menuBar.append(helpMenuItem)
+
+        manualMenuItem = gtk.ImageMenuItem(gtk.STOCK_HELP)
+        manualMenuItem.set_use_stock(True)
+        manualMenuItem.set_label(xstr("menu_help_manual"))
+        manualMenuItem.add_accelerator("activate", accelGroup,
+                                       ord(xstr("menu_help_manual_key")),
+                                       CONTROL_MASK, ACCEL_VISIBLE)
+        manualMenuItem.connect("activate", self._showManual)
+        helpMenu.append(manualMenuItem)
+
+        helpMenu.append(gtk.SeparatorMenuItem())
+        
+        aboutMenuItem = gtk.ImageMenuItem(gtk.STOCK_ABOUT)
+        aboutMenuItem.set_use_stock(True)
+        aboutMenuItem.set_label(xstr("menu_help_about"))
+        aboutMenuItem.add_accelerator("activate", accelGroup,
+                                      ord(xstr("menu_help_about_key")),
+                                      CONTROL_MASK, ACCEL_VISIBLE)
+        aboutMenuItem.connect("activate", self._showAbout)
+        helpMenu.append(aboutMenuItem)
 
         return menuBar
@@ -1232 +1268 @@
                 else:
                     print "gui.GUI._handleHotkeys: unhandled hotkey index:", index
+
+    def _showManual(self, menuitem):
+        """Show the user's manual."""
+        webbrowser.open(url ="file://" +
+                        os.path.join(self._programDirectory, "doc", "manual",
+                                     getLanguage(), "index.html"),
+                        new = 1)
+
+    def _showAbout(self, menuitem):
+        """Show the about dialog."""
+        dialog = self._getAboutDialog()
+        dialog.show_all()
+        dialog.run()
+        dialog.hide()
+
+    def _getAboutDialog(self):
+        """Get the about dialog.
+
+        If it does not exist yet, it will be created."""
+        if self._aboutDialog is None:
+            self._aboutDialog = dialog = gtk.AboutDialog()
+            dialog.set_transient_for(self._mainWindow)
+            dialog.set_modal(True)
+            
+            logoPath = os.path.join(self._programDirectory, "logo.png")
+            logo = pixbuf_new_from_file(logoPath)
+            dialog.set_logo(logo)
+                                
+            dialog.set_program_name(PROGRAM_NAME)
+            dialog.set_version(const.VERSION)
+            dialog.set_copyright("(c) 2012 by István Váradi")
+
+            isHungarian = getLanguage()=="hu"
+            authors = []
+            for (familyName, firstName, role) in GUI._authors:
+                authors.append("%s %s (%s)" % \
+                               (familyName if isHungarian else firstName,
+                                firstName if isHungarian else familyName,
+                                xstr("about_role_" + role)))            
+            dialog.set_authors(authors)
+
+            dialog.set_license(xstr("about_license"))
+
+        return self._aboutDialog

src/mlx/i18n.py

@@ -18 +18 @@
     _Strings.set(language)
     
+#------------------------------------------------------------------------------
+
+def getLanguage():
+    """Get the two-letter language code."""
+    language = _Strings.current().getLanguage()
+    underscoreIndex = language.find("_")
+    return language[:underscoreIndex] if underscoreIndex>0 else language
+
 #------------------------------------------------------------------------------
 
@@ -52 +60 @@
         on, until no underscore remains.
 
-        If nothing is found this way, the 
-        """
+        If nothing is found this way, the fallback will be returned."""
         while language:
             if language in _Strings._instances:
@@ -89 +96 @@
         """Construct an empty strings object."""
         self._strings = {}
+        self._language = languages[0]
         for language in languages:
             _Strings._instances[language] = self
@@ -106 +114 @@
         This releases the string dictionary to free space."""
         self._strings = {}
+
+    def getLanguage(self):
+        """Get the language."""
+        return self._language
 
     def add(self, id, s):
@@ -178 +190 @@
         self.add("menu_view_debug_key", "d")
         
+        self.add("menu_help", "Help")
+        self.add("menu_help_manual", "_User's manual")
+        self.add("menu_help_manual_key", "u")
+        self.add("menu_help_about", "_About")
+        self.add("menu_help_about_key", "a")
+
         self.add("tab_flight", "_Flight")
         self.add("tab_flight_tooltip", "Flight wizard")
@@ -936 +954 @@
         self.add("pirepView_tab_log_tooltip", "The flight log.")
 
+        self.add("about_license",
+                 "This program is in the public domain.")
+
+        self.add("about_role_prog_test", "programming, testing")
+        self.add("about_role_negotiation", "negotiation")
+        self.add("about_role_test", "testing")
+
 #------------------------------------------------------------------------------
 
@@ -992 +1017 @@
         self.add("menu_view_debug_key", "d")
         
+        self.add("menu_help", "Segítség")
+        self.add("menu_help_manual", "_Felhasználói kézikönyv")
+        self.add("menu_help_manual_key", "f")
+        self.add("menu_help_about", "_Névjegy")
+        self.add("menu_help_about_key", "n")
+
         self.add("tab_flight", "_Járat")
         self.add("tab_flight_tooltip", "Járat varázsló")
@@ -1766 +1797 @@
         self.add("pirepView_tab_log_tooltip", "A repülési napló.")
 
+        self.add("about_license",
+                 "A program köztulajdonban van.")
+
+        self.add("about_role_prog_test", "programozás, tesztelés")
+        self.add("about_role_negotiation", "tárgyalások")
+        self.add("about_role_test", "tesztelés")
+
 #------------------------------------------------------------------------------