15,534
edits
Changes
→Notes on User manual update
==Volunteer Website Administrator==
Manage and monitor the website (not Github)
*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
==Things to do==
===Addons===
* [[Addon:TMGimporter]] - 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** 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* [[Addon:HtreePedigreeView]] - Orphaned by Patsy LefebreOn hold
===Bug Triage===
My attempt at improving CI
* https://travis-ci.org/sam-m888/gramps - On hold
;Coverage
* https://www.codacy.com/app/manzi-sam/gramps/dashboard
* https://coveralls.io/r/sam-m888/gramps - On hold
* [[Testing Gramps]]
* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]
* {{bug|8888}} / {{bug|9042}} [Review]Gramps Help button User Manual wiki-links (On holdIn progress)
====Update for Gramps 5.0====
*Completed: 2018-01-13
Remaining images 10 image links:*(1image) 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
** Need to create KML file to recreate example
** Recreate two examples using example.gramps instead of custom family tree.
*(6images) https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Error_and_Warning_Reference
** find ways to recreate
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)
;Update and improve text to match the interface
*Started: 2018-010x-??xx
*Completed:
When I have time, issues and feature request will be created for the following if required.
<pre> ##################### As at 20180122 20190204 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )help button on when you try to run "Extract Event Description" the "Undo history warning"Select Father/Mother/Child/Events/Note/Select Media Object/Select a different person/ selectorsdialog disappears behind The "Tool Selection" dismisses dialog and does not work!(ms-windows only checked)[](Bug# )help button on "Family tree"Merge (managerpeople) dismisses dialog and does not workgrow larger when you use expand the help button forhttps://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Tools#Generate_Testcases_for_Persons_and_Familiesit disapears"Detailed Selection" section out.[](Bug# )"Books reports" "Manage Books" dialogs available items list when opened shows the end of the list first instead of the highlighted "Title Page" item entry image metadata gramplet - does not show metadata? (sitting unhelpfully just below the foldms-windows / linux )[](Bug# )"Books reports" item "statistics check why later then update user manual image with example. otherwise report" generates an error on empty databaseit.[](Bug# )pressing "helpSuppress warning about missing researcher when exporting to GEDCOM" on "Books" "Generate Book" dialog dismisses the dialog and opens help to the wrong section (non existent).https://gramps-project.org/wiki/index.phpcheckbox does not work?title=Gramps_5.0_Wiki_Manual_-_Reports#Generate_Book
[](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
[](Bug# )The "Undo history warning" dialog disappears behind the "Tool Selection" dialog when you try to run "Extract Event Description" (ms-windows only checked)for web calendar report:[]* (Bug# )need Attempting to rename load the wiki section index.html file shows a title page called "My Family Calendar" and update generated by gramps code " but no links to be "New Repository dialog" instead of "New_Repositor>ies< dialog"https://gramps-project.org/wiki/index.phpthe individual months?title=Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Repositories_dialog[]* (Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed SelectionYear at a glance" section out: fullyearlinked.[](Bug# )"Add Rule dialog" html two issuesdoes not work. clicking on a month only works and not a day as mentioned on page: * the search box does not stay "This calendar is meant to give you access to all your data at top of screen when a glance compressed into one page. Clicking on a date will take you expand to a page that shows all filters! * the events for that date, if you highlight a top level category of filterthere are any." the right hand window shows random stuff from previous filters (suggest blank area only) %%%%%%%% Help related bugs[](Bug# )[Fix user wiki - rename sections]encloses & enclosed by gramplets - help links failgoto: [](Bug# )Tool "Reorder_Gramps_ID" help link broken. https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Tools#manual|Reorder_Gramps_ID[](Bug# )Tool "Reorder_Gramps_ID" broken in alpha3 (need to check gramps50 )[](Bug# )image metadata gramplet - does not show metadata? (ms-windows / linux ) check why later then update user manual image with example. otherwise report it.[](Bug_Gramplets# )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.[](Bug# )for web calendar report:* 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?* fullyearlinked.html does not work.* on the individual month pages the "< & >" arrows are above the month name and not on either side[] See image: 2018-01-08 14_37_34-Export options-reordered-alignment issue of boxes in Export Assistant[] "Suppress warning about missing researcher when exporting to GEDCOM" checkbox does not work?[](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?Place_Enclosed_By
...........................
************Papercuts - Enhancements******************
[] (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)[]( )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 ( hae 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
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
[] 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.
[] 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: manaully type in a non existant 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 waist 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
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.
[] 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 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...)
depends_on = ["libwebconnect"]
mentioned in the following
http://gramps.1791082.n4.nabble.com/addon-importing-function-from-plugin-td3308398.html#a3308695
''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']
..............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 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 )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.0_Wiki_Manual_-_Reports_-_part_1
[] 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')
[] Godaddy Server resources issue: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! as still causing 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.
[] 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
https://gramps-project.org/wiki/index.php?title=Gramps_5.0_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.
[] 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
[] 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?
.............................................................
[] 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
.........................................................
[] 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
..........................................................................
[] 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)
..........................................................................
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) )
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=Gramps_5.0_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.
...................................................................
[](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.
...................................................................
</pre>
On wiki:
* [[Gramps Data Model]]
See also:
* [[Internationalization]]
* [[Gramps Glossary]]
= Information =
* [https://gramps-project.org/wiki/index.php?title=[Reviews#General |General Gramps Project Information]* [https://gramps-project.org/wiki/index.php?title=Website_application_upgrades Gramps Website application upgrades] - Wordpress/MantisBT/Mediawiki
[[Category:User|S]]
