Difference between revisions of "Gramps 5.1 Wiki Manual - FAQ"

From Gramps
Jump to: navigation, search
(How can I publish a genealogy web site with Gramps?)
m (How do I keep backups?: move widows caveat to end of paragraph)
(31 intermediate revisions by 5 users not shown)
Line 3: Line 3:
 
{{#vardefine:chapter|A}}
 
{{#vardefine:chapter|A}}
 
{{#vardefine:figure|0}}
 
{{#vardefine:figure|0}}
This appendix contains the list of '''Frequently asked questions''' that come up in mailing list discussions and forums. This list is by no means complete. If you would like to add questions/answers to this list, please join and email your suggestions to the [email protected] mailing list.
+
This appendix contains the list of '''Frequently Asked Questions''' (FAQ) that repeatedly come up in mailing lists and discussion forums.  
 +
 
 +
This list is by no means complete. If you would like to add questions/answers to this list, please [[Contact#Mailing_lists|join]] and email your suggestions to the <code>[email protected]</code> mailing list.
  
 
Also consider having a look at the following Categories on the Gramps wiki:
 
Also consider having a look at the following Categories on the Gramps wiki:
 
*[[:Category:How do I...|How do I...]]
 
*[[:Category:How do I...|How do I...]]
 
*[[:Category:Tutorials|Gramps Tutorials]]
 
*[[:Category:Tutorials|Gramps Tutorials]]
 
+
You may find it useful to review
 +
*[[:Gramps Glossary]] - gives an overview of terms that appear in Gramps
 +
*[[:Genealogy Glossary]] - genealogical terms and meanings.
 
==General==
 
==General==
  
Line 26: Line 30:
  
 
===How do I keep backups?===
 
===How do I keep backups?===
Automatic backup is a default feature that protects your genealogical data in Gramps. (It became automated in 2018 with the release of the 5.1 version.) The settings for the interval, backup file path and option whether to backup when exiting Gramps are in the {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}} tab of the {{man menu|Edit -> Preferences...}} menu. Additionally, a backup can be manually selected from the {{man menu|Family Trees > Make Backup...}} window.
+
Automatic backup is a default feature that protects your genealogical data in Gramps. (It became automated in 2018 with the release of the 5.1 version.) The interval, backup file path and option to backup when exiting Gramps settings are in the {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}} tab of the {{man menu|Edit -> Preferences...}} menu. Additionally, a backup can be manually selected from the {{man menu|Family Trees > Make Backup...}} window.
  
It is extremely important to keep backups of your data, and keep them in a safe place. Gramps has a specific portable file format which is small, and human readable, denoted by <code>.gramps</code>. See [[Gramps 5.1 Wiki Manual - Manage Family Trees#Backing up a Family_Tree]].
+
It is extremely important to keep backups of your data, and keep them in a safe place. Gramps has a specific portable file format which is small, and human readable, denoted by <code>.gramps</code>. See the "[[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|backup up a Family Tree]]" section of the manual. It is also important to be aware of [[Template:Backup_Omissions|what is omitted from a Gramps backup]].
  
You can copy this backup file from time to time to a save location (eg a usb stick).  
+
You can copy this backup file from time to time to a safe location (e.g., a USB stick).  
[Note: The .gramps files are compressed. Clicking them will open Gramps. To see the XML select them and open them with a decompressing utility (like ark, gunzip), after which you can extract the XML file which is human readable, see [[Generate_XML#How_do_I_uncompress_the_file?|details]].
+
[Note: The <code>.gramps</code> files are compressed by default. Clicking them will open Gramps. To see the XML, select the <code>.gramps</code> file and open it with a decompressing utility (like ark, gunzip, 7-zip), after which you can extract the XML text file which is human readable, see [[Generate_XML#How_do_I_uncompress_the_file?|details]].
  
Gramps does a quick hidden binary backup to allow restore if an error is noted. If the correct package is installed you can use a revision system.
+
Gramps does a quick hidden binary backup to allow restore if an error is noted. If the correct package is installed, you can use a revision system.
  
Another method is to backup the hidden directory ''/.gramps''. This directory is situated in your home directory on Linux systems. Backing up this directory will backup your databases and revisions.
+
Another method is to backup the ''<code>/.gramps</code>'' hidden directory. This subdirectory is situated in your [[Gramps_5.1_Wiki_Manual_-_User_Directory|User Directory]]. Backing up this directory will backup your databases and revisions. (On Windows 10 it is ''<code>/Users/<your username>/AppData/Roaming/gramps</code>'')
  
'''Do not keep backups in GEDCOM'''. Not all information Gramps stores can be written in the GEDCOM. Hence, an export/import operation Gramps --> GEDCOM --> Gramps, will mean you '''lose''' [[Gramps_and_GEDCOM|data]]. Use the <code>.gramps</code> file format for backups!
+
'''Do not keep backups in GEDCOM format'''. Not all information Gramps stores can be written in the GEDCOM. Hence, an export/import operation from Gramps exported into GEDCOM and re-imported into Gramps, will mean you '''lose''' [[Gramps_and_GEDCOM|data]]. Use the <code>.gramps</code> file format for backups!
  
 
'''Do not keep backups in GRDB format'''. GRDB is a database, which might be computer dependent (read, not working on a different PC). Small damage to a GRDB file can also not be repaired. Use the <code>.gramps</code> file format for backups!
 
'''Do not keep backups in GRDB format'''. GRDB is a database, which might be computer dependent (read, not working on a different PC). Small damage to a GRDB file can also not be repaired. Use the <code>.gramps</code> file format for backups!
Line 53: Line 57:
 
===Does Gramps work on Windows?===
 
===Does Gramps work on Windows?===
  
Yes, many people use it on Windows.  Probably the easiest thing is to [[Download]] the [[All In One Gramps Software Bundle for Windows|GrampsAIO]] software "bundle" for Windows, as that is an all-in-one package of Gramps with the other programs it needs, and so may be installed very trivially.
+
Yes, Windows is a community supported platform for Gramps.
  
We will do our best to solve Windows-related problems. See [[Contact|here]].
+
You can [[Download#MS_Windows|download]] the [[All In One Gramps Software Bundle for Windows]](GrampsAIO).
  
See [[Gramps and Windows]] for a summary of hints to use Gramps on a Windows PC.
+
We will do our best to solve any reported Windows-related problems. See [[Contact|here]].
  
Also, the [[Linux Genealogy CD]] can function as a live CD that you boot directly from (If you have a CD/DVD-ROM Drive). You can then run Linux and Gramps off the CD, even if your computer is entirely Windows.
+
===Does Gramps work on the Mac?===
  
===Does Gramps work on the Mac?===
+
Yes, macOS is a community supported platform for Gramps.
 +
 
 +
You can [[Download#macOS|download]] the macOS version.
  
Yes, Mac is a community supported platform for Gramps.
+
We will do our best to solve any reported Apple macOS related problems. See [[Contact|here]].
  
 
See [[Mac OS X:Application package|here]].
 
See [[Mac OS X:Application package|here]].
Line 84: Line 90:
 
The display spec was more recently updated to an odd spec misquote of 1080p of 1920 x 1080 Full High Definition (FHD). It seems quite arbitrarily... the 'at least' being related to no GUI design criteria. Simply a 'more is better' note:1080p was a widescreen spec introduced 2007
 
The display spec was more recently updated to an odd spec misquote of 1080p of 1920 x 1080 Full High Definition (FHD). It seems quite arbitrarily... the 'at least' being related to no GUI design criteria. Simply a 'more is better' note:1080p was a widescreen spec introduced 2007
 
-->
 
-->
We would recommend at least an 1980x1080 video display. The early memory requirements for Gramps, have been reduced, and Gramps were quite high. Beginning with Gramps 3.0, the software could run quite efficiently on a 256MB system, holding considerably more people. A system with 512MB should be able to hold around 200,000 people. However, disk disk space requirements for databases are however considerably larger, with a typical database being several megabytes in size. For 120.000 people you must consider already 530MB for the database. Pictures are stored on disk separately, so a large harddisk is necessary.
+
We would recommend at least an 1920x1080 video display. The early memory requirements for Gramps, have been reduced, and Gramps were quite high. Beginning with Gramps 3.0, the software could run quite efficiently on a 256MB system, holding considerably more people. A system with 512MB should be able to hold around 200,000 people. However, disk disk space requirements for databases are however considerably larger, with a typical database being several megabytes in size. For 120.000 people you must consider already 530MB for the database. Pictures are stored on disk separately, so a large harddisk is necessary.
  
 
<span id="How do I upgrade GRAMPS?">
 
<span id="How do I upgrade GRAMPS?">
Line 117: Line 123:
  
 
===Can Gramps read files created by other genealogy programs? ===
 
===Can Gramps read files created by other genealogy programs? ===
[[Gramps_5.1_Wiki_Manual_-_FAQ#Is_Gramps_compatible_with_other_genealogical_software.3F|See above.]]
+
Yes can read GEDCOM files created by other genealogy programs.
 +
* [[Gramps_5.1_Wiki_Manual_-_FAQ#Is_Gramps_compatible_with_other_genealogical_software.3F|See above.]]
  
 
===Can Gramps write files readable by other genealogy programs? ===
 
===Can Gramps write files readable by other genealogy programs? ===
[[Gramps_5.1_Wiki_Manual_-_FAQ#Is_Gramps_compatible_with_other_genealogical_software.3F|See above.]]
+
Yes can write GEDCOM files to be read by other genealogy programs.
 +
* [[Gramps_5.1_Wiki_Manual_-_FAQ#Is_Gramps_compatible_with_other_genealogical_software.3F|See above.]]
  
 
===What standards does Gramps support?===
 
===What standards does Gramps support?===
Line 159: Line 167:
 
===In what formats can Gramps output its reports?===
 
===In what formats can Gramps output its reports?===
  
Text reports are available in HTML, PDF, ODT, LaTeX, and RTF formats. Graphical reports (charts and diagrams) are available in PostScript, PDF, SVG, ODS, and GraphViz formats.
+
Text reports are available in HTML, PDF, ODT, LaTeX, and RTF formats. Graphical reports (charts and diagrams) are available in PostScript, PDF, SVG, ODS, and [[Output_formats#Graphviz|GraphViz]] formats.
  
 
===How can I change the default language in reports?===
 
===How can I change the default language in reports?===
Line 188: Line 196:
  
 
==Database - Gramps file formats==
 
==Database - Gramps file formats==
 
+
The default file format is [[Gramps XML]] it is used for exports, backups, and imports and preserves your entered genealogical data with no data loss as compared to the GEDCOM format.
 
===What is the maximum database size (bytes) Gramps can handle?===
 
===What is the maximum database size (bytes) Gramps can handle?===
  
Gramps has no hard limits on the size of a database that it can handle. Starting with 2.0.0 release, Gramps no longer loads all data into memory, which allows it to work with a much larger database than before. In reality, however, there are practical limits. The main limiting factors are the available memory on the system and the cache size used for BSDDB database access. With common memory sizes these days, Gramps should have no problem using databases with [[Gramps Performance|tens of thousands of people]].
+
Gramps has no hard limits on the size of a database that it can handle. Starting with 2.0.0 release, Gramps no longer loads all data into memory, which allows it to work with a much larger database than before. In reality, however, there are practical limits. The main limiting factors are the available memory on the system and the cache size used for BSDDB database access. With common memory sizes these days, Gramps should have no problem using databases with [[Gramps_Performance#JohnBoyTheGreat_2019-12.2C_version_5.1.1|Millions of people]].
  
 
===How many people can Gramps database handle? ===
 
===How many people can Gramps database handle? ===
  
See above. Again, this is dependent on how much memory you have, see [[Gramps Performance]].
+
See above. Again, this is dependent on how much memory and storage space your computer has, see [[Gramps Performance]].
  
 
===My database is really big. Is there a way around loading all the data into memory?===
 
===My database is really big. Is there a way around loading all the data into memory?===
Line 215: Line 223:
 
The problem with transactions (at least using BSDDB) is that it does not allow all the data to be stored in a single file. Logging files are needed to keep track of things. These logging files are kept in a DB Environment directory. We need a separate directory for each file, otherwise the log files can interfere with each other.
 
The problem with transactions (at least using BSDDB) is that it does not allow all the data to be stored in a single file. Logging files are needed to keep track of things. These logging files are kept in a DB Environment directory. We need a separate directory for each file, otherwise the log files can interfere with each other.
  
In 2.2, we keep the log files under the ~/.gramps/<path> directory, creating a unique directory for each database. The problem is that your GRDB file needs the log files, which are in a different directory.
+
In 2.2, we keep the log files under the <code>~/.gramps/</code> directory, creating a unique directory for each database. The problem is that your GRDB file needs the log files, which are in a different directory.
  
 
Copying the GRDB file is only copying a portion of the database.
 
Copying the GRDB file is only copying a portion of the database.
Line 223: Line 231:
 
===What do I do if I have found a bug?===
 
===What do I do if I have found a bug?===
  
The best thing you can do is to fix the bug and send the patch to [email protected] :-)
+
You can [[How to report bugs|submit a bug report.]]
 
 
If that is not possible, you should [[How to report bugs|submit a bug report]]
 
  
 
A good bug report would include:
 
A good bug report would include:
Line 266: Line 272:
  
 
===How do you add photos to an item?===
 
===How do you add photos to an item?===
{{stub}}
+
See [[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_brief#Adding_photos_and_other_media_objects|Adding photos and other media objects]].
  
 
===How do you find unused media?===
 
===How do you find unused media?===
{{stub}}
+
Media that have not been associated with any objects may be found by creating a [[Gramps_5.1_Wiki_Manual_-_Filters#Custom_Filters|Custom Filter]] in the Media Category view. Use the [[Gramps_5.1_Wiki_Manual_-_Filters#Media_objects_with_a_reference_count_of_.3Ccount.3E|Media objects with a reference count of &lt;count&gt;]] rule to find media with fewer than 1 reference.
  
 
===How can I publish a genealogy web site with Gramps?===
 
===How can I publish a genealogy web site with Gramps?===
Line 277: Line 283:
 
https://gramps-project.org/bugs/view.php?id=11742
 
https://gramps-project.org/bugs/view.php?id=11742
 
-->
 
-->
Gramps has built-in and addon reports to create website content. Once generated, you can upload the files to a webserver or distribute it on a portable thumbdrive or CD-ROM.</span>
+
Gramps has multiple options in the Reports menu for creating Web Pages based on your Tree data.
  
[[File:NarratedWebSite-WebPages-Individuals-page-example-50.png|right|150px|link=Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Narrated_Web_Site|thumb|NarrativeWeb - Individuals page]]A tutorial entitled "[[Howto:_Make_a_genealogy_website_with_Gramps|Howto: Make a genealogy website with Gramps]]" describes using the [[Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Narrated_Web_Site|NarrativeWeb]] (a.k.a. Narrated Web Site) report to generate a website about a set of people in your Tree.
+
The [[Howto:_Make_a_genealogy_website_with_Gramps|Howto: Make a genealogy website with Gramps]] tutorial describes using the [[Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Narrated_Web_Site|Narrated Web Site]] (a.k.a. NarrativeWeb) report. In it, you will learn to generate a website around a set of people in your Family Tree.
[[File:Shakespeare_network_1_dynamic_url.svg|thumb|left|150px|link=NetworkChart|NetworkChart addon]]
 
[[File:WebCalendar-WebPages-example-DecemberCalendar2018-50.png|thumb|right|150px|link=Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Web_Calendar|Web Calendar Report ]]
 
[[File:Addon-Interactive-Family-Tree-Topola-example-51.png|thumb|left|150px|link=Interactive_Family_Tree|Interactive Family Tree]]
 
  
Addons for creating new ways of displaying web content are contributed by 3rd parties. Instead, use the [[Gramps_5.1_Wiki_Manual_-_Plugin_Manager|plugin manager]] and [[Gramps_5.1_Wiki_Manual_-_Settings#General|preferences]] to check for the most current contributions. Check the [[5.1_Addons#Addon_List|addons list]] on the wiki to discover if documentation has been created for those which interest you. 
+
Once generated, you can upload the web files to a hosting service. You can also distribute them on a portable thumbdrive or other media.
*Addon name: Ancestral Fan Chart [Report]
+
</span>
:Description: Generates a web page with a graphical representation of ancestors (SVG) represented as a Fan Chart from the D3.js JavaScript library.
 
*Addon name: [[DenominoViso|DenominoViso]] [Report]
 
:Description: Generates a web (HTML) page with a graphical representation of ancestors/descendants (SVG) where details about individuals become visible upon mouse-events.
 
*Addon name: [[DynamicWeb_report#Demos|Dynamic Web]] Report [Report]
 
:Description: Produces dynamic web pages for the database
 
*Addon name: [[Interactive_Family_Tree|Interactive Family Tree]] [Tool]
 
:Description: Opens an interactive tree in the browser. This tool uses the Topola Genealogy Viewer to display the family tree.
 
*Addon name: [[NetworkChart|Network Chart]] [Report]
 
:Description: Generates a family network chart.
 
  
 +
You can also install third party addon reports to create other styles of web content. See the [[5.1_Addons#Addon_List|Addons List]].
 
{{-}}
 
{{-}}
 
{{man index|Gramps 5.1 Wiki Manual - Filters|Gramps 5.1 Wiki Manual - Keybindings|5.1}}
 
{{man index|Gramps 5.1 Wiki Manual - Filters|Gramps 5.1 Wiki Manual - Keybindings|5.1}}

Revision as of 21:36, 16 December 2020

Previous Index Next


This appendix contains the list of Frequently Asked Questions (FAQ) that repeatedly come up in mailing lists and discussion forums.

This list is by no means complete. If you would like to add questions/answers to this list, please join and email your suggestions to the [email protected] mailing list.

Also consider having a look at the following Categories on the Gramps wiki:

You may find it useful to review

Contents

General

What is Gramps?

Gramps is the Genealogical Research and Analysis Management Program System. In other words, it is a personal genealogy program letting you store, edit, and research genealogical data using the powers of your computer, see About.

Where do I get it and how much does it cost?

Gramps can be installed at no charge. Gramps is an Open Source project covered by the GNU General Public License. You have full access to the source code and are allowed to distribute the program and source code freely.

Do I need to register as a user to use Gramps, I am not a programmer?

No, registering is only needed if you want to file a bug (or feature request) report or edit/write a wiki page.

No programming skill needed for that.

Does Gramps exist in other languages?

Yes, at the release of Gramps 5.1 it has been translated into 28 languages, see Gramps translations.

How do I keep backups?

Automatic backup is a default feature that protects your genealogical data in Gramps. (It became automated in 2018 with the release of the 5.1 version.) The interval, backup file path and option to backup when exiting Gramps settings are in the Family Tree tab of the Edit -> Preferences... menu. Additionally, a backup can be manually selected from the Family Trees > Make Backup... window.

It is extremely important to keep backups of your data, and keep them in a safe place. Gramps has a specific portable file format which is small, and human readable, denoted by .gramps. See the "backup up a Family Tree" section of the manual. It is also important to be aware of what is omitted from a Gramps backup.

You can copy this backup file from time to time to a safe location (e.g., a USB stick). [Note: The .gramps files are compressed by default. Clicking them will open Gramps. To see the XML, select the .gramps file and open it with a decompressing utility (like ark, gunzip, 7-zip), after which you can extract the XML text file which is human readable, see details.

Gramps does a quick hidden binary backup to allow restore if an error is noted. If the correct package is installed, you can use a revision system.

Another method is to backup the /.gramps hidden directory. This subdirectory is situated in your User Directory. Backing up this directory will backup your databases and revisions. (On Windows 10 it is /Users/<your username>/AppData/Roaming/gramps)

Do not keep backups in GEDCOM format. Not all information Gramps stores can be written in the GEDCOM. Hence, an export/import operation from Gramps exported into GEDCOM and re-imported into Gramps, will mean you lose data. Use the .gramps file format for backups!

Do not keep backups in GRDB format. GRDB is a database, which might be computer dependent (read, not working on a different PC). Small damage to a GRDB file can also not be repaired. Use the .gramps file format for backups!

Does Gramps support Unicode fonts?

In particular, does it support non-Roman Unicode fonts? Yes. Gramps works internally with Unicode (UTF-8), so all alphabets can be used on all entry fields. All reports fully support this, although for PDF/PS you need to work with gnome-print or LibreOffice.

Installation

What is needed to install Gramps under Linux, Solaris, or FreeBSD?

Gramps is a GTK application. Gramps needs to have the PyGObject libraries installed on the system. As long as these libraries are installed, Gramps should function. It will operate under the GNOME desktop, KDE desktop, or any other desktop. If the GNOME bindings for Python are installed on the system, Gramps will have additional functionality. Please check that it meet the Gramps project recommendations on the GTK version to use.

Does Gramps work on Windows?

Yes, Windows is a community supported platform for Gramps.

You can download the All In One Gramps Software Bundle for Windows(GrampsAIO).

We will do our best to solve any reported Windows-related problems. See here.

Does Gramps work on the Mac?

Yes, macOS is a community supported platform for Gramps.

You can download the macOS version.

We will do our best to solve any reported Apple macOS related problems. See here.

See here.

Does Gramps work on my mobile device?

Short answer is no, Gramps cannot be installed on your Mobile Phone or tablet( Google Android or Apple iOS )

More technical answer is yes if you can install a version of Linux Operating systems on the mobile device along with all the support packages.

Does Gramps work on my Google Chromebook?

You can but with a few issues install Gramps on your Chromebook see #11058


What are the Minimum Specs to run Gramps?

We would recommend at least an 1920x1080 video display. The early memory requirements for Gramps, have been reduced, and Gramps were quite high. Beginning with Gramps 3.0, the software could run quite efficiently on a 256MB system, holding considerably more people. A system with 512MB should be able to hold around 200,000 people. However, disk disk space requirements for databases are however considerably larger, with a typical database being several megabytes in size. For 120.000 people you must consider already 530MB for the database. Pictures are stored on disk separately, so a large harddisk is necessary.

How do I upgrade Gramps?

GNU/Linux operating systems will typically deal with upgrade issues for you. If they do not then you need to ask users of your preferred GNU/Linux distribution.

Gnome-important.png
TODO

The Windows port of Gramps needs to be updated manually.

Preferences

Can I change the dates in reports to 'day month year'?

Yes, in the preferences (Edit -> Preferences Display tab) change the Date format: setting for Gramps to the required format (eg YYYY-MM-DD or day month year), and make the report. Your global date preferences will be used.

Collaboration-Portability

Is Gramps compatible with other genealogical software?

Gramps makes every effort to maintain compatibility with GEDCOM, the general standard of recording genealogical information. We have import and export filters that enable Gramps to read and write GEDCOM files.

It is important to understand that the GEDCOM standard is poorly implemented -- virtually every genealogical software has its own "flavor" of GEDCOM. As we learn about new flavor, the import/export filters can be created very quickly. However, finding out about the unknown flavors requires user feedback. Please feel free to inform us about any GEDCOM flavor not supported by Gramps, and we will do our best to support it!

There is a specific section of this wiki which discusses Gramps and GEDCOM.

Can Gramps read files created by other genealogy programs?

Yes can read GEDCOM files created by other genealogy programs.

Can Gramps write files readable by other genealogy programs?

Yes can write GEDCOM files to be read by other genealogy programs.

What standards does Gramps support?

The nice thing about standards is that there never is a shortage of them. Gramps is tested to support the following flavors of GEDCOM 5.5.1, Brother's Keeper, Family Origins, Family Tree Maker, Ftree, GeneWeb, Legacy, Personal Ancestral File, Pro-Gen, Reunion, and Visual Genealogie.

How do I import data from another genealogy program into Gramps?

The best way is to create a new family tree, and select the import option in the file menu. Here you select the GEDCOM you generated with the other program, and import it.

Can I install Gramps on a Linux Web Server and use it via a web browser?

This would enable my relations worldwide to access and update it.

While Gramps can generate web sites, it does not provide a web interface that allows for editing. If this is a requirement, then GeneWeb or webtrees are programs more likely to meet your needs. Also have a look at experimental gramps-online. However, you may wish to ask yourself the following questions:

  1. Do I really want relatives or other people to directly edit my genealogy database?
  2. Do I implicitly trust, without verification, any data that people may enter?
  3. Do these people have the same understanding of good genealogy practice that I have?

A better approach may be to provide a web form interface that allows others to enter data that is then held for your examination. You can then decide if the information should be entered into your database.

You may also want to consider the effects of possible downtime of your site if you cannot afford yourself a premium webhosting service.

Reports

Can Gramps print a genealogical tree for my family?

Yes. Different people have different ideas of what a genealogical tree is. Some think of it as a chart going from the distant ancestor and listing all his/her descendants and their families. Others think it should be a chart going from the person back in time, listing the ancestors and their families. Yet other people think of a table, text report, etc.

Gramps can produce any of the above, and many more different charts and reports. Moreover, the plugin architecture enables users (you) to create their own plugins which could be new reports, charts, or research tools.

How can the relationship between people on the tree be determined?

Some users are interested in only showing direct ancestor or descendant genetic relationships. Other users are also interested in collateral (cousins!) lines or immediate in-laws. And yet other users are interested in how the most indirect connections influence a community.

So Gramps offers a continually expanding variety of tools, reports and methods to determine how people are connected within a Tree's database. Following a discussion on the Gramps-User Maillist, the posted suggestions have been collated and expounded upon in the "How to find the relationship between people" article in the "How do I..." wiki category.

In what formats can Gramps output its reports?

Text reports are available in HTML, PDF, ODT, LaTeX, and RTF formats. Graphical reports (charts and diagrams) are available in PostScript, PDF, SVG, ODS, and GraphViz formats.

How can I change the default language in reports?

The reports are in the language of your installation. Most reports allow you to select the Language to output to look for the Translation: option to select the translation to be used for the report. You can change it by installing extra language packs, see Howto: Change the language of reports.

Is Gramps compatible with the Internet?

Gramps can store web addresses and direct your browser to them. It can import data that you download from the Internet. It can export data that you could send over the Internet. Gramps is familiar with the standard file formats widely used on the Internet (e.g. JPEG, PNG, and GIF images, MP3, OGG, and WAV sound files, QuickTime, MPEG, and AVI movie files, etc). Other than that, there is little that a genealogical program can do with the Internet.

Can I create custom reports/filters/whatever?

Yes. There are many levels of customization. One is creating or modifying the templates used for the reports. This gives you some control over the fonts, colors, and some layout of the reports. You can also use Gramps controls in the report dialogs to tell what contents should be used for a particular report. In addition to this, you have an ability to create your own filters -- this is useful in selecting people based on criteria set by you. You can combine these filters to create new, more complex filters. Finally, you have an option to create your own plugins. These may be new reports, research tools, import/export filters, etc. This assumes some knowledge of programming in Python.

Why are non-Latin characters displayed as garbage in PDF/PS reports?

This is a limitation of the built-in fonts of PS and PDF formats. To print non-Latin text, use the Print... in the format selection menu of the report dialog. This will use the gnome-print backend, which supports PS and PDF creation, as well as direct printing. (Note: you might need to install gnome-print separately as it is not required for Gramps).

If you only have Latin text, the PDF option will produce a smaller PDF compared to that created by gnome-print, simply because no font information will be embedded.

I would like to contribute to Gramps by writing my favorite report. How do I do that?

The easiest way to contribute to reports, filters, tools, etc. is to copy an existing Gramps report, filter, or tool. If you can create what you want by modifying existing code -- great! If your idea does not fit into the logic of any existing Gramps tool, you will need to write your own plugin from scratch. Help is available on the Developers Portal, or on the Developers mailing list: [email protected].

To test your work in progress, you may save your plugin under $HOME/.gramps/plugins directory and it should be found and imported on startup. The correctly written addon/plugin will register itself with Gramps, create menu item, and so on.

If you are happy with your addon/plugin and would like to contribute your code back to the Gramps project, you are very welcome to do so by joining and contacting us at [email protected] mailing list.

Database - Gramps file formats

The default file format is Gramps XML it is used for exports, backups, and imports and preserves your entered genealogical data with no data loss as compared to the GEDCOM format.

What is the maximum database size (bytes) Gramps can handle?

Gramps has no hard limits on the size of a database that it can handle. Starting with 2.0.0 release, Gramps no longer loads all data into memory, which allows it to work with a much larger database than before. In reality, however, there are practical limits. The main limiting factors are the available memory on the system and the cache size used for BSDDB database access. With common memory sizes these days, Gramps should have no problem using databases with Millions of people.

How many people can Gramps database handle?

See above. Again, this is dependent on how much memory and storage space your computer has, see Gramps Performance.

My database is really big. Is there a way around loading all the data into memory?

Starting with 2.0.0 release, Gramps no longer loads all data into memory, which allows it to work with a much larger database than before. The fileformat used is .grdb which means Gramps database.

Can I run Gramps from a database on a NFS share?

Yes you can run a Gramps database from a NFS(NetworkFile System) share.

What does "portable" mean?

A Gramps 3 database (and any .grdb file) is very dependent on the software versions that created it. For example, you can't just move your Gramps data in these formats to a different operating system (or even a different version of an operating system) and expect that you will be able to read your data. The data is not "portable". Therefore, you can't just rely on backups of these formats, but you should also occasionally export into a format that is portable. There are two possible portable formats: GEDCOM and Gramps XML (.gramps or .gpkg). But only Gramps XML is recommended, as it faithfully saves all of your data.

Why is the database format (GRDB) not portable?

The biggest issue with Gramps portability lies with 'transactions'. With Gramps 2.2, we added support for atomic transactions to protect data. With atomic transactions, multiple changes are committed as a single unit. Either all the changes make it, or none of the changes make it. You are never left in a situation with a partial set of changes. A side benefit of using transactions is that database access (reads and writes) are faster.

The problem with transactions (at least using BSDDB) is that it does not allow all the data to be stored in a single file. Logging files are needed to keep track of things. These logging files are kept in a DB Environment directory. We need a separate directory for each file, otherwise the log files can interfere with each other.

In 2.2, we keep the log files under the ~/.gramps/ directory, creating a unique directory for each database. The problem is that your GRDB file needs the log files, which are in a different directory.

Copying the GRDB file is only copying a portion of the database.

Bugs and requests

What do I do if I have found a bug?

You can submit a bug report.

A good bug report would include:

  1. Version of Gramps you were using when you encountered the bug (available through Help → About menu item).
  2. Language under which Gramps was run (available by executing echo $LANG in your terminal).
  3. Symptoms indicating that this is indeed a bug.
  4. Any Traceback messages, error messages, warnings, etc, that showed up in your terminal or a in separate traceback window.

Most problems can be fixed quickly provided there is enough information. To ensure this, please follow up on your bug reports. Then we will have a way of contacting you should we need more information.

Requests

  • Gramps should be a .... type of application

It is obvious that Gramps absolutely needs to become a (client-server/web-based/PHP/weblog/Javascript/C++/distributed/KDE/Motif/Tcl/Win32/C#/You-name-it) application. When is this going to happen?

The surest way to see it happen is to get it done by yourself. Since Gramps is free/open source, nobody prevents you from taking all of the code and continuing its development in whatever direction you see fit. In doing so, you may consider giving your new project another name to avoid confusion with the continuing Gramps development. If you would like the Gramps project to provide advice, expertise, filters, etc., we will gladly cooperate with your new project, to ensure compatibility or import/export options to your new format of a project.

If, however, you would like the Gramps project to adopt your strategy, you would need to convince Gramps developers that your strategy is good for Gramps and superior to the present development strategy.

Adding to and editing my database

What is the difference between a residence and an address?

A residence is a place where someone lived for a period of time. An address is the name of a residence formatted in the way expected by the postal system. Therefore each residence can also have an address if that is useful. See also: Why residence event and not Address?

How do I change the order of children?

Children can be moved in the Family Editor's Children tab by dragging and dropping or using the up and down buttons.

How do I change the order of spouses?

Spouses can be reordered from the Relationships Category by selecting the Reorder button in the toolbar.

How do I add an additional spouse?

See Add a spouse

How do I remove a spouse?

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


How do you add photos to an item?

See Adding photos and other media objects.

How do you find unused media?

Media that have not been associated with any objects may be found by creating a Custom Filter in the Media Category view. Use the Media objects with a reference count of <count> rule to find media with fewer than 1 reference.

How can I publish a genealogy web site with Gramps?

Gramps has multiple options in the Reports menu for creating Web Pages based on your Tree data.

The Howto: Make a genealogy website with Gramps tutorial describes using the Narrated Web Site (a.k.a. NarrativeWeb) report. In it, you will learn to generate a website around a set of people in your Family Tree.

Once generated, you can upload the web files to a hosting service. You can also distribute them on a portable thumbdrive or other media.

You can also install third party addon reports to create other styles of web content. See the Addons List.

Previous Index Next
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