Update welcome gramplet

gramps/plugins/gramplet/welcomegramplet.py

@@ -1,6 +1,7 @@
 # Gramps - a GTK+/GNOME based genealogy program
 #
 # Copyright (C) 2007-2009  Douglas S. Blank <doug.blank@gmail.com>
+# Copyright (C) 2020       Dave Scheipers
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -29,6 +30,7 @@ from gi.repository import Gtk
 #
 #------------------------------------------------------------------------
 from gramps.gen.const import URL_WIKISTRING, URL_MANUAL_PAGE, URL_HOMEPAGE
+from gramps.gen.const import WIKI_EXTRAPLUGINS
 from gramps.gen.plug import Gramplet
 from gramps.gui.widgets.styledtexteditor import StyledTextEditor
 from gramps.gen.lib import StyledText, StyledTextTag, StyledTextTagType
@@ -55,7 +57,7 @@ def linkst(text, url):
     """ Return text as link styled text
     """
     tags = [StyledTextTag(StyledTextTagType.LINK, url, [(0, len(text))])]
-    return StyledText(text, tags)
+    return StyledText('  • ') + StyledText(text, tags)
 
 #------------------------------------------------------------------------
 #
@@ -100,33 +102,74 @@ class WelcomeGramplet(Gramplet):
         welcome = boldst(_('Intro')) + '\n\n'
         welcome += _(
             'Gramps is a software package designed for genealogical research.'
-            ' Although similar to other genealogical programs, Gramps offers '
+            ' Although similar to other genealogical programs, Gramps offers'
-            'some unique and powerful features.\n\n')
+            ' some unique and powerful features.\n\n')
-        welcome += boldst(_('Links')) + '\n\n'
+        welcome += linkst(_('Home Page'), URL_HOMEPAGE) + '\n\n'
-        welcome += linkst(_('Home Page'), URL_HOMEPAGE) + '\n'
-        welcome += linkst(_('Start with Genealogy and Gramps'),
-                          '%(gramps_wiki_url)sStart_with_Genealogy' %
-                          {'gramps_wiki_url': URL_WIKISTRING}) + '\n'
-        welcome += linkst(_('Gramps online manual'),
-                          URL_WIKISTRING + URL_MANUAL_PAGE +
-                          _('', 'locale_suffix')) + '\n'
-        welcome += linkst(_('Ask questions on gramps-users mailing list'),
-                          '%(gramps_home_url)scontact/' %
-                          {'gramps_home_url': URL_HOMEPAGE}) + '\n\n'
 
         welcome += boldst(_('Who makes Gramps?')) + '\n\n' + _(
             'Gramps is created by genealogists for genealogists, organized in'
-            ' the Gramps Project.'
+            ' the Gramps Project. '
-            ' Gramps is an Open Source Software package, which means you are '
+            'Gramps is an Open Source Software package, which means you are'
-            'free to make copies and distribute it to anyone you like. It\'s '
+            ' free to make copies and distribute it to anyone you like. It\'s'
-            'developed and maintained by a worldwide team of volunteers whose'
+            ' developed and maintained by a worldwide team of volunteers whose'
             ' goal is to make Gramps powerful, yet easy to use.\n\n')
