🗃️ Gramps-xml

pol

Grafika powyższa przedstawia podstawy zrozumienia języku tagów/znaczników/elementów XML.

2️⃣: Model pliku z bazą danych gramps (typu xml)

grampsxml.dtd

<?xml version="1.0" encoding="UTF-8"?>

<!--

# Gramps - a GTK+/GNOME based genealogy program

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

-->

<!--

This is the Document Type Definition file for v1.7.2

of the GRAMPS XML genealogy data format.

Please use the following formal public identifier to identify it:

"-//GRAMPS//DTD GRAMPS XML V1.7.2//EN"

For example:

<!DOCTYPE database PUBLIC "-//GRAMPS//DTD GRAMPS XML V1.7.2//EN"

"http://gramps-project.org/xml/1.7.2/grampsxml.dtd"

[...]>

-->

<!--

DATABASE

Defines an XML document which is a <database> consisting of a

header Information about the "owner" of the database

name-formats

people

families

events

places

citations

sources

objects

repositories

notes

2️⃣-A1) Element: <database></database> - Główne ramy pliku ".gramps" z naszą bazą.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE database PUBLIC "-//Gramps//DTD Gramps XML 1.7.1//EN"

"http://gramps-project.org/xml/1.7.1/grampsxml.dtd">

<name-formats></name-formats>

</database>

2️⃣-A2) Element: <header></header> ;

Element ten jest obowiązkowy, składa się on z elementów: <created> (informacje o tej bazie danych genealogicznych), <researcher> (informacje o osobie, która stworzyła tę bazę danych) oraz <mediapath> (ścieżka do folderu z multimediami). Element <created> posiada dwie obowiązkowe cechy datę utworzenia pliku z bazą, oraz wersje programu w którym została utworzona.

<resname>Król Jagiełło</resname>

<resaddr>Zamek Wawel</resaddr>

<rescity>Kraków</rescity>

<resstate>Księstwo Krakowskie</resstate>

<rescountry>Królestwo Polskie</rescountry>

<resemail>szef-wszystkich@wawel.smok</resemail>

</researcher>

<mediapath>{GRAMPS_RESOURCES}/example/gramps</mediapath>

</header>

2️⃣-B1) Element: <name-formats></name-formats> ;

Element ten jest opcjonalny. Przechowuje on ustawienia sposobu wyświetlania nazwisk, tych ustawień może być ZERO lub WIĘCEJ. Niemniej w ostatnich wersjach gramps nie widzę możliwości edytowania z poziomu gramps. Zastosowanie/Celowość tego ustawienia będzie szerzej omówiona w punkcie A-8).

<name-formats>

</name-formats>

2️⃣-B2) Element: <namemaps></namemaps> ;

Element ten pozwala przechowywać globalne zasady grupowania nazwisk, np gdybyśmy chcieli by nazwiska Konstantynopolitański, Konstantynopolitańska, Konstantynopolitańczykówna, Konstantynopolitańczykwa, pogrupował jako Konstantynopolitański.

Grupować możemy też wyjątki tzn. pojedyncze wystąpienie - a nie wszystkie jak w tym przykładzie - ale omówię to później w punkcie A-8).

</namemaps>

2️⃣-B3) Element: <tags></tags> ;

Kolejnym ważnym zbiorem są TAGI, pomagają w pracy nad zasobem, możemy na przykład utworzyć tag "Nieczytelne dane w metryce" ,i podpinać go kolejno do wszystkich informacji które wymagają dalszej pracy nad nimi. Albo utworzyć tag "🔗💜⤵️" oraz "🔗💜⤴️" i podpinać je odpowiednio do każdego przodka, lub każdego krewnego by szybciej się połapać kto jest kim. Tagi oprócz swojej nazwy, posiadają przypisany priorytet który nie może się powtarzać oraz kolor - dzięki niemu widzimy od razu co ten tag ma a co nie,

<tags>

</tags>

2️⃣-B4) Element: <bookmarks></bookmarks> ;

