From d585e99c5adab3377ecce55cd74e07126a5920e0 Mon Sep 17 00:00:00 2001 From: Dave Scheipers Date: Fri, 15 May 2020 13:18:28 -0400 Subject: [PATCH] Update welcome gramplet --- gramps/plugins/gramplet/welcomegramplet.py | 114 ++++++++++++++++----- 1 file changed, 88 insertions(+), 26 deletions(-) diff --git a/gramps/plugins/gramplet/welcomegramplet.py b/gramps/plugins/gramplet/welcomegramplet.py index 2abe98892..5b23611b8 100644 --- a/gramps/plugins/gramplet/welcomegramplet.py +++ b/gramps/plugins/gramplet/welcomegramplet.py @@ -1,6 +1,7 @@ # Gramps - a GTK+/GNOME based genealogy program # # Copyright (C) 2007-2009 Douglas S. Blank +# 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 ' - 'some unique and powerful features.\n\n') - welcome += boldst(_('Links')) + '\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' + ' Although similar to other genealogical programs, Gramps offers' + ' some unique and powerful features.\n\n') + welcome += linkst(_('Home Page'), URL_HOMEPAGE) + '\n\n' welcome += boldst(_('Who makes Gramps?')) + '\n\n' + _( 'Gramps is created by genealogists for genealogists, organized in' - ' the Gramps Project.' - ' Gramps is an Open Source Software package, which means you are ' - 'free to make copies and distribute it to anyone you like. It\'s ' - 'developed and maintained by a worldwide team of volunteers whose' + ' the Gramps Project. ' + 'Gramps is an Open Source Software package, which means you are' + ' free to make copies and distribute it to anyone you like. It\'s' + ' 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 ' - 'create a new Family Tree (sometimes called \'database\') select ' - '"Family Trees" from the menu, pick "Manage Family Trees", press ' - '"New" and name your Family Tree. For more details, please read ' - 'the information at the links above\n\n') + 'The first time Gramps is started all of the Views are blank. There' + ' are very few menu options. A Family Tree is needed for any activity' + ' to happen.\n\n' + 'To create a new Family Tree (sometimes called \'database\') select' + ' "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 -