JMÉNO
gramps - programový systém pro správu genealogického výzkumu a analýzy.
POUŽITÍ
gramps [-?|--help] [--usage] [--version] [-l] [-u|--force-unlock] [-O|--open= DATABÁZE [-f|--format= FORMÁT]] [-i|--import= SOUBOR [-f|--format= FORMÁT]] [-i|--import= ...] [-e|--export= SOUBOR [-f|--format= FORMÁT]] [-a|--action= AKCE] [-p|--options= PARAMETRY]] [ SOUBOR ] [--version]
POPIS
Gramps je zdarma šířený Open Source genealogický program. Je napsán v jazyce Python s využitím rozhraní GTK+/GNOME. Gramps bude povědomý komukoli, kdo už pracoval s jinými genealogickými programy jako Family Tree Maker (TM), Personal Ancestral Files (TM), nebo GNU Geneweb. Podporuje import dat z populárního formátu GEDCOM, který je celosvětově rozšířen a je využíván téměř všemi ostatními genealogickými programy.
MOŽNOSTI
gramps SOUBOR
Pokud je zadán SOUBOR (bez dalších parametrů) jako název rodokmenu nebo jako adresář databáze rodokmenu, je gramps otevřeno v interaktivním módu. Pokud je SOUBOR formátem podporovaným Gramps, je vytvořen rodokmen s názvem založeným na názvu souboru a data ze vstupu jsou do něho naimportována. Zbytek parametrů příkazové řádky je ignorován. Tento způsob spouštění je vhodný pro gramps použitý jako prohlížeč genealogických dat např. pro webové prohlížeče. Spuštění tímto způsobem zpracuje jakákoli data ve formátu podporovaném gramps, viz dále.
-f,--format= FORMÁT
Explicitně definuje formát SOUBORu předchozího parametru -i, nebo -e. Pokud není parametr -f pro SOUBOR specifikován, bude automaticky použit formát odpovídající koncovce souboru nebo MIME-typu.
Formáty dostupné pro export jsou gramps-xml (automaticky použit pokud má SOUBOR koncovku .gramps), gedcom (automaticky použit pokud má SOUBOR koncovku .ged), případně jiný další formát dostupný prostřednictvím zásuvných modulů Gramps.
Formáty dostupné pro import jsou grdb, gramps-xml, gedcom, gramps-pkg (automaticky použit pokud má SOUBOR koncovku .gpkg), nebo geneweb (automaticky použit pokud má SOUBOR koncovku .gw).
Formáty dostupné pro export jsou gramps-xml, gedcom, gramps-pkg, wft (automaticky použit pokud má SOUBOR koncovku .wft), geneweb, a iso (nikdy není použit automaticky, vždy musí být specifikován parametrem -f).
-l |
Vypíše seznam známých rodokmenů. |
-u,--force-unlock
Odemkne zamčenou databázi.
-O,--open= DATABÁZE
Otevření DATABÁZE. Hodnota musí být existujícím databázovým adresářem, nebo názvem existujícího rodokmenu. Pokud na příkazové řádce nejsou žádné parametry importu nebo exportu, je nad danou databází spuštěna interaktivní relace.
-i,--import= SOUBOR
Importuje data ze SOUBORu. Pokud není specifikována databáze, je použita dočasná. Ta je po ukončení gramps smazána.
Pokud je předáván více než jeden vstup, musí každému souboru předcházet parametr -i. Soubory jsou zpracovávány v pořadí, v jakém byly zadány na příkazové řádce. Např. -i SOUBOR1 -i SOUBOR2 a -i SOUBOR2 -i SOUBOR1 mohou vytvořit ve výsledné databázi různá gramps ID.
-a,--action= AKCE
Provedení AKCE nad importovanými daty. Akce jsou spuštěny poté co jsou všechny importy dat úspěšně ukončeny. V tuto chvíli jsou podporovány následující akce: summary (stejné jako Zprávy->Pohled->Souhrn), check (stejné jako Nástroje->Database Processing->Kontrola a oprava), report (vytvoří zprávu), a tool (spustí nástroj zásuvného modulu). Akce report a tool potřebují v PARAMETRY zadat parametr -p .
PARAMETRY
by měly splňovat následující
kritéria:
Nesmí obsahovat žádné mezery.
Pokud některý argument potřebuje mezeru,
musí být řetězec uzavřen v
uvozovkách (držet se syntaxe
příkazové řádky).
Řetězec možností je seznam
párů název=hodnota. Jednotlivé
páry musí být odděleny
čárkami.
Většina možností nástrojů a zpráv jsou specifickými pro konkrétní nástroj nebo zprávu. Existují ale i takové, které jsou společné.
name=name
Povinná předvolba určující
který nástroj nebo zpráva bude
spuštěna. Pokud zadané name
neodpovídá žádné
dostupné funkčnosti, vypíše se
chybové hlášení
následované seznamem dostupných
nástrojů a zpráv
(záleží na AKCE).
show=all
Vytvoří seznam názvů všech
předvoleb dostupných pro danou zprávu
nebo nástroj.
show=optionname
Vypíše popis všech funkcionalit
poskytnutých optionname, ale také
všechny přijatelné typy a hodnoty pro
tuto volbu.
Použijte výše popsané volby pro zjištění všech možností dané zprávy.
Pokud je
zadána jedna nebo více
výstupních akcí, každá
musí být uvozena předvolbou -a.
Akce jsou prováděny jedna za druhou v
zadaném pořadí.
-d,--debug= LOGGER_NAME
Zapne ladicí výstup pro vývoj a testování. Detaily najdete ve zdrojovém kódu.
--version
Vytiskne číslo verze gramps a skončí
Chování
Pokud první parametr příkazové řádky nezačíná pomlčkou, pokusí se gramps otevřít soubor s názvem daným prvním argumentem na příkazové řádce a spustit interaktivní relaci. Zbytek argumentů na příkazové řádce je v tomto případě ignorován.
Pokud je zadán parametr -O, pak se gramps snaží otevřít zadanou databázi a pracovat s jejími daty podle instrukcí dalších parametrů příkazové řádky.
S nebo bez použití parametru -O může být provedeno více importů, exportů, případně akcí daných argumenty příkazové řádky (-i, -e a -a).
Na pořadí parametrů -i, -e, nebo -a nezáleží. Aktuální pořadí zpracování je vždy: všechny importy (pokud jsou nějaké) -> všechny akce (pokud jsou nějaké) -> všechny exporty (pokud jsou nějaké). Parametr otevření musí být ale vždy první!
Pokud nejsou zadány -O nebo -i, gramps otevře své hlavní okno a spustí se v obvyklém interaktivním módu s prázdnou databází.
Pokud nejsou zadány -e nebo -a, gramps otevře své hlavní okno a spustí se v ovbyklém interaktnivním módu s databází vzniklou výsledkem všech importů. Tato databáze je umístěna v souboru import_db.grdb v adresáři ~/.gramps/import.
Chyba vzniklá při importu, exportu nebo akci bude vypsána na stdout (pokud se jedná o vyjímku ošetřenou gramps) nebo na stderr (pokud problém není ošetřen). Pro uložení zpráv a chyb do souboru použijte obvyklá přesměrování výstupů stdout a stderr příkazové řádky.
PŘÍKLADY
Otevření
existujícího rodokmenu a import xml souboru do
něho může být
proveden takto:
gramps -O ’Můj rodokmen’ -i ~/db3.gramps
To samé, jen s importem
do dočasné databáze a
otevřením interaktivní
relace:
gramps -i ’My Family Tree’ -i ~/db3.gramps
Import čtyř
databází (jejichž formáty jsou
stanoveny podle názvů
souborů) a následná kontrola bezchybnosti
výsledné databáze může
být
provedena takto:
gramps -i file1.ged -i file2.tgz -i ~/db3.gramps -i file4.wft -a check
Explicitní specifikace
formátu databází
předchozího příkladu
přidáním
příslušného parametru -f za
název souboru:
gramps -i file1.ged -f gedcom -i file2.tgz -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check
Zapsání
výsledné databáze vytvořené
ze všech importů zajistí parametr
-e (použijte -f pokud nelze uhodnout
formát z názvu souboru):
gramps -i file1.ged -i file2.tgz -e ~/nový-balíček -f gramps-pkg
Import tří databází a start interaktivní gramps relace nad výsledkem:
gramps -i file1.ged -i file2.tgz -i ~/db3.gramps
Spuštění nástroje kontroly z příkazové řádky s výstupem na stdout:
gramps -O ’Můj rodokmen’ -a tool -p name=verify
A konečně spuštění normální interaktivní relace aplikace:
gramps
PROMĚNNÉ PROSTŘEDÍ
Program kontroluje, zda jsou nastaveny následující proměnné:
LANG - popisuje, který jazyk bude použit: Příklad: pro češtinu musí mít proměnná hodnotu cs_CZ.utf8.
GRAMPSHOME - pokud je nastavena, Gramps použije její hodnotu jako adresář v němž jsou uložena nastavení a databáze. Ve výchozím stavu, kdy proměnná není nastavena gramps předpokládá že adresář s databázemi a nastavením bude vytvořen v adresáři s uživatelským profile (popsán proměnnou prostředí HOME v Linuxu nebo USERPROFILE ve Windows 2000/XP).
KONCEPTY
gramps podporuje systém zásuvných modulů založených na jazyku python jehož prostřednictvím umožňuje přidání import/export modulů, modulů pro vytváření zpráv, nástrojů a zobrazovacích filtrů bez nutnosti zásahu do hlavního programu.
Dále, krom možnosti přímého tisku, dovoluje směřovat výstup také k ostatním systémům a aplikacím jako např. OpenOffice.org, AbiWord, HTML, nebo LaTeX. Tím dává možnost přizpůsobit formát požadavku uživatelů.
ZNÁMÉ CHYBY A OMEZENÍ
nejsou
SOUBORY
${PREFIX}/bin/gramps
${PREFIX}/share/gramps
${HOME}/.gramps
AUTOŘI
Donald
Allingham <don [AT] gramps-project.org>
http://gramps.sourceforge.net
Originální
manuálovou stránku vytvořil:
Brandon L. Griffith <brandon [AT] debian.org>
pro zařazení do systému Debian
GNU/Linux.
Tuto
manuálovou stránku přeložil a v
současné době spravuje:
Zdeněk Hataš
<zdenek.hatas [AT] gmail.com>
DOKUMENTACE
Uživatelská dokumentace je k dispozici prostřednictvím standardního prohlížeče nápovědy GNOME ve formě příručky Gramps. Příručka je také dostupná ve formátu XML jako gramps-manual.xml v adresáři doc/gramps-manual/$LANG v oficiální distribuci zdrojového kódu.
Dokumentace pro vývojáře je k dispozici na webu http://developers.gramps-project.org.