Kolejny elementem ułatwiający pracę, są zakładki, możemy przypiąć poszczególne elementy osoby, rodziny, miejsca, notatki, wydarzenia, źródła i obiekty.

</bookmarks>

2️⃣-C1) Element: <families></families> i <family></family> ;

Rodzina to podstawowa komórka społeczna. Element <families> jest elementem zbiorczym gromadzącym elementy <family> . Pojedyncza rodzina to Ojciec/Mąż/Partner <father /> i Matka/Żona/Partnerka <mother /> , oraz ich dzieci <childref /> . Oczywiście może istnieć rodzina z nieznanymi rodzicami lub rodzicem, podobnie jak rodzina bez dzieci. Podstawowym atrybutem rodziny jest prywatność informacji priv = "1" (wartość 1=tak, 0=nie). Najważniejszym elementem jest <rel type = "Married"/> określa on relacje pomiędzy ojcem/mężem/partnerem a matką/żoną/partnerką.
Dla każdej rodziny możemy dołączyć cytaty źródłowe <citationref hlink = "_fd3882047ae50d90223c224fb67"/> , notatki <noteref hlink = "_fd3881be19c16a35158075b0d5b"/> i tagi <tagref hlink = "_fd38a5dc3083c4e7e3ed477dd46"/>
Do rodziny możemy dołączania dzieci. Tu podobnie jak poprzednio możemy zwyczajnie dołączyć obiekt <childref hlink="_S3GKQCSAUG5LKNW2AK" priv="0" mrel="Brith" mrel="Brith"/> , albo dodać więcej informacji na temat związku dziecka z rodzicami. Czyli cytaty źródłowe i notatki.
Kolejnymi elementami są wydarzenia <eventref hlink = "_fd387b02e29adb65884a2db9bc" role = "Parents"/> , cecha "role" określa rodzaj udziału tej rodziny w wydarzeniu, czyli np. w chrzcie dziecka, rodzice są rodzicami stąd "Parents".
Każda rodzina może posiadać różne atrybuty ją opisujące, atrybuty mogą być podstawowe <attribute /> (czyli takie które zawierają nazwę i zawartość), lub szczegółowe <attribute> </attribute> (wtedy atrybut dodatkowo może zawierać: cytaty z źródeł i notatki); dodatkowo atrybuty również mogą być prywatne priv = "1" (wartość 1=tak, 0=nie).
Kolejnym elementem który możemy podpiąć pod rodzinę są zdjęcia - obiekty multimedia. Podobnie jak atrybuty obiekty multimedialne mogą być podstawowe <objref hlink = "_78V2GQX2FKNSYQ3OHE" priv = "0" /> (czyli takie które zawierają tylko odsyłacz do obiektu), lub szczegółowe <objref> </objref> Należy mieć na uwadze że informacje zawarte w "objref" - nie odnoszą się do samego obiektu, a do jego użycia w kontekście tej rodziny. Możemy tu umieścić wewnętrzne atrybuty, cytaty źródłowe i notatki. Dodatkowo możemy zaznaczyć konkretny prostokąt do którego odwołujemy się np. zaznaczając twarze - umieszczamy to w elemencie <region corner1_x = "30" corner1_y = "18" corner2_x = "71" corner2_y = "46"/> .

</childref>

</childref>

</childref>

</attribute>

</objref>

</objref>

</family>

</families>

2️⃣-C2) Element: <people></people> i <person></person> ;

Osoba to podstawowa jednostka społeczna. Element <people home="_fd285701e4f28dc628a69f137de"> jest elementem zbiorczym gromadzącym elementy <person> .

2️⃣-C3) Element: <events></events> i <event></event> ;

.....

2️⃣-C4) Element: <places></places> i <placeobj></placeobj> ;

.....

2️⃣-C5) Element: <objects></objects> i <object></object> ;

.....

2️⃣-C6) Element: <sources></sources> i <source></source> ;

.....

2️⃣-C7) Element: <citations></citations> i <citation></citation> ;

.....

2️⃣-C8) Element: <repositories></repositories> i <repository></repository> ;

.....

2️⃣-C9) Element: <notes></notes> i <note></note> ;

.....