FilterWorkbench — Guide

*En Gramps-gramplet til at bygge, gemme, redigere, dele og teste dine egne personfiltre. Engelsk navn: FilterWorkbench.*

Denne guide beskriver hvad FilterWorkbench er, hvordan den gemmer tingene, og hvordan du bruger hver del af den. For et hurtigt overblik og installation, se README.md.


1. Hvad det er

FilterWorkbench er en flydende gramplet, som du tilføjer til sidepanelet i Personer- visningen. Herfra kan du:

Den er tænkt til begyndere og let øvede, som forstår de tre måder regler kan kombineres på (alle / en hvilken som helst / præcis én), og som ønsker et venligere sted at eksperimentere end Gramps' indbyggede filtereditor.

2. Hvordan filtre gemmes (og hvorfor det betyder noget)

FilterWorkbench gemmer sine filtre i sin egen fil, én pr. slægtstræ, navngivet efter træets interne database-id. Den har to sektioner:

Som udgangspunkt skriver den aldrig til Gramps' custom_filters.xml. FilterWorkbench- filtre er helt adskilt fra Gramps' egne brugerfiltre, så det at eksperimentere her kan ikke rode i eller ødelægge din Gramps-filterliste. Når et filter er færdigt, kan du vælge at kopiere det ind i Gramps' egen filtereditor med Eksportér til — og tage det ud igen med Fjern fra (se §8). Begge er bevidste handlinger, én ad gangen, der aldrig overskriver noget.

Referencer mellem filtre gemmes som stabile id'er og oversættes først til navne, når et filter faktisk anvendes — så det at omdøbe et hjælpefilter aldrig ødelægger et hovedfilter, der bruger det.

3. Begreber

af…"*. FilterWorkbench bruger samme regelkatalog som Gramps, inklusive de regel-tilføjelser du har installeret.

refererer fra ét eller flere hovedfiltre. Hjælpefiltre er byggeklodser; de oprettes og redigeres inde i byggeren (der er med vilje ingen selvstændig "nyt hjælpefilter"-knap). Vil du have et filter tilgængeligt for sig selv andre steder, så lav det som et hovedfilter i stedet.

indeholde almindelige regler og/eller referencer til hjælpefiltre.

match en hvilken som helst, eller match præcis én. Der er også en invertér- mulighed ("vis det modsatte resultat").

4. Byggevinduet

Åbn det fra grampletten med Ny (blankt) eller Rediger (det valgte hovedfilter).

Øverst minder en kort note dig om hvad vinduet gør. Nedenunder:

kommentaren for et refereret hjælpefilter, så du med det samme kan se hvad en reference gør. Du kan trække Filter-kolonnen bredere; bredden huskes.

personlisten for at se, hvad den alene matcher.

højreklikke på en regel for at Tilføje til / Fjerne fra favoritter. Dine favoritter vises samlet øverst i listen til hurtig genbrug. Selve byggeren kan rulles lodret, så lange filtre altid kan nås.

filter** (kører kun det fremhævede hjælpefilter på personlisten).

byggeren**, så du kan blive ved med at justere.

Live match-tælling

Mens du bygger, viser FilterWorkbench hvor mange personer det aktuelle filter matcher, og opdaterer det løbende. Et særtilfælde: en regel der afhænger af den aktive person kan ikke tælles fra det flydende vindue (Gramps kender kun den aktive person i selve person- visningen), så dens tal vises blankt i stedet for et misvisende 0 — filteret virker stadig korrekt. Vil du have et pålideligt "proband"-anker, så brug Gramps' indbyggede Hjemperson- regel i stedet.

5. Test kontra anvend

mens du arbejder. Det er forbigående.

personlisten, indtil du trykker Nulstil (eller lukker Gramps).

Mens et filter er anvendt — eller mens du tester ét — optræder det også i Gramps' andre person-vælgere (GEDCOM-eksportens Personfilter, rapporter, sidepanelet) under det læsbare navn wb_<navn>. Det er praktisk: du kan anvende et filter her og så vælge det direkte fra GEDCOM-eksport-dialogen. Det lever kun i hukommelsen; Nulstil eller lukning fjerner det, og det skrives aldrig til custom_filters.xml.

> Bemærk forskellen: at anvende får kun et filter til at optræde forbigående i Gramps' > filter-valglister som wb_<navn> (væk ved Nulstil, eller når du lukker Gramps). For at > få et filter til at optræde permanent i Gramps' egen filter-editor, brug > Eksportér til i stedet (se §8).

6. Grampletten

Grampletten er din hjemmebase i sidepanelet i Personer-visningen:

bruger nestet nedenunder. Et Filter-felt over listen indsnævrer den mens du skriver, og en Guide-knap (øverst til højre) åbner denne guide.

