Changes

Jump to: navigation, search

Addon:PlaceCleanupGramplet

518 bytes added, 04:42, 21 July 2020
rewrite about 25% done
{{Third-party plugin}}
{{man note|Released for Gramps 5.x + versions}}
[[File:PlaceCleanupMain.png|thumb|right|450px350px|Place Cleanup Gramplet]]The '''Place Cleanup Gramplet'''is an add-on that uses the WebServices feature from the [https://www.geonames.org/about.html GeoNames.org geographical database] to lookup as many as 2,000 placenames per day. Selected parts of the validated information can then be pushed into Gramps to correct and improve incomplete [[Gramps_Glossary#place|Place]] records.  = Purpose of this Gramplet =This was written to assist in cleaning up '''already existing''' places. You ''can'' use it while adding a new place, but the place must be created with the normal Gramps {{man labelmenu|Add -> Place Cleanup Gramplet}} assist and select the new place in the top window prior to using the Gramplet. When starting with GEDCOM imported trees, the Places that are created are often incomplete or simply don't take full advantage of Gramps features. The place names and/or titles are often left with strings of comma separated names.  Even when transcribing events from census or other sources, Place data might have be ambiguous about which adminstrative area enclosed a locality and were, in cleaning turn, enclosed. Sometimes, Places may have been entered with the proper enclosure hierarchy... but without the Latitude/Longitude coordinates needed to plot Events on the maps of the Gramps Geography view. Rather than intefere the flow of data or research workflow to validate each Place, it can be more efficient to come back to handle these deficiencies collectively. Cleaning up these shortfalls previously required a lot of manual work to clean up . The Gramplet assists in merging new places with already existing present places; when you do a search, if the Place you are looking for is located elsewhere in your Gramps database, and is completed, then you can merge your current place with the completed place.  The Gramplet makes use of the GeoNames database via the internet web to get information to fill out the Places.{{man warn|1=Warning: Automated records updates are risky!|2= As always, back up your current tree BEFORE using any tool that automates data entry or editting. While it is usually possible to Undo changes individually within a session, you may decide that you need to restart from an earlier state.<br/>See [[How to make a backup|make a Gramps XML backup]]}}
See [[Addon:PlaceCleanupGramplet#Purpose_of_this_Gramplet|Purpose of this Gramplet]]
=Usage=
== Installing the Place Cleanup Gramplet ==
* {{man button|Cancel}} button. Pressing this button returns the view to the main search view. No changes are saved.
* {{man button|Ok}} button. Pressing this modifies the selected place with the new values. In addition, the next level of the place hierarchy will be set into the place. If that next level is already present in the local Gramps place list, and has a matching GeoNames ID, the modifications are completed. If not, the next level in the place hierarchy is shown in the results view.
 
= Purpose of this Gramplet =
This was written to assist in cleaning up '''already existing''' places. You can use it for a new place, but the place must be created with the normal Gramps {{man menu|Add ->Place}} and select the new place in the top window prior to using the Gramplet.
 
Often when starting with GEDCOM imported trees, or when adding events from census or other sources, the Places that are created are not fully filled in with Latitude/Longitude and Enclosure information. The place names and/or titles are often left with strings of comma separated names that previously required a lot of manual work to clean it up.
 
In other cases, Places may have been entered with proper enclosure hierarchy, but without the Latitude/Longitude needed to show up on Gramps Maps.
 
The Gramplet assists in merging new places with already present places; when you do a search, if the Place you are looking for is located elsewhere in your Gramps database, and is completed, then you can merge your current place with the completed place.
 
The Gramplet makes use of the GeoNames database via the web to get information to fill out the Places.
{{man warn|1=Warning: As always, Back up you current tree BEFORE using this tool.
See [[How to make a backup|make a Gramps XML backup]]|2= While it is possible to Undo changes individually, at least within a session, you may decide that you need to restart from an earlier state.}}
 
= FAQ =
I have included a French translation of the tool, mostly as a test of the internationalization code. Since I don't speak French (USA Texas version of English only), please excuse my French.
 
[[Category:Places]]
[[Category:Addons]]
[[Category:Plugins]]
3,380
edits

Navigation menu