Adapt scripts for translation files

generate new pot
add comments for translators
Update po files

1 files changed, 20 insertions, 15 deletions

diff --git a/src/ui.py b/src/ui.py
index 1431770..1fe6a9b 100644
--- a/src/ui.py
+++ b/src/ui.py
@@ -179,13 +179,13 @@ class Links(SlidePage):
             {
                 "name": _("Links", "Release notes"),
                 "url":
-                # Translate only if the link is to a specific page for your language
+                #: Translate only if the link is to a specific page for your language
                 _("Links", "https://wiki.mageia.org/en/Mageia_9_Release_Notes"),
             },
             {
                 "name": _("Links", "Forums"),
                 "url":
-                # Translate only if the link is to a specific page for your language
+                #: Translate only if the link is to a specific page for your language
                 _("Links", "https://forums.mageia.org/en/"),
             },
             {
@@ -195,13 +195,13 @@ class Links(SlidePage):
             {
                 "name": _("Links", "Errata"),
                 "url":
-                # Translate only if the link is to a specific page for your language
+                #: Translate only if the link is to a specific page for your language
                 _("Links", "https://wiki.mageia.org/en/Mageia_9_Errata"),
             },
             {
                 "name": _("Links", "Wiki"),
                 "url":
-                # Translate only if the link is to a specific page for your language
+                #: Translate only if the link is to a specific page for your language
                 _("Links", "https://wiki.mageia.org/en/Documentation"),
             },
             {
@@ -211,12 +211,12 @@ class Links(SlidePage):
             {
                 "name": _("Links", "Newcomers Howto"),
                 "url":
-                # Translate only if the link is to a specific page for your language
+                #: Translate only if the link is to a specific page for your language
                 _("Links", "https://wiki.mageia.org/en/Newcomers_start_here"),
             },
             {
                 "name": _("Links", "Chat Room"),
-                # Translate only if the link is to a specific page for your language
+                #: Translate only if the link is to a specific page for your language
                 "url": _("Links", "ircs://irc.libera.chat:6697/#mageia"),
             },
             {"name": _("Links", "Donations"), "url": "https://www.mageia.org/donate/"},
@@ -256,7 +256,7 @@ class Welcome(SlidePage):
     def __init__(self, user):
         super().__init__(_("Welcome", "Welcome"))
 
-        #         #  vertical layout
+        #  vertical layout
         layout = QVBoxLayout()
 
         # Add title
@@ -425,6 +425,7 @@ class Sources(SlidePage):
 
 class Updates(SlidePage):
     def __init__(self):
+        #  The button in the buttons bar
         super().__init__(_("Updates", "Update"))
 
         #  vertical layout
@@ -541,7 +542,7 @@ class Mcc(SlidePage):
 
 class InstallSoftware(SlidePage):
     def __init__(self, user):
-        #  The button in the buttons bar, shortcut for Mageia Control Center
+        #:  The button in the buttons bar
         super().__init__(_("InstallSoftware", "Install software"))
 
         #  vertical layout
@@ -565,6 +566,7 @@ class InstallSoftware(SlidePage):
 
         button_layout = QHBoxLayout()
         button_layout.addStretch(1)
+        #: Normally, this is not to translate
         button = MyPushButton(_("InstallSoftware", "RPMdrake") + " *")
         button.clicked.connect(
             partial(
@@ -579,6 +581,7 @@ class InstallSoftware(SlidePage):
         layout.addLayout(button_layout)
         button2_layout = QHBoxLayout()
         button2_layout.addStretch(1)
+        #: Normally, this is not to translate
         doc_button = MyPushButton(_("InstallSoftware", "Dnfdragora"))
         doc_button.clicked.connect(
             partial(self.install_and_launch, ["dnfdragora", "/usr/bin/dnfdragora"])
@@ -619,7 +622,7 @@ class InstallSoftware(SlidePage):
 
 class Applications(SlidePage):
     def __init__(self):
-        #  The button in the buttons bar, shortcut for Mageia Control Center
+        #:  The button in the buttons bar
         super().__init__(_("mw-ui", "Applications"))
 
         self.items = []
@@ -645,6 +648,7 @@ class Applications(SlidePage):
 
         self.nav = Breadcrumb(lateral=True)
         entries = [
+            #: category entries in Applications tab
             {"name": _("mw-ui", "Featured"), "group": "featured"},
             {"name": _("mw-ui", "Games"), "group": "games"},
             {"name": _("mw-ui", "Internet"), "group": "internet"},
@@ -716,7 +720,7 @@ class AppListPage(QWidget):
 
 class Configuration(SlidePage):
     def __init__(self):
-        #  The button in the buttons bar, shortcut for Mageia Control Center
+        #:  The button in the buttons bar
         super().__init__(_("Configuration", "Your configuration"))
 
         #  vertical layout
@@ -746,11 +750,11 @@ class Configuration(SlidePage):
         message = QMessageBox(
             QMessageBox.Icon.Warning,
             _("Configuration", "About Mageiawelcome"),
-            # %1 will be replaced with the release number, %2 with author's names
+            #: %1 will be replaced with the release number, %2 with author's names
             _("Configuration", "Release %1<br />Authors : %2")
             % (version.version, "Daniel Napora, Papoteur, Antony Baker<br />"),
         )
-        # Replace with the list of translator's names
+        #: Replace with the list of translator's names
         messaget.setDetailedText(
             _("Configuration", "Translators: English is the source language")
         )
@@ -759,7 +763,7 @@ class Configuration(SlidePage):
 
 class Live(SlidePage):
     def __init__(self):
-        #  The button in the buttons bar, shortcut for Mageia Control Center
+        #:  The button in the buttons bar
         super().__init__(_("Live", "Live mode"))
 
         #  vertical layout
@@ -791,7 +795,7 @@ class Live(SlidePage):
         doc_button.clicked.connect(
             partial(
                 self.weblink,
-                # the link to the local file can be adapted to your language if the documentation is translated
+                #: the link to the local file can be adapted to your language if the documentation is translated
                 _("Live", "file:///usr/share/doc/mageia/en/draklive/index.html"),
             )
         )
@@ -804,7 +808,7 @@ class Live(SlidePage):
 
 class Install(SlidePage):
     def __init__(self):
-        #  The button in the buttons bar, shortcut for Mageia Control Center
+        #:  The button in the buttons bar
         super().__init__(_("Install", "Install"))
 
         #  vertical layout
@@ -1256,6 +1260,7 @@ class SlideShowApp(QMainWindow):
 
     def __init__(self):
         super().__init__()
+        #: the application title
         self.setWindowTitle(_("mw-ui", _("Welcome", "Welcome to Mageia")))
         self.setGeometry(100, 100, 100 + DEFAULT_WIDTH, 700)