gramps/data/man/sv/gramps.1.in
2008-04-05 19:10:19 +00:00

317 lines
12 KiB
Groff

.TH gramps 1 "@VERSION@" "Januari 2008" "@VERSION@"
.SH NAMN
gramps \- Genealogical Research and Analysis Management Programming System.
.SH SAMMANFATTNING
.B gramps
.RB [ \-?|\-\^\-help ]
.RB [ \-\^\-usage ]
.RB [ \-\^\-version ]
.RB [ \-l ]
.RB [ \-u|\-\^\-force-unlock ]
.RB [ \-O|\-\^\-open=
.IR DATABAS
.RB [ \-f|\-\^\-format=
.IR FORMAT ]]
.RB [ \-i|\-\^\-import=
.IR FIL
.RB [ \-f|\-\^\-format=
.IR FORMAT ]]
.RB [ \-i|\-\^\-import=
.IR ... ]
.RB [ \-o|\-\^\-output=
.IR FIL
.RB [ \-f|\-\^\-format=
.IR FORMAT ]]
.RB [ \-a|\-\^\-action=
.IR ÅTGÄRD ]
.RB [ \-p|\-\^\-options=
.IR ALTERNATIVSTRÄNG ]]
.RB [
.IR FIL
.RB ]
.if 0 .RB [ bonobo\ options ]
.if 0 .RB [ sound\ options ]
.RB [ \-\-version ]
.SH BESKRIVNING
.PP
\fIGramps\fP ä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 \fIFamily Tree Maker (TM)\fR, \fIPersonal Ancestral Files (TM)\fR,
\fIDISGEN\fR 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.
.SH ALTERNATIV
.TP
.BI gramps " FIL"
När \fIFIL\fR ges (utan några flaggor) som namn ett familjeträd eller som
en mapp med familjeträd, så öppnas detta och en interaktiv session startas.
Om FIL är en fil, vars format försås av GRAMPS, skapas ett tomt famljeträd,
vars namn är grundat på namnet \fIFIL\fP och vars data importeras till det.
Resterande alternativ 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.
.br
.TP
.BI \-f,\-\^\-format= " FORMAT"
Uttryckligen specificera format på \fIFIL\fR givet av föregående
.ig
\fB\-O\fR,
..
\fB\-i\fR eller
\fB\-o\fR-alternativ. Om \fB\-f\fR-alternativet inte ges för någon \fIFIL\fR,
gissas filformat för den filen utgående från dess filändelse eller dess MIME-typ.
.br
De format, som är tillgängliga för utmatnig, är \fBgramps\-xml\fR (gissas om \fIFIL\fR slutar på
\fB.gramps\fR), \fBgedcom\fR (gissas om \fIFIL\fR slutar med \fB.ged\fR) eller
någon filexport, som är tillgänglig via GRAMPS tilläggsprogramsystem.
.br
De format, som är tillgängliga för inmatnig, är \fBgrdb\fR, \fBgramps\-xml\fR, \fBgedcom\fR,
\fBgramps\-pkg\fR (gissas om \fIFIL\fR slutar med \fB.gpkg\fR) och
\fBgeneweb\fR (gissas om \fIFIL\fR slutar med \fB.gw\fR).
.br
De format, som är tillgängliga för export är
.ig
\fBgrdb\fR,
..
\fBgramps\-xml\fR, \fBgedcom\fR,
\fBgramps\-pkg\fR, \fBwft\fR (gissas om \fIFIL\fR slutar med \fB.wft\fR),
\fBgeneweb\fR och \fBiso\fR (gissas aldrig, specificeras alltid med
\fB\-f\fR-alternativ).
.TP
.BI \-l
Listar alla databaser/familjeträd.
.TP
.BI \-u,\-\^\-force-unlock
Tvingar upplåsning av databas.
.TP
.BI \-O,\-\^\-open= " DATABAS"
Öppnar \fIDATABAS\fR, 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
session med den angivna databasen.
.TP
.BI \-i,\-\^\-import= " FIL"
Importera data från \fIFIL\fR. Om du inte har specificerat en databas, skapas en temporär sådan,
som tas bort när gramps avslutas.
.br
Om mer är en indatafil anges, måste varje föregås av en \fB\-i\fR-flagga.
Filerna importeras i den givna ordningen,
t.ex. \fB\-i\fR \fIFIL1\fR \fB\-i\fR \fIFIL2\fR
och \fB\-i\fR \fIFIL2\fR \fB\-i\fR \fIFIL1\fR kan skapa skilda
gramps IDs i den resulterande databasen.
.TP
.BI \-o,\-\^\-output= " FIL"
Exporterar data till \fIFIL\fR. För \fBiso\fR-format, är \fIFIL\fR i själva verket namnet på den mapp,
som gramps databas kommer att skrivas till.
För
.ig
\fBgrdb\fR,
..
\fBgramps\-xml\fR, \fBgedcom\fR, \fBwft\fR, \fBgramps\-pkg\fR
och \fBgeneweb\fR, är \fIFIL\fR namnet på resultatfilen.
.br
Om mer är en utdatafil anges, måste varje föregås av en \fB\-o\fR-flagga.
Filerna skrivs en efter en i den givna ordningen.
.TP
.BI \-a,\-\^\-action= " ÅTGÄRD"
Utför \fIÅTGÄRD\fR på importerade data. Detta görs efter att all import
har avslutats felfritt. F. n. är följand åtgärder möjliga \fBsummary\fR
(samma som Rapporter->Visa->Sammanfattning av databasen), \fBcheck\fR (samma som Verktyg->Reparera databas
->Kontrollera och reparera) samt \fBreport\fR (skapar report, kräver en
\fIALTERNATIVSTRÄNG\fR lämnad via \fB\-p\fR-flaggan).
.br
\fIALTERNATIVSTRÄNG\fR-en måste uppfylla följand villkor:
.br
Får ej innehålla några mellanslag.
Om några argument behöver inbegripa mellanslag, måste strängen omslutas av
anföringstecken.
Alternativsträngen är en lista med par av namn och värden (åtskiljda av likhetstecken).
Namn och värde måste åtskiljas med komma.
.br
De flesta rapportalternativ är unika för varje rapport eller verktyg. Emellertid finns
det gemensamm alternativ.
.BI "name=rapportnamn"
.br
Detta är obligatoriskt och bestämmer vilken rapport som skall skapas.
Om det givna \fInamn\fR 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.
.BI "show=all"
.br
Detta ger en lista med namn på alla möjliga alternativ för en bestämd rapport eller verktyg.
.BI "show=optionname"
.br
Detta skriver ut beskrivningen av den funktion, som \fBoptionname\fR innebär, likväl vad som
är godkända typer och värden för detta alternativ.
.br
Använd alternativen ovan för att ta reda på all om en viss rapport.
.LP
Om mer än en utdataåtgärd givits måste varje föregås av en \fB\-a\fR-flagga.
Åtgärderna utförs en och en i den givna turordningen.
.TP
.BI \-d,\-\^\-debug= " LOGGER_NAME"
Kopplar på avlusningshjälpmedel för utveckling och tester.
För detaljer hänvisas till källkoder
.TP
.BI \-\^\-version
Skriver ur gramps versionsnummer och avslutar
\" change 0 to 1 to enable output of OAF options
.if 0 \{
.PP
The following options are used for Bonobo activation.
.TP
.BI \-\^\-oaf-ior-fd= "FD"
File descriptor to print the OAF IOR on
.TP
.BI \-\^\-oaf-activate-iid= " IID"
OAF IID to activate
.TP
.BI \-\^\-oaf-private
Prevent registering of server with OAF
\}
\" change 0 to 1 to enable output of Gnome sound options
.if 0 \{
.PP
The following options are used for controlling sound using the Gnome Library.
.TP
.BI \-\^\-disable-sound
Disable sound server usage
.TP
.BI \-\^\-enable-sound
Enable sound server usage
.TP
.BI \-\^\-espeaker= " HOSTNAME:PORT"
Host:port on which the sound server to use is running
\}
.SH "Operation"
.br
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.
.LP
Om \fB\-O\fR-flagga givits, kommer gramps att försöka öppna den omnämnda databasen
och sedan arbeta med dess data, enligt ytterligare instruktioner på kommandoraden.
.LP
Med eller utan \fB\-O\fRflagga, kan det ske många importeringar,
exporteringar och åtgärder beskrivna ytterligare på kommanodraden
genom att använda \fB\-i\fR-,
\fB\-o\fR- samt \fB\-a\fR-flaggor.
.LP
Ordningen på \fB\-i\fR-, \fB\-o\fR- eller \fB\-a\fR-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!
.LP
Om inget \fB\-O\fR- eller \fB\-i\fR-alternativ givits, kommer gramps att starta sitt
huvudfönster samt påbörja den valiga interaktiva sessionen med en tom databas,
då hur som helst inget data finns att bearbeta.
.LP
Om inget \fB\-o\fR- eller \fB\-a\fR-alternativ givits, kommer gramps att starta sitt
huvudfönster samt påbörja den valiga interaktiva sessionen med den databas, som blev
resultet från all import. Denna databas återfinns i \fBimport_db.grdb\fR
under \fB~/.gramps/import\fR-mappen.
.LP
De fel som inträffar under import, export eller vid åtgärder kommer antingen att skrivas till
\fIstdout\fR (om dessa avbrott hanteras av gramps) eller
till \fIstderr\fR (om dessa inte hanteras). Använd vanliga skalkommandon för att styra om
\fIstdout\fR och \fIstderr\fR till att spara medelanden och fel i filer.
.SH EXAMPEL
.TP
För att öppna ett befintligt familjeträd och importera en xml-fil till det, kan man skriva:
\fBgramps\fR \fB\-O\fR \fI'Mitt familjeträd'\fR \fB\-i\fR \fI~/db3.gramps\fR
.TP
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:
\fBgramps\fR \fB\-i\fR \fI'My Family Tree'\fR \fB\-i\fR \fI~/db3.gramps\fR
.TP
För att importera fyra databaser (vars format kan avgöras av deras namn) och sedan felkontrollera den resulterande databasen, kan man skriva:
\fBgramps\fR \fB\-i\fR \fIFIL1.ged\fR \fB\-i\fR \fIFIL2.tgz\fR \fB\-i\fR \fI~/db3.gramps\fR \fB\-i\fR \fIFIL4.wft\fR \fB\-a\fR \fIcheck\fR
.TP
För att uttryckligen specificera formaten i examplet ovan, lägg till filnamn med passande \fB\-f\fR-alternativ:
\fBgramps\fR \fB\-i\fR \fIFIL1.ged\fR \fB\-f\fR \fIgedcom\fR \fB\-i\fR \fIFIL2.tgz\fR \fB\-f\fR \fIgramps-pkg\fR \fB\-i\fR \fI~/db3.gramps\fR \fB\-f\fR \fIgramps-xml\fR \fB\-i\fR \fIFIL4.wft\fR \fB\-f\fR \fIwft\fR \fB\-a\fR \fIcheck\fR
.TP
För att spara den databas, som är resultat av all import, ange \fB\-o\fR-flagga (använd \fB\-f\fR om filnamnet inte tillåter gramps att gissa dess format):
\fBgramps\fR \fB\-i\fR \fIFIL1.ged\fR \fB\-i\fR \fIFIL2.tgz\fR \fB\-o\fR \fI~/new-package\fR \fB\-f\fR \fIgramps-pkg\fR
.TP
För att importera tre databaser och påbörja en interaklive gramps-session med importresultatet:
\fBgramps\fR \fB\-i\fR \fIFIL1.ged\fR \fB\-i\fR \fIFIL2.tgz\fR \fB\-i\fR \fI~/db3.gramps\fR
.TP
För att köra verifieringsverktyget från kommandoraden och mata ut resultatet till stdout:
\fBgramps\fR \fB\-O\fR \fIfile.grdb\fR \fB-a\fR \fItool\fR \fB-p\fR \fBname\fR=\fIverify\fR
.TP
Slutligen, för att påbörja en normal interaktiv session skriv bara:
\fBgramps\fR
.SH BEGREPP
Stöder ett python\-baserat system för tilläggsprogram, som möjliggör att import- och export-funktioner,
rapportgeneratorer, verktyg samt visningsfilter, kan komplettera gramps utan ändringar i huvudprogrammet.
.LP
Förutom att skapa utskrift skrivare direkt, kan rapportgeneratorer ha andra målsystem som \fIOpenOffice.org\fR, \fIAbiWord\fR, HTML eller LaTeX att användaren kan tillåtas att ändra format för att passa behoven.
.SH KÄNDA FEL OCH BEGRÄNSNINGAR
.SH FILER
.LP
\fI${PREFIX}/bin/gramps\fP
.br
\fI${PREFIX}/share/gramps\fP
.br
\fI${HOME}/.gramps\fP
.SH FÖRFATTARE
Donald Allingham \fI<don@gramps-project.org>\fR
.br
\fIhttp://gramps.sourceforge.net\fR
.LP
Denna man-sida skrevs ursprungligen av:
.br
Brandon L. Griffith \fI<brandon@debian.org>\fR
.br
till att ingå i Debians GNU/Linux-system.
.LP
Denna man-sida underhålls f. n. av:
.br
Alex Roitman \fI<shura@gramps-project.org>\fR
.LP
Denna man-sida har översatts till svenska av:
.br
Peter Landgren \fI<peter.talken@telia.com>\fR
.br
.SH 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 \fBgramps-manual.xml\fR under \fIdoc/gramps-manual/$LANG\fR i den officiella
källdistributionen. Dock ej på svenska.
.LP
Utvecklingsdokumentationen kan hittas
\fIhttp://developers.gramps-project.org\fR.