Jump to: navigation, search


2,099 bytes added, 23:03, 17 September 2018
no edit summary
Place Cleanup Gramplet
== 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.
[[File:PlaceCleanupPref.png|thumb|right|44px|Place Cleanup Preferences]]
The Gramplet Preferences is accessed via the Preferences button (located in the top right of the main view of the Gramplet, next to the Title field). The button should appear as shown to the right.
 The preferences dialog has the following settings:
* {{man label|Keep Web Links}} checkbox. The GeoNames database contains various URL links to other web data, associated with each place. For example, many places have a Wikipedia link. If you check this setting, the Gramplet will save these web links with the place data. They will appear in the 'Internet' tab of the Place Edit dialog.
* {{man label|Add citation and source to Place}} checkbox. If you check this setting, a Citation will be added to each place, citing the 'GeoNames' Source and Repository, with the Citation having a 'Volume/Page:' value with the GeoNames ID number. There will be a Citation for each Place, but only a single Source and Repository.
* {{man label|GeoNames User ID}} field. This contains the necessary GeoNames user ID. You can sign up for the ID at the following link: [|].
* {{man label|Alternative Names Languages to keep}} field. This contains a space separated list of the ISO-639 2-letter language code; (en,de,fr,it,es,...). As you work with the Gramplet, you will see a list of alternate names available for most places, with the language code for the names. If you want these names automatically checked off for inclusion in your Gramps place, add the code to this field.
* Currently Enclosed Places. When you use the {{man button|Ok}} button after selecting a GeoNames place, the Gramplet may have to deal with a place enclosure. If you are modifying a current place, and your place is already 'Enclosed by' another place the Gramplet has two choices on how to handle changes to the enclosure.
** {{man label|Keep current Enclosure}} selector. If you select this setting, and your place is already 'Enclosed by' another place, then no changes to the 'Enclosed by' place value will be made, even if your current enclosing place differs from that provided by the GeoNames data.
**: If there is no 'Enclosed by' place value, and the GeoNames data has an enclosing place, then one will be created, and selected for approval.
** {{man label|Replace with GeoNames Enclosure}} selector. If you select this setting, and your place is already 'Enclosed by' another place, then the current enclosure is replaced by the enclosing place from the GeoNames data. If it did not exist before this, it will then be created, and selected for approval.
**: While this ensures that the enclosure matches GeoNames, it is possible that the previous enclosing place will no longer be used, and will remain in your database.
== Main view ==
The Main view has several buttons, a 'Title' field, a small 'xx Matches' status, and a 'Choices' or match results list.
* {{man label|Title}} field. This field shows the Place that is currently under investigation. It provides the search terms that are used for finding a place. It changes automatically to the place title when the Gramps Place view has an active selection. The field can also be modified by the user, just set the cursor in it and edit as normal. This is generally only needed when trying to find a place in GeoNames that might have unexpected abbreviations, or historical hierarchy or other issues which can make finding a match in the GeoNames database difficult.{{man note|NOTE|Changing the Title field should be done with some caution. The places found will depend on the contents of this field. If you change in inappropriate ways, you could end up with incorrect place data. For Example, if the original place is "Paris, France", and you change the field to "Berlin, Germany", when you find and accept the Berlin place, your original place will get changed to Berlin.}}
* {{man label|Matches}} status. This small status block is located on the left side of the Gramplet, just below the 'Title' label. It indicates the number of matching places found when searching the local Places list or the GeoNames database. The status also indicates where the matches were found, either 'Local', or 'GeoNames'.
* {{man label|Choices}} list. This area lists the found matches. The user should select the correct match for the place under investigation, and either press the {{man button|Select}} or double-click, press 'Enter' or 'Space' to move to the result/edit screen.
* {{man button|Help}} button. This brings up this web page.
* {{man button|Find}} button. This performs a search for the place indicated in the {{man label|Title}} field. The search is performed in two stages.
* {{man button|Select}} button. After the user selects one of the matches in the 'Choices' list, this causes the result/edit screen to be shown.
* {{man button|Edit}} button. If no suitable places are found, the user can use this to advance directly to the result/edit screen. This can occur if the place you are searching for is too detailed, for example 'My Estate, Paris, TX' or '123 Mains St., Paris, TX'. Since such detailed information is not going to be found in the GeoNames search, you have to edit it manually.
* {{man button|Next Place}} button. This causes the Gramplet to advance to the next incomplete Place in the Gramps Places list. Incomplete places are missing any of the Latitude/Longitude or Place Type data. If a place is found that is not used by any Event or encloses another place, you will get a dialog popup message suggesting that the place be deleted.
== Result/Edit view ==
[[File:PlaceCleanupRes.png|thumb|right|550px|Place Cleanup Result View]]
* {{man button|Discard}} button. If one or more of the places in the names list is selected, pressing this button will cause the associated names to be unmarked so they will not be included in the final Place alternative names list.
* {{man button|Cancel}} button. Pressing this button returns the view to the main search view. No changes are saved.
* {{man button|OKOk}} 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.
== Faq ==

Navigation menu