gramps(1) 6.0.5 gramps(1) NAME gramps - Genealogical Research and Analysis Management Programming System. (w wolnym tlumaczeniu: System Wspomagania Badan Genealogicznych i Programowego Zarzadzania Ta Informacja) SYNOPSIS gramps [-?|--help] [--usage] [--version] [-l] [-u|--force-unlock] [-O|--open= BAZA_DANYCH [-f|--format= FORMAT]] [-i|--import= PLIK [-f|--format= FORMAT]] [-i|--import= ...] [-e|--export= PLIK [-f|--format= FORMAT]] [-a|--action= AKCJA] [-p|--options= CIAG_OPCJI]] [ PLIK ] [--version] OPIS Gramps jest wolnym, darmowym programem genealogicznym OpenSource. Jest napisany w Python, przy uzyciu interfejsu GTK+/GNOME. Dla kazdego, kto wczesniej uzywal innego programu genealogicznego (np. Family Tree Maker (TM), Personal Ancestral Files (TM), lub GNU Geneweb), zapoznanie sie z interfejsem Gramps'a bedzie natychmiastowe. Program obsluguje takze import i eksport w popularnym formacie GEDCOM, ktory jest uzywany przez wiekszosc programow genealogicznych na swiecie. OPCJE gramps PLIK Kiedy PLIK jest podany (bez zadnych flag) jako nazwa drzewa rodzinnego albo nazwa katalogu z drzewem, to wybrane drzewo jest otwierane i rozpoczynana jest sesja interaktywna. Jesli PLIK jest formatem rozpoznawanym przez Gramps, to tworzone jest puste drzewo, ktorego nazwa bazuje na nazwie PLIKU i dane sa do niego importowane. Pozostale opcje sa wtedy ignorowane. Jest to sposob na uzywanie programu jako uchwytu obslugujacego dane genealogiczne, np. w przegladarce internetowej. Takie wywolanie akceptuje kazdy format natywny dla grampsa, zobacz ponizej. -f,--format= FORMAT Jawne okreslenie formatu PLIKU przez poprzedzenie opcji -i, lub -e. Jesli opcja -f nie jest podana dla zadnego PLIKU, to format pliku jest okreslany na podstawie rozszerzenia albo typu MIME. Dostepne formaty wyjsciowe to: gramps-xml (uzywany jesli PLIK konczy sie na .gramps), gedcom (przyjmowany jesli PLIK konczy sie na .ged), lub dowolny plik eksportu obslugiwany przez system wtyczek Gramps. Formaty dostepne dla importu to: grdb, gramps-xml, gedcom, gramps-pkg (przyjmowany jesli PLIK konczy sie na .gpkg), oraz geneweb (przyjmowany jesli PLIK ma rozszerzenie .gw). Formats dostepne dla eksportu to: gramps-xml, gedcom, gramps-pkg, wft (jesli rozszerzenie PLIKU to .wft), geneweb, i iso (uzywany tylko, jesli jawnie okreslony przez parametr -f ). -l Wyswietla liste dostepnych drzew genealogicznych. -u,--force-unlock Wymusza odblokowanie bazy danych. -O,--open= BAZA_DANYCH Otwiera BAZE_DANYCH, ktora musi istniec w katalogu baz lub byc nazwa istniejacego drzewa rodzinnego. Jesli nie podano akcji, to opcje eksportu albo importu sa wykonywane, a nastepnie jest uruchamiana sesja interaktywna z otwarciem wybranej bazy. -i,--import= PLIK Importuje dane z PLIKU. Jesli nie okreslono bazy danych, to tworzona jest tymczasowa baza kasowana po zamknieciu programu. Kiedy podany jest wiecej niz jeden plik do importu, to kazdy z nich musi byc poprzedzony flaga -i. Pliki sa importowane w kolejnosci podanej w linii polecen, np.: -i PLIK1 -i PLIK2 oraz -i PLIK2 -i PLIK1 moga utworzyc inne identyfikatory (gramps ID) w bazie wynikowej. -e,--export= PLIK Eksportuje dane do PLIKU. Dla formatu iso, PLIK natomiast nazwa katalogu, do ktorego baza danych gramps zostanie zapisana. Dla gramps-xml, gedcom, wft, gramps-pkg, oraz geneweb, PLIK jest nazwa pliku wynikowego. Kiedy wiecej niz jeden plik wyjsciowy jest podany, kazdy musi byc poprzedzony flaga -e. Pliki beda zapisywane kolejno, w podanej przez parametry kolejnosci. -a,--action= AKCJA Wykonuje AKCJE na zaimportowanych danych. Dzialanie to jest wykonywane dopiero, gdy wszystkie okreslone importy zakoncza sie powodzeniem. Aktualnie dostepne akcje to: summary (taka sama jak Raporty->Wyswietl->Podsumowanie bazy danych), check (tozsama z Narzedzia->Naprawa bazy danych->Sprawdz i napraw baze), report (generuje raport), oraz tool (uruchamia narzedzie/wtyczke). Zarowno report jak i tool wymagaja podania CIAGU_OPCJI poprzedzonego flaga -p ). CIAG_OPCJI powinien spelniac nastepujace warunki: Nie moze zawierac spacji. Jesli niektore argumenty wymagaja spacji, ciag powinien byc enkapsulowany w znakach cudzyslowu, (zobacz skladnie powloki). Ciag opcji jest lista parametrow z nazwa i wartoscia oddzielonymi znakiem rownosci. Kolejne parametry musza byc oddzielone od siebie znakiem przecinka. Wiekszosc opcji dla raportow czy narzedzi jest specyficzna dla konkretnej opcji, jednak czesc z opcji jest wspolna, szczegolnie dla raportow. name=nazwa Opcja wymagana, okreslajacy ktory raport czy narzedzie bedzie uruchamiane. Jesli podana wartosc nazwy nie pasuje do zadnego dostepnego raportu czy narzedzia, zostanie wyswietlony komunikat o bledzie oraz lista dostepnych raportow albo opcji (w zaleznosci od wartosci parametru AKCJA). show=all Wyswietla liste wszystkich nazw dostepnych opcji wraz z krotkim opisem dla danego raportu albo narzedzia. show=nazwa_opcji Wyswietla opis funkcji udostepnianej przez dana nazwe_opcji, jak rowniez liste parametrow, ktore akceptuje dana opcja. Uzywajac powyzszych opcji jestes w stanie dowiedziec sie o wszystkich mozliwosciach danego raportu. Kiedy wiecej niz jeden akcja wyjsciowa jest podana, kazda musi byc poprzedzona flaga -a. Akcje sa wykonywane jedna po drugiej, w kolejnosci w jakiej wystepuja w linii polecen. -d,--debug= NAZWA_LOGGERA Wlacza logi debuggowania dla celow programistycznych i testowych. Zobacz do kodu zrodlowego po szczegoly. --version Wyswietla wersje programu i konczy dzialanie. Nastepujace opcje sa uzywane przy aktywacji Bonobo: --oaf-ior-fd=FD Deskryptor pliku, do ktorego wpisac OAF IOR. --oaf-activate-iid= IID OAF IID do aktywacji. --oaf-private Wstgrzymuje rejestracje serwera przez OAF. Nastepujace opcje sa uzywane do kontroli dzwieku generowanego za pomoca Gnome Library. --disable-sound Wylacza uzycie serwera dzwieku. --enable-sound Wlacza uzycie serwera dzwieku. --espeaker= HOSTNAME:PORT Host:port na ktorym jest uruchomiony serwer dzwieku. Dzialanie Jesli pierwszy argument nie rozpoczyna sie znakiem myslnik, (nie jest flaga), to gramps bedzie probowal otworzyc plik podany przez pierwszy argument, a nastepnie sesje interaktywna a pozostala czesc parametrow w linii polecen zignoruje. Jesli podana jest flaga -O, bedzie probowal otworzyc podana baze i pracowac na danych w niej zawartych realizujac podane pozniej polecenia z linii komend. Z flaga -O czy bez, moze wystepowac wiele importow, eksportow oraz akcji okreslonych za pomoca flag -i, -e, oraz -a . Kolejnosc podawania opcji -i, -e, czy -a nie ma znaczenia. Wykonywane sa one zawsze w kolejnosci: wszystkie importy (jesli podane) -> wszystkie akcje (jesli podane) -> wszystkie eksporty (jesli podane) Ale otwarcie bazy zawsze musi byc na pierwszym parametrem ! Jesli nie podano opcji -O lub -i, gramps uruchomi swoje glowne okno i rozpocznie normalna sesje interaktywna z pusta baza danych (poniewaz nie zdolal przetworzyc do niej zadnych danych). Jesli nie podano opcji-e albo -a gramps uruchomi swoje glowne okno i rozpocznie normalna sesje interaktywna z baza bedaca wynikiem wszystkich importow. Ta baza bedzie znajdowac sie w pliku import_db.grdb w katalogu ~/.gramps/import. Blad podczas importu, eksportu albo dowolnej akcji bedzie przekierowany na stdout (jesli wyjatek zostanie obsluzony przez gramps) albo na stderr (jesli nie jest obsluzony). Uzyj standardowych przekierowan strumieni stdout oraz stderr jesli chcesz zapisac wyswietlane informacje i bledy do pliku. PRZYKLADY Aby otworzyc istniejace drzewo rodzinne i zaimportowac dane do niego, mozna wpisac: gramps -O 'Moje drzewo' -i ~/db3.gramps Powyzsza opcja otwiera istniejace drzewo, ale gdy chcesz zrobic wykonac taka sama akcje tworzac tymczasowe drzewo: wystarczy wpisac: gramps -i 'Moje drzewo' -i ~/db3.gramps Aby zaimportowac cztery bazy (ktorych formaty zostana okreslone na podstawie ich nazw) i nastepnie sprawdic powstala baze pod katem bledow, nalezy wpisac: gramps -i plik1.ged -i plik2.tgz -i ~/db3.gramps -i plik4.wft -a check Aby jawnie okreslic formaty w powyzszym przykladzie, nalezy dodac nazwy plikow 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 zachowac baze z wynikami wszystkich importow, nalezy dodac flage -e (nalezy uzyc -f jesli nazwa pliku nie pozwala gramps'owi na odgadniecie formatu wyjsciowego): gramps -i plik1.ged -i plik2.tgz -e ~/nowy-pakiet -f gramps-pkg W celu zaimportwania trzech baz i rozpoczecia sesji interaktywnej z wynikiem importu nalezy uzyc polecenia podobnego do ponizszego: gramps -i plik1.ged -i plik22.tgz -i ~/db3.gramps Aby uruchomic narzedzie weryfikacji z linii polecen i wyswietlic wyniki na stdout: gramps -O 'Moje drzewo' -a tool -p name=verify Zawsze mozna tez po prostu uruchomic sesje interaktywna wpisujac: gramps ZMIENNE SRODOWISKOWE Program sprawdza w systemie istnienie i wartosci nastepujacych zmiennych: LANG - okresla ustawienia, jaki jezyk zostanie wybrany. Np.: polski to pl_PL.UTF-8. GRAMPSHOME - okresla folder, w ktorym bedzie zapisywane ustawienia i bazy programu. Domyslnie jest on nieustawiony, a program przyjmuje, ze katalog z danymi zostanie utworzony w profilu uzytkownika (zmienna HOME pod Linuxem albo USERPROFILE pod Windows 2000/XP). KONCEPCJA Obsluga systemu rozszerzen bazujacego na pythonie, pozwalajacego na dodawanie formatow importu i eksportu zapisow, generatorow raportow, narzedzi i filtrow wyswietlania bez modyfikowania glownego programu Dodatkowo oprocz generowania standardowego wyjscia na drukarke, raporty moga takze byc generowane dla innch systemow i do innych formatow, takich jak: OpenOffice.org, AbiWord, HTML, lub LaTeX aby umozliwic uzytkownikm wybor formatu wyjsciowego w zaleznosci od ich potrzeb. ZNANE BLEDY I OGRANICZENIA Prawdopodobne. Lista bledow i propozycji znajduje sie na: http://developers.gramps-project.org. PLIKI ${PREFIX}/bin/gramps ${PREFIX}/share/gramps ${HOME}/.gramps (jesli nie uzyta zostala zmienna srodowiskowa GRAMPSHOME) AUTORZY Donald Allingham http://gramps.sourceforge.net Ta strona man jest tlumaczeniem strony man napisanej przez: Brandon L. Griffith dla systemu Debian GNU/Linux. Ta strona aktualnie jest pod opeka: Projekt Gramps Tlumaczenie na polski: Lukasz Rymarczyk DOCUMENTATION Dokumentacja uzytkownika jest dostepna poprzez standardowa przegladarke pomocy systemu GNOME. Dokumentacja dostepna jest takze w formacie XML jako plik gramps-manual.xml w folderze doc/gramps-manual/$LANG w glownym zrodle dystrybucji. Dokumentacja dla programistow jest dostepna na stronie projektu: http://developers.gramps-project.org. January 2008 6.0.5 gramps(1)