Difference between revisions of "User:Sam888"

From Gramps
Jump to: navigation, search
(Notes on User manual update)
m (Downloads Result Table)
 
(186 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{man note|Current Webmaster for the Gramps Project}}
 +
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases,  building the third party addons as needed.
 +
 
==Volunteer Website Administrator==
 
==Volunteer Website Administrator==
 
Manage and monitor the website (not Github)
 
Manage and monitor the website (not Github)
Line 5: Line 8:
 
*[[.dtd_and_.rng]]
 
*[[.dtd_and_.rng]]
 
*[[Rollover for the manual]]
 
*[[Rollover for the manual]]
 +
*[[Git merge]]
 +
* https://gramps-project.org/robots.txt
 +
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
 +
===Wordpress(Blog)===
 +
* Convert existing Gramps theme to use a more modern mobile aware template that comes with WordPress.
 +
===MantisBT(Bug tracker)===
 +
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!
 +
 +
===Mediawiki(Wiki)===
 +
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS]  ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
 +
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
 +
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ
 +
 +
* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]
 +
 +
* [[MediaWiki:Common.css]]
 +
 +
* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]]
 +
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
 +
* [[Talk:Gramplets]] renaming suggestion
 +
 +
====Extensions====
 +
=====Existing extensions=====
 +
======Extension:ConfirmAccount======
 +
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
 +
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): "  section and a confirmed email address for final account creation)
 +
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
 +
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
 +
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
 +
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
 +
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes
 +
 +
<!--
 +
Submitting the form on the wiki shows the following message:
 +
 +
Your account request has been sent and is now pending review. A confirmation email has been sent to your email address.
 +
 +
-
 +
Email shows the following:
 +
 +
 +
Subject: "Gramps email address confirmation"
 +
Message:
 +
 +
Someone, probably you from IP address XXX.XXX.XXX.XXX, has requested an account "Testuser2" with this email address on Gramps.
 +
 +
To confirm that this account really does belong to you on Gramps, open this link in your browser:
 +
 +
https://gramps-project.org/wiki/index.php?title=Special:RequestAccount&action=confirmemail&wpEmailToken=00000000000000000000000000000000
 +
 +
If the account is created, only you will be emailed the password.
 +
If this is *not* you, do not follow the link.
 +
This confirmation code will expire at 2021-12-13T22:06:28.
 +
-
 +
 +
Confirming the link will show the following wiki message:
 +
 +
Your email address has been confirmed and will be listed as such in your account request.
 +
 +
-
 +
Then the webmaster gets the following email:
 +
 +
-
 +
 +
 +
Subject: "Gramps account request"
 +
 +
Testuser2 has requested an account and is waiting for confirmation.
 +
The email address has been confirmed. You can confirm the request here:
 +
 +
https://gramps-project.org/wiki/index.php/Special:ConfirmAccounts
 +
 +
-
 +
I login and confirm as best I can that it is a real person, generally in 99 percent of request the person mentions something about genealogy or the Gramps program or has a question, spam account are rejected as very obvious as they have urls to spammy websites!
 +
-->
 +
* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc
 +
 +
{{-}}
 +
 +
=====Language Related extensions=====
 +
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
 +
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
 +
=====Requested Extensions=====
 +
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
 +
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code &amp; open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )
 +
 +
===Mailing lists===
 +
===== Sourceforge mailing list =====
 +
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the  [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format]  (Since 2019/11/08)
 +
* gramps-announce
 +
* gramps-bugs
 +
* gramps-devel
 +
* gramps-users
 +
 +
===Forum===
 +
 +
==== Discourse ====
 +
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)
 +
 +
* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]
 +
 +
===== Discourse Trial =====
 +
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
 +
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
 +
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
 +
* [x] Invite people to trial?
 +
====== Migration from sourceforge mailing list ======
 +
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
 +
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
 +
** [x] gramps-announce
 +
** [x] gramps-bugs
 +
** [x] gramps-devel
 +
** [x] gramps-users
 +
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
 +
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
 +
* [ ] create a discourse backup file and
 +
* [ ] contact the discourse support team to restore the discourse backup file.
  
 
==Things to do==
 
==Things to do==
 
===Addons===
 
===Addons===
* [[Addon:TMGimporter]] - On hold
+
* [[Addon:TMGimporter]] - On hold - Abandoned for now.
 
** [[User:Sam888/TMG|TMG Notes]] - On hold
 
** [[User:Sam888/TMG|TMG Notes]] - On hold
 