alle igen.

og de hjælpefiltre det bruger, som intet andet har brug for; hjælpefiltre der stadig bruges af et andet filter, samt eventuelle selvstændige hovedfiltre det refererede, bevares — bekræftelsen viser præcis hvad der slettes, og hvad der bliver stående. Sletter du det filter der er anvendt lige nu, nulstilles visningen automatisk.

filter ind i Gramps' egen filtereditor, eller tag det ud igen (se §8).

7. Import / eksport mellem træer

Eksportér skriver alle dette træs filtre til en fil. Importér tilføjer filtre fra en anden fil — den erstatter aldrig det, du allerede har. Sammenfletningen er omhyggelig:

og springes over; referencer peges mod din lokale kopi. At importere den samme fil igen tilføjer derfor intet (det er idempotent).

(Navn (2), Navn (3), …), og det importerende filter omdirigeres til den nye kopi. Dine lokale filtre ændres aldrig.

Import-dialogen opsummerer hvad der blev tilføjet, sprunget over og omdøbt. Refererer et importeret filter en regel-tilføjelse der ikke er installeret i denne Gramps, **advarer dialogen dig, før du bekræfter** — filteret importeres stadig, men virker først, når du installerer den tilsvarende regel-tilføjelse.

8. Eksportér til / Fjern fra Gramps' filtereditor

Nogle gange vil du have et færdigt FilterWorkbench-filter til at leve i Gramps' egen filtereditor — så det optræder der permanent, ligesom ethvert indbygget brugerfilter. Sektionen Gramps' filtereditor nederst i grampletten gør netop det, som et bevidst, ikke-destruktivt, valgfrit trin.

i Gramps' custom_filters.xml. Dit hovedfilter beholder sit navn; hjælpefiltre skrives under sikre, sorterbare navne, så de ikke kan kollidere med dine egne. Intet overskrives nogensinde: hvis et navn allerede tilhører et ikke-FilterWorkbench-filter, nægtes eksporten og beder dig omdøbe; eksporterede du det samme filter før, beder den dig Fjern fra først. Hjælpefiltre, der allerede er eksporteret af et andet af dine filtre, genbruges i stedet for at blive dubleret — så delte hjælpefiltre virker på tværs af flere eksporterede filtre.

de hjælpefiltre, intet andet bruger; hjælpefiltre der stadig deles af et andet eksporteret filter, bevares. Bekræftelsen viser præcis hvad der fjernes, og hvad der bliver stående.

To ting du bør vide:

dialog) åben, mens du bruger Eksportér til / Fjern fra, ville det at lukke den gemme dens gamle kopi hen over din ændring — så FilterWorkbench nægter, indtil den er lukket.

en bestemt person, sted eller hændelse, er den reference kun meningsfuld i det træ, den kom fra. Bekræftelsen advarer dig, når det kan være tilfældet.

Dette er forskelligt fra at anvende (§5): anvendelse viser et filter forbigående som wb_<navn> og forsvinder ved Nulstil; Eksportér til skriver det ind permanent, indtil du Fjern fra.

9. Regulære udtryk og store/små bogstaver

Regler der understøtter det (dem med en Brug regulære udtryk-mulighed i regeleditoren) kan matche via regex, og eventuelt med forskel på store/små bogstaver. Sæt flueben ved *Brug regulære udtryk for at behandle værdien som et regex; Forskel på store/små bogstaver* bliver tilgængelig, når regex er slået til. Disse indstillinger gemmes med reglen og genanvendes, hver gang filteret kører, på både Gramps 5.2 og 6.0.

10. Noter & kendte begrænsninger

garantere, at den genåbner samme sted; vinduets størrelse genskabes. X11 opfører sig som forventet. Ikke kritisk.

Hjemperson som et deterministisk anker.

11. Afinstallation

Luk Gramps og slet tilføjelsens mappe fra din bruger-plugins-mappe (se README for stien). Dine slægtstræ-data røres ikke. FilterWorkbenchs egne filter-filer pr. træ ligger separat, i …/gramps<XY>/filterbuilder/, og kan også fjernes, hvis du ønsker det.

12. Oversættelser

Brugerfladen leveres med en dansk oversættelse ("FilterWorkbench"/"Filterværksted"). Nogle få strenge, der deles med Gramps' egen regeleditor, følger Gramps' indbyggede oversættelse, så de optræder på dit sprog, hvis Gramps selv er oversat der. Kører Gramps på dansk, åbner Guide-knappen automatisk denne danske udgave.

Licens & forfatter

Udgivet under GNU General Public License v2.0 eller senere (GPL‑2.0‑or‑later), samme licens som Gramps.

Henning — <contact@myown-project.dk> · <https://myown-project.dk>