FI:Gramps 5.1 Wiki Manual - Command Line

From Gramps
Revision as of 06:46, 3 September 2023 by Sam888 (talk | contribs) (Protected "FI:Gramps 5.1 Wiki Manual - Command Line": Manual rolled over for Gramps 5.2 - protecting old version from further edits ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Edellinen Hakemisto Seuraava


Tässä liitteeseen on koottu komentokehotteet, jotka on käytettävissä, kun Gramps käynnistetään terminaalista.

Käynnistä Gramps komentokehotteesta

Normaalisti Gramps käynnistetään käyttöjärjestelmäsi graafisesta käyttöliittymästä (GUI) , ks. your platform.

Grampsin voi käynnistää myös komentokehotteesta (command line interface eli CLI). Sillä voi

  • tuottaa raportteja jotka eivät käytettävissä GUIssa,
  • tuottaa raportteja, tehdä muunnoksia jne avaamatta ikkunaa, ja
  • saada lisää tietoa ongelmallisissa tilanteissa.

Tämä käyttöohjeen osio kuvaa, kuinka Gramps käynnistetään CLI:stä, ja mitä toiminnallisuuksia on tarjolla.

Grampsin käynnisty CLI:stä riippuu käyttöjärjestelmästäsi.

Kuvauksen yksikertaistamiseksi seuraavana olevat esimerkit on tilanteesta, että Grampsia ajetaan Linuxissa. Esimerkkejä olisi muutettava muissa käyttöjärjestelmissä.

Linux

Virallisesti Grampsin ainoa tuettu alusta on Linux, koska Grampsin kehittäjät käyttävät sitä ja testaavat sillä ohjelman lähdeohjelman ja korjaavat versionkorotuksista aiheutuvat ongelmat.

Edellyttäen että käytät Linux distrosi vakio Package Manageria (CLI:n tai GUI:n kautta) , käynnistät Grampsin CLI:ssä (Pääte) kirjoittamalla

gramps

MS Windows

MS Windows on yhteisön tukema alusta. Jos asennat Windows AIO GrampsAIO32 tai GrampsAIO64 exe:n, työpöydällesi asentuu 3 kuvake ja 3 valintaa Käynnistä-valikkoon (Windows 8.1 sovellukset valikkoon).

Mikä on paras tapa saada tietoon, mikä komento on kirjoitettava?

Grampsin käynnistys komentokehotteesta (cmd.exe) riippuu siitä, minne asensit Grampsin.

  • Napsauta hiiren oikealla paikkeella Gramps(console) kuvaketta, tai vastaavaa Käynnistä-valikossa ja valitse ominaisuudet.
  • Kirjoita muistiin käynnistyskansio.
  • Valitse komentorivi (Kohde) kokonaisuudessaan ja kopioi se CTRL+C.
  • Käynnistä cmd.exe Käynnistä-valikosta.
  • Vaihda siihen hakemistoon, jonka kirjoitit muistiin.
  • Napsauta hiiren oikealla ja valitse Liitä.
  • Paina Enter.

Kansio saattaa olla esmerkiksi:

cd "\Program Files\GrampsAIO64\bin
"C:\Program Files\GrampsAIO64\bin\pythonw.exe" -EO ..\share\gramps\gramps.py

Kun seuraavassa sinua ohjeistetaan kirjoittamaan jotakin käynnistyskomennon jälkeen, kirjoita silloin viimeisen rivin jälkeen, esim.:

cd "\Program Files\GrampsAIO64\bin
"C:\Program Files\GrampsAIO64\bin\pythonw.exe" -EO ..\share\gramps\gramps.py -L

MS Windowsissa on muitakin tapoja asentaa Gramps, mutta ne ovat paljon monimutkaisempia eikä niitä siksi käsitellä tässä sen enempää.

Mac OS X

Mac OS X on yhteisön tukema alusta. Jos lataat Mac OS X levynkuvan (.dmg), raahaat yksinkertaisesti sovelluksen sovellutusten kansioon (tai minne muualle haluat sen tallettaa) ja käynnistä Gramps tuplanapsautuksella tavalliseen tapaan.

Ohjelman käynnistämiseksi komentokehotteesta käynnistät pääteikkunan, jonka sijaintipaikka on Applications:Utilities. Kirjoita sitten pääteikkunaan

 /path/to/Gramps.app/Contents/MacOS/Gramps

Jos asensit Grampsin muiden sovellutuksiesi joukkoon, kehote voisi olla

 /Applications/Gramps.app/Contents/MacOS/Gramps

Voit liitää komentoon mitä tahansa lisäoptioita. Esim. saadaksesi sukupuusiesi oletuskansiosta yksityiskohtaisen listauksen kaikista sukupuutietokannoista kirjoitat kehotteen

 /Applications/Gramps.app/Content/MacOS/Gramps -L

Gramps voidaan asentaa muillakin tavoin Mac OS X-alustalle, mutta ne ovat paljon monimutkaisempia eikä niitä siksi käsitellä tässä sen enempää.

Python optiot

Edellä esitettyjen alustojen esimerkeissä ja eri tiedostojen komennoissa voit nähdä optioita "python" komennon perässä, esim. '-EO' rivillä

"C:\Program Files\GrampsAIO64\bin\pythonw.exe" -EO ..\share\gramps\gramps.py -L

On tärkeää, että pidät erillään python optiot tässä:

-EO

ja Gramps optiot tässä

-L

Saatat törmätä seuraaviin python optioihin :

  • -E Jätä huomiotta kaikki PYTHON* ympäristömuuttujat, esim. PYTHONPATH ja PYTHONHOME, jotka on ehkä asetettu.
  • -O Käynnistä perusoptimoinnit. Tämä muuttaa käännettyjen (bytecode) tiedostojen päätteet pyc'stä .pyo'ksi. Katso myös PYTHONOPTIMIZE.

-O optimointivaihtimella on useita vaikutuksia Grampsissa:

Gramps optiot on kuvattu alla.

Tarjolla olevat Gramps optiot

This section provides the reference list of all command line options available in Gramps. If you want to know more than just a list of options, see next sections: Operation and Examples. The summary below is printed by gramps -h.

Usage: gramps.py [OPTION...]

 --load-modules=MODULE1,MODULE2,...     Dynamic modules to load

Help options

 -?, --help                             Show this help message
 --usage                                Display brief usage message

Application options

 -O, --open=FAMILY_TREE                 Open Family Tree
 -C, --create=FAMILY_TREE               Create on open if new Family Tree
 -i, --import=FILENAME                  Import file
 -e, --export=FILENAME                  Export file
 -f, --format=FORMAT                    Specify Family Tree format
 -a, --action=ACTION                    Specify action
 -p, --options=OPTIONS_STRING           Specify options
 -d, --debug=LOGGER_NAME                Enable debug logs
 -l                                     List Family Trees
 -L                                     List Family Trees in Detail
 -t                                     List Family Trees, tab delimited
 -u, --force-unlock                     Force unlock of Family Tree
 -s, --show                             Show config settings
 -c, --config=[config.setting[:value]]  Set config setting(s) and start Gramps
 -y, --yes                              Don't ask to confirm dangerous actions (non-GUI mode only)
 -q, --quiet                            Suppress progress indication output (non-GUI mode only)
 -v, --version                          Show versions

The usage message is as follows:

Example of usage of Gramps command line interface

1. To import four databases (whose formats can be determined from their names)
and then check the resulting database for errors, one may type:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a tool -p name=check. 

2. To explicitly specify the formats in the above example, append filenames with appropriate -f options:
gramps -i file1.ged -f gedcom -i file2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a  tool -p name=check. 

3. To record the database resulting from all imports, supply -e flag
(use -f if the filename does not allow Gramps to guess the format):
gramps -i file1.ged -i file2.gpkg -e ~/new-package -f gramps-pkg

4. To save any error messages of the above example into files outfile and errfile, run:
gramps -i file1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >outfile 2>errfile

5. To import three databases and start interactive Gramps session with the result:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps

6. To open a database and, based on that data, generate timeline report in PDF format
putting the output into the my_timeline.pdf file:
gramps -O 'Family Tree 1' -a report -p name=timeline,off=pdf,of=my_timeline.pdf  

7. To generate a summary of a database:
gramps -O 'Family Tree 1' -a report -p name=summary 

8. Listing report options
Use the name=timeline,show=all to find out about all available options for the timeline report.
To find out details of a particular option, use show=option_name , e.g. name=timeline,show=off string.
To learn about available report names, use name=show string.

9. To convert a family tree on the fly to a .gramps xml file:
gramps -O 'Family Tree 1' -e output.gramps -f gramps-xml

10. To generate a web site into an other locale (in german):
LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Family Tree 1' -a report -p name=navwebpage,target=/../de

11. Finally, to start normal interactive session type:
gramps

Note: These examples are for bash shell.
Syntax may be different for other shells and for Windows.

Listauksen optiot

Print a list of known family trees:

Sparse
-l, print a list of known family trees
Fig. C.1 Command Line Example Output for python gramps.py -l


Detailed
-L, print a detailed list of known family trees
Fig. C.2 Command Line Example Output for python gramps.py -L


Note that dates are shown in the default LOCALE format. You change that at the system level. For example, on POSIX-based systems you could:

LC_TIME=en_AU.UTF-8 gramps -L


Version optiot

-v or --version prints version of Gramps and dependencies,
     information about environment settings and python and system paths
Fig. C.3 Command Line Example Output for python gramps.py -v


Muodon optiot

The format of any file destined for opening, importing, or exporting can be specified with the

-f format

option. The acceptable format values are listed below.

Täysi tuki sukupuulle

Näissä muodoissa on mukana kaikki se tieto, joka on tällä hetkellä sukupuussa.

  • gramps - Gramps XML muoto: Muoto on käytettävissä tuontiin ja vientiin. Oletettava, jos tietostonimen loppuosa on .gramps
  • gpkg - Gramps package XML muoto: Muoto on käytettävissä tuontiin ja vientiin. Oletettava, jos tietostonimen loppuosa on .gpkg. Pakkaa tietosi xml-muotoisena ja ottaa kaikki mediatiedostot mukaan
  • grdb - pre Gramps 3.x database: Muoto on käytettävissä tuontiin Grampsin vanhan tiedostomuodon tukemiseksi. Kaikki grdb tiedostosta tuodaan. Oletettava, jos tietostonimen loppuosa on .grdb
  • burn - GNOME iso burning: vienti, käytettävissä vain jos polttoajuri löytyy

Rajattu tuki sukupuulle

Tämä muoto kattaa suurimman osan, muttei kaikkea tietoa, joka on luotavissa Grampsilla

  • ged - GEDCOM muoto: Muoto on käytettävissä tuontiin ja vientiin. Oletusarvoinen ja tiedostonimen loppuosa on .ged
  • gw - GeneWeb tiedosto: TMuoto on käytettävissä tuontiin ja vientiin. Oletusarvoinen ja tiedostonimen loppuosa on .gw

Osajoukko tiedoistasi

Nämä muodot kattavat vain määritetyn osapuolen tiedoistasi

  • csv - Comma Separated Value: Muoto on käytettävissä tuontiin ja vientiin. Varo, tuonti tapahtuu viennissäsi määritetyillä arvoilla. Tulostiedostoon menee vain osa tiedoistasi.
  • vcf - VCard muoto: vienti ja tuonti
  • vcs - VCalandar muoto: vienti
  • def - vanha Pro-Gen muoto: tuonti
  • wft - Web Family Tree: Käytettävissä vain vientiin. Oletusarvoisesti tiedostonimen pääte on .wft

Avaamisen optiot

Voit avata sukupuun suoraan tai tuomalla tiedoston tyhjään sukupuuhun.

Gramps hoitaa avaamisen automaattisesti, kun annat sukupuun tai tiedoston nimen, jonka haluat avata:

python gramps.py 'My Fam Tree'
python gramps.py JohnDoe.ged

Ensimmäinen avaa sukupuun ja jälkimmäinen tuo tiedoston tyhjään sukupuuhun.

Voit lisätä välittää Grampsille avattavan sukupuun nimen:

  • käytä tätä optiota :
    -O famtree
    tai
    --open=famtree 

-O, Avaa sukupuu. Saman saa aikaiseksi myös kirjoittamalla vai nimen (nimi ta tietokantahakemisto)

Esimerkkejä:

python gramps.py 'Family Tree 1'
python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
python gramps.py -O 'Family Tree 1'
python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d


Tango-Dialog-information.png
Vihje

Jos vain nimi on annettu muttei optioita, Gramps jättää huomiotta rivin loput argumentit. Käytä -O valitsinta avaamiseen, -i valitsinta tuontiin ja tee jotain tiedoilla.


Tango-Dialog-information.png
Vihje

Vain sukupuut on avattavissa suoraan. Muissa muodoissa sinun tarvitsee käyttää tuontioptiota, joka luo tyhjän tietokannan ja tuo siihen tiedot.


Tango-Dialog-information.png
Vihje

Vain sukupuut on avattavissa. Jos sinulla on tarve tuoda tietoja useasta lähteestä, on tarpeen käyttää tuontioptiota.


Tuonnin optiot

Tuotavat tiedostot määritellään

-i filename

tai

--import=filename

optiolla. Muoto määritellään

-f format

tai

--format=format

optiolla, jota seuraa välittömästi tiedostonimi . Jos muotoa ei ole annettu, se yritetään arvata tiedostonimestä.

Esimerkki:

  python gramps.py -i 'Family Tree 1' -i 'Family Tree 2'
  python gramps.py -i test.grdb -i data.gramps
Tango-Dialog-information.png
Vihje

Useakin tiedosto voidaan tuoda tällä optiolla. Jos näin toimitaan, Gramps lisää seuravasta tiedostosta tiedot käytössä olevaan tietokantaan.


WJos on annettu usea tiedosto, jokaisen edellä on oltava

-i

vaihdin. Tiedostot tuodaan annetussa järjestyksessä, esim.

 -i file1 -i file2 

ja

 -i file2 -i file1 

voivat tuottaa poikeavat GRAMPS ID avaimet tulostietokantaan.

Viennin optiot

The files destined for export can be specified with the

-e filename

or

--export=filename

option. The format can be specified with the

-f

option immediately following the filename . If not specified, the guess will be attempted based on the filename . For iso format, the filename is actually the name of directory the Gramps database will be written into. For gramps-xml, gpkg, gedcom, wft, geneweb, and gramps-pkg, the filename is the name of the resulting file.

-e, export a family tree in required format. It is not possible to export to a family tree.

Example:

 python gramps.py -i 'Family Tree 1' -i test.grdb -f grdb -e mergedDB.gramps

Note that above does not change 'Family Tree 1' as everything happens via a temporary database, whereas:

 python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -e mergedDB.gramps

will import test.grdb into Family Tree 1, and then export to a file !

Tango-Dialog-information.png
Exporting more files

More than one file can be exported in one command. If this is the case, Gramps will attempt to write several files using the data from the database available at the moment.


When more than one output file is given, each has to be preceded by

-e

flag. The files are written one by one, in the specified order.

Toimenpiteiden optiot

The action to perform on the imported data can be specified with the

-a action

or

--action=action

option. This is done after all imports are successfully completed.

The following actions remain the same:

  • report: This action allows producing reports from the command line.
  • tool: This action allows to run a tool from the command line.

Reports and tools generally have many options of their own, so these actions should be followed by the report/tool option string. The string is given using the

-p option_string

or

--options=option_string

option.

The actions available in older versions of Gramps which were relocated in Gramps 3.3 are:

  • summary: This action was the same as Reports ->View ->Summary. In Gramps 3.3 it was replaced by (or renamed to) -a report -p name=summary.
  • check: This action was the same as Tools ->Database Processing ->Check and Repair. In Gramps 3.3 it was replaced by (or renamed to) -a tool -p name=check.

report action option

You can generate most reports from the command line using the report action.

An example:

gramps -O "Family Tree 1" -a report -p "name=family_group,style=default,off=html,of=test.html"

You can provide the css style to use here with the css option:

gramps -O "Family Tree 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css=Web_Nebraska.css"

or without css in the html output:

gramps -O "Family Tree 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css="
Tango-Dialog-information.png
Report option string

The report option string should satisfy the following conditions: It must not contain any spaces (due to the general nature of the command line interface). If some arguments need to include spaces, the string should be enclosed with quotation marks. Option string must list pairs of option names and values. Within a pair, option name and value must be separated by the equal sign. Different pairs must be separated by commas.


Most of the report options are specific for every report. However, there are some common options.

  • name=report_name: This mandatory option determines which report will be generated. If the supplied report_name does not correspond to any available report, an error message will be printed followed by the list of available reports.
  • of : output filename
  • off: output format. These are the extension an output format makes available, eg, pdf, html, doc, ...
  • style: for text reports, the stylesheet to use. Defaults to 'default'.
  • show=all: This will produce the list of names for all options available for a given report.
  • show=option_name: This will print the description of the functionality supplied by the option_name, as well as what are the acceptable types and values for this option.

So, to learn to use a report, do for example:

gramps -O "Family Tree 1" -a report -p "name=family_group,show=all"
Tango-Dialog-information.png
Tip

If an option is not supplied, the last used value will be used. If this report has never been generated before, then the value from last generated report will be used when applicable. Otherwise, the default value will be used.


When more than one output action is given, each has to be preceded by

-a

flag. The actions are performed one by one, in the specified order.

Tango-Dialog-information.png
lists

Some reports have options or arguments which are interpreted (by the report) to be on multiple lines. For instance some reports allow you to format how the information will be shown, perhaps with a name on one line and the person's birth date on the next line. Such multiple-line options or arguments are called "lists" by Gramps.


On the command line such lists must always start with a left square bracket

[

and must always end with a right square bracket

]

but since such square brackets are usually "special" to the "shell" (they mean something to the command interpreter you are typing the command to), you must "escape" them so that they are ignored by your shell.

The details vary with each shell but (in linux/UNIX) usually you can precede such a square bracket with a backslash

\

or put quotation marks around the square bracket, usually either "single" or "double" ones.

The Hourglass Graph report allows you to put a "note" at the top of the report and such a "note" is an example of a "list" option. Here is an example:

gramps -O "Family Tree 1" -a report -p name=hourglass_graph,note='[line one,line two]'

which shows that inside such a list different lines are separated by commas, and that spaces are acceptable since the quotation marks are already there for the square brackets.

But if you want to have a comma inside your report you have to somehow tell Gramps that comma is not one which separates lines. You do that by enclosing the line with the comma in quotation marks (either single or double).

But if you are already using a set of quotation marks (to enclose your square brackets) you have to use the other type to enclose the line with your comma. Here is an example:

gramps -O "Family Tree 1" -a report -p name=hourglass_graph,note="['line one, also line one','line two, also line two']"

It is possible to include any character in a list but the details are beyond the scope of this command-line introduction to Gramps.

You will need to know the precise methods available in your particular command shell interpreter to include a character which is "special" to your shell or "special" to Gramps (like the comma in the example above) but in general you will have to "escape" it twice, once to your shell and once again to Gramps, since you don't want your shell to think it is some instruction it should pay attention to and you don't want Gramps to think that either.

tool action option

You can run most tools from the command line using the 'tool' action. To see which ones, say:

gramps -O "Family Tree 1" -a tool -p show=all

To see a tool's available options, for instance the "verify" tool:

gramps -O "Family Tree 1" -a tool -p name=verify,show=all

To run a tool, for instance the "verify" tool:

gramps -O "Family Tree 1" -a tool -p name=verify

book action option (new in 5.1)

You can run books from the command line using the 'book' action. To see which ones, say:

gramps -O "Family Tree 1" -a book

To see a book's available options, for instance a book called "mybook":

gramps -O "Family Tree 1" -a book -p name=mybook,show=all

To run a book, for instance a book called "mybook":

gramps -O "Family Tree 1" -a book -p name=mybook

Force unlock option

-u, you can extend the -O flag with -u to force a locked family to be unlocked. This allows you to recover from a crash that leaves the family tree (database) locked, from the command line.

An example (to unlock the "Family Tree 1" database):

gramps -O "Family Tree 1" -a report -u > /dev/null

Note that it is not possible to open family trees that need repair from the command line

Configuration (config) option

The option takes three forms: (the following examples, except 3.2, use behavior.database-path as the configuration variable to change.)

1) See all config values

