add a few more translator messages for further testing -- hopefully only one file left

Author: NSoiffer

addon/globalPlugins/MathCAT/MathCATPreferences.py

@@ -24,7 +24,7 @@
 
 # initialize the user preferences tuples
 user_preferences: Dict[str, Dict[str, Union[int, str, bool]]] = {}
-#Speech_Language is derived from the folder structure
+#Speech_Language is derived from the folder structures
 Speech_Impairment = ("LearningDisability", "Blindness", "LowVision")
 #Speech_SpeechStyle is derived from the yaml files under the selected language
 Speech_Verbosity = ("Terse", "Medium", "Verbose")
@@ -254,7 +254,9 @@ def GetLanguages(self):
         languages_dict = UserInterface.LanguagesDict()
         #clear the language names in the dialog
         self.m_choiceLanguage.Clear()
-        self.m_choiceLanguage.Append(_("Use Voice's Language") + " (Auto)")
+        # Translators: menu item -- use the language of the voice chosen in the NVDA speech settings dialog
+        # "Auto" == "Automatic" -- this is done separately because other items in menu are "English (en)", etc., so this matches that style
+        self.m_choiceLanguage.Append(_("Use Voice's Language") + _(" (Auto)"))
         #populate the available language names in the dialog
         #the implemented languages are in folders named using the relevant ISO 639-1 code https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
         for language in os.listdir(UserInterface.path_to_languages_folder()):
@@ -496,6 +498,7 @@ def OnRelativeSpeedChanged( self, event ):
         from .MathCAT import ConvertSSMLTextForNVDA
         from  speech import speak
         rate = self.m_sliderRelativeSpeed.GetValue()
+        # Translators: this is a test string that is spoken. Only translate "the square root of x squared plus y squared"
         text = _("<prosody rate='XXX%'>the square root of x squared plus y squared</prosody>").replace("XXX", str(rate), 1)
         speak( ConvertSSMLTextForNVDA(text) )
 
@@ -505,6 +508,7 @@ def OnPauseFactorChanged( self, event ):
         rate = self.m_sliderRelativeSpeed.GetValue()
         pf_slider = self.m_sliderPauseFactor.GetValue()
         pause_factor = 0 if pf_slider==0 else round(PAUSE_FACTOR_SCALE *math.pow(PAUSE_FACTOR_LOG_BASE, pf_slider))
+        # Translators: this is a test string that is spoken. Only translate "the fraction with numerator" and other parts NOT inside '<.../>', 
         text = _("<prosody rate='{rate}%'>the fraction with numerator <break time='{pause_factor_300}ms'/> <mark name='M63i335o-4'/> <say-as interpret-as='characters'>x</say-as> to the <mark name='M63i335o-5'/> <say-as interpret-as='characters'>n</say-as> <phoneme alphabet='ipa' ph='θ'>-th</phoneme> power <break time='{pause_factor_128}ms'/> <mark name='M63i335o-6'/> plus  <mark name='M63i335o-7'/> 1 <break time='{pause_factor_300}ms'/> and denominator <mark name='M63i335o-10'/> <say-as interpret-as='characters'>x</say-as> to the <mark name='M63i335o-11'/> <say-as interpret-as='characters'>n</say-as> <phoneme alphabet='ipa' ph='θ'>-th</phoneme> power <break time='{pause_factor_128}ms'/> <mark name='M63i335o-12'/> minus  <mark name='M63i335o-13'/> 1 <break time='{pause_factor_600}ms'/>end fraction <break time='{pause_factor_150}ms'/>").format(
             rate=rate,
             pause_factor_128=128*pause_factor//100,

addon/globalPlugins/MathCAT/MathCATgui.py

@@ -23,6 +23,7 @@
 class MathCATPreferencesDialog ( wx.Dialog ):
 
 	def __init__( self, parent ):
+		# Translators: title for MathCAT preferences dialog
 		wx.Dialog.__init__ ( self, parent, id = wx.ID_ANY, title = _("MathCAT Preferences"), pos = wx.DefaultPosition, size = wx.Size( -1,-1 ), style = wx.DEFAULT_DIALOG_STYLE )
 
 		self.SetSizeHints( wx.DefaultSize, wx.DefaultSize )
@@ -39,6 +40,7 @@ def __init__( self, parent ):
 
 		bSizerCategories.Add( self.m_staticTextCategories, 0, wx.ALL, 5 )
 
+		# Translators: these are tab headings for the MathCAT preferences dialog
 		m_listBoxPreferencesTopicChoices = [ _("Speech"), _("Navigation"), _("Braille") ]
 		self.m_listBoxPreferencesTopic = wx.ListBox( self.m_panelCategories, wx.ID_ANY, wx.Point( -1,-1 ), wx.Size( -1,-1 ), m_listBoxPreferencesTopicChoices, wx.LB_NO_SB|wx.LB_SINGLE )
 		bSizerCategories.Add( self.m_listBoxPreferencesTopic, 0, wx.ALL, 5 )
@@ -61,11 +63,13 @@ def __init__( self, parent ):
 
 		bSizerImpairment = wx.BoxSizer( wx.HORIZONTAL )
 
+		# Translators: this is the text label for whom to target the speech for (options are below)
 		self.m_staticTextImpairment = wx.StaticText( self.m_panelSpeech, wx.ID_ANY, _("Generate speech for:"), wx.DefaultPosition, wx.DefaultSize, 0 )
 		self.m_staticTextImpairment.Wrap( -1 )
 
 		bSizerImpairment.Add( self.m_staticTextImpairment, 0, wx.ALL, 5 )
 
+		# Translators: these are the categories of impairments that MathCAT supports
 		m_choiceImpairmentChoices = [ _("Learning disabilities"), _("Blindness"), _("Low vision") ]
 		self.m_choiceImpairment = wx.Choice( self.m_panelSpeech, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, m_choiceImpairmentChoices, 0 )
 		self.m_choiceImpairment.SetSelection( 1 )