Open main menu

Gramps β

Changes

Addon:PlaceCleanupGramplet/he

922 bytes added, 07:01, 1 November 2025
m
no edit summary
{{RTLPageStart}}
{{languages/he|Addon:PlaceCleanupGramplet}}{{Third-party plugin/he}}{{man note|Released for Gramps 5.x + versions}}[[File:PlaceCleanupMain.png|thumb|right|350px|Place Cleanup Gramplet]]The {{man label|Place Cleanup Gramplet}} addon 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. ( ''See '''[[GeoCodes#Filters|GeoCodes]]'''.)'' 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 menunote|Add -> Placeשוחרר עבור גרסאות גרמפס ‪5.x.x‬ ואילך}} and select the new place in the top window prior to using the Gramplet[[File:PlaceCleanupMain.png|thumb|left|350px|גרמפלט ניקוי מקומות]]
When starting with GEDCOM imported treesגרמפלט {{man label|ניקוי מקומות}} משתמש בתכונת שירותי המרשתת (WebServices) של [https://www.geonames.org/about.html מסד־הנתונים הגאוגרפי GeoNames.org] כדי לחפש עד 2, the Places that are created are often incomplete or simply don000 שמות מקומות ביום. (''למידע נוסף '''[[GeoCodes/he#מסננים|קוד גאוגרפי]]'''t take full advantage of Gramps features. The place names and) ניתן להחיל פריטים נבחרים מהמידע המאומת ישירות אל תוך גרמפס כדי לתקן ולשפר רשומות [[Gramps_Glossary/or titles are often left with strings of comma separated nameshe#מקום|מקום]] חסרות או חלקיות.
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 turn= מטרת הגרמפלט =גרמפלט זה נועד לסייע בניקוי מקומות '''שכבר קיימים''' במסד־הנתונים. ניתן להשתמש בו גם בעת יצירת מקום חדש, enclosed. Sometimesאך יש ליצור תחילה את המקום באמצעות {{man menu|הוספה ← מקום}}, 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בעת התחלה עם אילנות־יוחסין שיובאו מקובץ GEDCOM, 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 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: 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]]}}
=Usage=== Installing the Place Cleanup Gramplet ==הגרמפלט מסייע באיחוד מקומות חדשים עם מקומות שכבר קיימים במסד הנתונים של גרמפס. כאשר מחפשים מקום, אם מתגלה כי המקום כבר קיים בבסיס הנתונים ומכיל מידע מלא יותר, ניתן לאחד את הרשומות.
The Gramplet can be installed like any other Addon; see {{man label|[[5הגרמפלט שואב מידע ממסד־הנתונים של GeoNames דרך המרשתת, ומשתמש בו כדי להשלמת פרטי מקומות.1_Addons#Installing_Addons_in_Gramps|Installing Addons in Gramps]]}}
Once installed, make the Gramplet visible in the {{man labelwarn|Places}} category View and on either the {{man label1=אזהרה: עדכונים אוטומטיים הם מסוכנים!|Place Tree}} or {{man label|Places}} view (which ever you usually use)2=כרגיל, מומלץ לגבות את אילן־היוחסין לפני השימוש בכלי המעדכן או עורך נתונים באופן אוטומטי. אמנם ניתן לבטל שינויים בודדים במהלך שיח פעיל, and load the Gramplet in the bottom bar by clicking the {{man button| אך ייתכן ויהיה צורך לחזור למצב מוקדם יותר. <br />למידע נוסף [[Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#Bottombar_and_SidebarHow to make a backup/he| &or;יצירת גיבוי בקובץ גרמפס XML]]}} (''Down Arrowhead'' button also known as the '''Gramplet Bar Menu''') at the far top right of the bottombar titles, and then using the {{man button|Add a gramplet}} menu item.
=== GeoNames account prerequisite ===
[[File:GeoNamesFreeWebServices.png|thumb|right|250px|Add free WebServices at the Login screen]] The first time you attempt a search, you will be reminded to obtain and set a GeoNames user ID, which is required for use of their data. You can sign up for the ID at the following link: [http://www.geonames.org/login http://www.geonames.org/login].
The account signup requires responding to a confirmation eMail.=שימוש=== התקנת גרמפלט ניקוי מקומות ==
Just having a basic GeoNames account isn't quite enoughניתן להתקין את הגרמפלט כמו כל תוסף אחר; ראו {{man label|[[5. The Gramplet needs to access to the Web Services. Return to the login screen once you've validated your account, then enable the Free Web Services by clicking the link in the section of their login screen. It is shown in the screen capture to the right1_Addons/he#התקנת_תוספים_בגרמפס|התקנת תוספים בגרמפס]]}}.
Once you've logged into the GeoNames websiteלאחר ההתקנה, יש להציב את הגרמפלט בסוג־אב {{man label|מקומות}} – בין אם ב{{man label|מצג מדרג מקומות}} או ב{{man label|מצג מקומות}}, requests from Gramps on the same machine will be part of the same sessionלפי ההעדפה. If the session logלטעינת הגרמפלט בסרגל התחתון, יש להקיש על לחצן {{man button|[[Gramps_{{man version}}_Wiki_Manual_-in expires _Main_Window/he#סרגל_תחתון_וצד| &or you exceed the number of requests allowed in a day;]]}} (''החץ כלפי מטה'', the Gramplet will report failing to find matches for placenames being searched. If a suspiciously high number of failures occursהמכונה גם '''תפריט גרמפלטים''') בצידו הימני העליון של סרגל הגרמפלטים, try logging in againובחירה בפריט התפריט {{man button|הוספת גרמפלט}}.
Once you have an === דרישת חשבון GeoNames ===[[File:GeoNamesFreeWebServices.png|thumb|left|250px|הוספת שירותי רשת חינמיים למסך ההתחברות]]בפעם הראשונה שמנסים לבצע חיפוש, תתקבל תזכורת ליצור ולציין את מזהה משתמש (User ID) באתר GeoNames — דרישה חיונית לשימוש בנתונים שלהם. ניתן להירשם לקבלת מזהה משתמש בקישור הבא: [http://www.geonames.org/login http://www.geonames.org/login]. הליך ההרשמה מחייב קבלת אישור בדוא"ל. עם זאת, יצירת חשבון בסיסי באתר GeoNames אינה מספיקה. הגרמפלט נדרש לגישה ל־Web Services. לאחר אישור החשבון בדוא"ל, יש לשוב למסך הכניסה באתר וללחוץ על הקישור המאפשר את שירותי הרשת החינמיים (Free Web Services), כפי שמוצג בצילום המסך משמאל. לאחר הכניסה לחשבון באתר GeoNames, כל הבקשות שמגיעות מגרמפס באותו מחשב ייחשבו כחלק מאותה שיח. אם תוקף השיח יפוג או אם ייחצה מספר הבקשות המותר ליום, הגרמפלט ידווח על כישלון באיתור התאמות לשמות מקומות. אם כמות הכישלונות גבוהה בצורה מחשידה, you should set it into the Gramplet via the Preferences buttonכדאי לנסות להתחבר מחדש לאתר. לאחר יצירת מזהה משתמש, see belowיש להזינו לגרמפלט בבאמצעות לחצן ההעדפות. פרטים נוספים בהמשך.
{{-}}
== Preferences ==
== העדפות == [[File:PlaceCleanupPref.png|leftright||alt="Preferences iconסמל העדפות"]][[File:PlaceCleanupPrefDialog.png|thumb|rightleft|350px|Place Cleanup Gramplet גרמפלט ניקוי מקומות - Preferencesהעדפות]]The Gramplet Preferences is accessed via the Preferences את העדפות הגרמפלט ניתן לפתוח באמצעות לחצן {{man button |העדפות}} (located in the top right of the main view of the Grampletבחלק העליון־ימני של חלון הגרמפלט, next to the Title fieldבסמוך לשדה הכותרת). The button should appear in the far upper right of the Gramplet.
<br /><br /><br /><br /><br />
The preferences dialog has the following settingsחלון ההעדפות כולל את ההגדרות הבאות: * &#x2611;{{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|מרשתת}} בחלון העריכה של המקום. * &#x2611;{{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עמוד" עם מזהה ה־GeoNames של המקום. 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ניתן להירשם בקישור הבא: [http://www.geonames.org/login| http://www.geonames.org/login]. * {{man label|Alternative Names Languages to keepשמות שפות חלופיות להשארה}} field. This contains a space separated list of the — שדה להזנת קודי שפות (קוד בן שתי אותיות לפי תקן [https://wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639-1] 2-letter language code), המופרדים ברווחים: <code><abbr title="Englishאנגלית">en</abbr> <abbr title="Deutschגרמנית">de</abbr> <abbr title="françaisצרפתית">fr</abbr> <abbr title="Italianoעברית">he</abbr> <abbr title="איטלקית">it</abbr> <abbr title="Españolספרדית">es</abbr></code>וכן הלאה.בעת העבודה עם הגרמפלט תופיע רשימת שמות חלופיים למקום (אם קיימים), et ceteraבצירוף קוד שפת השם. As you work with the Grampletהוספת הקוד לרשימה זו תגרום לסימון אוטומטי של השם לשילוב במאגר המקומות של גרמפס. * {{man label|מקומות מוכלים נוכחיים}} — כאשר מאשרים מקום מהתוצא* == תצוגה ראשית =={{man warn|יש לנהוג בזהירות מיוחדת בעת שינוי שדה הכותרת|הנתונים שיובאו וישמשו לעדכון תצוגת המקום תלויים בתוכן שדה זה. אם משנים אותו באופן בלתי־מדויק, ייתכן שמידע על מקום שגוי ייקשר לרשומה הנוכחית. <br />לדוגמה, אם הרשומה הפעילה בתצוגת המקומות היא "Berlín, Usulután", והוזנה ידנית כותרת מקום כמו "Berlin, you will see a list of alternate names available for most placesGermany", with the language code for the namesולאחר מכן התקבל ונבחר מקום זה — אזי תירשם בגרמפס החלפה שגויה של הרשומה המקורית (עיר באל סלבדור) ברשומה חדשה (עיר באירופה)!}} [[File:PlaceCleanupFind. If you want these names automatically checked off for inclusion in your Gramps placepng|thumb|left|350px|ארגון מקומות - איתור כותרת מקום מסוימת]] החלון הראשי כולל מספר לחצנים, add the code to this fieldשדה {{man label|כותרת}}, תצוגת סטטוס של {{man label|התאמות}} ומסך רשימת תוצאות או התאמות.* Currently Enclosed Places. When you use the {{man buttonlabel|Okשדה כותרת}} button after selecting a – שדה זה מציג את שם המקום הנבדק כעת. שם זה ישמש במחרוזת החיפוש למקום הרצוי. השדה משתנה אוטומטית בהתאם לכותרת המקום שנבחר בתצוגת המקומות של גרמפס. ניתן גם לערוך את השדה ידנית בעת הצורך, למשל כשיש קיצורים בלתי־שגרתיים, מדרג היסטורי שונה, או בעיות אחרות המפריעות להתאמה בבסיס הנתונים של GeoNames place. (לדוגמה, the Gramplet may have to deal with a place enclosureאם הדרג של המקום בגרמפס הוא "west berliner, west germany", ולא מתקבלות התאמות – ייתכן שב־GeoNames נשמרו שמות רק לאחר איחוד גרמניה. If you are modifying a current placeבמקרה כזה, and your place is already ייתכן שהבעיה היא בכלל שגיאת הקלדה כמו סיומת מיותרת 'Enclosed byer' another place the Gramplet has two choices on how to handle changes to the enclosure, ויש לנסות במקום זאת את "west berlin, west germany").*{{man label|סטטוס התאמות}} – שדה סטטוס קטן הממוקם בצד שמאל של הגרמפלט, מתחת לתווית {{man label|כותרת}}. מציג את מספר המקומות שנמצאו התואמים את החיפוש, ומציין גם האם נמצאו בתצוגה המקומית של גרמפס או בבסיס הנתונים של GeoNames.* {{man label|[[Fileרשימת מקומות תואמים}} – אזור זה מציג את רשימת ההתאמות שנמצאו. המשתמש בוחר את ההתאמה הנכונה, ולוחץ על {{man button|בחר}}, או לוחץ פעמיים/מקיש Enter או רווח, כדי להמשיך למסך העריכה.:: יש שתי עמודות: שמות (כותרות מקוננות של המקומות כפי שהוזנו) ו־{{man label|סוגים}}. כאשר מציגים מקומות מגרמפס, העמודה מציגה את הסוג שהוקצה בגרמפס. כאשר מציגים מקומות מ־GeoNames, מציגה העמודה את קוד המאפיין לפי הסיווג שלהם:RadioButton_Selectedאות קבוצה (כמו A, P, S) ואחריה סוג, לפי הקוד של GeoNames.png{{man tip|הימנעות מכפילויות|21px]]Keep current Enclosureאם מחפשים מקום מ־GeoNames שכבר קיים במסד הנתונים המקומי, ייתכן שחלק מהתוצאות יופיעו בקו חוצה אדום. משמעות הדבר היא שהמקום כבר מוכנס תחת המקום הפעיל הנוכחי ולכן אינו ניתן לבחירה.}} [https:://wikipediaקוד הסוג משמש להכוונה בלבד. סוגי GeoNames לא תמיד ברורים מאליהם.org/wiki/Radio_button radio button selectorהתחביר כולל תחילה קוד קבוצה: 'A' (מקום מנהלי), 'P' (מקום מיושב), 'S' (אתר).] If you select this settingמתוך 9 קבוצות GeoNames, לא נתמכות הקטגוריות הבאות: 'H', 'L', 'R', and your place is already 'Enclosed byT' another place, then no changes to the 'Enclosed byU' place value will be made, even if your current enclosing place differs from that provided by the GeoNames data'V'. ניתן לסנן קטגוריות רצויות באמצעות תיבות סימון (ראו בהמשך). **: If there is no 'Enclosed by' place value&#x2611;{{man label|מיושב}} – אם סומן, and the ייכללו בתוצאות GeoNames data has an enclosing placeגם מקומות מיושבים (ערים, then one will be createdעיירות, and selected for approvalכפרים וכו'). הגדרה זו לא משפיעה על החיפוש המקומי. ברירת מחדל: פעיל.*&#x2611;{{man label|מינהלי}} – אם סומן, ייכללו בתוצאות GeoNames גם חלוקות מינהליות (מדינות, מחוזות וכו'). ברירת מחדל: פעיל.* &#x274f;{{man label|[[Fileאתר}} – אם סומן, ייכללו בתוצאות GeoNames גם אתרים נקודתיים (משקים, מבנים, אתרי קבורה וכו'). ברירת מחדל:RadioButton_Deselectedכבוי.* {{man button|עזרה}} – פותח את עמוד העזרה הנוכחי.png* {{man button|חפוש}} – מחפש את שם המקום שהוזן בשדה {{man label|21px]]Replace with GeoNames Enclosureכותרת}} [https, בשני שלבים://wikipedia** שלב ראשון – חיפוש בתצוגת המקומות המקומית, רק בין מקומות 'שלמים' (מכילים נקודות ציון וסוג מקום).org/wiki/Radio_button radio button selectorרק הקטע הראשון של המחרוזת נבדק.] If you select this settingלדוגמה, אם תחפשו 'Paris, FR' והנתונים כוללים גם את 'Paris, Lamar, Texas, and your place is already United States' וגם את 'Enclosed byParis, Paris, Île-de-France, France' another place– שניהם יוצגו.** שלב שני – אם לא נמצאו התאמות בשלב הראשון, יבוצע חיפוש ב־GeoNames. אם נמצאו התאמות אך אינן מתאימות, then the current enclosure is replaced by the enclosing place from the ניתן ללחוץ שוב על {{man button|חפש}} כדי ליזום את חיפוש GeoNames data. If it did not exist before thisהשירות מציג עד 10 תוצאות בכל פעם. אם המקום הרצוי לא נמצא – יש ללחוץ שוב כדי לראות עשר נוספות.{{man note|חיפוש מקומי קודם לחיפוש מרשתתי|לאחר חיפוש מקומי, it will then be createdמשתנה לחצן {{man button|חפוש}} ל{{man button|חפש ב־GeoNames}} כדי לרמוז שאפשר להרחיב את החיפוש החוצה אם לא נמצאה התאמה.}}* {{man button|בחירה}} – לאחר בחירת התאמה, and selected for approvalעובר למסך תוצאה/עריכה.**: While this ensures that the enclosure matches GeoNames{{man button|עריכה}} – מאפשר לעבור למסך עריכה ישירות, אם לא נמצאו התאמות. שימושי כששם המקום מפורט מדי ואינו קיים ב־GeoNames (כמו 'My Estate, it is possible that the previous enclosing place will no longer be usedParis, and will remain in your databaseTX').* {{man button|מקום הבא}} – מדלג למקום הלא־שלם הבא בתצוגת המקומות. מקום לא שלם הוא כזה שחסרים לו קואורדינטות או סוג. אם מדובר במקום בלתי־משויך או שאינו נמצא בשימוש – תופיע התראה המציעה למחוק אותו.
== Main view =={{man warn|Use extra caution when changing the Title field|The place data found and pushed to update the Place view will depend on the contents of this field. If you change it in inappropriate ways, you could end up with mismatched place data. <br />For example, if the originally active record in the Place view is "Berlín, Usulután", and you manually type in a Place title of "Berlin, Germany" to search, when you find ''and accept'' the Berlin place, your originally selected Place view record for the municipality in El Salvador will be changed to Europe!}}[[File:PlaceCleanupFind.png|thumb|right|350px|Place Cleanup - finding a particular place title]]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. (As an example, your Gramps place hierarchy has "west berliner, west germany". There are no matches and you wonder if GeoNames only has post-unification names. Then you notice that there is a typographical error with a trailing 'er'. So you change it to successfully search for "west berlin, west germany" instead of that elusive donut.)* {{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|Search result places}} 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.:: There are two columns in this list, the names, and the 'Types' columns. The names are comma separated places in the hierarchy, as found in the local database, or in GeoNames. The 'Type' column in the Places view shows the Gramps Type, when showing places from the local database, and shows [https://www.geonames.org/export/codes.html GeoNames Feature Codes] that includes a Feature class letter followed by a colon, then a type) when showing results from the GeoNames search. {{man tip|Avoiding rework|If you search GeoNames for a place in that is already in your database, the search results may return some entries annotated with a red strikethrough. This indicates that those places are already enclosed by the current place and cannot be selected.}}:: The Type column is provide for informational use only, to help the user determine a bit more about the found place. The GeoNames Feature Codes are not always obvious; the type [https://poldham.github.ioמצג תוצאה/places/reference/featurecodes.html#format type format] starts with a 'class'; one of 'A' (Administrative place), 'P' (Populated place), or 'S' (Spot). (Of the 9 GeoNames classes, searching <abbr titleעריכה ="Hydrographic Features">H</abbr>, <abbr title="Area Features">L</abbr>, <abbr title="Road / Railroad Features">R</abbr>, <abbr title="Hypsographic Features">T</abbr>, <abbr title="Undersea Features">U</abbr>, <abbr title="Vegetation Features">V</abbr> is not supported.) You can restrict the returned search matches to desired categories with the matching Checkboxes (see below). The remaining part of the type field for GeoNames can be decoded from [http://www.geonames.org/export/codes.html| http://www.geonames.org/export/codes.html], if desired.* &#x2611;{{man label|Populated}} checkbox. If you check this setting, 'Populated Places' (typically cities, towns, villages etc.) will be returned for a GeoNames search. This setting does not affect a local database search. This is initially enabled, as it allows the search to return what most people expect for a city type search.* &#x2611;{{man label|Admin}} checkbox. If you check this setting, '[[Gramps_Glossary#administrative_division|Administrative Divisions]]' (countries, states, regions etc.) will be returned for a GeoNames search. This setting does not affect a local database search. . This is initially enabled, as it allows the search to return what most people expect for a county, state, country type search.* &#x274f;{{man label|Spot}} checkbox. If you check this setting, 'Spots' (typically farms, buildings, graveyards, churches etc.) will be returned for a GeoNames search. This setting does not affect a local database search. This is initially disabled, as most place searches don't go to this level of detail.* {{man button|Help}} button. This brings up this web page.* {{man button|Find}} button. This performs a search for the placename indicated in the {{man label|Title}} field. The search is performed in two stages:** Initially, the local Gramps place list is examined for a match. The local match is only searched among 'Complete' places, those with Latitude/Longitude coordinates and Place Type data filled in. Only the initial segment of the place is used for searching. For example, if you search for 'Paris, FR', and your local Gramps Place Tree data has both 'Paris, Lamar, Texas, United States' and 'Paris, Paris, Île-de-France, France', both will be shown. Alternative names in the local Gramps places are also searched.** The second stage is the GeoNames search. It is performed automatically if the first stage doesn't find any matches. If the first stage did find one or more matches, but none of them were correct, the user can press the {{man button|Find}} button again to do the GeoNames search. Note that the Web Service of the GeoNames search can return only ten results at a time. If the place you want is not in the first subset of results, press the {{man button|Find}} button again to see the next ten.{{man note|Find shops locally before resorting to the net|The 'Find' button changes to 'Find GeoNames' after a local database search where something was found. This is a reminder that you can search that online database if the local search did not return what you wanted.}}* {{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|left|350px|ארגון מקומות – מצג תוצאה]]
[[File:PlaceCleanupResחלון זה מציג את נתוני המקום שנמצאו לצורך עיון ועריכה אפשרית.png|thumb|right|350px|Place Cleanup Result View]]
This view presents the found place data for review and potential editingבחלקה העליון של החלון מופיעה כותרת מלאה של שם המקום הנוכחי, בכתב '''מודגש'''.להלן תיאור של כל אחד מהשדות בחלון התוצאות:* {{man label|שם ראשי}} – שדה זה מציג את השם הראשי שנבחר מתוך רשימת השמות הזמינים. לא ניתן לערוך אותו.* {{man label|מיקוד}} – שדה זה מציג את המיקוד (או מספר מיקודים). ניתן לעריכה. מעל השדה יש תיבת סימון {{man button|מקור}} – אם סומנה, ישתמש הגרמפלט במיקוד המקורי במקום בזה שנמצא. תיבה זו מושבתת אם אין מיקוד מקורי.* {{man label|סוג}} – שדה המציג את סוג המקום (מדינה, עיר, כפר וכדומה). ניתן לעריכה. מעליו יש תיבת סימון {{man button|מקור}} – אם סומנה, ישתמש הגרמפלט בסוג המקורי ולא בזה שנמצא. תיבה זו מושבתת אם הסוג המקורי היה "לא ידוע".{{man note|לתשומת לב|בסיס הנתונים של GeoNames לא מספק נתוני סוגי מקום אותם גרמפס מנהל. לכן הגרמפלט מפיק ניחוש מושכל בהתבסס על הנתונים הזמינים, ויש לבדוק את הסוג המקום שמוצג ולעדכן ידנית לפי הצורך.}}* {{man label|קו רוחב וקו אורך}} – שדות המציגים את נקודות הציון (קו־רוחב וקו־אורך) של המקום. ניתנים לעריכה. מעליהם תיבת סימון {{man button|מקור}} – אם סומנה, ישתמש הגרמפלט בנקודות הציון המקוריות. תיבה זו מושבתת אם לא היו נתונים מקוריים.* {{man label|מזהה}} – שדה המציג את מזהה גרמפס עבור המקום כפי שמופיע במסד הנתונים של גרמפס. אינו ניתן לעריכה. מעליו תיבת סימון {{man button|מקור}} – אם סומנה, ישתמש הגרמפלט במזהה המקורי. תיבה זו מושבתת אם לא היה מזהה מקורי.* {{man label|רשימת שמות}} – רשימה זו מכילה את השמות הקשורים למקום שנמצא. לכל שורה נלווים שפת שם המקום ותאריך בו השם היה בשימוש. בעמודת 'כלול' מופיע '<b>P</b>' עבור שם ראשי, או סימן ביקורת ✔ אם השם ייכלל ברשימת שמות המקום החלופיים. לחיצה כפולה {{Man key press|Enter}}רווח על שורה תפעיל או תכבה את הסימון.* {{man button|שמירה}} – אם נבחרו שורות ברשימת השמות, לחיצה על לחצן זה תסמן את השמות הכלולים להוספה לרשימת השמות החלופיים של המקום.* {{man button|עקרי}} – אם נבחרו שורות, לחיצה על לחצן זה תסמן את השם העליון מביניהן כשם הראשי של המקום.* {{man button|לסלק}} – לחצן זה מסיר את הסימון מהשמות שנבחרו, כך שלא ייכללו ברשימת השמות החלופיים של המקום.* {{man button|ביטול}} – מחזיר לתצוגת החיפוש הראשית מבלי לשמור שינויים.* {{man button|אישור}} – משנה את המקום הנבחר לפי הערכים החדשים. בנוסף, אם קיים מדרג, תתווסף הרמה הבאה בו. אם היא כבר קיימת ברשימת המקומות בגרמפס ויש לה מזהה תואם מ־GeoNames – השינויים יושלמו. אם לא – תוצג אותה רמה הבאה בתצוגת התוצאה להמשך טיפול.
At the top of this view is the full title of the Current place, in '''bold''' text.* {{man label|Primary Name}} field. This field is displayed based on the name chosen as primary from the list of available names. It is not editable.* {{man label|Postal Code}} field. This field displays the postal code(s). It can be edited. There is a small {{man button|Orig}} checkbox just above this field, if checked, the Original postal code from the place is used instead of the found postal code. Note that this checkbox is disabled if there is no original postal code.* {{man label|Type}} field. This field displays the place type. It can be edited. There is a small {{man button|Orig}} checkbox just above this field, if checked, the Original place type from the place is used instead of the found place type. Note that this checkbox is disabled if there is an 'Unknown' original place type.{{man note|NOTE|The GeoNames database does NOT provide Gramps Place Type data. This Gramplet uses the available data to make a 'best guess' at the correct Place Type. You should always check and make sure that the value is correct, and fix it if necessary.}}* {{man label|Latitude and Longitude}} fields. These fields displays the Latitude and Longitude. They can be edited. There is a small {{man button|Orig}} checkbox just above these fields, if checked, the Original Latitude and Longitude from the place is used instead of the found Latitude and Longitude. Note that this checkbox is disabled if there is no original Latitude and Longitude.* {{man label|ID}} field. This field displays the Gramps ID. It cannot be edited. There is a small {{man button|Orig}} checkbox just above this field, if checked, the Original ID from the place is used instead of the found ID. Note that this checkbox is disabled if there is no original ID.* {{man label|The Names list.}} This list contains the names associated with the found place. Each name has an associated Language and Date. There is also an 'Inc' column which displays the include status of the name in that row. If there is a '<b>P</b>' in the 'Inc' column, that name is used as the Primary name. If the column has a checkmark '✔' the name will be included in the final Place alternative names list. If you double-click, press 'Enter' or 'Space' on a selected row, that will toggle the include status.* {{man button|Keep}} button. If one or more of the places in the names list is selected, pressing this button will cause the associated names to be marked for inclusion in the final Place alternative names list.* {{man button|Primary}} button. If one or more of the places in the names list is selected, pressing this button will cause the topmost associated name to be marked as the Primary name.* {{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|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.= שאלות נפוצות =
= FAQ =* הנתונים מ־GeoNames מיועדים בעיקר לשימוש עכשווי. הם כוללים מעט מידע היסטורי. לפי הדיווחים, המידע די שלם עבור ארצות־הברית וקנדה, ופחות שלם באירופה – אם כי נראה שכל הערים האירופיות שנבדקו כן קיימות. אם נמצאה שגיאה או השמטה בנתונים של GeoNames, ניתן לדווח עליה באמצעות הקישור הבא: [http://www.geonames.org/manual.html http://www.geonames.org/manual.html].* GeoNames מוצא מקומות כפולים: לדוגמה, "Santa Rosa, CA" – GeoNames מוצא גם את "Santa Rosa, Sonoma, California, United States" וגם את "City of Santa Rosa, Sonoma, California, United States". בסיס הנתונים כולל הן 'מקום מיושב' (Populated Place) עם שמות חלופיים רבים ומיקודים, והן 'תת־חלוקה מנהלית' (Administrative subdivision) לאותו מקום – בדרך כלל ללא מיקודים או שמות חלופיים. לרוב כדאי להעדיף את הגרסה הראשונה, שמופיעה ראשונה ברשימת האפשרויות.* פקיעת זמן (Timeout): בעת שימוש בבסיס הנתונים המקוון של GeoNames עם חשבון חינמי, עשויים להתרחש פקעי זמן. הזמן המוקצב לבקשה אחת הוא 20 שניות, אך פעולות מסוימות דורשות מספר בקשות, כך שייתכן שהמנשק של גרמפס לא יגיב במשך עד 40 שניות. ניתן תמיד לנסות שוב בלחיצה על הלחצן האחרון שנעשה בו שימוש. לפי אתר GeoNames, חשבון בתשלום משתמש בשרתים פחות עמוסים ולכן מאפשר ביצועים טובים יותר.* לא נמצא: מאגר GeoNames כולל גם שמות היסטוריים אך מתמקד בעיקר במידע עדכני. באילני־יוחסין מקובל לתאר מקומות בהתאם לתקופת האירוע – ולכן ייתכן שמקום שתואר אינו קיים עוד: ייתכן שהועבר למדינה אחרת, לתחום מנהלי אחר, או נטמע במקום אחר. במקרה כזה, נסו להסיר את הפרטים האמצעיים של המקום ולהשאיר רק את שם המקום הראשוני ואת המדינה. ייתכן שתתקבל רשימה ארוכה, אך היא עשויה להעניק רמזים לגבי המצב הנוכחי. לחלופין, ייתכן שתידרש בדיקה חיצונית כדי לברר מהו שמו הנוכחי של המקום.* סוגי מקומות: מכיוון ש־GeoNames אינו כולל מידע על סוג המקום כפי שנהוג ב־Gramps, תוסף זה מיישם אלגוריתם שמנסה לנחש את סוג המקום. במדינות שבהן יש מבנה מנהלי קבוע (כגון City/County/State/Country בארה"ב), האלגוריתם מקצה סוג מתאים לכל רמה. במדינות שבהן המבנה אינו ברור או אינו עקבי, האלגוריתם בודק את שם המקום – אם מופיע בו מונח המעיד על סוג המקום (כגון "Harris County" או "Smith Township") הוא ישויך בהתאם. תהליך זה סורק גם שמות חלופיים, למקרה שהשם הראשי אינו כולל מונח מתאים. אם ידוע לך שמבנה מנהלי מסוים במדינה כלשהי אינו מטופל כראוי – ניתן לפנות למחבר התוסף בכתובת paulr2787 @ gmail.com, כדי לשפר את האלגוריתם.* מזהים: כאשר מקור הנתונים הוא GeoNames, מזהה המקום הסטנדרטי (כגון "P0001") מוחלף במזהה ייחודי מ־GeoNames (כגון "GEO12345"). המספר עצמו הוא המזהה במערכת GeoNames. תצורת מזהים זו מאפשרת לתוסף לזהות אם מקומות כוללים כבר קיימים במסד הנתונים, כך שאין צורך לחפש ולבחור אותם ידנית.* GetGov – איך זה משתלב עם נתוני GetGov? בשלב זה אין שילוב ישיר. אם המקומות כבר הוזנו באמצעות תוסף [[Addon:GetGOV|GetGov]], שדה המזהה יכיל מזהה ממשלת גרמניה (GovID). במקרה כזה, כדאי להגדיר בהעדפות תוסף Place Cleanup לשמור על ערכי הכללה קיימים (Enclosure). בנוסף, כדאי לסמן את תיבת {{man button|מקור}} עבור המזהה, כדי לשמר את מזהה ה־Gov המקורי.
* GeoNames data is primarily intended for present day usage. It contains little historical information. I have heard that it is pretty complete for United States, Canada, and less so for Europe, although it seems to have all the European cities I have tested so far. If you find an error or omission in the GeoNames data, you may want to tell GeoNames about it [http://www.geonames.org/manual.html| http://www.geonames.org/manual.html].* GeoNames finds multiple places: Example, 'Santa Rosa, CA'. GeoNames finds both 'Santa Rosa, Sonoma, California, United States' and 'City of Santa Rosa, Sonoma, California, United States'. The way the GeoNames database is structured, they have a 'Populated Place', which generally has lots of Alternate names and postal codes, and an 'Administrative subdivision' for the same place. The 'City of' version is the Administrative subdivision, which generally doesn't have postal codes and alternate names. I personally prefer the first version, which should appear first in the 'Choices' list.* Timeouts: When using the GeoNames web database with a free account, you will sometimes get a timeout. The Timeout is set to 20 seconds for each request, unfortunately some actions take several requests, so the user may see unresponsive Gramps for up to 40 seconds. You can always try the request again by pressing the last used button. According to the GeoNames web site, if you pay for an account, you may get better performance, as the paid accounts use more lightly loaded servers.* Not Found: While the GeoNames database contains some historical names, it mostly tries to be up to date with the current times. Many places in a typical family tree are described as of the time the event occurred. So it is entirely possible that the described place no longer exists. It may now belong to a different country, or other administrative subdivision. Or it may have been subsumed within another larger place. Initially you should try removing the intermediate place data, leaving only the initial segment and the country. You may get a lot of matches, but that may give you a better clue as to the current situation. Or you may have to do some research outside the Gramplet to figure out what it might be called now.* Place Types: Since GeoNames does not have place 'type' data, the same way that Gramps does, this addon uses an algorithm to attempt to pick an appropriate place type. If a country is known to have a rigid administrative place type structure, such as the United States with its City/County/State/Country, then the various parts of the place hierarchy are typed accordingly.: If the structure is not always known or used, then the algorithm attempts to assign place types by looking at the place name. For example if the place name includes a word that matches a place type, such as "Harris County" or "Smith Township", then the place type is set accordingly. To do this, all the various place alternate names are scanned, in case the primary name does not include a suitable word.: If you know that a particular country has a rigid (or even mostly rigid) hierarchical structure, and this addon seems to be getting it wrong a lot, please let the author know at paulr2787 at gmail.com. I can modify the code to make it work better if I understand the correct country structure.* IDs: When GeoNames is the source of place data, the normal place ID ('P0001') is replaced by a GeoNames specific ID ('GEO12345'). The number portion of this ID is the GeoNames identifier for the place. By using this type of ID, the addon can easily identify when enclosing places are already present in your database, which means that the user doesn't have to do a local search for and selection of each level of enclosing place.* GetGov, how does this interoperate with the data from GetGov? At this time it does not integrate with that data. If you already have places loaded from the [[Addon:GetGOV|GetGov]] addon, then the ID field will have a GovID. If you want to do a lookup with GeoNames for that place, you should probably set the Place Cleanup preferences for the enclosure to keep the current values. In addition, you should probably use the 'Orig' checkbox for the ID to keep the original Gov ID.= סוגיות =
= Issues =הכלי הזה מורכב למדי. נא ווח על תקלות או בקשות לשיפורים לכתובת [email protected].
This tool is fairly complexכולל גם תרגום לצרפתית, בעיקר לבדיקת קוד ההבין־לאומיות. Please report any issues or desired enhancements to paulr2787 at gmail.comמאחר שאינני דובר צרפתית (מדבר רק אנגלית נוסח טקסס, ארה״ב) — סליחה על הצרפתית שלי.
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:He:מקומות]][[Category:He:תוספים]][[Category:He:מתקעים]]
[[Category:Places]]
[[Category:Addons]]
[[Category:Plugins]]
{{RTLPageEnd}}