Open main menu

Gramps β

Changes

Addon:CheckPlaceTitles

1,939 bytes added, 00:47, 28 December 2024
no edit summary
{{Third-party pluginaddon}}
The {{man label|CheckPlaceTitles}} tool brings up a way for checking current place titles.
A place object needs a name. Title is the legacy content and the top label on Place Editor.
We can let gramps managing the title according our preferences and data : a dynamic and smart display.
* Data migration : the legacy place title can generate confusions and empty place title should be the default designwith auto-title enabled.
==The tool==
[[File:Checkpt_columns_fr.png|thumb|right|450px600px|Inconsistency with titles and place name handling.]]
===The pass===
One pass will check all place objects whatever type (towncity, region, country, street, etc.) and will retrieve the current place title, which is related to our preferences set : the displayer.
So, we have :
* one legacy place title, inherited from previous database and place formatting.
* a dynamic place title, handled by gramps Gramps according to our policy, historical data, design, choices and preferences : the auto-title features.
Once a legacy title does not match current auto-title or is not empty, this can generate some frustrations
and confusions. So, this one pass tool will list entries not matchingsome place objects{{-}}
===Columns===
Two status : enable/disable auto-title on Places.
One check : <pre>hard-coded legacy place title =/= place display</pre> According to your preferences, the default selection will either check select all entries with differencesor only few(''place title == place display'').
Keep in my mind that the primary goal of the tool was to check place titles for a complete data migration (legacy title to the smart one).
Any minor difference between the legacy place title and the automatic displayed one will be detected.
[[File:Checkpt_differences_fr.png|thumb|center|200px|895 entries under 929 may be improved because of inconsistency or duplicated information.]] If you had set postal code or and an old name for a province and , state, building, etc. and now you have more consistency on place names by using place hierarchy, then the pass will return list the data. {{man note|''Seizure and importations''|Consistency with free plain text field as single place title, was a challenge. We inherited minor differences by setting textual place values without hierarchy and format features. The tool can also help us to point out some of these minor differences.}} {{-}}
==Options==
You have three options, available at the bottom :
*'''clean''' - remove legacy content for place titlestitle*'''copy''' - copy old place titles title to a new note. *'''tag''' - assign a tag and mark placesplace When the {{man button|Apply}} button is clicked, then changes or additions will be made on your selected place objects.
When the There is also an {{man button|ApplyHelp}} button is clicked, then changes will be made on your selected place objectsto see this page.
There is also a {{man button|Help-}} button to see this page.
==Examples==
{{stub}}
=== Developers In french=== [[File:Checkpt_autotitle_fr.png|450px|Autotitle enabled. You filled the place name with auto-title support (see Display item into Preferences dialog) but the tool detects a possible issue.]][[File:Checkpt_columns_fr.png|350px|checked by default.]]  [[File:Checkpt_legacy_fr.png|450px|Duplicate textual value on legacy field. You disable auto-title support and see that an hard-coded place title exists. It remains from old database model or after some importations. This field might be empty as gramps does well the job.]] [[File:Checkpt_free_title_fr.png|450px|Lazy textual place value on seizure or after an import. You have inconsistencies on place filling, the free form does not let you properly display an efficient place title, and gramps displayer does a better job.]][[File:Checkpt_DB_remain_fr.png|350px|What is the best place value? With or without auto-title and hierarchy support?]] {{-}} The tool will list possible issues, but let you select/unselect lines and use one of the options available. ==Go further== If you need advanced features, you should look at [[Addon:PlaceCleanupGramplet|Place Cleanup gramplet]]. ==See Also== * [[Addon:PlaceCleanupGramplet|Place Cleanup gramplet]]* [[GEPS_045:_Place_Model_Enhancements|GEPS 045: Place Model Enhancements]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Tools]]
15,091
edits