Add a couple of translation comments

Author: Nick-Hall

DescendantSpaceTree/DescendantSpaceTree.py

@@ -910,6 +910,7 @@ def _i18n_html(self, proto):
                 "___HELP_TEXT4___",
                 html.escape(
                     _(
+                        # Translators: Please do not translate ___HELP_RESET_BUTTON___.
                         "Click on the reset button ___HELP_RESET_BUTTON___ to "
                         "reset back to the starting descendant."
                     )
@@ -970,6 +971,7 @@ def _i18n_html(self, proto):
                 "___HELP_TEXT10___",
                 html.escape(
                     _(
+                        # Translators: Please do not translate ___NAV_BUTTON_CONTINUE___ or ___NAV_BUTTON_ALT___.
                         "A person may occur in different branches.  This is "
                         "usually because of inter-family marriages (such as "
                         "that of cousins.)  In this case, a button will also "

DescendantSpaceTree/po/template.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-08-13 17:43+0100\n"
+"POT-Creation-Date: 2025-08-13 18:19+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -170,13 +170,14 @@ msgstr ""
 msgid "Click and drag anywhere on the viewer to position the descendant tree."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:913
+#. Translators: Please do not translate ___HELP_RESET_BUTTON___.
+#: DescendantSpaceTree/DescendantSpaceTree.py:914
 msgid ""
 "Click on the reset button ___HELP_RESET_BUTTON___ to reset back to the "
 "starting descendant."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:922
+#: DescendantSpaceTree/DescendantSpaceTree.py:923
 msgid ""
 "Search for a person by typing into the search box.  At least three "
 "characters are required to search.  Click on any of the suggestions to "
@@ -185,31 +186,32 @@ msgid ""
 "spouse."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:935
+#: DescendantSpaceTree/DescendantSpaceTree.py:936
 msgid ""
 "A descendant and any spouses are listed in the same node.  Children of all "
 "of the descendant's families are grouped together."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:945
+#: DescendantSpaceTree/DescendantSpaceTree.py:946
 msgid ""
 "Persons born after a specified date may not display their birth or death "
 "dates."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:954
+#: DescendantSpaceTree/DescendantSpaceTree.py:955
 msgid ""
 "Person nodes are colored to indicate the number of children, the deeper tint "
 "of the coloring, the greater number of children."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:964
+#: DescendantSpaceTree/DescendantSpaceTree.py:965
 msgid ""
 "The currently selected descendant and all of the ancestors of that person "
 "are highlighted in yellow."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:973
+#. Translators: Please do not translate ___NAV_BUTTON_CONTINUE___ or ___NAV_BUTTON_ALT___.
+#: DescendantSpaceTree/DescendantSpaceTree.py:975
 msgid ""
 "A person may occur in different branches.  This is usually because of inter-"
 "family marriages (such as that of cousins.)  In this case, a button will "
@@ -218,82 +220,82 @@ msgid ""
 "expand descendants of this person. "
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:987
+#: DescendantSpaceTree/DescendantSpaceTree.py:989
 msgid ""
 "The following open source projects are used in building this viewer, see "
 "source code LICENSE*.txt files for complete licenses and required notices."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1014
+#: DescendantSpaceTree/DescendantSpaceTree.py:1016
 msgid "Search. . ."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1070
+#: DescendantSpaceTree/DescendantSpaceTree.py:1072
 msgid "Report Options"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1074
+#: DescendantSpaceTree/DescendantSpaceTree.py:1076
 msgid "Center Person"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1075
+#: DescendantSpaceTree/DescendantSpaceTree.py:1077
 msgid "The center person for the report"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1080
+#: DescendantSpaceTree/DescendantSpaceTree.py:1082
 msgid "Include Generations"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1083
+#: DescendantSpaceTree/DescendantSpaceTree.py:1085
 msgid "The number of generations to include in the report"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1089
+#: DescendantSpaceTree/DescendantSpaceTree.py:1091
 msgid "Branch to expand when duplicated"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1100
+#: DescendantSpaceTree/DescendantSpaceTree.py:1102
 msgid ""
 "When a descendant appears more than once, prefer the selected lineage to "
 "expand descendancy line"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1108
+#: DescendantSpaceTree/DescendantSpaceTree.py:1110
 msgid "Maximum display birth year"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1111
+#: DescendantSpaceTree/DescendantSpaceTree.py:1113
 msgid "Birth/death dates will not be displayed after this year"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1116
+#: DescendantSpaceTree/DescendantSpaceTree.py:1118
 msgid "Theme preference"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1123
+#: DescendantSpaceTree/DescendantSpaceTree.py:1125
 msgid "Theme color preference for Space Tree"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1128
+#: DescendantSpaceTree/DescendantSpaceTree.py:1130
 msgid "Destination"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1130
+#: DescendantSpaceTree/DescendantSpaceTree.py:1132
 msgid "The destination path for generated files."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1136
+#: DescendantSpaceTree/DescendantSpaceTree.py:1138
 msgid "Destination File"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1138
+#: DescendantSpaceTree/DescendantSpaceTree.py:1140
 msgid "The destination file name for the report."
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1142
+#: DescendantSpaceTree/DescendantSpaceTree.py:1144
 msgid "Open with default viewer"
 msgstr ""
 
-#: DescendantSpaceTree/DescendantSpaceTree.py:1144
+#: DescendantSpaceTree/DescendantSpaceTree.py:1146
 msgid "Open generated HTML file with default browser."
 msgstr ""

make.py

@@ -403,7 +403,7 @@ def register(ptype, **kwargs):
             fnames = " ".join(glob.glob(f"{addon}/*.py"))
             system(
                 f"xgettext --language=Python --keyword=_ --keyword=N_"
-                f" --from-code=UTF-8"
+                f" --from-code=UTF-8 --add-comments=Translators"
                 f' -o "{addon}/po/template.pot" {fnames} '
             )
             fnames = " ".join(glob.glob("%s/*.glade" % addon))