Difference between revisions of "Example.gramps"

From Gramps
Jump to: navigation, search
(add a link to the Wiki page on the General Preferences features, consolidate Linux lines on Finding/Expanding the example.gramps file)
(Load example.gramps)
Line 6: Line 6:
 
Follow these steps to load the example family tree:
 
Follow these steps to load the example family tree:
 
# Find <code>example.gramps.gz</code> or <code>example.gramps</code> on your system. For example:
 
# Find <code>example.gramps.gz</code> or <code>example.gramps</code> on your system. For example:
## on Linux <code>/usr/share/doc/gramps/example/gramps/</code>,  open <code>example.gramps.gz</code>, and extract <code>example.gramps</code> to a temporary location.
+
#* on Linux <code>/usr/share/doc/gramps/example/gramps/</code>,  open <code>example.gramps.gz</code>, and extract <code>example.gramps</code> to a temporary location.
## on MS-Windows AIO <code>C:\Program Files\GrampsAIO64-X.X.X\share\doc\gramps\example\gramps</code> (On MS-Windows ensure you can see hidden files; see  [[Gramps_5.0_Wiki_Manual_-_User_Directory#MS_Windows|User Directory:MS Windows]])
+
#* on MS-Windows AIO <code>C:\Program Files\GrampsAIO64-X.X.X\share\doc\gramps\example\gramps</code> (On MS-Windows ensure you can see hidden files; see  [[Gramps_5.0_Wiki_Manual_-_User_Directory#MS_Windows|User Directory:MS Windows]])
## The example database is not included in the MacOS AIO.
+
#* The example database is not included in the MacOS AIO.
  
 
# Start Gramps
 
# Start Gramps
 
# To create a new family tree {{man menu|Family Trees > Manage Family Trees...}} select the {{man button|New}} button. Give it some name, such as ''example''
 
# To create a new family tree {{man menu|Family Trees > Manage Family Trees...}} select the {{man button|New}} button. Give it some name, such as ''example''
 
# Open this new family tree. It will be empty.
 
# Open this new family tree. It will be empty.
 +
# In Gramps, use {{man menu|Family Trees > Import...}} to import <code>example.gramps</code>.
 +
#;Import Statistics of the example.gramps family tree
 +
{| class="wikitable"
 +
|
 +
Number of new objects imported:
 +
* People: 2157
 +
* Families: 762
 +
* [[Sources|{{man label|Sources}}]]: 4
 +
* [[Events_in_Gramps|{{man label|Events}}]]: 3432
 +
* Media Objects: 7
 +
* [[Places_in_Gramps|{{man label|Places}}]]: 1294
 +
* [[Repositories_in_Gramps|{{man label|Repositories}}]]: 3
 +
* Notes: 19
 +
* [[Tags_in_Gramps|{{man label|Tags}}]]: 2
 +
* [[Citations#Why_Cite|{{man label|Citations}}]]: 2854
 +
 +
Media objects with relative paths have been
 +
imported. These paths are considered relative to
 +
the media directory you can set in the preferences,
 +
or, if not set, relative to the user's directory.
 +
|[[File:GEDCOM-ImportStatistics-dialog-50.png|right|200px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Import Statistics - dialog]]
 +
|}
 +
There are seven example Media Objects (JPEG and PNG images) provided but the relative media path starting point (the Base Path) hasn't been defined in the Preferences. So these images won't be displayed until the media path has been re-defined.  The media path can be reset now or if starting to experiment with images. 
 
# In {{man menu|Edit > Preferences}}, change the {{man label|Base path for relative media paths:}} in the [[Gramps_5.0_Wiki_Manual_-_Settings#General|{{man label|General}}]] tab. This could be in a new directory, to keep it separate to your own family tree media. (eg On Linux <code>~/gramps/example/</code>)
 
# In {{man menu|Edit > Preferences}}, change the {{man label|Base path for relative media paths:}} in the [[Gramps_5.0_Wiki_Manual_-_Settings#General|{{man label|General}}]] tab. This could be in a new directory, to keep it separate to your own family tree media. (eg On Linux <code>~/gramps/example/</code>)
 
# Copy the media files from the example directory (that you found in step 1, above) to this media path directory.
 
# Copy the media files from the example directory (that you found in step 1, above) to this media path directory.
# In Gramps, use {{man menu|Family Trees > Import...}} to import <code>example.gramps</code>.
 
  
 
==See also==
 
==See also==

Revision as of 19:37, 13 October 2018

Your installation of Gramps should include an example family tree database. This is used to provide a known stable environment for testing.

If you think you have an issue/bug in your Family Tree/database, try the same operation with the example family tree. If the problem happens there as well, then it is probably not due to a corruption in your data.

Load example.gramps

Follow these steps to load the example family tree:

  1. Find example.gramps.gz or example.gramps on your system. For example:
    • on Linux /usr/share/doc/gramps/example/gramps/, open example.gramps.gz, and extract example.gramps to a temporary location.
    • on MS-Windows AIO C:\Program Files\GrampsAIO64-X.X.X\share\doc\gramps\example\gramps (On MS-Windows ensure you can see hidden files; see User Directory:MS Windows)
    • The example database is not included in the MacOS AIO.
  1. Start Gramps
  2. To create a new family tree Family Trees > Manage Family Trees... select the New button. Give it some name, such as example
  3. Open this new family tree. It will be empty.
  4. In Gramps, use Family Trees > Import... to import example.gramps.
    Import Statistics of the example.gramps family tree

Number of new objects imported:

Media objects with relative paths have been imported. These paths are considered relative to the media directory you can set in the preferences, or, if not set, relative to the user's directory.

Fig. .1 Import Statistics - dialog

There are seven example Media Objects (JPEG and PNG images) provided but the relative media path starting point (the Base Path) hasn't been defined in the Preferences. So these images won't be displayed until the media path has been re-defined. The media path can be reset now or if starting to experiment with images.

  1. In Edit > Preferences, change the Base path for relative media paths: in the General tab. This could be in a new directory, to keep it separate to your own family tree media. (eg On Linux ~/gramps/example/)
  2. Copy the media files from the example directory (that you found in step 1, above) to this media path directory.

See also