adding help for the localized window

Author: s-n-g

pyradio/config_window.py

@@ -4499,15 +4499,6 @@ def _read_file_list(self):
 
         # Sort and return the list of filenames
         self._files = [['Define New Layout', None, False, None], ['No Layout', None, False, None]] + sorted(filenames)
-        # self._files.append(['Item 1', None, False, None])
-        # self._files.append(['Item 2', None, False, None])
-        # self._files.append(['Item 3', None, False, None])
-        # self._files.append(['Item 4', None, False, None])
-        # self._files.append(['Item 5', None, False, None])
-        # self._files.append(['Item 6', None, False, None])
-        # self._files.append(['Item 7', None, False, None])
-        # self._files.append(['Item 8', None, False, None])
-        # self._files.append(['Item 9', None, False, None])
 
     def _read_layout_file(self, index):
         ''' read a layout file from disk
@@ -4831,6 +4822,10 @@ def keypress(self, char):
         self._needs_update = False
         self._set_ok_enabled()
 
+        if self._focus != 1 and (char == kbkey['?'] or \
+                 check_localized(char, (kbkey['?'], ))):
+            return 2
+
         if char in (curses.KEY_EXIT, 27, ):
             self._win.nodelay(True)
             char = self._win.getch()

pyradio/messages_system.py

@@ -1604,6 +1604,40 @@ def set_text(self, parent, *args):
 so you can resolve the issue and try again.
 
 '''
+),
+
+    'M_LOC_HELP': ('Localized Shortcuts Help',
+r'''This window allows you to define or edit a keyboard layout that maps
+your local language characters to their English equivalents.
+
+__The purpose of this mapping is to ensure that PyRadio responds
+correctly to keyboard shortcuts even when your system keyboard layout
+is not English. For example, if your layout is Greek and you press
+the key corresponding to '|α|', the program will recognize it as the
+English '|a|' and trigger the appropriate action.
+
+To create or edit a layout:
+
+__• Select an existing layout to edit (press |{edit}|), or choose "|Define
+____|New Layout|" (or press |{add}|) to create one.
+__• Use the input grid to map each English letter (lowercase and
+____uppercase) to the corresponding character in your local language.
+__• When you type a lowercase character, its uppercase version is
+____auto-filled, but you can change it manually.
+
+__The |Display| option affects only the visual ordering of keys in the
+table (e.g., QWERTY, AZERTY) to help you locate them according to
+your physical keyboard. It does |not| affect the functionality or
+saved layout.
+
+|Note:|
+__• If you attempt to edit a default layout provided with the
+____program, you will be asked to use a new name.
+__• Your personalized layout will take priority during runtime.
+
+To set the default layout to use, just press |space|, |Enter|, |{l}| or
+the |Left Arror| while you are in the "|Available Layouts|" field.
+'''.replace('{add}', chr(kbkey['add'])).replace('{edit}', chr(kbkey['edit'])).replace('{l}', chr(kbkey['l']))
 ),
 
     'M_LOC_READ_ONLY': ('Read-Only Warning',

pyradio/radio.py

@@ -6802,7 +6802,7 @@ def keypress(self, char):
                 self.refreshBody()
             elif ret == 2:
                 # display help
-                pass
+                self._open_simple_message_by_key('M_LOC_HELP')
             elif ret == 3:
                 # edit read only
                 self._open_simple_message_by_key('M_LOC_READ_ONLY')
@@ -8017,9 +8017,9 @@ def keypress(self, char):
 
                 elif ret == self.ws.LOCALIZED_CONFIG_MODE:
                     ''' keyboard localized window '''
-                    self._print_not_implemented_yet()
-                    # self.ws.operation_mode = self.ws.LOCALIZED_CONFIG_MODE
-                    # self._localized_init_config()
+                    # self._print_not_implemented_yet()
+                    self.ws.operation_mode = self.ws.LOCALIZED_CONFIG_MODE
+                    self._localized_init_config()
                     return
 
                 else: