Addon:Rule expansions/he

שפות:

זהו 'תוסף צד ג'.

נא להשתמש בזהירות מרבית ורק לאחר גיבוי הנתונים. להמשך שיפור התוסף, נא לדווח כל סוגיה או הערה ליוצר, או בעמוד מעקב תקלים
אלא אם צוין אחרת בעמוד זה. ניתן להוריד ולהתקין תוסף זה על־פי הנחיות ההתקנה.
לתשומת־לב, למקצת מהתוספים דרישות קדם לחבילות ו/או ספריות אותם יש למלא ולהתקין לפני שניתן יהיה להשתמש בהם.
מערכת תוספים/מתקעים זו נשלטת על ידי מנהל המתקעים

תיקוני כללים

שינויים בכלליים לא תמיד בולטים לעין

כללים מובנים חדשים במערכת, מופיעים ללא הכרזה מיוחדת, ולעיתים קשה להבחין בהם בשל ריבוי הקבוצות וסוגי־אב משניים שבהן הם משובצים.
לעומת זאת, תוספים יש להוריד ולהתקין, ולכן כללי־תוסף ניכרים יותר. נוסף על כך ניתן לאתרם לפי סוג־אב במנהל התוספים.

איור Addons (Rules).1 – העדפות: בדיקת הימצאות עדכוני תוספים מסוג כללים

הכללים הם אבני־היסוד ליצירת מסננים מותאמים אישית. בגרמפס מובנים כברירת מחדל מגוון רחב של כללים ומשמשים ליצירת מסננים לפי סוגי־אב שונים.

נוסף על כך ראכזו מספר אוספי תוספי כללים שהופצו כ"חבילות כללים":

FilterRules – תיעוד: מאגר גיטהוב
FilterRules2 – תיעוד: גיטהוב GitHub
כללים כלליים (SuperTool) – (רשומות נפרדות בכול סוג־אב עצם, לשימוש עם קוד כלל מותאם שנוצר על ידי SuperTool) – תיעוד, מאגר גיטהוב

עם יציאת גרסה ‎5.1‎ של גרמפס, פורסמו לראשונה תוספי־כללים כדוגמה לכתיבת תוסף מסוג כלל סינון. התקנתם מתבצעת כמו כל תוסף אחר, ולאחר ההתקנה הכלל החדש מופיע כאפשרות חדשה בתיבת הדו־שיח הוספת כלל בעת הגדרת מסנן מותאם.

מסננים שנוצרים באמצעות כללים אלה ניתנים לבדיקה, שכפול או מחיקה באמצעות עורך המסננים ,שנגיש מתפריט עריכה בכל מצג סוג־אב.

איתור תוספי כללים

איור Addons (Rules).2 – חיפוש המילה Rule במנהל התוספים (Plugin Manager)

מנהל התוספים (Plugin Manager) משמש לא רק להתקנה ולעדכון של מודולים, אלא גם לאיתור יכולות חדשות שנוספו לגרמפס.

יש לפתוח את מנהל התוספים מתפריט עזרה ולהשתמש בשדה החיפוש כדי לסנן תוספים הכוללים את המונח "Rule" בשם הקובץ או בתיאורם.

איור Addons (Rules).3 – פרטי תוסף כלל מסוג People related to <filter>

כללי־תוסף שעברו בדיקה וסקירה יתווספו למערכת עדכון התוספים האוטומטית של גרמפס, המאפשרת התקנה פשוטה.

בעת התקנה ידנית, קובצי קוד־המקור של כללי התוסף (.py) וקובצי הרישום של גרמפס (.gpr.py) ממוקמים בתיקייה: \gramps60\plugins\FilterRules\ שנמצאת תחת תיקיית המשתמש.

ניתן לבדוק את מיקום ההתקנה של כל כלל קיים דרך חלון המידע של התוסף (Info).

תוספי כללים

הוספת כללים נעשית בקבוצות דרך מנהל התוספים. כל הכללים בקבוצה אחת נוספים או מוסרים יחד בעת התקנה או הסרה.

כל קבוצה תומכת ברב־לשוניות באמצעות קובצי ‎‎.po‎ ו־‎.pot‎ בעזרת gettext.

מאז שהוצגה האפשרות לתוספי־כללים, נאספו שתי קבוצות עיקריות של כללים:

כללים פרטניים

אדם פעיל (Active Person)

איור Addons (Rules).4 – חיפוש כללים הכוללים את המילה person

כלל סינון כללי (General Filter Rule) של תוסף שמטרתו למצוא את האדם הפעיל.

זמין עבור: אנשים, קשרים, תרשימים, גאוגרפיה.

זהו כלל "בסיסי" שימושי במיוחד ליצירת מסננים מורכבים.

לקריאה נוספת:

כלל הסינון לאדם הראשי.

Isotammi Addon Rules

Rather than distributing through the Gramps open source project, the Taapeli Project (which is a national database of Finnish Genealogical Society) curates their own set of "Isotammi lisäosia" : “Big Oak (the mythological World Tree) addons" for Gramps. The addon manager installation files are hosted separately.

Besides an initial experiment distributing a rule, they created the SuperTool for directly executing queries and building custom query rules used by a "Generic <Object> filter" in each category view.

FilterRules : Plugin Manager Rulebook Collection

General Filter Rule Addons

People related to <filter>

Fig. Addons (Rules).5 Searching by Rule name

Person • General filters addon rule to find Person(s) matching a specified filter. Matches people who are related to anybody matched by a person filter.

isrelatedwithfiltermatch provided as sample .gpr.py & .py code for writing addon filter rules. Demonstrates piping the output of one custom Filter into another.

People with events with a selected role

Fig. Addons (Rules).6 Searching for Person Rules which include the 'role' term.

Person • Event filters addon rule to find Person(s) having any Event with a specified Event Role.

This rule is particularly useful to search for people with Events having an "Unknown" event role. An Unknown role always a placeholder that should be resolved as soon as possible.

Families with Events with a selected role

Fig. Addons (Rules).7 Searching by Rule name

Families • Event filters addon rule to find Families having any Family member or shared Family level Event with a specified Event Role.

hasrolerule provided as sample .gpr.py & .py code for writing addon filter rules. Demonstrates including category variants of a rule in the same addon.

Source matching parameters

Fig. Addons (Rules).8 Searching by Rule name

Sources • General filters addon rule to find Sources based on the following parameters: Title, Author, Abbreviation, Publication.

This addon rule has similar options to the standard Filter Gramplet for the Source Category View. It can be used to save complex filter parameters.

hassourcefilter provided as sample .gpr.py & .py code for writing addon filter rules. Demonstrates text based filtering with RegEx options.

People Separated less than <N> degrees of <Home person>

Fig. Addons (Rules).9 Searching for Person Rules which include the 'degrees' term.

Person • Relationship filters addon rule to find Person(s) having a relationship to the Home Person within a specified degree of Consanguinity and Affinity.

The Home person is point of reference for calculating (<N>) Degrees. For N, Minimum value is 1, Maximum is value 32.

Degree 1: person/spouse + children ( <zero N> ancestors, because the selected person is generation 1 + 1N descendants)
Degree 2: person plus person’s parents, siblings, niece/nephew, children, grandchildren, etc. (= 1N ancestors + 2N descendants)
Degree 3: persons grandparents and 3 generations down. (= 2N ancestors + 3N descendants).

The ancestors and descendants generations have an offset of 1 to mimic the builtin filter rule behavior. Early versions of this rule optionally included partners and non-primary parents. Those relatives are now always included.

This Rule may need to manually downloaded and installed: see the source code files on the GitHub Repository

People Separated less than <N> degrees of <person>

Fig. Addons (Rules).10 Searching Person rules by 'degrees' term; roll-over hint for ID.

Person • Relationship filters addon rule to find Person(s) having a relationship to a specified Person within a specified degree of Consanguinity and Affinity.

The Person corresponding to the ID is the focal point of reference for calculating (<N>) Degrees. For N, Minimum value is 1, Maximum is value 32.

Degree 1: person/spouse + children ( <zero N> ancestors, because the selected person is generation 1 + 1N descendants)
Degree 2: person plus person’s parents, siblings, niece/nephew, children, grandchildren, etc. (= 1N ancestors + 2N descendants)
Degree 3: persons grandparents and 3 generations down. (= 2N ancestors + 3N descendants).

