Changes

Jump to: navigation, search

Gramps 4.1 Wiki Manual - Command Line

843 bytes added, 22:02, 5 February 2016
m
Protected "Gramps 4.1 Wiki Manual - Command Line": outdated user manual ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))
The '''python options''' that you may come across are:
* <code>-E </code> Ignore all PYTHON* environment variables, e.g. <code>PYTHONPATH </code> and <code>PYTHONHOME</code>, that might be set.* <code>-O </code> Turn on basic optimizations. This changes the filename extension for compiled (bytecode) files from <code>.pyc </code> to <code>.pyo</code>. See also PYTHONOPTIMIZE.
The <code>-O </code> optimise flag has a number of effects in Gramps:
* If it is not turned on, an additional '''Debug''' entry appears in the '''Tools''' menu.
* If it is not turned on, [[Logging_system#So_how_logging_works_in_Gramps_after_all.3F|info logging messages are output]].
python gramps.py JohnDoe.ged
The first opens a family tree, the second imports a gedcom GEDCOM into an empty family tree.
Additionally, you can pass Gramps the name of the family tree to be opened:
* use this option : <precode>-O famtree</precode> or <precode>--open=famtree </precode>
<code>-O</code>, Open of a family tree. This can be done also by just typing the name (name or database dir)
Examples:
{{Man tip| Tip |If no option is given, just a name, Gramps will ignore the rest of the command line arguments. Use the <code>-O </code> flag to open, <code>-i </code> to import, and do something with the data.}}
{{Man tip| Tip |Only family trees can be opened directly. For other formats, you will need to use the import option which will set up the empty database and then import data into it.}}
=== Configuration (config) option ===
When all configuration variable(s) are set Gramps will start with these new values.
 
These options can takes three forms:
{{man note|Note|Except for example examples <tt>1</tt> and <tt>3.2</tt>, All the following examples, use <code>behavior.database-path</code> as the configuration variable to change.}}
1) See all config values: <code>-s</code> or <code>--show</code>
<br>For example:
<pre>
$python gramps.py -show
Gramps config settings from /home/username/.gramps/gramps41/gramps.ini:
behavior.max-age-prob-alive=110
behavior.betawarn=false
behavior.check-for-updates=0
behavior.check-for-update-types=['new']
behavior.avg-generation-gap=20
behavior.database-path='/home/grampsdev/.gramps/grampsdb'
behavior.startup=0
behavior.database-backend='bsddb'
</pre>
[[Image:CommandLineExampleOutput-s-40.png|400px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Command Line Example Output for ''python gramps.py -s'']]
{{-}}
2) See a value:  <code>--config=behavior.database-path </code> or <code>-c behavior.database-path</code><br>For example:<pre>$python gramps.py --config=behavior.database-path3) Set a valueCurrent Gramps config setting:behavior.database-path:'/home/username/.gramps/grampsdb'</pre>
3) Set a value: <code>--config=behavior.database-path:'/media/mydb' </code> or <code>-c behavior.database-path:'/media/mydb'</code><br>For example:
3.1) Set a value to its default: <code>--config=behavior.database-path:DEFAULT</code> or <code>-c behavior.database-path:DEFAULT</code><br>For example:
--config=behavior.database-path:DEFAULT or -c behavior.database-path:DEFAULT 3.2) Set more than one value:  <code>--config=behavior.use-tips:False --config=behavior.autoload:True </code> or <code>-c behavior.use-tips:False -c behavior.autoload:True</code> When all configuration variable(s) are set Gramps will start with these new values.<br>For example:
== Operation ==

Navigation menu