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.