36
edits
Changes
Centralize installation folder information in All_In_One_Gramps_Software_Bundle_for_Windows > Installation folder section instead adding details here.
=== MS Windows ===
* From the Start menu, start cmd.exe.
* Change directory to the starting installation directory you noted downlocated.* Right click and select PasteType in or paste the path, surrounding it in quotes if there are spaces.
* Press {{man key press|Enter}}.
For example, this might be:
cd "C:\Program Files\GrampsAIO64GrampsAOI64-{{template:Version windows AIO64}}"
gramps
gramps -L
=== Mac OS X MacOS ===
To run from the command line, you'll need to start Terminal, found in the Utilities folder of the main Applications folder (/Applications:/Utilities).Once you have a terminal window open, at the prompt type
/path/to/Gramps.app/Contents/MacOS/Gramps
If you installed Gramps in Applications along with most of your other apps, as suggested above, that would be
/Applications/Gramps.app/Contents/MacOS/Gramps
You may use any of the command-line options along with this. For example, to get a detailed listing of all of the Family Tree databases in your default Family Tree folder, you would use
/Applications/Gramps.app/ContentContents/MacOS/Gramps -L
There are other ways to install Gramps for Mac OS XMacOS, but these are much more complicated and are not covered here.
== Python options ==
gramps -O 'Family Tree 1' -e output.gramps -f gramps-xml
10. To generate a web site into an other locale (in germanGerman):
LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Family Tree 1' -a report -p name=navwebpage,target=/../de
Family Tree "Example Family Tree":
Database: SQLite
Database module location: /usr/lib/python3.56/sqlite3/__init__.py
Database module version: 2.6.0
Database version: 3.1121.0
Last accessed: 30/12/17 09:29:37
Locked?: False
</pre>
{{man note|Note that dates are shown in the default LOCALE format.|You change that at the system level. For example, on [[Gramps_Glossary#posix|POSIX]]-based systems you could use: <pre>LC_TIME=en_AU.UTF-8 gramps -L</pre>}}
{{-}}
* '''csv''' - Comma Separated Value: This format is available for import and export. Be careful however, import must be as values created by the export function. Only a part of your data is contained in the output.
* '''vcf''' - VCard format: import and export
* '''vcs''' - VCalandar VCalendar format: export
* '''def''' - old Pro-Gen format: import
* '''wft''' - Web Family Tree: This format is available for export only. When not specified, it can be guessed if the filename ends with .wft
You can open a family tree, or you can ''open'' a file by importing it in an empty family tree.
To let Gramps handle this automatically, just supply the familytree family tree or filename you want to open:
python gramps.py 'My Fam Tree'
ancestor_chart - Ancestor Tree
ancestor_report - Ahnentafel Report
AncestorFill - AncestorFill
birthday_report - Birthday and Anniversary Report
calendar - Calendar
d3-ancestralcollapsibletree - Ancestral Collapsible Tree
d3-ancestralfanchart - Ancestral Fan Chart
d3-descendantindentedtree - Descendant Indented Tree
database-differences-report - Database Differences Report
denominoviso - DenominoViso
descend_chart - Descendant Tree
descend_report - Descendant Report
DescendantBook - Descendant Book
Descendants Lines - Descendants Lines
det_ancestor_report - Detailed Ancestral Report
det_descendant_report - Detailed Descendant Report
DetailedDescendantBook - Detailed Descendant Book
double_cousins - Double Cousins
DynamicWeb - Dynamic Web Report
endofline_report - End of Line Report
family_descend_chart - Family Descendant Tree
family_group - Family Group Report
familylines_graph - Family Lines Graph
FamilySheet - Family Sheet
FamilyTree - Family Tree
fan_chart - Fan Chart
gt_ancestor - Ancestor Tree
gt_descendant - Descendant Tree
gt_grandparent - Grandparent Tree
gt_sandclock - Sandclock Tree
gt_sandclock_family - Sandclock Tree for a Family
Heatmap - Heatmap
hourglass_graph - Hourglass Graph
indiv_complete - Complete Individual Report
kinship_report - Kinship Report
LastChangeReport - Last Change Report
LinesOfDescendency - Lines of Descendency Report
ListeEclair - Tiny Tafel
MediaReport - Media Report
navwebpage - Narrated Web Site
networkchart - Network Chart
notelinkreport - Note Link Report
number_of_ancestors - Number of Ancestors Report
PedigreeChart - Pedigree Chart
PersonEverythingReport - PersonEverything Report
place_report - Place Report
records - Records Report
rel_graph - Relationship Graph
Repositories Report - Repositories Report
SourcesCitationsReport - Sources and Citations Report
statistics_chart - Statistics Charts
summary - Database Summary Report
tag_report - Tag Report
timeline - Timeline Chart
TimePedigreeHTML - Timeline Pedigree Report
TodoReport - Todo Report
WebCal - Web Calendar
</pre>}}
:<code>gramps -O 'Family Tree 1' -e output.gramps -f gramps-xml</code>
* To generate a web site into an other locale (in germanGerman):
:<code>LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Family Tree 1' -a report -p name=navwebpage,target=/../de </code>
===GRAMPSHOME===
* '''GRAMPSHOME''' - if set, [[Gramps_and_Windows#Setting_the_configuration_path|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[[Gramps_Glossary#user_directory|User Directory]]. It can also be used to configure Gramps to [[Run_Gramps_from_a_portable_drive|run from a portable drive]] or to prepare for a [[Installation|manual installation]]. The path can also be used to configure the path to a [[Gramps_for_Windows_with_MSYS2#Keep_your_GRAMPSHOME_separate|separate test Tree]] or [[Getting_started_with_Gramps_development|development Tree]].
For example <pre>GRAMPSHOME=$HOME/familytrees/paternal</pre>
===GRAMPS_RESOURCES===
* The environment variable GRAMPS_RESOURCES is the path to Gramps builtin built-in resources files. You should only change this if you are using Gramps from source code or a custom environment. An indicator that you need to set this variable is if you receive one of the following errors:
** ''Encoding error while parsing resource path''
** ''Failed to open resource file''
Example [[Linux:Build_from_source#Running_from_a_tarball_release|usage]]:
GRAMPS_RESOURCES=/home/bennyusername/gramps/branches/maintenance/gramps50gramps51/build/lib.linux-x86_64-2.7/ PYTHONPATH=$GRAMPS_RESOURCES:$PYTHONPATH ./gramps
{{-}}