+        welcome += _(
+            'There is an active community of users available on the mailing'
+            ' lists and Discourse forum to share ideas and techniques.\n\n')
+        welcome += linkst(_('Gramps online manual'),
+                          URL_WIKISTRING + URL_MANUAL_PAGE +
+                          _('locale_suffix|')) + '\n\n'
+        welcome += linkst(_('Ask questions on gramps-users mailing list'),
+                          '%(gramps_home_url)scontact/' %
+                          {'gramps_home_url': URL_HOMEPAGE}) + '\n\n'
+        welcome += linkst(_('Gramps Discourse Forum'),
+                          'https://gramps.discourse.group/') + '\n\n'
         welcome += boldst(_('Getting Started')) + '\n\n' + _(
-            'The first thing you must do is to create a new Family Tree. To '
+            'The first time Gramps is started all of the Views are blank. There'
-            'create a new Family Tree (sometimes called \'database\') select '
+            ' are very few menu options. A Family Tree is needed for any activity'
-            '"Family Trees" from the menu, pick "Manage Family Trees", press '
+            ' to happen.\n\n'
-            '"New" and name your Family Tree. For more details, please read '
+            'To create a new Family Tree (sometimes called \'database\') select'
-            'the information at the links above\n\n')
+            ' "Family Trees" from the menu, pick "Manage Family Trees", press'
+            ' "New" and name your Family Tree. "Load Family Tree" to make the'
+            ' tree active and ready to accept data by entering your first'
+            ' family, or importing a family tree. For more details, please'
+            ' read the information at the links below.\n\n')
+        welcome += linkst(_('Start with Genealogy and Gramps'),
+                          '%(gramps_wiki_url)sStart_with_Genealogy' %
+                          {'gramps_wiki_url': URL_WIKISTRING}) + '\n\n'
+        welcome += boldst(_('Enter your first Family')) + '\n\n' + _(
+            'You will now want to start entering your first Family and that'
+            ' starts with the first Person.\n\n'
+            'Switch to the "People" view and from the menu clicking "Add" and then'
+            ' clicking "Person" (or using the [+] icon) will bring up the window'
+            ' to enter a person. Entering the basic information and saving the'
+            ' record gives you a starting point. Select this Person\'s record and'
+            ' now switch to the "Relationships" view.\n\n'
+            'With this first person, all of the menu options and icon functions'
+            ' have become available. Spend some time moving your mouse over the'
+            ' icons. As your cursor passes over an icon, a message will appear'
+            ' telling you the icon\'s function. The same is true for any of the'
+            ' edit windows. Moving the mouse cursor over an item will tell you'
+            ' what it will do.\n\n'
+            'You can now create families by adding parents, a spouse and children.'
+            ' Once started, you will be able to add Events to People and Families.'
+            ' You can provide Sources and Citations to provide documentation for'
+            ' your entries.\n\n'
+            'As you start using Gramps, you will find that information can be'
+            ' entered from all the various Views. There are multiple ways of'
+            ' doing most activities in Gramps. The flexibility allows you to'
+            ' choose which fits your work style.\n\n')
+        welcome += linkst(_('Entering and editing data (brief)'),
+                          '%(gramps_wiki_url)s_-_Entering_and_editing_data:_brief' %
+                          {'gramps_wiki_url': URL_WIKISTRING + URL_MANUAL_PAGE}) + '\n\n'
+        welcome += boldst(_('Importing a Family Tree')) + '\n\n' + _(
+            'To import a Family Tree from another program first create'
+            ' a GEDCOM (or other data) file from the previous program.\n\n'
+            'Once you have created a new Gramps database file, use the "Import"'
+            ' option under the "Family Trees" menu to import the GEDCOM data.\n\n')
+        welcome += linkst(_('Import from another genealogy program'),
+                          '%(gramps_wiki_url)sImport_from_another_genealogy_program' %
+                          {'gramps_wiki_url': URL_WIKISTRING}) + '\n\n'
         welcome += boldst(_('Dashboard View')) + '\n\n' + _(
             'You are currently reading from the "Dashboard" view, where you can'
             ' add your own gramplets. You can also add gramplets to any view by'
@@ -136,8 +179,28 @@ class WelcomeGramplet(Gramplet):
             ' additional columns, while right-click on the background allows to'
             ' add gramplets. You can also drag the Properties button to'
             ' reposition the gramplet on this page, and detach the gramplet to'
-            ' float above Gramps.'
+            ' float above Gramps.')
-        )
+        welcome += '\n\n'
+        welcome += linkst(_('Gramps View Categories'),
+                          '%(gramps_wiki_url)s_-_Categories' %
+                          {'gramps_wiki_url': URL_WIKISTRING + URL_MANUAL_PAGE}) + '\n\n'
+        welcome += boldst(_('Addons and "Gramplets"')) + '\n\n' + _(
+            'There many Addons or "Gramplets" that are available to assist you'
+            ' in data entry and visualizing your family tree. Many of these tools'
+            ' are already available to you. Many more are available to download'
+            ' and install.\n\n')
+        welcome += linkst(_('Addons and "Gramplets"'),
+                          URL_WIKISTRING + WIKI_EXTRAPLUGINS) + '\n\n'
+        welcome += boldst(_('Example Database')) + '\n\n' + _(
+            'Want to see Gramps in use. Create and Import the Example database.\n\n'
+            'Create a new Family Tree as described above. Suggest that you name'
+            ' the Family Tree “EXAMPLE”.\n\n'
+            'Import the Gramps file example.gramps.\n\n'
+            'Follow the instructions for the location of the file stored with'
+            ' the Gramps program.\n\n')
+        welcome += linkst(_('Example.gramps'),
+                          '%(gramps_wiki_url)sExample.gramps' %
+                          {'gramps_wiki_url': URL_WIKISTRING}) + '\n\n'
 
         self.texteditor.set_text(welcome)
 
@@ -146,4 +209,3 @@ class WelcomeGramplet(Gramplet):
         Return True if the gramplet has data, else return False.
         """
         return True
-