* [[Addon:Prerequisites Checker Gramplet]] [https://github.com/gramps-project/addons-source/pull/109 PR109] - On hold
 
* [[Addon:Prerequisites Checker Gramplet]] [https://github.com/gramps-project/addons-source/pull/109 PR109] - On hold
** Backport to older Gramps versions - On hold
 
 
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold
 
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold
  
 
===Bug Triage===
 
===Bug Triage===
Unofficial bug triager.
+
Unofficial [[Bug triage|bug triager]].
  
 
Cleanup Started: 201409 Completed 20150523 with life in between...
 
Cleanup Started: 201409 Completed 20150523 with life in between...
Line 21: Line 140:
 
Gramps Bugtracker:  
 
Gramps Bugtracker:  
 
https://gramps-project.org/bugs/
 
https://gramps-project.org/bugs/
 +
 +
<!--
 +
====Idea Bug Triage day/week====
 +
**Draft** (using kill arch bugs day as a guide)
 +
 +
Subject: Clean up Gramps Bugs: Help us on the xx of xxx!
 +
 +
If any of you have some spare time this weekend, I need some extra hands with triaging the bug tracker.
 +
 +
I'd like to hold a bug wrangling day on the xx of xxx to check open issues. If you cannot take part on the bug wrangling day, then feel free to help us any time before that event.
 +
 +
How?
 +
 +
Please review all bugs that were reported by you and check if they are still valid. (detail how)
 +
 +
Please request a bug closure on the bug tracker if the bug may be closed as resolved in the current version of Gramps. Otherwise please provide further information so that we can continue to work on the bug. We cannot fix bugs without your feedback.
 +
 +
Questions?
 +
 +
Join us at discourse forum (link to discussion for day) during xx of xxx. As we live in different timezones not all developers and bug wranglers will be available at the same time, but feel free to report your issues to any developers available.
 +
 +
Also please check your mailboxes that may contain notifications about comments made on your tickets.
 +
 +
 +
[ ] Decide date.
 +
[ ] send out email.
 +
 +
 +
-->
  
 
===CI Test===
 
===CI Test===
My attempt at improving CI
+
Improving CI
  
 
* https://travis-ci.org/sam-m888/gramps  - On hold
 
* https://travis-ci.org/sam-m888/gramps  - On hold
  
 
;Coverage
 
;Coverage
* https://www.codacy.com/app/manzi-sam/gramps/dashboard
+
* https://app.codacy.com/manual/gramps-project/gramps/dashboard
* https://coveralls.io/r/sam-m888/gramps  - On hold
 
  
 
* [[Testing Gramps]]
 
* [[Testing Gramps]]
Line 42: Line 189:
 
* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]
 
* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]
  
* {{bug|8888}} / {{bug|9042}} [Review]Gramps Help button User Manual wiki-links (In progress)
+
* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)
  
====Update for Gramps 5.0====
+
====Update for Gramps 5.1====
Gramps 5.0 [[User manual]]
+
Gramps 5.1 [[User manual translations]]
 +
 
 +
Ensure that any new functionality is covered by user documentation.
  
 
;Update (almost) all images:
 
;Update (almost) all images:
*Started: 2017-12-13
+
*Started: 2019-0x-xx
*Completed: 2018-01-13
+
*Completed:  
  
 
Remaining 10 image links:
 
Remaining 10 image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Categories#All_known_places_for_one_person_with_graphical_information_.28KML_files.29
+
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Categories#All_known_places_for_one_person_with_graphical_information_.28KML_files.29
 
** Need to create KML file to recreate example
 
** Need to create KML file to recreate example
*(2 images) https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Reports_-_part_4#Examples
+
*(2 images) https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Examples
 
** Recreate two examples using example.gramps instead of custom family tree.
 
** Recreate two examples using example.gramps instead of custom family tree.
*(6 images) https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Error_and_Warning_Reference
+
*(6 images) https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Error_and_Warning_Reference
 
** find ways to recreate
 
** find ways to recreate
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_About
+
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_About
 
** Update About Screen with released version (instead of alpha)
 
** Update About Screen with released version (instead of alpha)
  
  
 
;Update and improve text to match the interface
 
;Update and improve text to match the interface
*Started: 2018-0x-xx
+
*Started: 2019-0x-xx
 
*Completed:  
 
*Completed:  
  
Line 69: Line 218:
  
 
=====Notes on User manual update=====
 
=====Notes on User manual update=====
Notes on various regressions, papercuts and annoyances noticed during the user manual update.
+
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.
  
 
When I have time, issues and feature request will be created for the following if required.
 
When I have time, issues and feature request will be created for the following if required.
 +
 +
* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual
 +
 
<pre>
 
<pre>
#################### As at 20190204 #################
+
#################### As at 20200729 #################
 
************Bugs**************************************
 
************Bugs**************************************
 
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
 
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
 
