other versions
- jessie 4.1.1~dfsg-3
- jessie-backports 4.2.5~dfsg-1~bpo8+1
- stretch 4.2.5~dfsg-1
- testing 5.0.1-1
- stretch-backports 5.0.1-1~bpo9+1
- unstable 5.0.1-1
other languages
gramps(1) | 4.1.1 | gramps(1) |
NAME¶
gramps - Genealogical Research and Analysis Management Programming System.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= 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ł innego programu genealogicznego (np. Family Tree Maker (TM), Personal Ancestral Files (TM), lub GNU Geneweb), zapoznanie się z interfejsem Gramps'a będzie natychmiastowe. Program obsługuje także import i eksport w popularnym formacie GEDCOM, który 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łe opcje są wtedy ignorowane. Jest to sposób
na używanie programu jako uchwytu obsługującego dane
genealogiczne, np. w przeglądarce internetowej. Takie
wywołanie akceptuje każdy format natywny dla grampsa, zobacz
poniżej.
- -f,--format= FORMAT
- Jawne określenie formatu PLIKU przez poprzedzenie opcji
-i, lub -e. Jeśli opcja -f nie jest podana dla
żadnego PLIKU, to format pliku jest określany na
podstawie rozszerzenia albo typu MIME.
- -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.
- -e,--export= 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.
- -a,--action= AKCJA
- Wykonuje AKCJĘ na zaimportowanych danych. Działanie
to jest wykonywane dopiero, gdy wszystkie określone importy
zakończą się powodzeniem. Aktualnie dostępne
akcje to:
- -d,--debug= NAZWA_LOGGERA
- Włącza logi debuggowania dla celów programistycznych i testowych. Zobacz do kodu źródłowego po szczegóły.
- --version
- Wyświetla wersję programu i kończy działanie.
- --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.
- --disable-sound
- Wyłącza użycie serwera dźwięku.
- --enable-sound
- Włącza użycie serwera dźwięku.
- --espeaker= HOSTNAME:PORT
- Host:port na którym jest uruchomiony serwer dźwięku.
Działanie¶
Jeśli pierwszy argument nie rozpoczyna się znakiem myślnik, (nie jest flagą), to gramps będzie próbował otworzyć plik podany przez pierwszy argument, a następnie sesję interaktywną a pozostałą część parametrów w linii poleceń zignoruje. Jeśli podana jest flaga -O, będzie próbował otworzyć podaną bazę 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, -e, oraz -a . Kolejność podawania opcji -i, -e, 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łówne okno i rozpocznie normalną sesję interaktywną z pustą bazą danych (ponieważ nie zdołał przetworzyć do niej żadnych danych). Jeśli nie podano opcji -e albo -a gramps uruchomi swoje głowne 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łąd podczas importu, eksportu albo dowolnej akcji będzie przekierowany na stdout (jeśli wyjątek zostanie obsłużony przez gramps) albo na stderr (jeśli nie jest obsłużony). Użyj standardowych przekierowań strumieni stdout oraz stderr jeśli chcesz zapisać wyświetlane informacje i błędy do pliku.PRZYKŁADY¶
- 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łą bazę pod kątem błędów, należy wpisać: gramps -i plik1.ged -i plik2.tgz -i ~/db3.gramps -i plik4.wft -a check
- Aby jawnie określić formaty w powyższym przykładzie, należy dodać nazwy plików
- 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ę -e (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 -e ~/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ługa systemu rozszerzeń bazującego na pythonie, pozwalającego na dodawanie formatów importu i eksportu zapisów, generatorów raportów, narzędzi i filtrów wyświetlania bez modyfikowania głównego programu 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ŁĘDY I OGRANICZENIA¶
Prawdopodobne. Lista błędów i propozycji znajduje się na: http://developers.gramps-project.org.PLIKI¶
${PREFIX}/bin/grampsAUTORZY¶
Donald Allingham <don@gramps-project.org>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łównym źródle dystrybucji. Dokumentacja dla programistów jest dostępna na stronie projektu: http://developers.gramps-project.org.4.1.1 | January 2008 |