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 ReportsView 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