Ubuntu Manpage: gramps - programový systém pro správu genealogického výzkumu a analýzy.

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@gramps-project.org>
       http://gramps.sourceforge.net

       Originální manuálovou stránku vytvořil:
       Brandon L. Griffith <brandon@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@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.

Leden 2011                                            5.1.5                                            gramps(1)