[](Bug# )when you try to run "Extract Event Description" the "Undo history warning" dialog disappears behind The "Tool Selection" dialog (ms-windows only checked)
 
[](Bug# )when you try to run "Extract Event Description" the "Undo history warning" dialog disappears behind The "Tool Selection" dialog (ms-windows only checked)
 
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.
 
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.
[](Bug# )image metadata gramplet - does not show metadata? (ms-windows / linux ) check why later then update user manual image with example. otherwise report it.
 
[] "Suppress warning about missing researcher when exporting to GEDCOM" checkbox does not work?
 
[](Bug# )pedigree chart view - two charts look wrong compared to 4.2.6 check later(need to check again) -
 
  * vertical and down
 
  * vertical and up
 
[]( )for web calendar report:
 
* (Bug#)Attempting to load the index.html file shows a title page called "My Family Calendar" and generated by gramps" but no links to the individual months?
 
* (Bug#)"Year at a glance": fullyearlinked.html  does not work. clicking on a month only works and not a day as mentioned on page:
 
"This calendar is meant to give you access to all your data at a glance compressed into one page. Clicking on a date will take you to a page that shows all the events for that date, if there are any."
 
  
 
%%%%%%%% Help related bugs
 
%%%%%%%% Help related bugs
[](Bug# )[Fix user wiki - rename sections]encloses & enclosed by gramplets - help links goto:
+
[](Bug# )Encloses & Enclosed by gramplets - Fix user wiki - rename sections for help links to goto:
  
https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Gramplets#Place_Enclosed_By
+
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Gramplets#Place_Enclosed_By
  
https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Gramplets#Place_Encloses
+
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Gramplets#Place_Encloses
  
...........................
 
 
************Papercuts - Enhancements******************
 
************Papercuts - Enhancements******************
 +
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
 +
[] context menu's (right click) add an entry for "Help" at the bottom of each?
 +
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
 +
    [] Dashboard Category (grampletview)  ( gramps/gui/widgets/grampletpane.py : def _button_press( )
 +
        [] Also show context menu ###>>> when no database is loaded! <<<###
 +
          See https://gramps-project.org/bugs/view.php?id=10594
 +
    [] Chart Category views
 +
            [] 2 way fan chart
 +
            [] fan chart (ancestors)
 +
            [] descendant fan chart
 +
    [] Each of the "list" & "grouped list" views
 +
            [] Relationships Category view
 +
                    [] Nick Halls new "Combined View" for Relationships Category
 +
            [] Families Category view
 +
            [] Events View
 +
            [] Citations List View
 +
            [] Repository List View
 +
            [] Media List View
 +
            [] Notes List View
 +
            [] People Category
 +
                [] Tree View - Grouped People
 +
                [] Tree View - People List View
 +
            [] Places Category
 +
                [] Places List View
 +
                [] Places Tree View
 +
            [] Sources Category
 +
                [] Citation Tree View
 +
                [] Sources List View
 +
    [] Geography views
 +
        [] All known places
 +
        [] All known places for one Family
 +
        [] Have they been able to meet ?
 +
        [] All places related to Events
 +
        [] All known places for one Person
 +
            [] All known places for one person with graphical information (KML files)
 +
        [] Every residence or move for a person and any descendants
 +
        [] Have these two families been able to meet ?
 +
    [] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
 +
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
 
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
 
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
 
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)
 
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)
[]( )for web calendar report:
+
 
* (feature)on the individual month pages the "< & >" arrows are above the month name and not on either side
 
[](Feature/Bug# )edit preferences "base path for media" "{GRAMPS_RESOURCES}/example/gramps" setting "{GRAMPS_RESOURCES}" from the example.gramps does not work on MS_Windows! How about Apple Mac?
 
 
[] (Bug#) dashboard - order of default Gramplets is different on ms-windows  versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)
 
[] (Bug#) dashboard - order of default Gramplets is different on ms-windows  versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)
 +
 
[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory  "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ]  eg:  Gtk.FileChooser.set_current_folder()
 
[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory  "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ]  eg:  Gtk.FileChooser.set_current_folder()
 
see recent issue where user overwrote report_settings.xml with a report on Macosx!
 
see recent issue where user overwrote report_settings.xml with a report on Macosx!
 +
 
[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory"  (see recent difficulty with finding user directory  
 
[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory"  (see recent difficulty with finding user directory  
 
https://gramps-project.org/bugs/view.php?id=10370
 
https://gramps-project.org/bugs/view.php?id=10370
[] For "Paper_Options" if the user is not in [Myanmar, Liberia, or the United States] and comes from a country that uses metric set paper to A4 automatically!
 
https://gramps-project.org/bugs/view.php?id=1703
 
https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Reports_-_part_4#Paper_Options
 
  
'''The International System of Units has been adopted as the official system of weights and measures by all nations in the world except for Myanmar, Liberia, and the United States, while the United States is the only industrialised country where the metric system is not the predominant system of units.'''
 
https://en.wikipedia.org/wiki/Metric_system#International_System_of_Units
 
 
[] text reports - Place Report  - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)
 
[] text reports - Place Report  - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)
[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum.
+
 
 +
[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )
 +
 
 
[] For each report determine what the optimal page settings are and use them as defaults
 
[] For each report determine what the optimal page settings are and use them as defaults
 +
 
[] for each report be able to have separate settings per report for the page settings!
 
[] for each report be able to have separate settings per report for the page settings!
 +
 
[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference.  and it's missing an actual summary of other information eg citation/repository's it can provide more information
 
[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference.  and it's missing an actual summary of other information eg citation/repository's it can provide more information
 +
 
[] text reports - "Records Report" is not very useful as it does not name the "Family Tree"  or the date produced
 
[] text reports - "Records Report" is not very useful as it does not name the "Family Tree"  or the date produced
 +
 
[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)
 
[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)
[] context menu's (right click) add an entry for "Help" at the bottom of each?
+
 
[] how do we get text under icons on the toolbar? (for usability)
 
 
[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list   
 
[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list   
 +
 
[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?
 
[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?
[] Tool Selection dialog - needs help button
+
 
 +
[] Tool Selection dialog - needs help button  
 +
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog
 +
 
 +
[] Report Selection dialog - needs help button
 +
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog
 +
 
 
[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.
 
[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.
 +
 
[] "Books reports"  dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)
 
[] "Books reports"  dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)
[] "Select a Map Service" button list does not indicate which one has been selected. (have a radio button next to it?)
+
 
 
[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent  Family Tree"
 
[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent  Family Tree"
 +
 
[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?
 
[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?
 +
 
[] No Menu option to add/delete/restore a Gramplet is available.
 
[] No Menu option to add/delete/restore a Gramplet is available.
 +
 
[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.
 
[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.
 +
 
[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ?  ctl plus / minus?  [SM- ok: ctl + n = next category / ctl + p = previous category]
 
[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ?  ctl plus / minus?  [SM- ok: ctl + n = next category / ctl + p = previous category]
 +
 
[] age on date gramplett - awkward wording on the resulting "quick view"
 
[] age on date gramplett - awkward wording on the resulting "quick view"
 +
 
[] "Family Tree Manager" for the status column the status icons need tooltips or just use words
 
[] "Family Tree Manager" for the status column the status icons need tooltips or just use words
 +
 
[] Sort Events tool has no feedback on completion!
 
[] Sort Events tool has no feedback on completion!
 +
 
[] narweb spelling of the tab "Html options" should be "HTML Options" to keep it consistent.
 
[] narweb spelling of the tab "Html options" should be "HTML Options" to keep it consistent.
 +
 
[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!
 
[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!
[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing!  eg: manaully type in a non existant file path and run the report.
+
 
 +
[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing!  eg: manually type in a non existent file path and run the report.
  
 
@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
 
@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
 
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!
 
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!
[] Note that page 20 ( Gramps_5.0_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.0_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)
+
 
[] add documentation section about "Active Person"  / " Home Person"  to user manual
+
[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)
 +
 
 
[] geography view rename:
 
[] geography view rename:
 
* "The map" tab to "Map Common"
 
* "The map" tab to "Map Common"
 
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.
 
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.
 +
 
[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?
 
[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?
  
 
prcully>>(Almost) Anything is possible ;-)...  I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor.  And then finally change active to new whatever.  Probably only four lines of code for each editor.
 
prcully>>(Almost) Anything is possible ;-)...  I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor.  And then finally change active to new whatever.  Probably only four lines of code for each editor.
 +
 +
..........................
 +
Mentioned by others:
 +
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/
 +
 +
.................................................................................................
 
[] for addon prerequistes have a look at converting them to use "depends_on = "  like in the following addons
 
[] for addon prerequistes have a look at converting them to use "depends_on = "  like in the following addons
 
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
 
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
 
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=
 
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=
  
which can be a comma separated list for multiple depencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilites...)
+
which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)
  
 
depends_on = ["libwebconnect"]
 
depends_on = ["libwebconnect"]
  
 
mentioned in the following
 
mentioned in the following
http://gramps.1791082.n4.nabble.com/addon-importing-function-from-plugin-td3308398.html#a3308695
+
https://sourceforge.net/p/gramps/mailman/message/27070037/
 
''In your gpr file, you can have a line like:
 
''In your gpr file, you can have a line like:
  
Line 178: Line 385:
 
Cannot resolve the following plugin dependencies:
 
Cannot resolve the following plugin dependencies:
 
   Plugin 'UK Web Connect Pack' requires: ['libwebconnect']
 
   Plugin 'UK Web Connect Pack' requires: ['libwebconnect']
 +
 +
[](feature)  For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.
  
 
..............Unsorted................................
 
..............Unsorted................................
 
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)
 
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)
[] '''Configuration Files''' Add advanced apendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup?  also ( recent-files-gramps.xml )   
+
 
 +
[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup?  also ( recent-files-gramps.xml )   
 
see:
 
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Reports_-_part_1
+
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
 
Report Settings
 
Report Settings
 
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.  
 
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.  
[] update url's from http to https where possible eg:  gramps/gen/config.py see:
+
 
register('behavior.web-search-url', 'http://google.com/#&q=%(text)s')
+
############## Website admin ####################################
[] Godaddy Server resources issue: Appdata images!
+
[] A2 Hosting Server resources seem ok: Appdata images!  
 
https://gramps-project.org/wiki/index.php?title=Category:AppData
 
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! as still causing code:500 server errors)
+
(Consider another location eg github! )
...........................
+
(Was: Godaddy Server resources issue that caused code:500 server errors )
-----------------------------------
+
 
 
############## Addons #################
 
############## Addons #################
 
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream  (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list)  / also report defaults to png but is able to output svg according to the wiki help page.
 
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream  (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list)  / also report defaults to png but is able to output svg according to the wiki help page.
[] for Graphview addon change defaults to show at least 3 generations of ancestors and reduce the descendants to 7
+
 
[] "Birthdays Gramplet Gramplet"  repeated in title
 
 
[] PedigreeChart help url addon goes to
 
[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Reports#Pedigree_Chart
+
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
 
instead of:
 
instead of:
 
https://gramps-project.org/wiki/index.php?title=PedigreeChart
 
https://gramps-project.org/wiki/index.php?title=PedigreeChart
 +
 
[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.
 
[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.
[] editexifmetadata addon may not work (checked on windows)
+
 
[ ] "Date Calculator Gramplet" issue with the entry fields being collapsed and you need to expand and detach the addon.  Instruction Text does wrap in entry fields.
 
...........................................................
 
[] Add help url to context menu'same
 
    [] dashboard (grampletview)  when no database is loaded especially!  be able to popup context menu showing "About Dashboard"
 
    good reason why is issue https://gramps-project.org/bugs/view.php?id=10594
 
    [] each of the seven(7) geography views
 
    [] chart views
 
            [] pedigree view
 
            [] 2 way fan chart
 
            [] fan chart (ancestors)
 
            [] descendant fan chart
 
    [] each of the "list" & "grouped list" views"
 
            [] when empty
 
    [] add gramplet dropdown for each sidebar & bottombar
 
    [] category drop down under navigator?
 
 
.............................................................
 
.............................................................
 
[] htree - cherry-pick changes to addon-source master
 
[] htree - cherry-pick changes to addon-source master
[] for the following addons, add a context menu entry for "About: Addon name"
+
 
        [x] htree  (TODO[]change name to ancestor grid?)
 
        [x] Timeline pedigreeview
 
        [x] graph view
 
        [x] quilt view
 
 
[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
 
[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
 
.............................................................
 
.............................................................
Line 231: Line 422:
 
(gramps.exe:6340): Gtk-WARNING **: Can't set a parent on widget which has a parent
 
(gramps.exe:6340): Gtk-WARNING **: Can't set a parent on widget which has a parent
 
.........................................................
 
.........................................................
[] denominoviso - still creates report but show the following:
 
 
2018-02-24 13:40:48.275: WARNING: _enumeratedlist.py: line 143: Value 'Publishable' not found for option 'Source reference attribute'
 
2018-02-24 13:40:48.275: WARNING: _enumeratedlist.py: line 144: Valid values: []
 
2018-02-24 13:40:48.290: WARNING: _enumeratedlist.py: line 143: Value 'Publishable' not found for option 'Source reference attribute'
 
2018-02-24 13:40:48.290: WARNING: _enumeratedlist.py: line 144: Valid values: []
 
............................................................
 
[] calculate estimated dates:
 
 
** Only issue I could spot had nothing to do with your changes ( https://github.com/gramps-project/addons-source/pull/114 ).  When you  try to expand out the **Select** tab the result section does not fill all the space.
 
 
** If you run the older version over the database and then install the newer version you get the following when run:
 
 
166745: ERROR: grampsapp.py: line 143: Unhandled exception
 
Traceback (most recent call last):
 
  File "C:\Program Files\GrampsAIO64-5.0.0-alpha3\gramps\gui\plug\_windows.py", line 805, in on_ok_clicked
 
    self.run() # activate results tab
 
  File "C:\Users\me\Documents\gramps-test-profile\gramps\gramps50\plugins\CalculateEstimatedDates\CalculateEstimatedDates.py", line 270, in run
 
    source = self.db.get_source_from_handle(source_handle)
 
  File "C:\Program Files\GrampsAIO64-5.0.0-alpha3\gramps\plugins\db\bsddb\read.py", line 696, in get_source_from_handle
 
    return self._get_from_handle(handle, Source, self.source_map)
 
  File "C:\Program Files\GrampsAIO64-5.0.0-alpha3\gramps\plugins\db\bsddb\read.py", line 680, in _get_from_handle
 
    raise HandleError('Handle %s not found' % handle)
 
gramps.gen.errors.HandleError: Handle c140d4ef77841431905 not found
 
...........................................................................
 
[]Using Family - overview gives:
 
 
 
26568: ERROR: grampsapp.py: line 143: Unhandled exception
 
Traceback (most recent call last):
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\gui\widgets\grampletbar.py", line 532, in __add_clicked
 
    self.add_gramplet(gname)
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\gui\widgets\grampletbar.py", line 306, in add_gramplet
 
    self.dbstate, self.uistate)
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\gui\widgets\grampletpane.py", line 177, in make_requested_gramplet
 
    getattr(module, opts["content"])(gui)
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\gen\plug\_gramplet.py", line 73, in __init__
 
    self._db_changed(self.dbstate.db)
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\gen\plug\_gramplet.py", line 400, in _db_changed
 
    self.update()
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\gen\plug\_gramplet.py", line 300, in update
 
    self.update_has_data()
 
  File "C:\Users\me\Documents\gramps-test-profile\gramps\gramps50\plugins\Overview\Overview.py", line 201, in update_has_data
 
    active = self.dbstate.db.get_family_from_handle(active_handle)
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\plugins\db\bsddb\read.py", line 736, in get_family_from_handle
 
    return self._get_from_handle(handle, Family, self.family_map)
 
  File "C:\Program Files (x86)\GrampsAIO32-5.0.0-beta1\gramps\plugins\db\bsddb\read.py", line 680, in _get_from_handle
 
    raise HandleError('Handle %s not found' % handle)
 
gramps.gen.errors.HandleError: Handle  not found
 
..........................................................................
 
 
[ ] Pluginmanager (prculley)  also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
 
[ ] Pluginmanager (prculley)  also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
 
..........................................................................
 
..........................................................................
 
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)
 
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)
 +
 +
* SM another options is https://groups.io/ 
 +
* 2020 We are trialing https://gramps.discourse.group/
 
..........................................................................
 
..........................................................................
 
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
 
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
Gramplet does not work ( Needs converting from pyexiv2 to GExiv2. (Was originally included in Gramps 3 and earlier) )
+
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
 
 
    2018-04-02 10:33:07.872: WARNING: _manager.py: line 295: Plugin error (from 'editexifmetadata'): No module named 'pyexiv2'
 
 
..........................................................................
 
..........................................................................
 
https://gramps-project.org/wiki/index.php?title=Addons_Status
 
https://gramps-project.org/wiki/index.php?title=Addons_Status
 
..........................................................................
 
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes
+
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes
  
 
Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.
 
Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.
  
 
eg: from Source's attribute tab creating a new attribute.
 
eg: from Source's attribute tab creating a new attribute.
...................................................................
+
........................................................
[](feature)  For plugins/addons if prerequistes not available display a page stating why/what is missing that includes the addon description and a url to the support page.
+
[ ] Some addons when building have the following warning:
 +
 
 +
Listed:          Graph View
 +
GraphView/graphview.py:2383: warning: 'msgid' format string with unnamed arguments cannot be properly localized:
 +
                                      The translator cannot reorder the arguments.
 +
                                      Please consider using a format string with named arguments,
 +
                                      and a mapping instead of a tuple for the arguments.
 +
 
 +
For solution see:
 +
https://stackoverflow.com/questions/23405521/why-i-get-msgid-format-string-unnamed-arguments-warning-only-when-running-m
 +
 
 +
Which essentially say "To solve the problem, simply use named arguments"
 +
 
 +
my_string = "Hello %(person)s, it is %(time)s o'clock." % ({
 +
    'person':'Foo',
 +
    'time':'two'
 +
})
 +
 
 +
translated_string = "It is %(time)s o'clock, Mr. %(person)s" % ({
 +
    'person':'Foo',
 +
    'time':'two'
 +
})
 
...................................................................
 
...................................................................
 
</pre>
 
</pre>
  
 
====Reports====
 
====Reports====
 +
 +
====Create new advanced settings appendix====
 +
* https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings
  
 
=== Gramps Developer Documents ===
 
=== Gramps Developer Documents ===
Line 315: Line 481:
 
* [[Internationalization]]
 
* [[Internationalization]]
 
* [[Gramps Glossary]]
 
* [[Gramps Glossary]]
 +
 +
=== User Experience Test Plan ===
 +
* [[GEPS 034: Improve usability]]
 +
** [[Usability]]
 +
 +
* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
 +
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
 +
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
 +
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
 +
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
 +
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
 +
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha.  It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
 +
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
 +
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance.  No matter how easy or explicit the directions are that I would send to her.]
 +
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
 +
* [ ] Update the test plan for the current version of Gramps
 +
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)
 +
 +
 +
==== Check/Mention ====
 +
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
 +
* [[Calendar tools holidays]] - see if these calendars needs updating?
 +
 +
=== Gramps Downloads (since: 2001/04/21) ===
 +
 +
====Downloads Result Table====
 +
For the various Gramps program installers.
 +
 +
{| class="wikitable sortable"
 +
! #
 +
! Download Location
 +
! Gramps Version
 +
! Date Checked
 +
! Download Count
 +
! Comment
 +
|-
 +
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 5.1.5 || 2022-08-28 || 658,919 || Official ||
 +
|-
 +
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 5.1.5 || 2001-04-01 to 2022-08-01 || 1,046,818 || Official - Old site ||
 +
|-
 +
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 5.1.5 || 2005-10-01 to 2022-08-01 || 850,019 || Unofficial ||
 +
|-
 +
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 5.1.3 || 2004-01 to 2020-01 || 1,082 || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. ||
 +
|-
 +
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 5.1.3 || 20XX-0x-0x || 3450 || Repacked MS-Windows installer? ||
 +
|-
 +
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 5.1.3 || 20XX-0x-0x || 9,790 || Direct from them Downloads ||
 +
|-
 +
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 5.1.3 || 20XX-0x-0x || 3,044 || Publisher: Aaron R. Short&Ormus? ||
 +
|-
 +
| 8 || '''[http://www.download82.com/download/windows/gramps/ download82.com]''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads ||
 +
|-
 +
| 9 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 5.1.3 || 20XX-0x-0x || 9,336 || Direct downloads ||
 +
|-
 +
| 10 || '''[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads ||
 +
|-
 +
| 11 || '''[http://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 20XX-0x-0x || 6,119 || Direct downloads ||
 +
|-
 +
| 12 || '''softpedia.com''' || 5.1.3 || 2021-06-15 || 6,358 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
 +
|-
 +
| 13 || '''softpedia.com''' || 5.1.3 || 2021-06-15 || 5,587 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
 +
|-
 +
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
 +
|-
 +
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
 +
|-
 +
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
 +
|-
 +
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
 +
|-
 +
| 18 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
 +
|-
 +
| 19 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
 +
|-
 +
| 20 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
 +
<!-- | 00 || '''XXXXX''' || X.X.X || 20XX-0x-0x || 00000 || "text" || -->
 +
|-
 +
! Total || - || - || 2021-05-13 || 2,429,358 || <- Manual count ||
 +
|}
 +
 +
The Gramps Project has broken the multi-million download milestone( Total: 2,429,358 (as at 2021-05-13) ).
 +
 +
Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from
 +
 +
The shown total downloads is not an indication of the active userbase.
 +
 +
* [ ]Write up a blog post or wiki page or just leave here.
 +
* [ ]create an issue to hold the csv files.
 +
* [ ]create a Graph to plot downloads overtime.
 +
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.
 +
 +
Here is my attempt at gathering the statistics required to answer how many download to date.
 +
 +
The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet
 +
 +
 +
It is very difficult to estimate userbase as you get many different types of users
 +
 +
* One time users who download and install Gramps and find it is not for them.
 +
* Long term users.
 +
* Alot of the downloads will be for users upgrading existing installations
 +
 +
 +
Download Statistics commence from when the Gramps project started 2001/04/21.
 +
 +
A further break down of downloads is possible by (but I won't be doing that):
 +
* Supplied by project (Source code for manual installation)
 +
* Linux/OpenBSD etc
 +
** Supplied by volunteers to the project for download
 +
** Supplied by directly from the distribution website
 +
* Microsoft Windows
 +
** Supplied by volunteers to the project for download
 +
** Legacy version from portableapps.com
 +
* Apple MacOS
 +
** Supplied by volunteers to the project for download
 +
 +
====Addon downloads and popularity====
 +
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:
 +
 +
;Question: Does the Gramps project know which addons are the most popular and are download statistics available?
 +
 +
;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!
 +
 +
;Question: Why?
 +
 +
;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.
 +
 +
Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether  as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !
 +
 +
=====addon repositories=====
 +
We use two addons repositories the first is for the source code where addon developers can have access
 +
 +
https://github.com/gramps-project/addons-source
 +
 +
the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:
 +
 +
https://github.com/gramps-project/addons
  
 
= Information =
 
= Information =
 
* [[Reviews#General|General Gramps Project Information]]
 
* [[Reviews#General|General Gramps Project Information]]
 +
* [[What to do for a release]]
 +
* [[5.2 Roadmap]]
  
 
[[Category:User|S]]
 
[[Category:User|S]]

Latest revision as of 03:55, 28 August 2022

Gramps-notes.png
Current Webmaster for the Gramps Project

Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

Volunteer Website Administrator

Manage and monitor the website (not Github)

Wordpress(Blog)

  • Convert existing Gramps theme to use a more modern mobile aware template that comes with WordPress.

MantisBT(Bug tracker)

  • Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade" so a few tables may be referring to things that don't exist!

Mediawiki(Wiki)

Extensions

Existing extensions
Extension:ConfirmAccount
Extension:ConfirmAccount : Request account - page 2021/11/15 current config


Language Related extensions
Requested Extensions

Mailing lists

Sourceforge mailing list

Each of the Gramps Sourceforge mailing list are backed up regularly to the MBOX format (Since 2019/11/08)

  • gramps-announce
  • gramps-bugs
  • gramps-devel
  • gramps-users

Forum

Discourse

The Gramps Discourse Forum is backed up regularly to the Discourse XML backup format (Since 2020-01-02)

Discourse Trial

Investigate replacing the mailing list on Sourceforge and trial using Discourse at https://gramps.discourse.group/

Migration from sourceforge mailing list

Things to do

Addons

Bug Triage

Unofficial bug triager.

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker: https://gramps-project.org/bugs/


CI Test

Improving CI

Coverage

Gramps User Manual

The Gramps User manual is a mix of the following:

  • Reference manual
  • User guide
  • Tutorials (how to?)
  • 8888 / 9042 / 10919 [Review]Gramps Help button User Manual wiki-links (In progress)

Update for Gramps 5.1

Gramps 5.1 User manual translations

Ensure that any new functionality is covered by user documentation.

Update (almost) all images
  • Started: 2019-0x-xx
  • Completed:

Remaining 10 image links:


Update and improve text to match the interface
  • Started: 2019-0x-xx
  • Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

Notes on User manual update

Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )when you try to run "Extract Event Description" the "Undo history warning" dialog disappears behind The "Tool Selection" dialog (ms-windows only checked)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[](Bug# )Encloses & Enclosed by gramplets - Fix user wiki - rename sections for help links to goto:

https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Gramplets#Place_Enclosed_By

https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Gramplets#Place_Encloses

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each? 
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
    [] Dashboard Category (grampletview)  ( gramps/gui/widgets/grampletpane.py : def _button_press( )
        [] Also show context menu ###>>> when no database is loaded! <<<###
           See https://gramps-project.org/bugs/view.php?id=10594
    [] Chart Category views
            [] 2 way fan chart
            [] fan chart (ancestors)
            [] descendant fan chart
    [] Each of the "list" & "grouped list" views
            [] Relationships Category view
                    [] Nick Halls new "Combined View" for Relationships Category
            [] Families Category view
            [] Events View
            [] Citations List View
            [] Repository List View
            [] Media List View
            [] Notes List View
            [] People Category
                [] Tree View - Grouped People
                [] Tree View - People List View
            [] Places Category
                [] Places List View
                [] Places Tree View
            [] Sources Category
                [] Citation Tree View
                [] Sources List View
    [] Geography views
        [] All known places
        [] All known places for one Family
        [] Have they been able to meet ?
        [] All places related to Events
        [] All known places for one Person
            [] All known places for one person with graphical information (KML files)
        [] Every residence or move for a person and any descendants
        [] Have these two families been able to meet ?
    [] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows  versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory  "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ]  eg:  Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory"  (see recent difficulty with finding user directory 
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report  - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference.  and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree"  or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list  

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button 
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button 
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports"  dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent  Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ?  ctl plus / minus?   [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] narweb spelling of the tab "Html options" should be "HTML Options" to keep it consistent.

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing!  eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
	* "The map" tab to "Map Common"
	* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)...   I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor.  And then finally change active to new whatever.   Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = "  like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''


example output is on terminal only:

Cannot resolve the following plugin dependencies:
   Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature)  For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup?  also ( recent-files-gramps.xml )  
see:
	* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
	Report Settings
	The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted. 

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images! 
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream  (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list)  / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[] FIX Timeline pedigreeview  & htree when I select "About" from context menu.

(gramps.exe:6340): Gtk-WARNING **: Can't set a parent on widget which has a parent
.........................................................
[ ] Pluginmanager (prculley)  also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/  
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? (  https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Addons_Status
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
........................................................
[ ] Some addons when building have the following warning:

Listed:          Graph View
GraphView/graphview.py:2383: warning: 'msgid' format string with unnamed arguments cannot be properly localized:
                                      The translator cannot reorder the arguments.
                                      Please consider using a format string with named arguments,
                                      and a mapping instead of a tuple for the arguments.

For solution see:
https://stackoverflow.com/questions/23405521/why-i-get-msgid-format-string-unnamed-arguments-warning-only-when-running-m

Which essentially say "To solve the problem, simply use named arguments"

my_string = "Hello %(person)s, it is %(time)s o'clock." % ({
    'person':'Foo', 
    'time':'two'
})

translated_string = "It is %(time)s o'clock, Mr. %(person)s" % ({
    'person':'Foo', 
    'time':'two'
})
...................................................................

Reports

Create new advanced settings appendix

Gramps Developer Documents

In the sphinx format:

On wiki:

See also:

User Experience Test Plan


Check/Mention

Gramps Downloads (since: 2001/04/21)

Downloads Result Table

For the various Gramps program installers.

# Download Location Gramps Version Date Checked Download Count Comment
1 Github ([1]) 5.1.5 2022-08-28 658,919 Official
2 Sourceforge [2] 5.1.5 2001-04-01 to 2022-08-01 1,046,818 Official - Old site
3 Portableapps.com Sourceforge ([3]) 5.1.5 2005-10-01 to 2022-08-01 850,019 Unofficial
4 Debian 5.1.3 2004-01 to 2020-01 1,082 Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps.
5 chocolatey.org 5.1.3 20XX-0x-0x 3450 Repacked MS-Windows installer?
6 Majorgeeks 5.1.3 20XX-0x-0x 9,790 Direct from them Downloads
7 bytesin.com 5.1.3 20XX-0x-0x 3,044 Publisher: Aaron R. Short&Ormus?
8 download82.com 5.0.0 20XX-0x-0x 1,169 Direct downloads
9 chip.de 5.1.3 20XX-0x-0x 9,336 Direct downloads
10 computerbild.de 5.0.1 2015-04-14 - 20XX-0x-0x 8,656 Direct downloads
11 softonic.findmysoft.com 5.0.1 20XX-0x-0x 6,119 Direct downloads
12 softpedia.com 5.1.3 2021-06-15 6,358 Gramps AIO
13 softpedia.com 5.1.3 2021-06-15 5,587 Gramps AIO Portable
14 cnet.com - (Gramps-Project) 5.0.0 2021-06-16 62 Gramps for Linux
15 cnet.com - (Gramps-Project) 5.0.0 2021-06-16 176 Gramps for Unbuntu
16 cnet.com - (Gramps-Project) 5.0.0 2021-06-16 31 Gramps for Fedora
17 cnet.com - (Gramps-Project) 5.0.0 2021-06-16 675 Gramps AIO (64bit)
18 cnet.com - (Gramps-Project) 5.0.0 2021-06-16 3,197 Gramps AIO (32bit)
19 cnet.com - (Gramps-Project) 5.0.0 2021-06-16 131 Gramps for macOS
20 cnet.com - (PortableApps) 5.1.3 2021-06-16 1,748 Gramps Portable
Total - - 2021-05-13 2,429,358 <- Manual count

The Gramps Project has broken the multi-million download milestone( Total: 2,429,358 (as at 2021-05-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

  • [ ]Write up a blog post or wiki page or just leave here.
  • [ ]create an issue to hold the csv files.
  • [ ]create a Graph to plot downloads overtime.
  • [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "User Base" - is the number of people who use a particular product or service, especially one available on the Internet


It is very difficult to estimate userbase as you get many different types of users

  • One time users who download and install Gramps and find it is not for them.
  • Long term users.
  • Alot of the downloads will be for users upgrading existing installations


Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):

  • Supplied by project (Source code for manual installation)
  • Linux/OpenBSD etc
    • Supplied by volunteers to the project for download
    • Supplied by directly from the distribution website
  • Microsoft Windows
    • Supplied by volunteers to the project for download
    • Legacy version from portableapps.com
  • Apple MacOS
    • Supplied by volunteers to the project for download

Addon downloads and popularity

As a number of people have commented and or raised the issue directly with me via email here is a summary of what I know:

Question
Does the Gramps project know which addons are the most popular and are download statistics available?
Answer
Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!
Question
Why?
Answer
Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

addon repositories

We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

Information