-s or --show
Fig. C.4 Command Line Example Output for python gramps.py -s


2) See a value:

--config=behavior.database-path
or
-c behavior.database-path

3) Set a value:

--config=behavior.database-path:'/media/mydb'
or
-c behavior.database-path:'/media/mydb'

3.1) Set a value to its default:

--config=behavior.database-path:DEFAULT
or
-c behavior.database-path:DEFAULT

3.2) Set more than one value:

--config=behavior.use-tips:False --config=behavior.autoload:True
or
-c behavior.use-tips:False -c behavior.autoload:True

When all configuration variable(s) are set Gramps will start with these new values.

Operation

If the first argument on the command line does not start with a dash (i.e. no flag), Gramps will attempt to open the file with the name given by the first argument and start an interactive session, ignoring the rest of the command line arguments.

If the

-O

flag is given, then Gramps will try opening the supplied file name and then work with that data, as instructed by the further command line parameters.

Gramps-notes.png
Note

Only one file can be opened in a single invocation of Gramps. If you need to get data from multiple sources, use the importing options by using
-i
flag.

With or without the

-O

flag, there could be multiple imports, exports, and actions specified further on the command line by using

-i

,

-e

, and

-a

flags. The order of

-i

,

-e

, or

-a

options with respect to each does not matter. The actual execution order always is: all imports (if any) -> all exports (if any) -> all actions (if any).