The ancestors and descendants generations have an offset of 1 to mimic the builtin filter rule behavior. Early versions of this rule optionally included partners and non-primary parents. Those relatives are now always included.

Early versions of this rule optionally included partners and non-primary parents. Those relatives are now always included. See the GitHub Repository files

Events of families matching a <family filter>

Families matching <event filter>

Matches families that are matched by an event filter

People who are part of families matching <filter>

Filter people by their age at death

Match associations of <person filter>

People with multiple parent records

Person • Family filters addon rule that matches people who have more than one set of parents.

People with <count> of <event>

Person • Family filters addon rule that Matches persons which have events of given type and number..

FilterRules2 : Plugin Manager Rulebook Collection

Genetic Genealogy Filter Rule Addons

The following rules are based on the logical rules of genetics, not on comparing DNA data. They are introduced in the "New filter rules for genetic genealogy" thread of the Discourse community support forum.

Matrilineal progenitrix of <person>

Matches the earliest recorded matrilineal ancestor mother.

Mitochondrial inheritance of <filter>

Matches recorded descendants of a filter result following mitochondrial inheritance patterns.

Mitochondrial inheritance of <person>

Matches recorded descendants of person following mitochondrial inheritance patterns.

Patrilineal progenitor of <person>

Matches the earliest recorded patrilineal ancestor father.

X-chromosomal ancestors of <person>

Matches ancestors of <person> following a X-chromosomal inheritance pattern.

X-chromosomal descendants of <person>

Matches descendants of <person> following a X-chromosomal inheritance pattern.

Y-chromosomal inheritance of <person filter>

Matches recorded descendants of a filter result following Y-chromosomal inheritance patterns.

Y-chromosomal inheritance of <person>

Matches recorded descendants of person following Y-chromosomal inheritance patterns.

Pre-Release Rules

Descendants of <person> sharing yDNA with each other

Matches descendants of a <person> sharing yDNA

The Evolution of of Rules as Addons

Gramps 5.1.1 (Sept. 2019)

Fix bug 0011114: resolve crashes in withinarea filter rule:

Avoid bad coordinates in the ref place

Avoid alphabetic characters in filter rules

Could not convert string to float by using withinarea filter rule

Difference between sidebar filter and filter rule

Fix Bug 0011293 Fix internationalization issue where untranslated English GUI items appear in Event filter

Gramps 5.1.0 (Aug. 2019)

New feature : Filter Rules can now be expanded through the addons interface.
Filter Rule editor, save pane position
Fix Bugs 0007950 and 0011430: Name Filter rule now supports multiple attribute: Check all values of an attribute type and not only the first one
filters rule have children person filter: Check all families of a person for children and not only the first
Person Sidebarfilter:

Fix Person Sidebarfilter when using ‘Event’ and Reg expressions

In personsidebarfilter, search on each part of name Instead of requiring that the entire search string matches a single one of the Person’s names, the function will require that each word in the search string matches any of the Person’s name fields.

Fix exception when merging with active sidebar filter

Gramps 5.0.2 (Aug. 2019)

Fix bug 0010509: resolves silent fail - relationship path between filter rule when parent is missing
Fix crash when using sidebar filter and merging in another view
Fix Place Tree view when using enclosed by sidebar filter
Fix Relationship Graph; extra people when using filters & subgraphs

Gramps 5.0.1 (Dec. 2018)

Fix bug 0010685: resolves crash in IsDuplicatedAncestorOf filter rule on tree loop
Fix Person Sidebarfilter when using ‘Event’ and Reg expressions
Fix FilterParser for much older 3.x custom_filters.xml files
Fix crash when a filter with loop in definition is defined
Fix view so column widths are preserved when using filters

Gramps 5.0.0 (Jul. 2018)

Fix Custom filter update when created via sidebar.

Developing New Rule Addons

Beginning with version 5.0, Gramps implemented an database API (application programming interface) infrastructure supporting user selectable backends. This new exploration of database support lead developer to extend the addon (plug-in) framework to support expanding Filter Rules via the Plugin Manager.

The 5.1 release changed the default database backend from BSDDB (Berkeley database) to SQLite. With the broader group of user familiar with optimizing searches, it made sense to open Gramps to the specialized knowledge.