|
|
| |
gramps(1) |
5.1.5 |
gramps(1) |
gramps - programový systém pro správu genealogického
výzkumu a analýzy.
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]
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.
- 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čí
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.
- 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
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).
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ů.
${PREFIX}/bin/gramps
${PREFIX}/share/gramps
${HOME}/.gramps
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>
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.
Visit the GSP FreeBSD Man Page Interface. Output converted with ManDoc. |