Gramps-notes.png
Note

But opening must always be first!

If no

-O

or

-i

option is given, Gramps will launch its main window and start the usual interactive session with the empty database, since there is no data to process, anyway. (Unless you have already expressed a "preference" that it start with the last database it used.) If no

-e

or

-a

options are given, Gramps will launch its main window and start the usual interactive session with the database resulted from opening and all imports (if any). This database resides in the import_db.grdb file under the ~/.gramps/import/ directory.

Any errors encountered during import, export, or action, will be either dumped to stdout (if these are exceptions handled by Gramps) or to stderr (if these are not handled). Use usual shell redirections of stdout and stderr to save messages and errors in files.

Examples

  • To import four databases (whose formats can be determined from their names) and then check the resulting database for errors, one may type:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a check
  • To explicitly specify the formats in the above example, append filenames with appropriate -f options:
gramps -i file1.ged -f gedcom -i file2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check
  • To record the database resulting from all imports, supply -e flag (use -f if the filename does not allow Gramps to guess the format):
gramps -i file1.ged -i file2.gpkg -e ~/new-package -f gramps-pkg
  • To save any error messages of the above example into files outfile and errfile, run:
gramps -i file1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >outfile 2>errfile 
  • To import three databases and start interactive Gramps session with the result:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps 
  • To open a database and, based on that data, generate timeline report in PDF format putting the output into the my_timeline.pdf file:
gramps -O 'Family Tree 1' -a report -p name=timeline,off=pdf,of=my_timeline.pdf 
Tango-Dialog-information.png
Listing report options

Use the name=timeline,show=all to find out about all available options for the timeline report. To find out details of a particular option, use show=option_name , e.g. name=timeline,show=off string. To learn about available report names, use name=show string.


  • To convert the bsddb database on the fly to a .gramps xml file:
gramps -O 'Family Tree 1' -e output.gramps -f gramps-xml
  • To generate a web site into an other locale (in german):
LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Family Tree 1' -a report -p name=navwebpage,target=/../de 
  • Finally, to start normal interactive session type:
gramps

Ympäristömuuttujat

Gramps can take advantage of these environment variables (but do not change them if you do not know what are you doing):

GRAMPSHOME

  • GRAMPSHOME - if set, override default path to profile allowing user to use an external network drive to store data and all settings. For technically advanced users who run multiple versions of Gramps, setting a different $GRAMPSHOME is a way to avoid interference between the different versions in the Gramps user directory.

For example

GRAMPSHOME=$HOME/familytrees/paternal

LANG

  • LANG - is used by Gramps to determine which language file should be loaded.
Gramps-notes.png
MacOSX

Because of the way launching with Finder works, the environment variables for the Gramps.app bundle are hard-coded in Gramps.app/Contents/MacOS/Gramps. If for some reason you need to change them, edit that file with TextEdit; be sure to save it back as plain text. See as well setting locale for an alternative to using the LANG and LANGUAGE environment variables.

GRAMPSI18N

  • $GRAMPSI18N (for your locale) - The LANG assumes the Gramps translations are installed globally. If this is not the case, you need to give Gramps the directory where the translations will be found. A translation is called gramps.mo, you can find it in linux with the locate command. For example, if you have Swedish in directory /home/me/gramps/mo/sv/gramps.mo, you can direct Gramps there using:
GRAMPSI18N=/home/me/gramps/mo LC_ALL=C.UTF-8 LANG="sv" python3 gramps

GRAMPSDIR

Edellinen Hakemisto Seuraava
Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions