268 lines
11 KiB
ReStructuredText
268 lines
11 KiB
ReStructuredText
|
Gramps(1) 3.4.0 Gramps(1)
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
NAMN
|
|||
|
|
Gramps - Genealogical Research and Analysis Management Programming Sys‐
|
|||
|
|
tem.
|
|||
|
|
|
|||
|
|
|
|||
|
|
SAMMANFATTNING
|
|||
|
|
Gramps [-?|--help] [--usage] [--version] [-l] [-u|--force-unlock]
|
|||
|
|
[-O|--open= DATABAS [-f|--format= FORMAT]] [-i|--import= FIL [-f|--for‐
|
|||
|
|
mat= FORMAT]] [-i|--import= ...] [-e|--export= FIL [-f|--format= FOR‐
|
|||
|
|
MAT]] [-a|--action= ÅTGÄRD] [-p|--options= ALTERNATIVSTRÄNG]] [ FIL ]
|
|||
|
|
[--version]
|
|||
|
|
|
|||
|
|
|
|||
|
|
BESKRIVNING
|
|||
|
|
Gramps är ett Free/OpenSource släktforskningsprogram. Det är skrivet i
|
|||
|
|
Python, med hjälp av GTK+/GNOME gränssnittet. Gramps bör kännas bekant
|
|||
|
|
för de flesta, som har använt andra släktforskningsprogram tidigare,
|
|||
|
|
som Family Tree Maker (TM), Personal Ancestral Files (TM), DISGEN eller
|
|||
|
|
GNU Geneweb. Det stöder import via det populära GEDCOM-formatet, som
|
|||
|
|
används över hela världen av nästan all släktforskningsprogramvara.
|
|||
|
|
|
|||
|
|
|
|||
|
|
ALTERNATIV
|
|||
|
|
Gramps FIL
|
|||
|
|
När FIL ges (utan några flaggor) som namn på ett familjeträd
|
|||
|
|
eller som en mapp med familjeträd, så öppnas detta och en inter‐
|
|||
|
|
aktiv session startas. Om FIL är en fil, vars format förstås av
|
|||
|
|
Gramps, skapas ett tomt famljeträd, vars namn är grundat på nam‐
|
|||
|
|
net FIL och vars data importeras till det. Resterande alterna‐
|
|||
|
|
tiv ignoreras. Detta sätt att starta passar vid användning av
|
|||
|
|
Gramps som en hanterare för släktforskningsdata i t. ex. en web-
|
|||
|
|
läsare. Detta startsätt accepterar alla inbyggda dataformat för
|
|||
|
|
Gramps, se nedan.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-f,--format= FORMAT
|
|||
|
|
Uttryckligen specificera format på FIL givet av föregående -i
|
|||
|
|
eller -e-alternativ. Om -f-alternativet inte ges för någon FIL,
|
|||
|
|
gissas filformat för den filen utgående från dess filändelse
|
|||
|
|
eller dess MIME-typ.
|
|||
|
|
|
|||
|
|
De format, som är tillgängliga för utmatnig, är Gramps-xml (gis‐
|
|||
|
|
sas om FIL slutar på .Gramps), gedcom (gissas om FIL slutar med
|
|||
|
|
.ged) eller någon filexport, som är tillgänglig via Gramps
|
|||
|
|
tilläggsprogramsystem.
|
|||
|
|
|
|||
|
|
De format, som är tillgängliga för inmatnig, är grdb,
|
|||
|
|
Gramps-xml, gedcom, Gramps-pkg (gissas om FIL slutar med .gpkg)
|
|||
|
|
och geneweb (gissas om FIL slutar med .gw).
|
|||
|
|
|
|||
|
|
De format, som är tillgängliga för export är Gramps-xml, gedcom,
|
|||
|
|
Gramps-pkg, wft (gissas om FIL slutar med .wft), geneweb och iso
|
|||
|
|
(gissas aldrig, specificeras alltid med -f-alternativ).
|
|||
|
|
|
|||
|
|
|
|||
|
|
-l Listar alla databaser/familjeträd.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-u,--force-unlock
|
|||
|
|
Tvingar upplåsning av databas.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-O,--open= DATABAS
|
|||
|
|
Öppnar DATABAS, som måste vara en befitlig databasmapp eller ett
|
|||
|
|
befintligt familjeträd. Om ingen åtgärd, import eller export-
|
|||
|
|
alternativ anges på kommandoraden så startas en interaktiv ses‐
|
|||
|
|
sion med den angivna databasen.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-i,--import= FIL
|
|||
|
|
Importera data från FIL. Om du inte har specificerat en databas,
|
|||
|
|
skapas en temporär sådan, som tas bort när Gramps avslutas.
|
|||
|
|
|
|||
|
|
Om mer är en indatafil anges, måste varje föregås av en -i-
|
|||
|
|
flagga. Filerna importeras i den givna ordningen, t.ex. -i FIL1
|
|||
|
|
-i FIL2 och -i FIL2 -i FIL1 kan skapa skilda Gramps IDs i den
|
|||
|
|
resulterande databasen.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-e,--export= FIL
|
|||
|
|
Exporterar data till FIL. För iso-format, är FIL i själva verket
|
|||
|
|
namnet på den mapp, som Gramps databas kommer att skrivas till.
|
|||
|
|
För Gramps-xml, gedcom, wft, Gramps-pkg och geneweb, är FIL nam‐
|
|||
|
|
net på resultatfilen.
|
|||
|
|
|
|||
|
|
Om mer är en utdatafil anges, måste varje föregås av en -e-
|
|||
|
|
flagga. Filerna skrivs en efter en i den givna ordningen.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-a,--action= ÅTGÄRD
|
|||
|
|
Utför ÅTGÄRD på importerade data. Detta görs efter att all
|
|||
|
|
import har avslutats felfritt. F. n. är följand åtgärder möjliga
|
|||
|
|
summary (samma som Rapporter->Visa->Sammanfattning av
|
|||
|
|
databasen), check (samma som Verktyg->Reparera databas ->Kon‐
|
|||
|
|
trollera och reparera) samt report (skapar report, kräver en
|
|||
|
|
ALTERNATIVSTRÄNG lämnad via -p-flaggan).
|
|||
|
|
|
|||
|
|
ALTERNATIVSTRÄNG-en måste uppfylla följand villkor:
|
|||
|
|
Får ej innehålla några mellanslag. Om några argument behöver
|
|||
|
|
inbegripa mellanslag, måste strängen omslutas av anföring‐
|
|||
|
|
stecken. Alternativsträngen är en lista med par av namn och
|
|||
|
|
värden (åtskiljda av likhetstecken). Namn och värde måste
|
|||
|
|
åtskiljas med komma.
|
|||
|
|
|
|||
|
|
De flesta rapportalternativ är unika för varje rapport eller
|
|||
|
|
verktyg. Emellertid finns det gemensamm alternativ.
|
|||
|
|
|
|||
|
|
name=rapportnamn
|
|||
|
|
Detta är obligatoriskt och bestämmer vilken rapport som skall
|
|||
|
|
skapas. Om det givna namn inte motsvarar någon möjlig rapport
|
|||
|
|
eller verktyg, kommer ett felmeddelande att skrivas ut, följt av
|
|||
|
|
möjliga namn på rapporter eller verktyg.
|
|||
|
|
|
|||
|
|
show=all
|
|||
|
|
Detta ger en lista med namn på alla möjliga alternativ för en
|
|||
|
|
bestämd rapport eller verktyg.
|
|||
|
|
|
|||
|
|
show=optionname
|
|||
|
|
Detta skriver ut beskrivningen av den funktion, som optionname
|
|||
|
|
innebär, likväl vad som är godkända typer och värden för detta
|
|||
|
|
alternativ.
|
|||
|
|
|
|||
|
|
Använd alternativen ovan för att ta reda på all om en viss rap‐
|
|||
|
|
port.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Om mer än en utdataåtgärd givits måste varje föregås av en -a-flagga.
|
|||
|
|
Åtgärderna utförs en och en i den givna turordningen.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-d,--debug= LOGGER_NAME
|
|||
|
|
Kopplar på avlusningshjälpmedel för utveckling och tester. För
|
|||
|
|
detaljer hänvisas till källkoder
|
|||
|
|
|
|||
|
|
--version
|
|||
|
|
Skriver ur Gramps versionsnummer och avslutar
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Operation
|
|||
|
|
Om första argumentet på kommandoraden inte inledds med ett minustecken
|
|||
|
|
(d. v. s. ingen flagga), kommer Gramps att försöka öppna den fil, vars
|
|||
|
|
namn givits av det första argumentet samt påbörja en interaktiv session
|
|||
|
|
utan att ta hänsyn till resten av argumenten på kommandoraden.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Om -O-flagga givits, kommer Gramps att försöka öppna den omnämnda
|
|||
|
|
databasen och sedan arbeta med dess data, enligt ytterligare instruk‐
|
|||
|
|
tioner på kommandoraden.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Med eller utan -Oflagga, kan det ske många importeringar, exporteringar
|
|||
|
|
och åtgärder beskrivna ytterligare på kommanodraden genom att använda
|
|||
|
|
-i-, -e- samt -a-flaggor.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Ordningen på -i-, -e- eller -a-alternativen spelar ingen roll. Den
|
|||
|
|
gällande ordningen är alltid: all import (om någon) -> alla åtgärder
|
|||
|
|
(om några) -> all export (om någon). Men öppning måste alltid ske
|
|||
|
|
först!
|
|||
|
|
|
|||
|
|
|
|||
|
|
Om inget -O- eller -i-alternativ givits, kommer Gramps att starta sitt
|
|||
|
|
huvudfönster samt påbörja den vanliga interaktiva sessionen med en tom
|
|||
|
|
databas, då hur som helst inget data finns att bearbeta.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Om inget -e- eller -a-alternativ givits, kommer Gramps att starta sitt
|
|||
|
|
huvudfönster samt påbörja den vanliga interaktiva sessionen med den
|
|||
|
|
databas, som blev resultet från all import. Denna databas återfinns i
|
|||
|
|
import_db.grdb under ~/.Gramps/import-mappen.
|
|||
|
|
|
|||
|
|
|
|||
|
|
De fel som inträffar under import, export eller vid åtgärder kommer
|
|||
|
|
antingen att skrivas till stdout (om dessa avbrott hanteras av Gramps)
|
|||
|
|
eller till stderr (om dessa inte hanteras). Använd vanliga skalkomman‐
|
|||
|
|
don för att styra om stdout och stderr till att spara medelanden och
|
|||
|
|
fel i filer.
|
|||
|
|
|
|||
|
|
|
|||
|
|
EXAMPEL
|
|||
|
|
För att öppna ett befintligt familjeträd och importera en xml-fil till
|
|||
|
|
det, kan man skriva:
|
|||
|
|
Gramps -O 'Mitt familjeträd' -i ~/db3.Gramps
|
|||
|
|
|
|||
|
|
Ovanstående ändrar det öppnade familjeträdet, för att göra samma sak,
|
|||
|
|
men importera bägge till ett tillfälligt familjeträd och påbörja en
|
|||
|
|
interaktiv session, kan man skriva:
|
|||
|
|
Gramps -i 'My Family Tree' -i ~/db3.Gramps
|
|||
|
|
|
|||
|
|
För att importera fyra databaser (vars format kan avgöras av deras
|
|||
|
|
namn) och sedan felkontrollera den resulterande databasen, kan man
|
|||
|
|
skriva:
|
|||
|
|
Gramps -i FIL1.ged -i FIL2.tgz -i ~/db3.Gramps -i FIL4.wft -a
|
|||
|
|
check
|
|||
|
|
|
|||
|
|
För att uttryckligen specificera formaten i examplet ovan, lägg till
|
|||
|
|
filnamn med passande -f-alternativ:
|
|||
|
|
Gramps -i FIL1.ged -f gedcom -i FIL2.tgz -f Gramps-pkg -i
|
|||
|
|
~/db3.Gramps -f Gramps-xml -i FIL4.wft -f wft -a check
|
|||
|
|
|
|||
|
|
För att spara den databas, som är resultat av all import, ange -e-
|
|||
|
|
flagga (använd -f om filnamnet inte tillåter Gramps att gissa dess for‐
|
|||
|
|
mat):
|
|||
|
|
Gramps -i FIL1.ged -i FIL2.tgz -e ~/new-package -f Gramps-pkg
|
|||
|
|
|
|||
|
|
För att importera tre databaser och påbörja en interaklive Gramps-ses‐
|
|||
|
|
sion med importresultatet:
|
|||
|
|
Gramps -i FIL1.ged -i FIL2.tgz -i ~/db3.Gramps
|
|||
|
|
|
|||
|
|
För att köra verifieringsverktyget från kommandoraden och mata ut
|
|||
|
|
resultatet till stdout:
|
|||
|
|
Gramps -O file.grdb -a tool -p name=verify
|
|||
|
|
|
|||
|
|
Slutligen, för att påbörja en normal interaktiv session skriv bara:
|
|||
|
|
Gramps
|
|||
|
|
|
|||
|
|
|
|||
|
|
BEGREPP
|
|||
|
|
Stöder ett python-baserat system för tilläggsprogram, som möjliggör att
|
|||
|
|
import- och export-funktioner, rapportgeneratorer, verktyg samt vis‐
|
|||
|
|
ningsfilter, kan komplettera Gramps utan ändringar i huvudprogrammet.
|
|||
|
|
|
|||
|
|
Förutom att skapa utskrift på skrivare direkt, kan rapportgeneratorer
|
|||
|
|
ha andra målsystem som OpenOffice.org, AbiWord, HTML eller LaTeX så att
|
|||
|
|
användaren kan tillåtas att ändra format för att passa behoven.
|
|||
|
|
|
|||
|
|
|
|||
|
|
KÄNDA FEL OCH BEGRÄNSNINGAR
|
|||
|
|
FILER
|
|||
|
|
${PREFIX}/bin/gramps
|
|||
|
|
${PREFIX}/share/gramps
|
|||
|
|
${HOME}/.gramps
|
|||
|
|
|
|||
|
|
|
|||
|
|
FÖRFATTARE
|
|||
|
|
Donald Allingham <don@gramps-project.org>
|
|||
|
|
http://gramps.sourceforge.net
|
|||
|
|
|
|||
|
|
Denna man-sida skrevs ursprungligen av:
|
|||
|
|
Brandon L. Griffith <brandon@debian.org>
|
|||
|
|
till att ingå i Debians GNU/Linux-system.
|
|||
|
|
|
|||
|
|
Denna man-sida underhålls f. n. av:
|
|||
|
|
Alex Roitman <shura@gramps-project.org>
|
|||
|
|
|
|||
|
|
Denna man-sida har översatts till svenska av:
|
|||
|
|
Peter Landgren <peter.talken@telia.com>
|
|||
|
|
|
|||
|
|
|
|||
|
|
DOCUMENTATION
|
|||
|
|
Användardokumentationen är tillgänglig genom GNOME's standard hjälp-
|
|||
|
|
bläddrare i form av Gramps-handboken. Handboken finns även i XML-format
|
|||
|
|
som gramps-manual.xml under doc/gramps-manual/$LANG i den officiella
|
|||
|
|
källdistributionen. Dock ej på svenska.
|
|||
|
|
|
|||
|
|
Utvecklingsdokumentationen kan hittas på http://developers.gramps-
|
|||
|
|
project.org.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Januari 2008 3.4.0 Gramps(1)
|