gramps(1)

NAME

gramps - Genealogical Research and Analysis Management Programming System.
(w wolnym t�
i Programowego Zarz�dzania T� Informacj�)

SYNOPSIS

gramps  [-?|--help]  [--usage]  [--version]  [-l]   [-u|--force-unlock]
[-O|--open=   BAZA_DANYCH  [-f|--format=  FORMAT]]  [-i|--import=  PLIK
[-f|--format=   FORMAT]]   [-i|--import=   ...]    [-o|--output=   PLIK
[-f|--format= FORMAT]] [-a|--action= AKCJA] [-p|--options= CI�G_OPCJI]]
[ PLIK ] [--version]

OPIS

Gramps jest wolnym, darmowym programem genealogicznym OpenSource. Jest napisany w Python, przy użyciu interfejsu GTK+/GNOME. Dla każdego, kto wcze�niej używa�
Family Tree Maker (TM), Personal Ancestral Files (TM), lub GNU Geneweb), zapoznanie si� z interfejsem Gramps'a b�dzie natychmiastowe. Program obs�
jest używany przez wi�kszo�� programów genealogicznych na �wiecie.

OPCJE

gramps PLIK: Kiedy PLIK jest podany (bez żadnych flag) jako nazwa drzewa rodzinnego albo nazwa katalogu z drzewem, to wybrane drzewo jest otwierane i rozpoczynana jest sesja interaktywna. Je�li PLIK jest formatem rozpoznawanym przez GRAMPS, to tworzone jest puste drzewo, którego nazwa bazuje na nazwie PLIKU i dane s� do niego importowane. Pozosta�
Jest to sposób na używanie programu jako uchwytu obs�
dane genealogiczne, np. w przegl�darce internetowej. Takie wywo� każdy format natywny dla grampsa, zobacz poniżej.
-f,--format= FORMAT: Jawne okre�lenie formatu PLIKU przez poprzedzenie opcji -i, lub -o. Je�li opcja -f nie jest podana dla żadnego PLIKU, to format pliku jest okre�lany na podstawie rozszerzenia albo typu MIME.; Dost�pne formaty wyj�ciowe to:
gramps-xml (używany je�li PLIK ko� gedcom (przyjmowany je�li PLIK ko�
lub dowolny plik eksportu obs�
.br; Formaty dost�pne dla importu to: grdb, gramps-xml, gedcom, gramps-pkg (przyjmowany je�li PLIK ko� oraz geneweb (przyjmowany je�li PLIK ma rozszerzenie .gw).; Formats dost�pne dla eksportu to: gramps-xml, gedcom, gramps-pkg, wft (je�li rozszerzenie PLIKU to .wft), geneweb, i iso (używany tylko, je�li jawnie okre�lony przez parametr -f ).
-l Wy�wietla list� dosŧ�pnych drzew genealogicznych.
-u,--force-unlock: Wymusza odblokowanie bazy danych.
-O,--open= BAZA_DANYCH: Otwiera BAZ�_DANYCH, która musi istnie� w katalogu baz lub by� nazw� istniej�cego drzewa rodzinnego. Je�li nie podano akcji, to opcje eksportu albo importu s� wykonywane, a nast�pnie jest uruchamiana sesja interaktywna z otwarciem wybranej bazy.
-i,--import= PLIK: Importuje dane z PLIKU. Je�li nie okre�lono bazy danych, to tworzona jest tymczasowa baza kasowana po zamkni�ciu programu.; Kiedy podany jest wi�cej niż jeden plik do importu, to każdy z nich musi by� poprzedzony flag� -i. Pliki s� importowane w kolejno�ci podanej w linii polece� np.: -i PLIK1 -i PLIK2 oraz -i PLIK2 -i PLIK1 mog� utworzy� inne identyfikatory (gramps ID) w bazie wynikowej.
-o,--output= PLIK: Eksportuje dane do PLIKU. Dla formatu iso, PLIK natomiast nazw� katalogu, do którego baza danych gramps zostanie zapisana. Dla gramps-xml, gedcom, wft, gramps-pkg, oraz geneweb, PLIK jest nazw� pliku wynikowego.; Kiedy wi�cej niż jeden plik wyj�ciowy jest podany, każdy musi by� poprzedzony flag� -o. Pliki b�d� zapisywane kolejno, w podanej przez parametry kolejno�ci.
-a,--action= AKCJA: Wykonuje AKCJ� na zaimportowanych danych. Dzia�
dopiero, gdy wszystkie okre�lone importy zako�dost�pne akcje to: summary (taka sama jak Raporty->Wy�wietl->Podsumowanie bazy danych),
check (tożsama z Narz�dzia->Naprawa bazy danych->Sprawdź i napraw baz�),
report (generuje raport), oraz
tool (uruchamia narz�dzie/wtyczk�). Zarówno report jak i tool wymagaj� podania CI�GU_OPCJI poprzedzonego flag� -p ).; CI�G_OPCJI powinien spe�
.br Nie może zawiera� spacji. Je�li niektóre argumenty wymagaj� spacji, ci�g powinien by� enkapsulowany w znakach cudzys� parametrów z nazw� i warto�ci� oddzielonymi znakiem równo�ci. Kolejne parametry musz� by� oddzielone od siebie znakiem przecinka.; Wi�kszo�� opcji dla raportów czy narz�dzi jest specyficzna dla konkretnej opcji, jednak cz�� z opcji jest wspólna, szczególnie dla raportów.; name=nazwa
Opcja wymagana, okre�laj�cy który raport czy narz�dzie b�dzie uruchamiane. Je�li podana warto�� nazwy nie pasuje do żadnego dost�pnego raportu czy narz�dzia, zostanie wy�wietlony komunikat o b�
raportów albo opcji (w zależno�ci od warto�ci parametru AKCJA).; show=all
Wy�wietla list� wszystkich nazw dost�pnych opcji wraz z krótkim opisem dla danego raportu albo narz�dzia.; show=nazwa_opcji
Wy�wietla opis funkcji udost�pnianej przez dan� nazw�_opcji, jak również list� parametrów, które akceptuje dana opcja.; Używaj�c powyższych opcji jeste� w stanie dowiedzie� si� o wszystkich możliwo�ciach danego raportu.
Kiedy wi�cej niż jeden akcja wyj�ciowa jest podana, każda musi by� poprzedzona flag� -a. Akcje s� wykonywane jedna po drugiej, w kolejno�ci w jakiej wyst�puj� w linii polece�.
-d,--debug= NAZWA_LOGGERA: W�
do kodu źród�
--version: Wy�wietla wersj� programu i ko�
Nast�puj�ce opcje s� używane przy aktywacji Bonobo:
--oaf-ior-fd=FD: Deskryptor pliku, do którego wpisa� OAF IOR.
--oaf-activate-iid= IID: OAF IID do aktywacji.
--oaf-private: Wstgrzymuje rejestracj� serwera przez OAF.
Nast�puj�ce opcje s� używane do kontroli dźwi�ku generowanego za pomoc� Gnome Library.
--disable-sound: Wy�
.TP --enable-sound W�
.TP --espeaker= HOSTNAME:PORT Host:port na którym jest uruchomiony serwer dźwi�ku.

Dzia�

.br
Je�li pierwszy argument nie rozpoczyna si� znakiem my�lnik, (nie jest flag�), to gramps b�dzie próbowa�
nast�pnie sesj� interaktywn� a pozosta�

Je�li podana jest flaga -O, b�dzie próbowa�
i pracowa� na danych w niej zawartych realizuj�c podane później polecenia z linii komend.

Z flag� -O czy bez, może wyst�powa� wiele importów, eksportów oraz akcji okre�lonych za pomoc� flag -i, -o, oraz -a .

Kolejno�� podawania opcji -i, -o, czy -a nie ma znaczenia. Wykonywane s� one zawsze w kolejno�ci: wszystkie importy (je�li podane) -> wszystkie akcje (je�li podane) -> wszystkie eksporty (je�li podane) Ale otwarcie bazy zawsze musi by� na pierwszym parametrem !

Je�li nie podano opcji -O lub -i, gramps uruchomi swoje g�
okno i rozpocznie normaln� sesj� interaktywn� z pust� baz� danych (ponieważ nie zdo�

Je�li nie podano opcji-o albo -a gramps uruchomi swoje g�
okno i rozpocznie normaln� sesj� interaktywn� z baz� b�d�c� wynikiem wszystkich importów. Ta baza b�dzie znajdowa� si� w pliku import_db.grdb w katalogu ~/.gramps/import.

B�
stdout (je�li wyj�tek zostanie obs�
stderr (je�li nie jest obs�
informacje i b�

PRZYK�

.TP
Aby otworzy� istniej�ce drzewo rodzinne i zaimportowa� dane do niego, można wpisa� : gramps -O 'Moje drzewo' -i ~/db3.gramps

Powyższa opcja otwiera istniej�ce drzewo, ale gdy chcesz zrobi� wykona� tak�: sam� akcj� tworz�c tymczasowe drzewo: wystarczy wpisa� : gramps -i 'Moje drzewo' -i ~/db3.gramps
Aby zaimportowa� cztery bazy (których formaty zostan� okre�lone na podstawie: ich nazw) i nast�pnie sprawdi� powsta�
gramps -i plik1.ged -i plik2.tgz -i ~/db3.gramps -i plik4.wft -a check
Aby jawnie okre�li� formaty w powyższym przyk� z odpowiednimi opcjami -f options:: gramps -i plik1.ged -f gedcom -i plik2.tgz -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i plik4.wft -f wft -a check
Aby zachowa� baz� z wynikami wszystkich importów, należy doda� flag� -o (należy uży� -f je�li nazwa pliku nie pozwala gramps'owi na odgadni�cie formatu wyj�ciowego):: gramps -i plik1.ged -i plik2.tgz -o ~/nowy-pakiet -f gramps-pkg
W celu zaimportwania trzech baz i rozpocz�cia sesji interaktywnej z wynikiem: importu należy uży� polecenia podobnego do poniższego: gramps -i plik1.ged -i plik22.tgz -i ~/db3.gramps
Aby uruchomi� narz�dzie weryfikacji z linii polece� i wy�wietli� wyniki na: stdout: gramps -O 'Moje drzewo' -a tool -p name=verify
Zawsze można też po prostu uruchomi� sesj� interaktywn� wpisuj�� :: gramps

ZMIENNE �RODOWISKOWE

Program sprawdza w systemie istnienie i warto�ci nast�puj�cych zmiennych:

LANG - okre�la ustawienia, jaki j�zyk zostanie wybrany. Np.: polski to pl_PL.UTF-8.

GRAMPSHOME - okre�la folder, w którym b�dzie zapisywane ustawienia i bazy programu. Domy�lnie jest on nieustawiony, a program przyjmuje, że katalog z danymi zostanie utworzony w profilu użytkownika (zmienna HOME pod Linuxem albo USERPROFILE pod Windows 2000/XP).

KONCEPCJA

Obs�
formatów importu i eksportu zapisów, generatorów raportów, narz�dzi i filtrów wy�wietlania bez modyfikowania g�
.LP Dodatkowo oprócz generowania standardowego wyj�cia na drukark�, raporty mog� także by� generowane dla innch systemów i do innych formatów, takich jak: OpenOffice.org, AbiWord, HTML, lub LaTeX aby umożliwi� użytkownikm wybór formatu wyj�ciowego w zależno�ci od ich potrzeb.

ZNANE B�

Prawdopodobne. Lista b�
http://developers.gramps-project.org.

PLIKI

${PREFIX}/bin/gramps
${PREFIX}/share/gramps
${HOME}/.gramps (je�li nie użyta zosta�

AUTORZY

Donald Allingham <don@gramps-project.org> http://gramps.sourceforge.net

Ta strona man jest t�
.br Brandon L. Griffith <brandon@debian.org> dla systemu Debian GNU/Linux.

Ta strona aktualnie jest pod opek�:
Projekt Gramps<xxx@gramps-project.org> T�
.br

DOCUMENTATION

Dokumentacja użytkownika jest dost�pna poprzez standardow� przegl�dark� pomocy systemu GNOME. Dokumentacja dost�pna jest także w formacie XML jako plik gramps-manual.xml w folderze doc/gramps-manual/$LANG w g�
.LP Dokumentacja dla programistów jest dost�pna na stronie projektu: http://developers.gramps-project.org.

docs.sk

comprehensive documentation repository

Most Viewed