# Parancssor használata

Ez a fejezet segítséget kíván nyújtani a &app; terminálban való futtatásához.

A &app; eredendően egy interaktivitást igénylő program. Mivel grafikus felületet használ, nem futtatható a hagyományos nem grafikus konzolról. Hatalmas munkát igényelne a program teljesen szöveges konzolon való futtatásának az elérése. A parancssori felhasználással, gyakori (ismétlődő) folyamatokat lehet egyszerűbbé/ kényelmesebbé tenni. Akár scriptekben is alkalmazhatóak a következő kapcsolók. Ennek ellenére a grafikai felület mindig elérhető kell, hogy legyen!

Összefoglalva, a parancssor használatával interaktivitásmentesen lehet futtatni a programot, de ettől még nem lesz független a grafikai elemektől. Vagy megszoksz vagy megszöksz! :)

## Az elérhető kapcsolók

Itt a lista a &app; parancssori kapcsolóiról:

Formátum kapcsolók

  Az importálás/exportálás fájlformátumát az `-f` formátum paraméterezéssel lehet megadni. A formátum a következő lehet:

  gramps

    &app; adatbázisa. Ez a formátum mind importáláshoz mind exportáláshoz használható. Ha nincsen pontosan definiálva, akkor a megadott név könyvtárnévként értelmeződik.

  gedcom

    GEDCOM fájl. Ez a formátum mind importáláshoz mind exportáláshoz használható. Ha nincsen pontosan definiálva, akkor a megadott fájlnévnek .ged -re kell végződnie.

  gramps-pkg

    &app; csomag. Ez a formátum mind importáláshoz mind exportáláshoz használható. Ha nincsen pontosan definiálva, akkor a megadott fájlnévnek .tgz -re kell végződnie.

  wft

    Web Family Tree. Ez a formátum tapasztaltabb felhasználóknak ajánlott. Ha nincsen pontosan definiálva, akkor a megadott fájlnévnek .wft -re kell végződnie.

  iso

    CD "lenyomat". Ez a formátum tapasztaltabb felhasználóknak ajánlott. Mindig pontosan meg kell adni a fájlnevet.

Importáló kapcsolók

  Az importálandó fájlokat a `-i` fájlnév kapcsolóval lehet megadni. A formátumot pedig az `-f` kapcsolóval, rögtön a fájlnév után. Ha nincsen formátum megadva akkor a fájlnév alapján történik a formátum meghatározása. A

gramps
formátumnak, a fájlnév a jelenlegi adatbázist tartalmazó könyvtárat jelenti. A
gedcom
-nak és a
gramps-pkg
-nak, a fájlnév a megfelelő kiterjesztésű fájl megadását jelenti.

Ha több mint egy bemeneti fájl van megadva, akkor mindegyiket meg kell, hogy előzze az `-i` kapcsoló. A fájlok felsorolási sorrendben kerülnek feldolgozásra, pl.: `-i` fájl1 `-i` fájl2 és `-i` fájl2 `-i` fájl1 különböző gramps ID-ket produkál a beolvasás utáni adatbázisban.

Exportáló kapcsolók

  Az exportálandó fájlokat a `-o` fájlnév kapcsolóval lehet megadni. A formátumot pedig az `-f` kapcsolóval, rögtön a fájlnév után. Ha nincsen formátum megadva akkor a filename alapján történik a formátum meghatározása. A

gramps
-nek és az
iso
formátumnak, a fájlnév a jelenlegi adatbázist tartalmazó könyvtárat jelenti. A
gedcom
-nak,
wft
-nek, és a
gramps-pkg
-nak, pedig a fájlnév a megfelelő kiterjesztésű kimeneti fájlt.

Ha több mint egy bemeneti fájl van megadva, akkor mindegyiket meg kell, hogy előzze az `-o` kapcsoló. A fájlok felsorolási sorrendben kerülnek feldolgozásra.

Műveleti kapcsolók

  Az importált adatokon elvégzendő műveletet az `-a` / action kapcsolóval lehet megadni. A művelet a sikeres importálási művelet után hajtódnak végre. Az aktuális opciók:

summary
(hasonló mint a Reports View Summary menüpont) és a
check
(hasonló mint a Tools Database Processing Check and Repair menüparancs).

Mikor több művelet van megadva, akkor mindegyiket meg kell, hogy előzze az `-a` kapcsoló. A műveletek felsorolási sorrendben kerülnek feldolgozásra.

## Működés

Az `-i`, `-o`, és/vagy `-a` kapcsolók sorrendje nem számít. A végrehajtási sorrend a következő: importálás (ha kell) -> exportálás (ha kell) -> műveletek (ha kell).

Ha az `-i` kapcsoló nincsen megadva, akkor a gramps a szokásos Főablakát elindítva egy üres adatbázissal kezdi meg a működését (mivel nincsen bemenő adat).

Ha az `-o` vagy az `-a` kapcsolók nincsenek megadva, akkor a gramps a megszokott Főablakban az importálásból származó adatbázissal kezdi meg a működését. Ez az adatbázis a ~/.gramps/import könyvtárba kerül.

Ha valamilyen hiba lép fel az importálás, exportálás vagy műveletvégrehajtás során, akkor a hibaüzeneteket a program jeleníti meg (ha a hibák a gramps működése közben léptek fel) vagy a rendszer alapértelmezett módszere szerint. A szokások shell átirányítások használhatóak az stdout és az stderr üzenetek és hibák fájlokba való mentéséhez.

## Példák

Négy adatbázis importálásához (a formátumok a fájlnevekből kideríthetők) és hibaellenőrzéshez, a következőt kell beírni:

`gramps -i` file1.ged `-i` file2.tgz `-i` ~/db3 `-i` file4.wft `-a` check

A fenti példa a fájlformátumok pontos megadásával, az `-f` kapcsolóval:

`gramps -i` file1.ged `-f` gedcom `-i` file2.tgz `-f` gramps-pkg `-i` ~/db3 `-f` gramps `-i` file4.wft `-f` wft `-a` check

A importált adatbázis(ok) exportálása az `-o` kapcsoló megadásával (használja az `-f` kapcsolót ha a gramps nem képes eldönteni a kimeneti fájlformátumot):

`gramps -i` file1.ged `-i` file2.tgz `-o` ~/new-package `-f` gramps-pkg

Mindem hibaüzenet fájlba való kiírására az outfile és az errfile-ba:

`gramps -i` file1.ged `-i` file2.tgz `-o` ~/new-package `-f` gramps-pkg >outfile 2>errfile

Három adatbázis importálása az interaktív felületen keresztül:

`gramps -i` file1.ged `-i` file2.tgz `-i` ~/db3

Végezetűl, a normális interaktív felület indítása:

`gramps`