diff --git a/gramps2/doc/gramps-manual/C/Makefile.in b/gramps2/doc/gramps-manual/C/Makefile.in index 537aa4b95..fd2d56cf8 100644 --- a/gramps2/doc/gramps-manual/C/Makefile.in +++ b/gramps2/doc/gramps-manual/C/Makefile.in @@ -14,39 +14,67 @@ @SET_MAKE@ -# To use this template: -# 1) Define: figs, docname, lang, omffile, sgml_ents although figs, -# omffile, and sgml_ents may be empty in your Makefile.am which -# will "include" this one -# 2) Figures must go under figures/ and be in PNG format -# 3) You should only have one document per directory # -# Note that this makefile forces the directory name under -# $prefix/share/gnome/help/ to be the same as the SGML filename -# of the document. This is required by GNOME. eg: -# $prefix/share/gnome/help/fish_applet/C/fish_applet.sgml -# ^^^^^^^^^^^ ^^^^^^^^^^^ -# Definitions: -# figs A list of screenshots which will be included in EXTRA_DIST -# Note that these should reside in figures/ and should be .png -# files, or you will have to make modifications below. -# docname This is the name of the SGML file: .sgml -# lang This is the document locale -# omffile This is the name of the OMF file. Convention is to name -# it -.omf. -# sgml_ents This is a list of SGML entities which must be installed -# with the main SGML file and included in EXTRA_DIST. -# eg: -# figs = \ -# figures/fig1.png \ -# figures/fig2.png +# No modifications of this Makefile should be necessary. +# +# To use this template: +# 1) Define: figdir, docname, lang, omffile, and entities in +# your Makefile.am file for each document directory, +# although figdir, omffile, and entities may be empty +# 2) Make sure the Makefile in (1) also includes +# "include $(top_srcdir)/doc/xmldocs.make" and +# "dist-hook: app-dist-hook". +# 3) Optionally define 'entities' to hold xml entities which +# you would also like installed +# 4) Figures must go under $(figdir)/ and be in PNG format +# 5) You should only have one document per directory +# 6) Note that the figure directory, $(figdir)/, should not have its +# own Makefile since this Makefile installs those figures. +# +# example Makefile.am: +# figdir = figures # docname = scrollkeeper-manual # lang = C # omffile=scrollkeeper-manual-C.omf -# sgml_ents = fdl.sgml -# include $(top_srcdir)/help/sgmldocs.make +# entities = fdl.xml +# include $(top_srcdir)/help/xmldocs.make # dist-hook: app-dist-hook # +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# + +# +# No modifications of this Makefile should be necessary. +# +# This file contains the build instructions for installing OMF files. It is +# generally called from the makefiles for particular formats of documentation. +# +# Note that you must configure your package with --localstatedir=/var/lib +# so that the scrollkeeper-update command below will update the database +# in the standard scrollkeeper directory. +# +# If it is impossible to configure with --localstatedir=/var/lib, then +# modify the definition of scrollkeeper_localstate_dir so that +# it points to the correct location. Note that you must still use +# $(localstatedir) in this or when people build RPMs it will update +# the real database on their system instead of the one under RPM_BUILD_ROOT. +# +# Note: This make file is not incorporated into xmldocs.make because, in +# general, there will be other documents install besides XML documents +# and the makefiles for these formats should also include this file. +# +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# SHELL = @SHELL@ srcdir = @srcdir@ @@ -102,16 +130,13 @@ AWK = @AWK@ BINSH = @BINSH@ CC = @CC@ DEPDIR = @DEPDIR@ -DISABLE_SCROLLKEEPER = @DISABLE_SCROLLKEEPER@ GNOMEHELP = @GNOMEHELP@ GNOMEINC = @GNOMEINC@ GNOMELIB = @GNOMELIB@ GPREF = @GPREF@ -HAVE_JW = @HAVE_JW@ HAVE_PKG_CONFIG = @HAVE_PKG_CONFIG@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ INTLLIBS = @INTLLIBS@ -JW = @JW@ LANGUAGES = @LANGUAGES@ LIBS = @LIBS@ MOFILES = @MOFILES@ @@ -129,7 +154,8 @@ PYTHON_PLATFORM = @PYTHON_PLATFORM@ PYTHON_PREFIX = @PYTHON_PREFIX@ PYTHON_VERSION = @PYTHON_VERSION@ RELEASE = @RELEASE@ -SCROLLKEEPER_REQUIRED = @SCROLLKEEPER_REQUIRED@ +SCROLLKEEPER_BUILD_REQUIRED = @SCROLLKEEPER_BUILD_REQUIRED@ +SK_CONFIG = @SK_CONFIG@ STRIP = @STRIP@ SWIG = @SWIG@ VERSION = @VERSION@ @@ -142,106 +168,40 @@ pkgpyexecdir = @pkgpyexecdir@ pkgpythondir = @pkgpythondir@ pyexecdir = @pyexecdir@ pythondir = @pythondir@ -SGML_FILES = gramps-manual.sgml - -figs = \ - figures/addmedia.png \ - figures/druidpg1.png \ - figures/editbookmarks.png \ - figures/ep-address.png \ - figures/ep-altname.png \ - figures/ep-attributes.png \ - figures/ep-event.png \ - figures/ep-gallery.png \ - figures/ep-general.png \ - figures/ep-internet.png \ - figures/ep-lds.png \ - figures/ep-notes.png \ - figures/familyview.png \ - figures/filter.png \ - figures/globalmedia.png \ - figures/gotobookmark.png \ - figures/localmedia.png \ - figures/mainwin.png \ - figures/mediaview.png \ - figures/opendb.png \ - figures/pedegreesel.png \ - figures/pedegreeview.png \ - figures/peoplelist.png \ - figures/placelist.png \ - figures/prefs-bars.png \ - figures/prefs-colors.png \ - figures/prefs-dates.png \ - figures/prefs-disp.png \ - figures/prefs-find.png \ - figures/prefs-gen.png \ - figures/prefs-guess.png \ - figures/prefs-ids.png \ - figures/prefs-main.png \ - figures/prefs-media.png \ - figures/prefs-report.png \ - figures/prefs-research.png \ - figures/prefs-revision.png \ - figures/reportsel.png \ - figures/revcontrol.png \ - figures/savecomment.png \ - figures/sourcelist.png \ - figures/sourcerefsel.png \ - figures/toolsel.png - - +figdir = figures docname = gramps-manual lang = C omffile = gramps-manual-C.omf -sgml_ents = +entities = legal.xml -docdir = $(datadir)/gnome/help/$(docname)/$(lang) - -doc_DATA = index.html - -sgml_files = $(sgml_ents) $(docname).sgml +# ************* Begin of section some packagers may need to modify ************** +# This variable (docdir) specifies where the documents should be installed. +# This default value should work for most packages. +docdir = $(datadir)/@PACKAGE@/doc/$(docname)/$(lang) +# ************** You should not have to edit below this line ******************* +xml_files = $(entities) $(docname).xml omf_dir = $(top_srcdir)/omf-install -EXTRA_DIST = $(sgml_files) $(doc_DATA) $(omffile) $(figs) - +EXTRA_DIST = $(xml_files) $(omffile) CLEANFILES = omf_timestamp -# when doing a distclean, we also want to clear out html files: -CONFIG_CLEAN_FILES = index.html $(docname)/*.html $(docname)/stylesheet-images/*.gif +omf_dest_dir = $(datadir)/omf/@PACKAGE@ +scrollkeeper_localstate_dir = $(localstatedir)/scrollkeeper subdir = doc/gramps-manual/C mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_CLEAN_FILES = DIST_SOURCES = -DATA = $(doc_DATA) - DIST_COMMON = Makefile.am Makefile.in all: all-am .SUFFIXES: -$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/doc/sgmldocs.make $(top_srcdir)/configure.in $(ACLOCAL_M4) +$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/doc/xmldocs.make $(top_srcdir)/doc/omf.make $(top_srcdir)/configure.in $(ACLOCAL_M4) cd $(top_srcdir) && \ $(AUTOMAKE) --gnu doc/gramps-manual/C/Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe) uninstall-info-am: -docDATA_INSTALL = $(INSTALL_DATA) -install-docDATA: $(doc_DATA) - @$(NORMAL_INSTALL) - $(mkinstalldirs) $(DESTDIR)$(docdir) - @list='$(doc_DATA)'; for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f="`echo $$p | sed -e 's|^.*/||'`"; \ - echo " $(docDATA_INSTALL) $$d$$p $(DESTDIR)$(docdir)/$$f"; \ - $(docDATA_INSTALL) $$d$$p $(DESTDIR)$(docdir)/$$f; \ - done - -uninstall-docDATA: - @$(NORMAL_UNINSTALL) - @list='$(doc_DATA)'; for p in $$list; do \ - f="`echo $$p | sed -e 's|^.*/||'`"; \ - echo " rm -f $(DESTDIR)$(docdir)/$$f"; \ - rm -f $(DESTDIR)$(docdir)/$$f; \ - done tags: TAGS TAGS: @@ -251,7 +211,6 @@ top_distdir = ../../.. distdir = $(top_distdir)/$(PACKAGE)-$(VERSION) distdir: $(DISTFILES) - $(mkinstalldirs) $(distdir)/figures @list='$(DISTFILES)'; for file in $$list; do \ if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ @@ -277,10 +236,9 @@ distdir: $(DISTFILES) dist-hook check-am: all-am check: check-am -all-am: Makefile $(DATA) +all-am: Makefile installdirs: - $(mkinstalldirs) $(DESTDIR)$(docdir) install: install-am install-exec: install-exec-am @@ -323,7 +281,9 @@ info: info-am info-am: -install-data-am: install-docDATA +install-data-am: install-data-local + @$(NORMAL_INSTALL) + $(MAKE) $(AM_MAKEFLAGS) install-data-hook install-exec-am: @@ -341,122 +301,85 @@ mostlyclean: mostlyclean-am mostlyclean-am: mostlyclean-generic -uninstall-am: uninstall-docDATA uninstall-info-am uninstall-local +uninstall-am: uninstall-info-am uninstall-local .PHONY: all all-am check check-am clean clean-generic distclean \ distclean-generic distdir dvi dvi-am info info-am install \ - install-am install-data install-data-am install-docDATA \ + install-am install-data install-data-am install-data-local \ install-exec install-exec-am install-info install-info-am \ install-man install-strip installcheck installcheck-am \ installdirs maintainer-clean maintainer-clean-generic \ mostlyclean mostlyclean-generic uninstall uninstall-am \ - uninstall-docDATA uninstall-info-am uninstall-local + uninstall-info-am uninstall-local -all: index.html omf - omf: omf_timestamp omf_timestamp: $(omffile) -for file in $(omffile); do \ - scrollkeeper-preinstall $(docdir)/$(docname).sgml $$file $(omf_dir)/$$file; \ + scrollkeeper-preinstall $(docdir)/$(docname).xml $(srcdir)/$$file $(srcdir)/$$file.out; \ done touch omf_timestamp -index.html: $(docname)/index.html - -cp $(docname)/index.html . +install-data-hook-omf: + $(mkinstalldirs) $(DESTDIR)$(omf_dest_dir) + for file in $(omffile); do \ + $(INSTALL_DATA) $(srcdir)/$$file.out $(DESTDIR)$(omf_dest_dir)/$$file; \ + done + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) -o $(DESTDIR)$(omf_dest_dir) -# The weird srcdir trick is because the db2html from the Cygnus RPMs -# cannot handle relative filenames. -# The t1 test is for certain versions of jw that create cryptic -# html pages, o fwhich the index is called "t1". Also, the jw -# script from docbook-utils 0.6.9 does not copy the template -# stylesheet-images directory like the db2html script does, so -# we give it a little help (at least for now) +uninstall-local-omf: + -for file in $(srcdir)/*.omf; do \ + basefile=`basename $$file`; \ + rm -f $(omf_dest_dir)/$$basefile; \ + done + -rmdir $(omf_dest_dir) + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) -$(docname)/index.html: $(docname).sgml - -srcdir=`cd $(srcdir) && pwd`; \ - if test "$(HAVE_JW)" = 'yes' ; then \ - if test -f /usr/share/sgml/docbook/dsssl-stylesheets/images/next.gif ; then \ - mkdir -p $$srcdir/$(docname)/stylesheet-images ; \ - cp /usr/share/sgml/docbook/dsssl-stylesheets/images/*.gif $$srcdir/$(docname)/stylesheet-images/ ; \ - fi; \ - jw -c /etc/sgml/catalog $$srcdir/$(docname).sgml -o $$srcdir/$(docname); \ - else \ - db2html $$srcdir/$(docname).sgml; \ - fi - if test -f $(docname)/t1.html; then \ - cd $(srcdir)/$(docname) && cp t1.html index.html; \ - cd $(srcdir); \ - fi +all: omf -$(docname).sgml: $(sgml_ents) - -ourdir=`cd . && pwd`; \ +$(docname).xml: $(entities) + -ourdir=`pwd`; \ cd $(srcdir); \ - cp $(sgml_ents) $$ourdir + cp $(entities) $$ourdir -app-dist-hook: index.html - -$(mkinstalldirs) $(distdir)/$(docname)/stylesheet-images - -$(mkinstalldirs) $(distdir)/figures - -cp $(srcdir)/$(docname)/*.html $(distdir)/$(docname) - -for file in $(srcdir)/$(docname)/*.css; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - cp $$file $(distdir)/$(docname)/$$basefile ; \ - done - -for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - cp $$file $(distdir)/$(docname)/stylesheet-images/$$basefile ; \ - done - -if [ -e topic.dat ]; then \ - cp $(srcdir)/topic.dat $(distdir); \ - fi +app-dist-hook: + if test "$(figdir)"; then \ + $(mkinstalldirs) $(distdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(distdir)/$(figdir)/$$basefile; \ + done \ + fi -install-data-am: index.html omf - -$(mkinstalldirs) $(DESTDIR)$(docdir)/stylesheet-images - -$(mkinstalldirs) $(DESTDIR)$(docdir)/figures - -cp $(srcdir)/$(sgml_files) $(DESTDIR)$(docdir) - -for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$$basefile; \ +install-data-local: omf + $(mkinstalldirs) $(DESTDIR)$(docdir) + for file in $(xml_files); do \ + cp $(srcdir)/$$file $(DESTDIR)$(docdir); \ done - -for file in $(srcdir)/figures/*.png; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/figures/$$basefile; \ - done - -for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/stylesheet-images/$$basefile; \ - done - -if [ -e $(srcdir)/topic.dat ]; then \ - $(INSTALL_DATA) $(srcdir)/topic.dat $(DESTDIR)$(docdir); \ - fi + if test "$(figdir)"; then \ + $(mkinstalldirs) $(DESTDIR)$(docdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$(figdir)/$$basefile; \ + done \ + fi -$(docname).ps: $(srcdir)/$(docname).sgml - -srcdir=`cd $(srcdir) && pwd`; \ - db2ps $$srcdir/$(docname).sgml +install-data-hook: install-data-hook-omf -$(docname).rtf: $(srcdir)/$(docname).sgml - -srcdir=`cd $(srcdir) && pwd`; \ - db2ps $$srcdir/$(docname).sgml +uninstall-local: uninstall-local-doc uninstall-local-omf -uninstall-local: - -for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - rm -f $(docdir)/stylesheet-images/$$basefile; \ - done - -for file in $(srcdir)/figures/*.png; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - rm -f $(docdir)/figures/$$basefile; \ - done - -for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - rm -f $(DESTDIR)$(docdir)/$$basefile; \ - done - -for file in $(sgml_files); do \ +uninstall-local-doc: + -if test "$(figdir)"; then \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + rm -f $(docdir)/$(figdir)/$$basefile; \ + done; \ + rmdir $(DESTDIR)$(docdir)/$(figdir); \ + fi + -for file in $(xml_files); do \ rm -f $(DESTDIR)$(docdir)/$$file; \ done - -rmdir $(DESTDIR)$(docdir)/stylesheet-images - -rmdir $(DESTDIR)$(docdir)/figures -rmdir $(DESTDIR)$(docdir) dist-hook: app-dist-hook # Tell versions [3.59,3.63) of GNU make to not export all variables. diff --git a/gramps2/doc/gramps-manual/C/gramps-manual.sgml b/gramps2/doc/gramps-manual/C/gramps-manual.sgml deleted file mode 100644 index 61993dd57..000000000 --- a/gramps2/doc/gramps-manual/C/gramps-manual.sgml +++ /dev/null @@ -1,1863 +0,0 @@ - -]> - - - -
- - - GRAMPS User Manual - - 2001 - Donald N. Allingham - - - - - - - - - - - Permission is granted to copy, distribute and/or modify this document - under the terms of the GNU Free Documentation - License, Version 1.1 or any later version - published by the Free Software Foundation with no Invariant Sections, - no Front-Cover Texts, and no Back-Cover Texts. A copy of the license - can be found here. - - - Many of the names used by companies to distinguish their products and - services are claimed as trademarks. Where those names appear in any - GNOME documentation, and those trademarks are made aware to the members - of the GNOME Documentation Project, the names have been printed in caps - or initial caps. - - - - - - - - - - - - - - - - - - - - This is version 1.1 of the GRAMPS manual. - - - - - - - - - Introduction - - GRAMPS is an acronym for the - Genealogical Research and Analysis Management Programming System. - It was conceived under the concept that most genealogy programs - were designed to provide the researcher the capability to input - information related to a particular family tree. Most of these - programs have allowed for the arranging and storing of information - consistent with the GEDCOM standards. They usually provide a - means for displaying descendant or ancestral relationships by - means of graphical displays, charts, or reports. These may be - augmented with pictures or other media to enhance the data. Most - provide for inputting data on unconnected individuals/families - that may or may not have a relationship to the primary surname - being researched. Various other enhancements may also be provided - in the genealogical program that allows for different degrees of - importing and exporting data from other programs and printing of - the data contained in the various reports. GRAMPS, on the other - hand, attempts to provide all of the common capabilities of these - programs, but, more importantly, to provide a capability not - common to these programs. This is the ability to input any bits - and pieces of information directly into GRAMPS and - rearrange/manipulate any/all data events in the entire data base - (in any order or sequence) to assist the user in doing research, - analysis and correlation with the potential of filling - relationship gaps. In short, a tool that provides a way to input - all your research into one place and do your analysis and - correlation using the speed, power, and accuracy of your computer - instead of pencils and unmanageable reams of paper. - - - To run GRAMPS, select - - Programs - Applications - gramps - - from the Main Menu, or type - gramps on the command line. - - - This document describes version &version; of - GRAMPS. - - - - - - - - Running GRAMPS for the first time. - - The first time you run the program, - GRAMPS will display its Getting Started - screens. - -
- Getting Started screen, page 1 - - Getting Started screen, page 1 - - - -
- - GRAMPS will guide you through a few pages - that prompt you for some setup information. The information it requests - includes information about yourself and your preferences. - - - Although GRAMPS requests information about - your, this information is used only so that it can create valid GEDCOM - output files. A valid GEDCOM file requires information about the file"s - creator. If you chose, you may leave the information empty. - - - - - Getting Started - - Starting GRAMPS opens the - Main window, shown in . You will be prompted to either open an - existing database, or to create a new - database. GRAMPS requires that a - database always be open. - -
- GRAMPS Main Window - - GRAMPS Main Window - - - -
- - Importing data - - If you already have a family file created using another - genealogy program you can import your GEDCOM file into GRAMPS. - To do this you select File - Import Import from - GEDCOM . The GEDCOM - Import box will open. Select New - Database and click the - Browse... button to select your saved - GEDCOM file (filename.ged). Click - OK to select the file and then click - OK to import the file. The - GEDCOM Import Status will tell you what - the importer is doing and a little bit about your file (file - location, which program created it, the version, Encoding, - Number of Families, Number of People, and the Number of Errors). - Once the Importer is done, you can click - Close and start editing/adding to your - file. - - - - Entering Data - - If you have never used a genealogy program or you do not have a - GEDCOM file to import, you can start creating your database - right away. From the main window click the Add - Person button and the Edit - Person dialog will open. Enter in the information - you have on the first person. Start with their general - information (Name, Birth and Death Date/Place) and then move on - to the Names, - Events, - Attributes, - Addresses, Notes, - Gallery, and - Internet tabs and fill in the known - information you have. Some of the information you enter has a - Source button and/or a - Note button. These buttons are there to - add more information (Source button to - add the source of where you acquired the information and the - Note button to add more detail to the - information) - - - - - - - - People View - - The People View window is the initial view seen on the main - window. It displays the name, gender, birth date, and death - date of all individuals in the database. At any time, you can - return to this view either by pressing the - People button at the top of the screen, or - by choosing the - - View - People - - entry from the menus. - -
- People View - - People View - - - -
- - Selecting and Editing Individuals - - The People View lists the individuals in the database. An - individual can be selected as the active person by clicking on - an entry in the list. Once a person has been selected as the - active person, the person's name appears in the status bar in - the lower left hand corner of the window. - - - Once the active person has been selected, pressing the - Edit Person button will display the - Edit Person dialog allowing you to edit - the individual's personal information. If the Edit - Person button is pressed without an active person - being set, a blank Edit Person dialog is - presented, allowing you to enter a new person. - - - Double-clicking on a entry in the list will set the active - person and bring up the individual in the Edit - Person dialog. - - - Pressing the Add Person button will - display a blank Edit Person dialog, - allowing you to add a new person to the database. - - - If the Delete Person button is pressed, - the active person and all of the personal information related to - the active person are removed from the database. - - - - Applying Filters - - GRAMPS allows you to apply filters to - the People View. When a filter is applied, the People View will - only display the entries matching the filter. All of the entries - remain in the database, but some entries may be temporarily hidden. - - - There are up to three parts to a filter. The first part is the - selection of the filter to be applied. A filter is selected from - the option menu directly above the People View. The second part - is an optional argument. This qualifier provides more specific - information for the filter. Many filters do not require the - argument, and it will not be displayed if it is not needed. If - the argument is required, a text box with a descriptive label - will appear. The third part of the filter is the invert - selection. When this option is selected, - GRAMPS will display the entries that - do not match the filter. - -
- Filter that requires an argument - - Filter that requires an argument - - - -
- - A filter is not applied until the Apply - button is pressed. The filter will remain in effect until the - next time the Apply button is pressed. - - - - Sorting - - Four columns are shown in the People View display. The entries - in the list can be sorted by three of the fields: Name, Birth - Date, or Death Date. Clicking on the column label will cause - the list to be re-sorted by that column. Arrows on the label - indicate whether the list is sorted by ascending or descending - order. - - - If the list is already sorted by a particular column, clicking - on the same column label will switch the sorting order. For - example, if the list is currently sorted in ascending order by - Name, clicking on the Name column header will re-sort the list - in descending order. - - - - - Editing a person's data - - A person's personal information can be edited in the - Edit Person dialog. - - - General Information Tab -
- General Information Tab - - General Information Tab - - - -
- - The General Information tab contains the basic information about - the person. This includes the person's name, gender, birth - information, and death information. - - - If images have been associated with the person, the primary - image is displayed on the right side of the window. - - - - Alternate Names Tab -
- Alternate Names Tab - - Alternate Names Tab - - - -
- - It is possible for people to use more than one name during their - lifetime. These may be legal name changes, or just informal - names. An example would be a person changing his or her name due - to marriage or adoption. GRAMPS - allows multiple alternate names to be specified for each person. - - - The Alternate Names tab allows additional - names to be added or removed from list. Clicking the - Add button allows a new name to be added - to the list. The Edit/View allows the - selected alternate name to be edited. The - Delete button removes the selected name. - - - - Events Tab - - The Events tab allows information about - various events in a person's life to be - recorded. GRAMPS provides a list of - common events, but allows you to name an event anything that you - choose. - - - An event consists of the name of an event (such as "Baptism" or - "Education"), a date or date range on which the event occurred, - the place where the event occurred, and a description of the - event. A note or a source may also be attached to the event. - -
- Events Tab - - Events Tab - - - -
- - The Event tab displays information about - the currently selected event at the top of the window. Below - this information is a list of the events that have been - previously entered. Clicking on one of the events in the list - selects the event, and displays its information at the top of - the window. - - - An event may be added by clicking the Add - button. This displays a form that allows you to enter the - information about the particular event. The - Edit/View button allows to view or to - alter the information of the currently displayed event. The - Delete button allows you to delete the - currently displayed event. - - - - Attributes Tab - - Attributes are similar to events, but are for information items - that do not necessarily have the concept of a place or a - date. An example would be a person's Social Security Number or - national origin. Attributes consist of an attribute name and its - value. - - - Like events, attributes may also have a note, source, privacy - marker, and confidence level associated with them. - -
- Attributes Tab - - Attributes Tab - - - -
- - The Attribute tab displays information - about the currently selected attribute at the top of the - window. Below this information is a list of the attributes that - have been previously entered. Clicking on one of the attributes - in the list selects the attribute, and displays its information at - the top of the window. - - - An attribute may be added by clicking the - Add button. This displays a form that - allows you to enter the information about the particular - attribute. The Edit/View button allows to - view or to alter the information of the currently displayed - attribute. The Delete button allows you to - delete the currently displayed attribute. - - - - Addresses Tab - - Addresses are used to record information about where a person - has lived. Addresses are different from - GRAMPS' concept of a place. An - address, as GRAMPS sees, it consists - of an equivalent of a mailing address and the date or date range - when the person lived at the address. - - - Like events and attributes, addresses may also have a note, - source, privacy marker, and confidence level associated with - them. - -
- Addresses Tab - - Addresses Tab - - - -
- - The Address tab displays information - about the currently selected address at the top of the - window. Below this information is a list of the addresses that - have been previously entered. Clicking on one of the addresses - in the list selects the address, and displays its information at - the top of the window. - - - An address may be added by clicking the - Add button. This displays a form that - allows you to enter the information about the particular - address. The Edit/View button allows to - view or to alter the information of the currently displayed - address. The Delete button allows you to - delete the currently displayed address. - - - - Notes Tab - - In addition to the notes that may be attached to any particular - event, attribute, or address, GRAMPS - has a generic note attached to the person. - -
- Notes Tab - - Notes Tab - - - -
- - The note window is a free-form edit window, allowing you to - enter any information that you want. - - - - Gallery Tab - - The Gallery tab allows you to associate - files (known in GRAMPS as media - objects) with a particular person. These files are typically - images or photographs, but may be of any file type, such as (but - not limited to) sound files and word processing documents. - - - - GRAMPS provides a central repository - for all media objects in the Media View. This allows the same - media object to appear in multiple galleries. Adding a media - object to a gallery actually adds the object to the Media View, - and makes a local reference in the gallery. - - - While each media object can have a note and attributes attached - to it, each gallery can add its own notes and attributes to the - reference in its gallery. This allows media objects to have - global and local properties. For example, a photo of a family - reunion may have many people in it. A global note may describe - the picture in general, identifying the place and date. When - this object is added to a gallery, you can attach a note to the - reference in the gallery adding some specific information, such - as "Aunt Martha is the third person from the right in the - second row". Clicking the Edit - Properties allows you to edit the local properties. - -
- Local Media Properties - - Local Media Properties - - - -
- - The first object in the gallery is considered to be the primary - image. If this object is an image, it will appear on the - General Information tab, and will be the - primary image used by report generators. An image can be made - the default at any time by selecting the thumbnail image and - dragging it to the first position in the gallery. In this same - manner, the order of the images can be changed using the same - drag and drop technique. - - - Objects may be added to the gallery in several ways. By clicking - the Add Media Object button, a dialog box - is presented which allows you to choose an object from the file - system. This method adds a new object to the Media View and - creates a reference in the gallery. Objects may also be added - by either dragging and dropping from one gallery to another, or - by dragging from the Media View to a gallery. In this case, a - new media object is not created, but a reference to an existing - media object is made in the gallery, sharing the same media - object between galleries. Finally, new objects may be added to a - gallery and the Media View by dragging and dropping from a file - manager (such as Nautilus or - Konqueror) or a web browser (such as - Galeon, - Mozilla, or - Konqueror) into a gallery. - - - Media objects can be removed from a gallery by clicking the - Delete Media Object button. This action - only removes the reference to the current gallery. It does not - remove the media object from the Media View or from any other - galleries that are referencing it. - - - Right clicking on a selected object brings up a menu. - - Menu options - - View in default viewer - - - Allows you to view an object image using GNOME's default - viewer for the file type. - - - - - Edit with the GIMP - - - Launches the gimp program, - allowing you to edit the image. This option only shows up - if the media object is an image. - - - - - Edit Object Properties - - - Allows you to change the attributes and note attached to the - media object. - - - - - Convert to local copy - - - This option is only displayed if the media is a reference - to a file that is not controlled by - GRAMPS. Selecting the option - causes GRAMPS to make its own - copy of the media object. - - - - - - - Internet Tab - - Frequently, information about a person is available on the - internet, frequently on someone else's web site. With multiple - people researching the same family, it is desirable to keep track - of internet sites that contain information about someone in your - database. This allows you to keep track of the web sites you - can periodically check them for any addition information. - -
- Internet Tab - - Internet Tab - - - -
- - The Internet tab displays information about - the currently selected internet address at the top of the window. Below - this information is a list of the internet address that have been - previously entered. Clicking on one of the events in the list - selects the event, and displays its information at the top of - the window. - - - Clicking on the internet address displayed at the top part of - the window will cause GRAMPS to attempt - to display the site using the GNOME default browser. - - - An internet address may be added by clicking on the - Add button. This displays a form that - allows you to enter the information about the internet - address. This information consists of the web address (URL) and - a description of the location. The - Edit/View button allows to view or alter - the information of the currently displayed internet address. The - Delete button allows you to delete the - currently displayed internet address. - - - - LDS Tab - - If you have chosen to enable support for the LDS (Latter Day Saints) - ordinances, the LDS tab is visible, and can - be selected. This tab allows you to enter specific information used - by the Church of Jesus Christ of Latter Day Saints. - -
- LDS Tab - - LDS Tab - - - -
- - - - Family View - - The Family View window displays the spouses, parents, and children - of the active person. At any time, you can return to this view - either by pressing the Family button at the - top of the screen, or by choosing the - - View - Family View - - entry from the menus. - -
- Family View - - Family View - - - -
- - In the Family View, the family information related to the active - person is displayed. This information falls into two categories: - families in which the person is a child, and families in which the - person is a spouse or parent. - - - Relationships to Parents - - On the right hand side of the window displays the parents of the - active person. By default, a birth relationship is - assumed. GRAMPS supports multiple - family relationships for each person. For example, a person may - have natural birth parents and adopted parents. In this case, an - option menu will appear below the parents names, allowing you to - choose which set of parents you wish to view. - - - Pressing the Add/Edit Parents - allows you to choose the active person's parents and specify the - person's relationship to the parents. - - - Pressing the Delete Parents does not - remove the parents from the database, but instead deletes the - relationship between the active person and the currently displayed - parents. - - - To right of the names of the parents are two "arrow" - buttons. Selecting the button next to the father changes the - father to the active person, and displays the fathers - information in the Family View window. Similarly, selecting the - button next to the mother changes the mother to the active - person. - - - To the left of the parents' names are buttons indicating the - relationship to the active person. These are typically labeled - "Father" and "Mother", but in some cases may simply be labeled - "Parent". Pressing one of these buttons will display the - Edit Person for the corresponding person. - - - - Marriage/Relationship Information - - On the left side of the window, below the active person's name, - is the information related to the person's marriages and - relationships. If the person has one or no relationships, the - spouse will appear within a non-editable text box. If more than - one relationship exists, the text box will be replaced with an - option menu that allows you to select the relationship to view. - - - Between the active person and the relationship information is a - button with two arrows. Pressing this button will exchange the - active person and spouse on the display. The currently displayed - spouse will become the active person, and the family information - on the right hand side of the screen will change to reflect - this. - - - Pressing the Spouse next to the spouse's - name will display the currently displayed spouse's information - in an Edit Person dialog, allowing you - change the information - - - Pressing the Add located below the entry - for the spouse's name allows a new relationship to be - added. This gives you the opportunity to select and existing - person or to add a new person as the new spouse. The type of - relationship can also be specified. All relationship types, - except "Partners" require that the spouses be of opposite - sex. The "Partners" relationship type requires that the spouses - be of the same sex. - - - Pressing the Edit button allows you to - edit the information related to the marriage. The information - includes events, attributes, and images. - - - The Remove button removes the current - spouse from the relationship. If no children exist in the - relationship, the entire relationship is removed. If children - exist in the relationship, the current spouse is removed, - and the children remain in a family with the active person as the - only parent. - - - - Children of a Relationship - - The bottom of the window contains the list of children related - to the active person and the currently selected spouse. Clicking - on an entry in the list makes that child the active child. - - - Clicking the Add New Child creates a new - child and adds him or her as a child of the current - relationship. Clicking the Add Existing - Child allows you to select an existing person and - assign the person as a child of the current - relationship. Clicking the Remove Child - removes the active child from the current relationship, but does - not delete the person from the database. - - - Double clicking on an entry in the list brings up the - Edit Person dialog for the child. - - - You are able to make the selected child the active person by - clicking the arrow button next to the child list. The - highlighted child in the child list becomes the active person. - - - - - Pedigree View - - The Pedigree View window displays the active person, the active - person's parents, and the active parent's grandparents in a - somewhat graphical manner. At any time, you can return to this - view either by pressing the Pedigree button at the top of the - screen, or by choosing the - - View - Pedigree - - entry from the menus. - -
- Pedigree View - - Pedigree View - - - -
- - Moving the mouse over a displayed name will display additional - information about a person, including their date of birth and date - of death. Double-clicking the box will display the Edit - Person dialog box for the person. Holding down the - Shift key while double clicking will will make that person the - active person. - - - Navigation around the tree can be accomplished several - ways. Clicking on the arrow next to the active person will display - a menu listing the children of the active person. Selecting a - person from this list will change the active person to the - selected child, effectively shifting the pedigree view to the - left, or down one generation. Clicking one of the arrow buttons on - the left side of the screen will make the select either the active - person's father (top button) or mother (bottom button), - effectively shifting the pedigree view to the right, or up one - generation. If the active person does not have any children, then - the button on the left-hand side of the screen will not - appear. Similarly, if the active person does have a father or - mother, the corresponding button on the right-hand side of the - screen will not appear. - - - - As a quick short cut, double clicking on a line between two people - will make the person on the right-hand side of the line the active - person. shows navigation using this - method. When the mouse is over one of the lines connecting - individuals, the line widens and becomes highlighted. In this - case, double clicking on the line would make Hjalmar Smith the - active person. - - - - - Source View - - The Source View window displays the different sources that have - been entered into the database. At any time, you can return to - this view either by pressing the Sources - button at the top of the screen, or by choosing the - - View - Sources - - entry from the menus. - -
- Source list - - Source View - - - -
- - From this screen you are able to Add and Edit sources. Currently, - deleting of sources is not available. This will be implemented in - a future version. - - - - - Place View - - The Place View window displays the different sources that have - been entered into the database. At any time, you can return to - this view either by pressing the Places - button at the top of the screen, or by choosing the - - View - Places - - entry from the menus. - -
- Place View - - Place View - - - -
- - From this screen you are able to Add, Edit, and Delete places. - - - - - Media View - - The Media View window displays the files associated with the - database. Typically, these files are images, but - GRAMPS allows you to attach any type of - file to the database. GRAMPS refers to - attached files as media objects. You can access the Media View at - any time by either pressing the Media - button at the top of the screen, or by choosing the - - View - Media - - entry from the menus. - -
- Media View - - Media View - - - -
- - Media Objects - - Media objects can be either local or external to a - GRAMPS database. If - GRAMPS is told to import an object as - a local object, it will make its own copy of the file in the - database directory. If the object is not imported as a local - object, the original file is used. - - - There are advantages and disadvantages to both methods. If the - object is local, then if the original file is moved or deleted, - then GRAMPS will still have its own - copy. However, this is at the price of having two copies of the - file. If the file is not imported as a local object, then a copy - is not made, saving disk space. However, altering or deleting - the original copy will affect the - GRAMPS database. - - - - Adding a Media Object - - Media objects can be imported in several ways. Adding an object - to any gallery adds the object to the Media View. The gallery is - will actually contain a reference to the object in the Media - View. - - - Objects may also be added using the Add Media - Object button. This will add the object to the Media - View, but not to any gallery. When you select the file to be - added, a preview will be displayed in the preview window. If the - file is an image, the image will be displayed. Otherwise, an - icon representing the file type will be displayed. In the dialog - box, you may choose to either import the object as a local - object, or leave it as an external object. -
- Add Media Object Dialog Box - - Add Media Object Dialog Box - - - -
- - - Finally, you may drag-and-drop an object from either a file - manager or a web browser. If the object is dropped into a - gallery, then a reference is made in the gallery, and the object - appears in the Media View. If the object is dropped directly - into the Media View, then it appears in the Media View, but will - not appear in a gallery. Currently, all objects imported via - drag-and-drop are imported as external (not local) objects. - - - - Making a Reference to a Media Object - - Once an object is in the Media View, it is possible to make a - reference to it in any gallery. You may place the object in as - many galleries as you like, and only one copy of the file will - exist. - - - To make a reference to a media object in a gallery, you may - simply drag-and-drop the object from the Media View directly to - a gallery. The object will then appear in the - gallery. Similarly, you may drag-and-drop from one gallery to - another gallery, and a new object reference is created in the - target gallery. - - - - Changing a Media Object's Properties - - Media objects have global and local properties. The title of the - object is a global property. It may only be changed from the - Media View, and it will affect all references. An object also - has a global note and a set of user defined global attributes. - A reference in a gallery may a have a local note and local - attributes as well. All references share the global properties, - but each gallery has its own set of notes a attributes. - - - The global note can be used to provide a general - description. For example, in a family reunion image, you may - wish to use the global note to indicate the place, date, and - occasion of the photograph. In a local note in Aunt Martha's - gallery, you may wish to add a local note indicating that - "Aunt Martha is the third person from the right in the - second row". - - - The global properties may be changed by selecting the - Edit Media Object button. -
- Edit a Media Object's Global Properties - - Edit a Media Object's Global Properties - - - -
- - - - - - Bookmarking People - - GRAMPS supports two mechanisms to - quickly find people - the home person and bookmarks. - - - Home Person - - The home person is the default person of the database. Upon - loading the database, GRAMPS will set - the active person to the default person. At any time, clicking - the Home button will return the active - person to the home person. - - - The home person can be set by choosing - - Settings - Set Default Person - . - - - - Bookmarks - - Bookmarks work similar to bookmarks in HTML browsers. They - allow you to quickly jump to a person, making that person the - active person. This allows you to avoid searching for them - every time you want to add/change something in their information. - -
- Using Bookmarks - - Using Bookmarks - - - -
- - Choosing - - Bookmarks - Add Bookmark - - adds the current active person to the bookmark list. The person - will then appear in the bookmark list, allowing you to quickly - select the person. - - - Choosing - - Bookmarks - Go to Bookmark - - displays a sub-menu which allows you to choose a person who was - previously bookmarked. Selecting a person from this menu will - make that person the active person. - - - Choosing - - Bookmarks - Edit Bookmarks - - displays a dialog box that allows you to reorder or delete - bookmarks in the list. - -
- Editing Bookmarks - - Editing Bookmarks - - - -
- - - - - Using Revision Control - - Revision control allows you to keep a history of the changes that - you have made to your database. Instead of needing to keep - multiple sets of back up files, a single revision control database - is maintained. At any point, you can revert back to a previously - saved version. - - - GRAMPS uses the standard - RCS system to handle revisions. - - - Revision control is enabled in the Revision Control tab of the - preferences dialog. Once enabled, every save is logged into the - revision control database. If you have enabled prompting for a - comment, then a dialog box will be displayed on every save asking - you to provide a comment about the changes you have made. -
- Providing a revision control comment - - Providing a revision control comment - - - -
- - - Reverting to a previous version - - If revision control has been enabled, you have the option of - reverting to a previous version of the database. Selecting the - check box will allow you to select a previous version. -
- Opening a database - - Opening a database - - - -
- - - If the check box has be selected, GRAMPS - will display a dialog box that will allow you to choose which version - you would like to view. The dialog box displays the version number, the - date the version was saved, who saved the database, and any comment supplied - when the database was saved. -
- Choosing a revision - - Choosing a revision - - - -
- - - Choosing a previous revision does not replace your current - database. If you do not save the retrieved database, it will not - replace the current version. If for some reason you accidentally - save the retrieved database when you did not want to replace the - current version, you can always use the revision control - mechanism to get back the version you replaced. - - - Revision control is applied only to the database itself, not to - any media objects have been associated with the database. - - - - - - - - Customization - - To change the application settings, select - - Settings - Preferences... - . This opens the - Preferences dialog, shown in . - - - - Preferences Dialog -
- Preferences Dialog - - Preferences Dialog - - - -
- - GRAMPS groups is options into - categories visible in the left hand side of the - dialog. Selecting one of these entries will display the - corresponding settings in the right hand side of the dialog. - - - - General Database options -
- General Database options - - General Database Options - - - -
- - The General Database page contains basic information to - control the operation of GRAMPS. - - - General Database options - - Automatically load last database - - - With this selected it will automatically load your last - database. - - - - - Do not compress XML data file - - - GRAMPS normally compresses its - data file to conserve disk space. If you do not wish to - have the file compressed, selecting this option will cause - GRAMPS to leave the file - uncompressed. This may be desirable if other applications - need to process the generated XML file. - - - - - Autosave interval (minutes) - - - If this value is set to a non-zero value, GRAMPS - will save an autosave file every few minutes, depending on the - value set. If for some reason the execution of GRAMPS - is interrupted, you can recover to the last autosave point. - - - - - Default database directory - - - This value indicates the default directory for loading and saving - databases. - - - - - - - Dates and Calendars -
- Dates and Calendars - - Dates and Calendars - - - -
- - The Dates and Calendars page allows you to change the - display and entry formats of dates. - - - - - Dates and Calendars options - - Display Formats - - - Allows you to choose your preferences for displaying dates - and names. Options exist for several different date - formats. Names can be displayed with either the given name - or the surname first. This option typically does not - affect lists that are sorted by last name, in which case - the surname is displayed first. - - - - - Entry Formats - - - Numerical date formats can be ambiguous. Some people enter - the day, month, and year (European style), while others - prefer month, day, year (American style). Selecting the - option here informs GRAMPS how - it should interpret numerical dates. - - - - - Calendars - - - GRAMPS can support calendars - other than the typical Gregorian calendar. If enabled, - GRAMPS will display a menu - allowing you to specify the calendar that a date - represents. Calendars currently supported are Gregorian, - Hebrew, Julian, and French Republican. - - - - - - - Media Options -
- Media Options - - Media Options - - - -
- - - GRAMPS ID Options -
- GRAMPS ID Options - - GRAMPS ID Options - - - -
- - - Revision Control Options -
- Revision Control Options - - Revision Control Options - - - -
- - - General Display Options -
- General Display Options - - General Display Options - - - -
- - - Tool and Status Bar Options -
- Tool and Status Bar Options - - Tools and Status Bar Options - - - -
- - - List Color Options -
- List Color Options - - List Color Options - - - -
- - - Find Options -
- Find Options - - Find Options - - - -
- - - Report Options -
- Report Options - - Report Options - - - -
- - Many of the reports that GRAMPS - produces can be generated in different file formats and - different paper sizes. Selecting a Preferred Output - Format and a Preferred Output - Format tells the report generator your - preferences. It should be noted that a report generator might - not support all possible formats. - - - - Researcher Information -
- Researcher Information - - Researcher Information - - - -
- - This is where you are able to change the information you entered - when you started GRAMPS for the first time and was asked to - enter in some information. (This information shows up in your - GEDCOM files as being the researcher/author of the file) - - - - Data Guessing Options -
- Data Guessing Options - - Data Guessing Options - - - -
- - - - - - - - - Generating Reports - - GRAMPS can produce a wide variety of - reports. A new report generator can be written by the user without - modifying the main program. For this reason, there may be more - reports available than are documented by this manual. - -
- Report Generation Dialog - - Report Generation Dialog - - - -
- - Unlike many genealogy programs, GRAMPS - does not directly print reports. Instead, - GRAMPS produces reports in formats that - are understood by other programs. These formats include - OpenOffice, AbiWord, PDF, and HTML, among others. This allows the - generated reports to be modified after they are generated, stored - for use at a later time, or e-mailed to another person. - - - After selecting the report you would like generated there are - options you must select. In the Save As option specify your file - name (use /full path/filename to specify a different directory - than in your Default Report Directory preference in the - preferences). The next step is to select the Report Format. - After choosing the Format you can select the style you would like - to use for your report (this does not apply to the HTML format). - You can Add/Edit/Delete a style for that particular report by - clicking the Style Editor button. - Selecting one of those options you can then change the font (font - face, size, color, and options) for each Paragraph Style along - with the Paragraph Options (Alignment, background color, margins, - and borders). Once you are satisfied with the style you are ready - to proceed with the generation of your report. The next step is - to choose the options (if any for that specific report) and then - Choose the Template (for HTML format only) and click OK. Your - report will now be in default report directory (unless otherwise - specified). - - - Using HTML templates - - Many programs exist to convert GEDCOM files into HTML files that - can be viewed in a web browser. Most of these programs generate - HTML files according to their own predefined style. Since most - people have a style that they prefer, they are left with the - option of modifying hundreds of files by hand. - - - To solve this problem, GRAMPS allows - the user to specify a template to be used for generating HTML - files. At the time the report is generated, if HTML is selected - as the target format, the user can select an HTML template to be - used. Since the template is chosen at report generation time, a - different template may be chosen each time, allowing the user to - change the appearance of the generated files at any time. - Nearly any existing HTML file can be used as an HTML template - for GRAMPS. - - - When a file has been established as the HTML template file, - GRAMPS uses the template for each - file that it generates. GRAMPS starts - each file by copying data from the template until it reaches the - HTML comment, which it uses as a marker. At that point, - GRAMPS inserts its data into the - output file. GRAMPS the continues - reading the until it reaches a second comment that tells it to - resume copying from the template. - - - GRAMPS uses the string - <!-- START --> to indicate where it - should start inserting its information, and the string - <!-- STOP --> to indicate where it - should resume copying data from the template. The effect is - that GRAMPS will create a new - document, replacing everything between the <!-- - START --> and <!-- STOP - --> comments with the report information. - - - The comment markers should be at the beginning of a line in the - HTML template file. Adding the comments to an existing HTML - document will not affect the original HTML document in any way. - - - If no HTML template is specified, or if the specified template - cannot be read, GRAMPS will use a - default, predefined template. - -
- Sample HTML Template Example - -<HTML> -<HEAD> -<TITLE> -This is my Title -</TITLE> -</HEAD> -<BODY BGCOLOR="#FFFFFF"> -<P> -This is a simple template. This text will appear in the HTML output. -</P> -<!-- START --> -<P> -This is where GRAMPS will place its report information. Any -information between the two comments, including this paragraph, -will not appear in the GRAMPS generated output. -</P> -<!-- STOP --> -<P> -This text, since it appears after the stop comment, will also -appear in every GRAMPS generated file. -</P> -</BODY> -</HTML> - -
- - - - - - - Running Tools - - GRAMPS supports standard and user - written tools. These tools can operate on the database to perform - a specified task. - -
- Tool Selection Dialog - - Tool Selection Dialog - - - -
- - Analysis and Exploration - - Compare individual events - - - Aids in the analysis of data by allowing the development of - custom filters that can be applied to the database to find - similar events. - - - - - Interactive descendant browser - - - Provides a browsable hierarchy based on the active person. - - - - - - Data Processing - - Check and repair database - - - Checks the database for integrity problems, fixing the - problems that it can. - - - - - Extract information from names - - - Searches the entire database and attempts to extract titles - and nicknames that may be embedded in a person's given name - field. - - - - - Merge people - - - Searches the entire database, looking for individual entries - that may represent the same person. - - - - - Rename personal event types - - - Allows all the events of a certain name to be renamed to a - new name. - - - - - Reorder GRAMPS ID's - - - Reorders the GRAMPS ID's according to GRAMPS' default rules. - - - - - - Utilities - - Generate SoundEx codes - - - Generates SoundEx codes for names. - - - - - Relationship calculator - - - Calculates the relationship between two people. - - - - - - - - - - - - Authors - - GRAMPS was written by Don Allingham - (dallingham@users.sourceforge.net). To find more - information about GRAMPS, please visit - the GRAMPS - Web page. - - - This manual was written by Don Allingham - (dallingham@users.sourceforge.net), Larry Allingham - (llkla@erinet.com), and Shawn Ann Griffith - (shawnann1@home.com). - - - - - - - - - - License - - This program is free software; you can redistribute it and/or - modify it under the terms of the GNU General Public - License as published by the Free Software - Foundation; either version 2 of the License, or (at your option) - any later version. - - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more - details. - - - A copy of the GNU General Public License is - included as an appendix to the GNOME Users - Guide. You may also obtain a copy of the - GNU General Public License from the Free - Software Foundation by visiting their Web site or by writing to -
- Free Software Foundation, Inc. - 59 Temple Place - Suite 330 - Boston, MA 02111-1307 - USA -
- - -
diff --git a/gramps2/doc/gramps-manual/C/gramps.html b/gramps2/doc/gramps-manual/C/gramps.html deleted file mode 100644 index 6bfd2b388..000000000 --- a/gramps2/doc/gramps-manual/C/gramps.html +++ /dev/null @@ -1,6672 +0,0 @@ - -GRAMPS Manual V2.0

GRAMPS Manual V2.0

This manual describes version 0.9.1 of GRAMPS. -

Copyright © 2003 Alex Roitman

Copyright © 2001 Donald N. Allingham

Revision History
Revision GRAMPS Manual V2.0March 2003
Revision GRAMPS User Manual V1.12001
Revision gramps User Manual V1.02001
Table of Contents
1. Introduction
1.1. Why GRAMPS?
2. Getting Started
2.1. To Start GRAMPS
2.2. Running GRAMPS for the first time
2.2.1. Choosing a database on startup
2.2.2. Optional ZODB support
3. Main Window
3.1. Views
3.1.1. Switching Views and Viewing Modes
3.1.2. People View
3.1.3. Family View
3.1.4. Pedigree View
3.1.5. Sources View
3.1.6. Places View
3.1.7. Media View
4. Usage
4.1. Opening Database
4.2. Starting New Database
4.3. Saving Database
4.4. Importing GEDCOM Data
4.5. Exporting GEDCOM Data
4.6. Importing and Exporting GRAMPS Packages
4.7. Editing Data: Quick Start
4.7.1. To Add a Person
4.7.2. To Specify a Relationship
4.7.3. To Specify Parents
4.7.4. To Specify Children
4.7.5. To Add Images
4.7.6. To Edit Sources and Places
4.8. Editing Data: Complete Description
4.8.1. Edit Personal Information
4.8.2. Edit Relationship Data
4.8.3. Edit Source Data
4.8.4. Edit Place Data
4.8.5. Edit Media Data
4.8.6. Edit Events
4.8.7. Edit Source Information
4.8.8. Edit Alternate Names
4.8.9. Edit Attributes
4.8.10. Edit Addresses
4.8.11. Edit Witnesses
4.9. Navigation
4.9.1. Using People View
4.9.2. Using Family View
4.9.3. Using Pedigree View
4.9.4. Setting Default Person
4.9.5. Bookmarking People
4.10. Generating Reports
4.10.1. Graphical Reports
4.10.2. Text Reports
4.10.3. View
4.10.4. Web Page
4.11. Running Tools
4.11.1. Analysis and Exploration
4.11.2. Database Processing
4.11.3. Utilities
5. Settings
5.1. Usage
5.1.1. Find
5.1.2. Report Preferences
5.1.3. Researcher Information
5.1.4. Data Guessing
5.2. Display
5.2.1. General
5.2.2. Dates and Calendar
5.2.3. Tool and Status Bars
5.3. Database
5.3.1. General
5.3.2. Media Objects
5.3.3. GRAMPS internal IDs
5.3.4. Revision Control
6. About GRAMPS

1. Introduction

The GRAMPS is a genealogical - application. GRAMPS is an acronym for the - Genealogical Research and Analysis Management Programming System. To put - it shortly, it allows you to store, edit, and research genealogical data - using your computer. Its functionality is somewhat common to other - genealogical programs. However, GRAMPS offers - some unique features.

1.1. Why GRAMPS?

GRAMPS was conceived under the concept - that most genealogy programs were designed to provide the researcher the - capability to input information related to a particular family tree. - Most of these programs have allowed for the arranging and storing of - information consistent with the GEDCOM standards. They usually provide - means for displaying descendant or ancestral relationships by means of - graphical displays, charts, or reports. These may be augmented with - pictures or other media to enhance the data. Most provide for inputting - data on unconnected individuals/families that may or may not have a - relationship to the primary surname being researched. Various other - enhancements may also be provided in the genealogical program that - allows for different degrees of importing and exporting data from other - programs and printing the data contained in the various reports.

GRAMPS, on the other hand, attempts to - provide all of the common capabilities of these programs, but, more - importantly, to provide an additional capability of integration not common - to these programs. This is the ability to input any bits and pieces of - information directly into GRAMPS and - rearrange/manipulate any/all data events in the entire data base (in any - order or sequence) to assist the user in doing research, analysis and - correlation with the potential of filling relationship gaps. In short, a - tool that provides a way to input all your research into one place and do - your analysis and correlation using the speed, power, and accuracy of your - computer instead of pencils and unmanageable reams of paper.

2. Getting Started

2.1. To Start GRAMPS

You can start GRAMPS in the - following ways:

Applications menu

Choose Other->Gramps.

Command line

To start GRAMPS - from a command line, type gramps, then - press Return.

If you would like GRAMPS to open - a specific database or to import a specific file on startup, you can - supply the filename as a command line argument:

gramps filename.ged -

where filename.ged is the name - of the file you want to open/import.

2.2. Running GRAMPS for the first time

- [ FIXME: NEED TO RUN Getting Started DRUID to document this section ] - - The first time you run the program, GRAMPS will display its - Getting Started screens.

Figure 1. GRAMPS Getting Started Window

2.2.1. Choosing a database on startup

If GRAMPS is started without any - database to open, the following window will appear prompting you to - choose what database to open.

Figure 2. Open Database Window

If you would like to open an existing database, check the top radio - button and click OK. You will then be asked to - specify the name of your existing database. If you would like to start - creating your brand new database from scratch right away, choose new XML - database.

2.2.2. Optional ZODB support

If either StandaloneZODB or Zope is installed on your system, - GRAMPS will give you the third option of - creating a new ZODB database. You can choose to start your new database - in either XML or ZODB format. Both formats have their strong and weak - points.

XML stands for eXtensible Markup Language, and is a human readable - structured description of data. It could be easily parsed by other - programs should the need occur. It stores only the data itself. Its weak - point is the relatively low speed of processing large data files.

ZODB stands for Zope Object Database and provides the full-fledged - database support. ZODB files are not human readable. They contain a - certain overhead to assist working with large data structures. However, - ZODB provides a significant speed-up when the database size is large (over - few thousand people).

Its is hard to tell which format is better, since this is a typical - tradeoff situation. If you are starting your research then you are likely - to be fine with the regular XML database. If you have tons of data to - import describing thousands upon thousands of people, then you are - probably better of with ZODB.

3. Main Window

When you open a database (either existing or brand new), - the following window is displayed.

Figure 3. GRAMPS Main Window

The GRAMPS window contains the following elements:

Menubar

The menubar provides access to all features of - GRAMPS through its menus.

Toolbar

The toolbar provides access to the most frequently - used functions of GRAMPS. The appearance of - the toolbar can be adjusted in Preferences - dialog.

Progress bar

The progress bar is located in the lower left corner - of the GRAMPS window. It displays the - progress of time consuming operations, such as opening and saving - large data bases, importing and exporting to other formats, generating - web sites, etc.

Statusbar

The statusbar is located to the right of the progress - bar, on the very bottom of the GRAMPS window. - It displays information about current GRAMPS - activity and contextual information about the menu items. - The behavior of the Status line can be adjusted in - Preferences dialog.

Display area

The largest area in the center of the - GRAMPS window is the display area. - It shows certain aspects of genealogical information, depending on the - currently selected View. The following six Views are available - in GRAMPS: -

  • People View

  • Family View

  • Pedigree View

  • Sources View

  • Places View

  • Media View

-

3.1. Views

Views are the various ways to display different aspects of - genealogical information, as described below. Since the relevant - information is very broad and non-uniform in both context and modality, - it is best to split it's display into smaller categories, uniform in - context and modality. Each View represents such a split and displays a - certain portion of overall available information. Before the detailed - description of available Views, let us guide you through the ways of - switching between the Views.

3.1.1. Switching Views and Viewing Modes

Depending on the state of the View->Sidebar menu item, the View could be switched either in the - sidebar or in the notebook tabs in the top part of the window. -

To switch the View while in a Sidebar mode, - click on the desired sidebar icon.

Figure 4. Sidebar Viewing Mode

To switch the View while in a Notebook mode, - click on the desired notebook tab.

Figure 5. Tabbed Viewing Mode

To switch between sidebar and notebook viewing modes, - choose View->Sidebar from the GRAMPS menu.

3.1.2. People View

When GRAMPS opens a database, - the View is set to the People View (Figure 4 - and Figure 5). People View lists individuals - whose data is stored in the database. People View displays people's - Names, GRAMPS ID numbers, - Gender, and - their Birth and Death dates. - The list can be ordered by any field.

Example: to order list by the Birth date, click on the - Birth date column heading. To order list in - reverse (descending) order, click one more time on the desired column - heading.

3.1.2.1. Filters

Genealogical databases may contain huge numbers of people. - Since the long lists are hard for humans to handle, - GRAMPS provides a convenient way to limit - the scope of browsing by using the Filter. To save screen space, - Filter controls may be hidden, depending on the state of - View->Filter menu item.

Figure 6. Filter Controls Displayed

When GRAMPS opens a database, the - Filter is set to the trivial filter called All - people, i.e. no filtering is in effect. To choose a - filter, use a pop-up Filter menu above the - people's list. Once the Filter is chosen, click - Apply in the upper right corner of the - window. The filtering will take effect upon clicking - Apply. To invert the filtering rule, check - the Invert box on the left - of Apply button.

Example: To show people without children, choose - People with children filter, then check - Invert box, and then click - Apply. To cancel any filtering, set - the filter to All people - and then click Apply.

Note: even if the Filter controls are not displayed - (View->Filter menu item is - unchecked), the filtering might still be in place. In other words, - the visibility of the Filter controls is not related to the actual - filtering imposed on the list. This may be a cause of confusion, when - you enable the filtering and then remove the controls from the - display. If in doubt, enable the display of Filter controls by - checking View->Filter menu item and check - what kind of filtering is currently set.

3.1.2.2. Alphabetical Tabs

GRAMPS offers another way of - managing long lists of people -- alphabetical tabs. Upon loading a - database, GRAMPS checks for the stored - Family names and breaks the people list into sublists based on the - first letter of their name. The alphabetical tabs are displayed in - the bottom part of the GRAMPS window. - The last tab, Other, stands for unidentified - characters -- all the entries not assigned to any other tab end up - in Other. In particular, people with no family - name will appear under this category.

3.1.3. Family View

Family View displays the Family information of a currently - selected (or Active) person. Specifically, this view shows the - relationships (e.g marriages, partnerships, etc.) of the active - person, his/her parents (or step parents, or guardians, etc), and - his/her children (could be step children, adopted children, etc.). -

Figure 7. Family View

The Active person's data is in the list-box in the upper left - corner of the window. Directly below it, another box lists the Spouse's - data, for each relationship of Active person (can be more than one). - The double-arrow button to the right of the Active person list-box - allows to exchange the currently selected spouse (Current spouse) - with the Active person. Double-clicking on the Active person allows - to edit Active person's data. Double-clicking on the Current spouse - allows to edit their relationship information. To add a spouse, - click + to the right of the spouse box. - To remove Current spouse, click - to the - right of the spouse box.

The parents of both the Active person and the Current spouse - are listed in the corresponding list-boxes in the right-hand part of - the window (Active person's parents on top, Current spouse parents - on the bottom). Both list-boxes have a set of three buttons on their - right side. The + and - - buttons allow to add and remove parents of the Active person and the - Current spouse, respectively. Clicking -> - makes the family in the corresponding list-box and active family. - That is, it makes the selected Father the Active person, and the - selected Mother the Current spouse.

The bottom list-box displays children of the Active person and - the Current Spouse. Children's list can be order by the Birth date, - by usual way of clicking on the Birth date column - header. In addition to the Name, - ID, Gender, and - Birth date columns, the list includes - Status column. The pair of status words reflect the - relationship between the child and his Father/Mother (such as Birth, Adoption, - etc.) The three buttons are available on the right side of the - children list-box. The + - and + buttons allow to add and remove - children, respectively. Clicking <- makes - the selected child the Active person.

3.1.4. Pedigree View

Figure 8. Pedigree View

Pedigree View helps to visualize the place of the Active - person in the tree of its ancestors. Pedigree View shows four - generations, going back in time from the Active person - 1 to his/her parents 1, - to grandparents 1, to great-grandparents - 1. - Each person is denoted by a white box bearing the person's name. - The two lines that converge on the box represent ties with the - person's Father (top line) and mother (bottom line). Solid lines - represent birth relations, while dashed lines represent non-birth - relations (such as adoption, step-parenthood, guardianship, etc.). - When the mouse moves over the white box, it expands to display the - corresponding person's dates of birth and death. When the mouse is - placed over the family line, the line changes color to indicate an - active link: double-clicking on the line makes the corresponding - ancestor the Active person. The display in that case is re-adjusted - to show four generations, starting from a newly selected Active - person.

The left-hand side of the window shows the left arrow button. - Upon clicking, the button expands to the menu listing the children - of the Active person. Selecting the menu item makes the corresponding - child the Active person.

The right-hand side of the window shows two right arrow buttons. - When the top button is clicked, the Father of the Active person - becomes Active person. Clicking the bottom button makes the Mother of - the Active person the Active person. Again, the display is re-adjusted - to show four generations, starting from a newly selected Active - person.

3.1.5. Sources View

Figure 9. Sources View

Sources View lists the sources of information stored in the - database. This can include various documents (birth, death, and - marriage certificates, etc.), books, films, journals, private diaries, - i.e. virtually anything that can be classified as a source of - information. The sources can be used as the reference for any event - stored in the database. The Source View lists the - Title, ID, and the - Author of the source. All the columns can be - used for sorting the list. The usual rules apply: one click for - ascending order, another click for descending order.

3.1.6. Places View

Figure 10. Places View

Places View lists the geographical places in which the events - of the database took place. These could be places of birth, death, - marriages of people, as well as their home, employment, education - addresses, or any other conceivable reference to the geographical - location. The Places View lists places' Name, - ID, Church Parish, - City, County, - State, and Country. All of - these can be used for sorting by the usual sorting rules.

3.1.7. Media View

Figure 11. Media View

Media View is a list of Media Objects used in the database. - Media Objects are any files that relate somehow to the stored - genealogical data. Technically, any file can be stored as a Media - Object. Most frequently, these are images, audio files, animation - files, etc. The list-box on the bottom lists the Name, ID, Type, and - Path to the Media Object. The top part of the GRAMPS window shows - the preview (if available) and the information about the Media - Object.

4. Usage

As commonly encountered in everyday life, in - GRAMPS there is usually more than one way to - accomplish something. The alternatives to some actions will therefore - be listed as appropriate.

4.1. Opening Database

To open a database, either choose File->Open - or click Open button on the Toolbar. - The Open Database dialog will appear. - Either type the full path into the Database text - entry field, or click Browse... to get the - Open File dialog in which you can select the file - that you want to open. After you have selected the file, click - OK to open it.

If you have previously opened files with - GRAMPS you can retrieve your past selections - from the drop-down menu by clicking the down arrow button. Finally, if - the Revision Control System (RCS) is enabled in the - Preferences dialog, the check-box - Revert to an older version from RCS - will be available. Check it to revert your database to an older RCS - version.

Note: the name you type or select should be the directory - (folder) which has your data (data.gramps or data.zodb files) as well as - any possible copies of Media Objects.

4.2. Starting New Database

To start a new database, choose File->New. You will then be - prompted with the Save Database dialog asking - to specify the name under which the new database will be stored. - Choose an empty directory for your new database (create one if - necessary).

4.3. Saving Database

To save changes made to your database, choose File->Save or click - Save on the Toolbar. The Status line will then - display Saving filename... - message, and the progress bar will advance as the saving progresses.

4.4. Importing GEDCOM Data

Importing GEDCOM data allows you to incorporate the data created in - other genealogical programs into your currently open GRAMPS database. - GRAMPS can import GEDCOM data files from a - number of software packages, as long as they comply with GEDCOM - standards. To import GEDCOM file, choose File->Import->Import from - GEDCOM. You will then be prompted with the - Open File dialog asking to specify the GEDCOM file - name.

Upon starting the import, GRAMPS will - display the following GEDCOM import dialog with the summary of the - information about the data. The information is updated as the import - progresses.

Figure 12. GEDCOM Import

4.5. Exporting GEDCOM Data

Exporting GEDCOM data allows you to share any portion of your - GRAMPS database with other researchers - by way of standard GEDCOM files. To export into GEDCOM file, - choose File->Export->Export to GEDCOM. The following - Export GEDCOM file dialog will appear.

Figure 13. Export GEDCOM File dialog

Type the desired GEDCOM filename into the text entry box or - click Browse... to evoke - Save File dialog. Use Filter - pop-up menu to limit the scope of export according to the stated rule. - Choose the desired Encoding of the exported file. - Use Target to select the desired GEDCOM - dialect. Select you copyright statement from the - Copyright menu. Check Do not include - records marked private to disable the output of private - records. Check Restrict data on living people - to limit living people's data to family ties. With this option, - information concerning birth, death, addresses, various events, - etc. will be omitted in the exported GEDCOM file. -

Upon starting the export, GRAMPS will - display the following GEDCOM export progress window with the progress - bars reflecting the current state of exporting.

Figure 14. Export GEDCOM progress dialog

4.6. Importing and Exporting GRAMPS Packages

GRAMPS provides a way to make your - GRAMPS database completely portable. This might - prove useful, for instance, when you need to move your database to - another machine or to share it with somebody, while retaining all the - features provided by GRAMPS. To accomplish - this, choose File->Export->Export to GRAMPS Package. The - GRAMPS Package Export window will appear. Type - the desired package name into the text entry area or click - Browse... to select the file using the - Save File dialog. The resulting package is - gzip-compressed tar archive (also known as tarball) which contains - gramps database, all local media objects, and copies of all external - media objects.

To import data from such a package into your GRAMPS database, choose - File->Import->Import from GRAMPS, then select - a package to be imported from the Import from GRAMPS - dialog.

4.7. Editing Data: Quick Start

Editing any portion of data allows you to amend and/or - modify information stored in the database. The available editing - options include editing personal data, relationship data, data about - children and parents, information about sources, places, and media - objects used in the database. In short, any data stored in the - database can be edited! Adding new pieces of information is in fact - creating an appropriate empty data structure and subsequent - editing of that empty structure.

4.7.1. To Add a Person

To add a person to the database, switch to the People View - (Figure 4) and then click - Add on the toolbar. - Enter any data you know about this person into the Edit - Person Dialog (see Figure 15 - for details). To edit information about a person already present - in the database, select an entry you would like to view/modify, - and then click Edit on the toolbar.

4.7.2. To Specify a Relationship

To specify a relationship, first switch to the Family View - (Figure 7). Then click + - button on the right of the spouse box. Select a spouse/partner from the - list and specify their relationship using the menu at the bottom. If - necessary, you can add a person to the list by clicking - Add... button. To edit information about - relationship already present in the database, move the mouse over - Spouse box and double-click. -

4.7.3. To Specify Parents

To specify parents of an active person, first switch to the - Family View (Figure 7). Then click - + button on the right of the active person's - parents list-box. Select the parents from two lists and specify the - parents' relationships to the active person using menus at the bottom. - You can also specify parents' relationship to each other. - If necessary, you can add a person to the list by clicking - Add... button.

The top and bottom lists contain males and females, - respectively. By default, GRAMPS will - limit both lists to people who could possibly be the parents (judged - by the date of birth) of the active person. To override this, check - the Show all box for each list. -

To specify parents of the active person's spouse, switch to the - Family View and then click + button on the - right of the spouse's parents list-box. To edit information about - parents already present in the database, move the mouse over - the corresponding parents' box and double-click.

4.7.4. To Specify Children

To specify children of an active person, switch to the - Family View (Figure 7) and then - click + button on the - right of the children list-box. Select a child from the list and - specify child's relationship with father and mother using menus - at the bottom. If necessary, you can add a person to the list by - clicking Add... button.

By default, GRAMPS will - limit the list lists to people who could possibly be the child (judged - by the date of birth) of the active person. To override this, check - the Show all box. -

4.7.5. To Add Images

You can add images (as well as other media objects) to - individual people, events, sources, places, as well as images - generally related to the database (e.g. group family photos).

To add images related to a single person, switch to the - People View (Figure 4), select a person, and - then click Edit on the toolbar to invoke - the Edit Person Dialog - (Figure 15). Then, select the - Gallery tab, and click - Add... to invoke Select a media - object dialog. Type filename or select a file with the - image, then provide a title for that image. To prevent the file from - being copied into your database directory, check the Do not - make a local copy box. Keep adding images until you are - done.

To add images related to a relationship (e.g. marriage), - switch to the Family View (Figure 7) and then - double click on the Spouse box invoke Marriage/Relationship - editor dialog. Select the Gallery - tab and click Add... to add an image.

To add images related to a source or a place, first switch to - the Sources View (Figure 9) or Places - View (Figure 10), respectively. Then select the - appropriate source or place and then either double click on it - or click Edit on the toolbar to invoke - Source Editor (or Place - Editor) dialog. Select the Gallery - tab and click Add... to add an image.

Finally, to add images that are generally related to the - database but not limited to any person, relationship, source, or place - in particular, switch to the Media View (Figure 11). - Then click Add on the toolbar to add an image. - If you have already added any images to any individual galleries, - you will also find the listed in the Media View.

In any gallery, you can also use Edit... - and Remove buttons to edit image information - and to remove the image reference from that gallery. Note that in all - galleries removing the reference to the image does not remove the image - from the database. To completely remove the image from the database, - delete it from Media View by first selecting it and then - clicking Remove on the toolbar.

4.7.6. To Edit Sources and Places

To add a source or a place to the database, switch to - the appropriate Sources View (Figure 9) or - Places View (Figure 10). - Then click Add on the toolbar to add a - source/place. Enter the information into the Source - Editor (or Place Editor) dialog. -

To edit information about sources and places already present - in the database, switch to the appropriate view, select an entry - you would like to view/modify, and then click - Edit on the toolbar. -

4.8. Editing Data: Complete Description

This section provides a complete description of all editing - options for all pieces of data in the GRAMPS database.

4.8.1. Edit Personal Information

Editing of personal data can be performed in the - following ways.

From People View:

- Double-click the name of the person whose data you would like - to edit, or select the name by single click and then click - Edit on the toolbar. -

From Family View:

Move the mouse into the Active person box, - then double-click. -

With either method, the following Edit - Person dialog will appear:

Figure 15. Edit Person dialog

The top of the window shows the name of the person whose - data is being edited. The main part of the window displays nine - notebook tabs containing different categories of available - information. You can bring any tab to the top for viewing - or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking OK - at any time will apply all the changes made in all tabs and close the - dialog window. Clicking Cancel at any time will - close the window without applying any changes. If any of the data - in any tab was modified, the alert window will appear with the - choices of closing the dialog without saving changes, canceling the - initial cancel request, or saving the changes. -

The tabs provide the following information categories of - personal data: -

General

- General tab allows editing of - the most general information about the person. This includes text - entry fields of Given name, - Family name, Family prefix - (such as de or van), Suffix (e.g. Jr. or III), - Title (e.g. Dr. or Rev.), - Nickname (Bob for Robert), - Type of the name (birth name, married name, etc.) - and Date and Place of birth - and death. Some of these (Family name, - Type, and both Place fields), - in addition to typing the data in, allow to choose the corresponding - contents from the drop-down menus by clicking on a down-arrow button - located immediately to the right of the text entry field. The - available menu choices are formed from the information already stored - in the database. Also, when you start to type within these fields, - GRAMPS will try to guess the remainder of - the text by using the same choices that are available from the - corresponding menu. To accept the highlighted guess and move to - the next field, press Tab.

The Gender radio buttons offers - the choice of person's gender between male, - female, and unknown. - The buttons Source... and - Note... allow to add or modify the data about - the sources of the name information and any notes relevant to it. - Similarly, clicking Edit.. buttons located by the - birth and death Date fields allows to edit the - corresponding events of birth and death. - The field ID displays internal - GRAMPS ID number which identifies user in the - database. Finally, the Image area shows the first - image available in the Gallery of this person. -

Names

Figure 16. Edit Person dialog - Names

Names tab displays information concerning - alternate names of the person and the controls allowing its - modification. The bottom part displays the list of all alternate names - of the person stored in the database. The top part shows the details - of the currently selected name in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an alternate name record from the database. - Note that Edit... and - Delete buttons become available only when - an alternate name is selected from the list. -

Events

Figure 17. Edit Person dialog - Events

Events tab displays information about - the events relevant to the person and the controls allowing its - modification. The bottom part displays the list of all such events - stored in the database. The top part shows the details - of the currently selected event in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an event record from the database. - Note that Edit... and - Delete buttons become available only when - an event is selected from the list. -

Attributes

Figure 18. Edit Person dialog - Attributes

Attributes tab displays information about - the attributes of the person and the controls allowing its - modification. These could be any personal attributes of a person whose - description naturally fits into Parameter-Value pairs (e.g. enormous - generosity can be stored as the parameter "Generosity" with the - value "Enormous", etc.). The bottom part displays the list of all - attributes stored in the database. The top part shows the details - of the currently selected attribute in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an attribute record from the database. - Note that Edit... and - Delete buttons become available only when - an attribute is selected from the list. -

Addresses

Figure 19. Edit Person dialog - Addresses

Addresses tab displays information about - the addresses of the person and the controls allowing its - modification. The bottom part displays the list of all - addresses stored in the database. The top part shows the details - of the currently selected address in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an address record from the database. - Note that Edit... and - Delete buttons become available only when - an address is selected from the list. -

Notes

Figure 20. Edit Person dialog - Notes

Notes tab displays information about - the notes concerning the person. These could be any notes which do not - naturally fit into the Parameter-Value pairs available to Attributes. - To add a note or modify existing notes simply edit the text in the - text entry field. -

Gallery

Figure 21. Edit Person dialog - Gallery

Gallery tab displays information about - media objects associated with the person and the controls allowing its - modification. The central part shows the list of all such media objects. - For media object which are valid image files previews of images are - displayed. For other objects such as audio files, movie files, etc. - generic GRAMPS icon is displayed instead. Note that the first available - image in the gallery will be also displayed in the - Image area in the General - tab. The buttons Add..., - Edit..., and Remove allow - to correspondingly add, modify, and remove a media object reference - to this person. Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. -

Internet

Figure 22. Edit Person dialog - Internet

Internet tab displays information about - Internet addresses relevant to the person and the controls - allowing its modification. The bottom part displays the list of all - such Internet addresses stored in the database. The top part shows the - details of the currently selected addresses in the list (if any). - The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove an Internet address - record from the database. The button Go allows - to open a web-page with the corresponding address with your default - browser. Note that Edit..., - Delete, and Go buttons - become available only when an address is selected from the list. -

LDS

Figure 23. Edit Person dialog - LDS

LDS tab displays information - about LDS ordinances of the person and the controls allowing its - modification. These are LDS baptism, - Endowment, and Sealed to - parents ordinances, as labeled inside the tab. - Each ordinance is described by its date, LDS temple, and Place where - it happened. An additional pop-up menu Parents is - available for the Sealed to parents ordinance. - Each ordinance can further be described by its status through the - selections available in the Status pop-up - menu and can also be referenced by sources and notes via corresponding - Sources... and Note - buttons. -

4.8.2. Edit Relationship Data

Editing of relationship data is performed in the following - Marriage/Relationship Editor dialog which appears - after double-clicking on the spouse box in the Family View.

Figure 24. Marriage/Relationship Editor dialog

The top of the window shows the names of the people whose - relationship is being edited. The main part of the window displays - six notebook tabs containing different categories of available - information. You can bring any tab to the top for viewing - or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking OK - at any time will apply all the changes made in all tabs and close the - dialog window. Clicking Cancel at any time will - close the window without applying any changes. If any of the data - in any tab was modified, the alert window will appear with the - choices of closing the dialog without saving changes, canceling the - initial cancel request, or saving the changes.

The tabs provide the following information categories of - relationship data: -

General

- General tab allows editing of the most general - information about the relationship: the relationship type. - The available types (such as married, partners, etc.) can be chosen - from the drop-down Relationship type menu. - The non-editable field ID displays internal GRAMPS - ID number which identifies this relationship in the database. -

Events

Events tab displays information about - the events relevant to the relationship and the controls allowing - its modification. The bottom part displays the list of all such events - stored in the database. The top part shows the details - of the currently selected event in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an event record from the database. - Note that Edit... and - Delete buttons become available only when - an event is selected from the list. -

Attributes

Attributes tab displays information about - the attributes of the relationship and the controls allowing its - modification. The bottom part displays the list of all such - attributes stored in the database. The top part shows the details - of the currently selected attribute in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an attribute record from the database. - Note that Edit... and - Delete buttons become available only when - an attribute is selected from the list. -

Notes

Notes tab displays information about the - notes concerning the relationship. These could be any notes which do - not naturally fit into the Parameter-Value pairs available to - Attributes. To add a note or modify existing notes simply edit the - text in the text entry field. -

Gallery

Gallery tab displays information about - media objects associated with the person and the controls allowing its - modification. The central part shows the list of all such media objects. - For media object which are valid image files previews of images are - displayed. For other objects such as audio files, movie files, etc. - generic GRAMPS icon is displayed instead. The buttons - Add..., Edit..., - and Remove allow to correspondingly add, modify, - and remove a media object reference to this relationship. - Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. -

LDS

LDS tab displays information - about LDS Sealed to spouse ordinance - of the person and the controls allowing its - modification. The data can include date, LDS temple, and Place where - it happened. The ordinance can further be described by its status - through the selections available in the Status - pop-up menu and can also be referenced by sources and notes via - corresponding Sources... and - Note buttons.

4.8.3. Edit Source Data

To edit source data, switch to the Sources View and select the - desired entry in the list of sources. Double-click on that entry or - click Edit on the toolbar to invoke the - following Source Editor dialog:

Figure 25. Source Editor dialog

The top of the window shows the Source Editor - title of the dialog. The main part of the window displays four notebook - tabs containing different categories of available information. You can - bring any tab to the top for viewing or editing by clicking on the - appropriate tab heading. The bottom part has OK - and Cancel buttons. Clicking - OK at any time will apply all the changes made - in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - source data: -

General

- General tab allows editing of the most general - information about the source: its title, author, and publication - information. This information can be typed in the appropriate - text entry fields. -

Note

Note tab displays any notes concerning - the source. To add a note or modify existing notes simply edit the - text in the text entry field. -

Gallery

Gallery tab displays information about - media objects associated with the given source and the controls - allowing its modification. The central part shows the list of all - such media objects. For media object which are valid image files - previews of images are displayed. For other objects such as audio - files, movie files, etc., generic GRAMPS icon is displayed instead. - The buttons Add..., - Edit..., and Remove allow - to correspondingly add, modify, and remove a media object reference - to this source. Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. -

References

References tab displays information about - database records that refer to this source. If the source is not - referenced from any database record, the tab shows empty list. - If the source is referenced from many records, the tab will list - all of them. The list can be ordered by any of its column headers: - Source type, Object, or - Value. This information cannot be modified from - the Source Editor dialog. Instead, the - corresponding database record (e.g. birth event) has to be brought - up and its source reference edited.

4.8.4. Edit Place Data

To edit place data, switch to the Places View and select the - desired entry in the list of places. Double-click on that entry or - click Edit on the toolbar to invoke the - following Place Editor dialog:

Figure 26. Place Editor dialog

The top of the window shows the Place Editor - title of the dialog. The main part of the window displays seven - notebook tabs containing different categories of available information. - You can bring any tab to the top for viewing or editing by clicking on - the appropriate tab heading. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - place data: -

General

- General tab allows editing of the most general - information about the place: title which labels it in the database, - city, church parish, county, state, country, longitude, and latitude. - This information can be typed in the appropriate text entry fields. -

Other names

- Other names tab displays information concerning - other names by which the place might be known and the controls - allowing its modification. The bottom part displays the list of all - other names of the place stored in the database. The top part shows - the details of the currently selected name in the list (if any). - The buttons Add..., - Edit..., and Delete allow - to correspondingly add, modify, and remove a name record - from the database. Note that Edit... and - Delete buttons become available only when - a name is selected from the list.

Note

Note tab displays any notes concerning - the place. To add a note or modify existing notes simply edit the - text in the text entry field. -

Sources

- Sources tab displays information about sources - relevant to this place and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete allow - to correspondingly add, modify, and remove a source reference - to this place. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list.

Gallery

Gallery tab displays information about - media objects associated with the given place and the controls - allowing its modification. The central part shows the list of all - such media objects. For media object which are valid image files - previews of images are displayed. For other objects such as audio - files, movie files, etc., generic GRAMPS icon is displayed instead. - The buttons Add..., - Edit..., and Remove allow - to correspondingly add, modify, and remove a media object reference - to this source. Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. -

Internet

Internet tab displays information about - Internet addresses relevant to the place and the controls - allowing its modification. The bottom part displays the list of all - such Internet addresses stored in the database. The top part shows the - details of the currently selected addresses in the list (if any). - The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove an Internet address - record from the database. The button Go allows - to open a web-page with the corresponding address with your default - browser. Note that Edit..., - Delete, and Go buttons - become available only when an address is selected from the list. -

References

References tab displays information about - database records that refer to this place. If the place is not - referenced from any database record, the tab shows empty list. - If the place is referenced from many records, the tab will list - all of them. This information cannot be modified from - the Place Editor dialog. Instead, the - corresponding database record (e.g. birth event) has to be brought - up and its place reference edited.

4.8.5. Edit Media Data

To edit media data, switch to the Media View and select the - desired entry in the list of sources. Double-click on that entry or - click Edit on the toolbar to invoke the - following Edit Media Properties dialog:

Figure 27. Edit Media Properties dialog

The top of the window shows the dialog title. Below the title - is the preview of an object and the summary of its properties (ID, - path, and object type). The central part of the window displays four - notebook tabs containing different categories of available information. - You can bring any tab to the top for viewing or editing by clicking on - the appropriate tab heading. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - media object data: -

General

- General tab allows to edit the title which labels - this object in the database. The title can be typed in the appropriate - text entry field. If the object is not local (i.e. the corresponding - file does not reside under GRAMPS database directory), the - Make a local copy button is available. - Click it to copy the media into GRAMPS database directory. This will - increase the amount of disk space consumed by GRAMPS database. However, - if the external file is deleted or removed, GRAMPS will still be able - to use the local copy.

Attributes

Attributes tab displays information about - the attributes of the media object and the controls allowing its - modification. The bottom part displays the list of all such - attributes stored in the database. The top part shows the details - of the currently selected attribute in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an attribute record from the database. - Note that Edit... and - Delete buttons become available only when - an attribute is selected from the list.

Notes

Notes tab displays information about the - notes concerning the media object. These could be any notes which do - not naturally fit into the Parameter-Value pairs available to - Attributes. To add a note or modify existing notes simply edit the - text in the text entry field.

References

References tab displays information about - database records that refer to this media object. If the object is not - referenced from any database record, the tab shows empty list. - If the object is referenced from many records, the tab will list - all of them. The list can be ordered by any of its column headers: - Type, Object, or - Value. This information cannot be modified from - the Media Object Properties Editor dialog. - Instead, the corresponding database record (e.g. birth event) has to - be brought up and its media object reference edited in the gallery - tab.

4.8.6. Edit Events

Events are edited through the following Event - Editor dialog:

Figure 28. Event Editor dialog

The top of the window shows the dialog title including the name - of the person whose event is being edited. The central part of the - window displays four notebook tabs containing different categories of - available information. You can bring any tab to the top for viewing or - editing by clicking on the appropriate tab heading. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - the event data:

General

- General tab allows editing of the most general - information about the event: its type, date, place, cause, and - description. The type can be selected from available types listed - in the Event type drop-down menu. The rest - of the information can be typed in the appropriate text entry fields. - Check the Private record box to mark this event - record as private. This will give you a chance to omit this event from - being included in the reports, if you choose so among the report - generation options.

Sources

- Sources tab displays information about sources - relevant to this event and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this event. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list.

Note

Note tab displays any notes concerning - the event. To add a note or modify existing notes simply edit the - text in the text entry field. -

Witnesses

- Witnesses tab displays information about witnesses - relevant to this event and the controls allowing its modification. - The central part displays the list of all such witnesses - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a witness reference - to this event. Note that Edit... and - Delete buttons become available only when - a witness reference is selected from the list.

4.8.7. Edit Source Information

When adding source references to events, places, etc., - the following dialog appears:

Figure 29. Source Information dialog

The top of the window shows the dialog title. The central part - displays the source information. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The source can be selected from available sources listed in the - Title drop-down menu. If the source you are - referencing is not present in the database yet, you can enter it into - the database. To do this, click New... button - and enter source information into the invoked Source - Editor dialog. You can also set the details specific for - this particular reference: confidence, volume/file/page. date, text, - and comments. Choose the confidence - level from the Confidence drop-down menu. - The rest of the details can be typed in the appropriate text entry - fields.

4.8.8. Edit Alternate Names

Alternate names are edited through the following - Alternate Names Editor dialog:

Figure 30. Alternate Names Editor dialog

The top of the window shows the dialog title including the name - of the person whose alternate name is being edited. The central part - of the window displays three notebook tabs containing different - categories of available information. You can bring any tab to the - top for viewing or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - the alternate name data:

General

- General tab allows editing of the most general - information about the alternate name: given name, family name, family - prefix, suffix, title, and type of the name. The information can be - typed in the appropriate text entry fields. The family name and the - type can be also selected from available choices listed in the - appropriate drop-down menus. - Check the Private record box to mark this name - record as private. This will give you a chance to omit this name from - being included in the reports, if you choose so among the report - generation options.

Sources

- Sources tab displays information about sources - relevant to this name and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this name. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list.

Note

Note tab displays any notes concerning - the name. To add a note or modify existing notes simply edit the - text in the text entry field. -

4.8.9. Edit Attributes

Attributes are edited through the following - Attribute Editor dialog:

Figure 31. Attribute Editor dialog

The top of the window shows the dialog title including the name - of the person whose attribute is being edited. The central part - of the window displays three notebook tabs containing different - categories of available information. You can bring any tab to the - top for viewing or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - the attribute data:

General

- General tab allows editing of the most general - information about the attribute: name of the attribute and its value. - The information can be typed in the appropriate text entry fields. - The attribute name can also be selected from available choices (if any) - listed in the Attribute drop-down menu. - Check the Private record box to mark this - attribute record as private. This will give you a chance to omit - this attribute from being included in the reports, if you choose - so among the report generation options.

Sources

- Sources tab displays information about sources - relevant to this attribute and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this attribute . Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list.

Note

Note tab displays any notes concerning - the attribute . To add a note or modify existing notes simply edit the - text in the text entry field. -

4.8.10. Edit Addresses

Addresses are edited through the following - Address Editor dialog:

Figure 32. Address Editor dialog

The top of the window shows the dialog title including the name - of the person whose address is being edited. The central part - of the window displays three notebook tabs containing different - categories of available information. You can bring any tab to the - top for viewing or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes.

The tabs provide the following information categories of - the address data:

General

- General tab allows editing of the most general - information about the address: date, street address, city or county, - state or province, country, and the postal code. The information can - be typed in the appropriate text entry fields. - Check the Private record box to mark this address - record as private. This will give you a chance to omit this address - from being included in the reports, if you choose so among the report - generation options.

Sources

- Sources tab displays information about sources - relevant to this address and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this address. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list.

Note

Note tab displays any notes concerning - the address. To add a note or modify existing notes simply edit the - text in the text entry field. -

4.8.11. Edit Witnesses

Witnesses are edited through the following - Witness Editor dialog:

Figure 33. Witness Editor dialog

The top of the window shows the dialog title. The central part - of the window displays information about the witness. The bottom part - has OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made and close the dialog window. Clicking - Cancel at any time will close the window - without applying any changes. If any of the data was - modified, the alert window will appear with the choices of closing - the dialog without saving changes, canceling the initial cancel - request, or saving the changes.

The witness name can be entered in two ways, depending on - whether the witness is a person already stored in the database or - not (unrelated person).

Person from the database

- If the person's data are stored in a database, click Person - is in the database box. Then ... - -[ FIXME: Need Don to decide which way this will eventually be implemented. ] - -

Unrelated person

- If the person is not in the database, make sure that - Person is in the database box is unchecked. - Then enter the name or any description of a person into the - Person text entry field. This information - is stored as entered, and this is the only place it is stored in. - In other words, there is no reference to that person in the entire - database except for this witness reference. If the person is in fact - a member of the database, it is advised to user the former method. -

The Comment text area allows to enter - any comments concerning the witness. To add a comment or to modify - existing comments simply edit the text in the text area. -

4.9. Navigation

As long as any database is open, - GRAMPS is focused on a - single person usually referred to as an Active person. This - allows you to view or modify the data concerning this person, - his or her immediate family, etc. Navigating in the database (i.e. - moving from person to person) is in fact nothing else but changing - the Active person. This section describes many alternative ways - to navigate through the database using complex and convenient - interface GRAMPS provides. All these ways - eventually accomplish the same thing, but some are more convenient - than others, depending what you are doing in - GRAMPS at the moment.

4.9.1. Using People View

The most intuitive way to select an active person is - to use the People View. When in the People View, just select the - name of the desired person from the list by clicking that list - entry. The person you have selected becomes active. The statusbar - updates to reflect the change of the active person.

4.9.2. Using Family View

When in the Family View, you can easily navigate between the - members of the displayed family as follows:

  • To make currently selected spouse the active person, - click double-arrow button to the right of the active person box. -

  • To make currently selected parents the active family - (thereby making father the active person and mother the selected - spouse), click right-arrow button to the right of the active person's - parents box.

  • To make currently selected spouse's parents - the active family (thereby making father the active person and mother - the selected spouse), click right-arrow button to the right of the - spouse's parents box.

  • To make currently selected child the active person, - click left-arrow button to the right of the children box. -

4.9.3. Using Pedigree View

Pedigree View also allows you to move along the family tree. - The benefits of this method is that you can see more than one - generation of the family tree. Also, you can jump directly from a - great-grandson to a great-grandfather without going through the - intermediate generations.

Note that after changing the active person in the Pedigree - View, the display is re-adjusted to show four generations, starting - from a newly selected Active person. When in the Pedigree View, you - can easily navigate between the members of the displayed family tree - as follows:

  • To make any displayed person the active person, - double click the line that connects to the left side of the - corresponding box.

  • To make a child of currently active person (if any) - the active person, click the left arrow button to the left of the - corresponding box. If there is more than one child, the button expands - to the menu listing the children to choose from.

  • To move the whole family tree one generation back, - click on the corresponding right arrow button on the right-hand side - of the display area. Clicking the upper button will move the tree - along the paternal line. Clicking the lower button will move the - tree along the maternal line.

    Clicking either of these buttons is completely equivalent to - double-clicking the lines connecting to the left of the corresponding - boxes for father and mother.

4.9.4. Setting Default Person

One and only one person in the database can be selected as the - default person. Once the default person is selected, moving to that - person becomes a matter of a single click, regardless of which view - you are using at the moment.

To set the default person, first navigate to that person using - any method you like. Then choose - Settings->Default Person. Once this is - done, you can move to the default person from anywhere in the - database by simply clicking Home on the - toolbar.

4.9.5. Bookmarking People

Similarly to the default person, you can bookmark other people - from the database to simplify further navigation. To bookmark a person, - first navigate to that person, then choose - Bookmarks->Add bookmark. To move to that - person from anywhere in the database, choose - Bookmarks->Go to bookmark->Person's name.

You can manage your bookmarks by choosing - Bookmarks->Edit bookmarks. This opens - the followingEdit Bookmarks dialog with the - list of bookmarks and the controls to modify this list.

Figure 34. Edit Bookmarks dialog

4.10. Generating Reports

Reports are the most common form of the output produced by - genealogical research. Majority of genealogical software puts a lot - of emphasis on developing nicely looking reports. GRAMPS is no - exception in this regard: it offers a variety of reports to choose - from. GRAMPS can generate reports in a multitude of open formats, both - text based and graphical. GRAMPS can also produce screen based reports - that are convenient for viewing the summary of your database. - Finally, GRAMPS can generate a web-site suitable for immediate - posting on the Internet. All these are almost infinitely flexible: - you get to design and choose the style for your reports.

All reports can be accessed through the menu by choosing - Reports->Report Type->Particular - Report. Alternatively, - you can browse the complete selection of available reports along - with their brief descriptions in a Report - Selection dialog evoked by clicking - Reports on the toolbar. -

4.10.1. Graphical Reports

Graphical reports represent information in forms of charts - and graphs. Most of the options are common among graphical reports, - therefore they will be described only once, at the end of this - section. Few options specific to the given report will be - described directly in that report's entry.

The following graphical reports are currently - available in GRAMPS:

Timeline Graph

This report outputs the list of people with their - lifetimes represented by intervals on a common chronological scale. - Specific options include filter, sorting method, and the title of - the report.

Relationship Graph

This report creates complex relationship graph in - GraphViz format. The GraphViz dot tool can - transform the graph into postscript, jpeg, png, vrml, svg, and many - other formats. GraphViz tools are freely available from - GraphViz - site. Specific options include filter for this report - include filter and number of generations considered, as well as - several GraphViz specific options related to pagination, color, - and details of the graph.

Descendant Graph

This report generates the graph of people who are - descendants of a currently active person. Specific options include - the format of the displayed entries.

Ancestor Chart

This report generates the chart of people who are - ancestors of a currently active person. Specific options include - the number of generations considered and the format of the displayed - entries.

Common options for graphical reports are the filename of the - output, the format of the output, selected style, and page size and - orientation.

4.10.2. Text Reports

Text reports represent the desired information as formatted - text. Most of the options are common among text reports, - therefore they will be described only once, at the end of this - section. Few options specific to the given report will be - described directly in that report's entry.

The following text reports are currently - available in GRAMPS:

Individual Summary

This report produces a detailed summary on the - active person. The report includes all the facts known to the - database about that person.

Family Group Report

This creates a family group report, showing - information on a set of parents and their children. Specific - options: the spouse (available only if the active person has more - than one spouse).

Detailed Descendant Report

This report covers in detail the descendants of the - active person. It includes vital (birth and death) as well as - marriages. Specific options: number of forward generations - to consider.

Detailed Ancestral Report

This report covers in detail the ancestors of the - active person. It includes vital data (birth and death) as well as - marriages. Specific options: number of backward generations - to consider, as well as a variety of options on what exactly - contents to include.

Descendant Report

This report produces brief description - of descendants of the active person. Specific options: number - of forward generations to consider.

Complete Individual Report

This report provides individual summaries similar to - that of the Individual Summary report. The advantage of this report - is the specific filter option. Depending on the filter choice (active - person only, his or her descendants, his or her ancestors, or entire - database), the report may contain from one to many individual - summaries. Another option for this report is the inclusion of - source information when listing events.

Ahnentafel Report

This report lists the active person and his or her - ancestors along with their vital data. The people are numbered in a - special way which is an established standard called Ahnentafel. - The active person is given number 1. His or her father and mother - have numbers 2 and 3, respectively. This rule holds for every person - while going back in generations: father's parents are numbered 4 and 5, - and mother's parents are numbered 6 and 7, fathers always numbered - with even and mothers with odd numbers. Therefore, for any person - having number N in this tree, the numbers of father and mother - are 2N and 2N+1, respectively. -

Common options for text reports are the filename of the - output, the format of the output, selected style, and page size and - orientation. For HTML reports, there is no page information. - Instead, HTML options include the choice of the HTML template, - either available in GRAMPS or a custom template defined by you.

4.10.3. View

View reports represent overall summaries of the database - information available immediately for on-screen viewing. - The following view reports are currently available in GRAMPS:

Number of ancestors

This report displays the number of ancestors of the - active person.

Summary of the database

This report displays the overall statistics concerning - number of individuals of each gender, various incomplete entries - statistics, as well as family and media statistics.

4.10.4. Web Page

This report generates web pages, either for a selected - individual (active person) or a set of individuals. The options - for this report are broken down into contents, privacy, and advanced - options. The contents options include the filter (determine the - scope of the database to consider), number of generations to consider, - destination directory for the images, and a link to the index page. - Privacy options allow you to omit private records, restrict - information on living people, to skip images (either all or those of - living people), and to omit comments and text in source information. - Finally, the advanced options allow to include optional GRAMPS ID, - create a GENDEX index, and specify the extension of the resulting - files.

4.11. Running Tools

GRAMPS tools allow you to perform various types of analyses - of your genealogical data. Typically, the tools do not produce - output in form of printouts or files. Instead, they produce screen - output immediately available for the researcher. However, when - appropriate, you can save the result of running a tool into a file. - Tools present one of the major strengths of GRAMPS compared to the most - genealogical software.

The tools can be accessed through the menu by choosing - Tools->Tool Section->Particular - Tool. Alternatively, - you can browse the complete selection of available tools along - with their brief descriptions in a Tool - Selection dialog evoked by clicking - Tools on the toolbar.

4.11.1. Analysis and Exploration

This section contains tools which analyze and explore the - database, but do not alter it. The following analysis and exploration - tools are currently available in GRAMPS:

Compare individual events

This tool compares events across the selected group of - people. The people for this comparison are chosen with the use of - custom filters. The custom filters can be created in the Custom Filter - Editor (see Section 4.11.3). The resulting table produced - by this tool can be saved as a spreadsheet.

Interactive descendant browser

This tool builds a tree with the active person being - the root. Children branch from their parents in a usual manner. - Use this tool for a quick glance on a person's descendants. -

4.11.2. Database Processing

This section contains tools which may modify your database. - The modifications will only be performed upon your explicit consent. - The tools from this section are used most for finding and correcting - errors in the data. The following database processing tools are - currently available in GRAMPS:

Check and repair database

This tool checks the database for integrity problems, - fixing the problems it can. -

Extract information from names

This tool searches the entire database and attempts - to extract titles and nicknames that may be embedded in a person's - given name field. -

Find possible duplicate people

This tool searches the entire database, looking - for the entries that may represent the same person. -

Rename personal event types

This tool allows all the events of a certain name - to be renamed to a new name. -

Reorder GRAMPS IDs

This tool reorders the GRAMPS IDs according to the - defaults of GRAMPS. -

4.11.3. Utilities

This section contains tools allowing to perform a simple - operation on a portion of data. The results can be saved in your - database, but they will not modify your existing data. - The following utilities are currently available in GRAMPS:

Custom Filter Editor

The Custom Filter Editor builds custom filters - that can be used to select people included in reports, exports, - and other tools and utilities. This is in fact a very powerful tool - in genealogical analysis.

When you launch it, the User defined filters - dialog appears that lists all the filters (if any) previously defined - by you. Click Add... to define a new filter. - Once you have designed your filters, you can edit, test, and delete - selected filters using Edit..., - Test..., and Delete... - buttons, respectively. All the filters displayed in the list will be - automatically saved along with your database and will be available - upon the future runs of GRAMPS.

Clicking Add... invokes the - following Define filter dialog:

Figure 35. Define filter dialog

Type the name for your - new filter into the Name field. Enter any - comment that would help you identify this filter in the future - into the Comment field. Add as many rules as you - would like to your filter using Add... button. - Check Invert box to negate the filter rule - (e.g. inverting "has a common ancestor with I1" rule will match - everyone who does not have a common ancestor with that person). - If the filter has more than one rule, choose whether all of them - must apply, only one (either) rule must apply, or exactly one (either) - rule must apply, in order for the filter to generate a match.

Note that the filters you already designed may be used as a rule - for another filter. This gives you nearly infinite flexibility in - custom-tailoring your selection criteria that can be later used in - most of the exports, reports and some of the tools (such as comparing - individual events).

Generate SoundEx codes

This utility generates SoundEx codes for the names of - people in the database. -

Relationship calculator

This utility calculates the relationship between - two people from the database. -

Verify the database

This utility allows you to verify the database based - on the set of criteria specified by you. -

5. Settings

To configure GRAMPS, choose - Settings->Preferences. - The Preferences dialog contains the following - categories:

5.1. Usage

This category contains preferences relevant to the - general usage of GRAMPS. It has the following subcategories:

5.1.1. Find

Enable autocompletion

If this box is checked, GRAMPS will attempt to complete - the text as you type it into text entry fields such as family name, - place of birth, etc. Completion is attempted based on the match - between the beginning of the text being typed and the corresponding - data already stored in the database. -

5.1.2. Report Preferences

Preferred text format

Select the preferred format for text reports - from the available formats listed in this menu. -

Preferred graphical format

Select the preferred format for graphical reports - from the available formats listed in this menu. -

Preferred paper size

Select the preferred paper size used for reports - from the available sizes listed in this menu. -

Default report directory

Choose the default directory for the reports using - Browse... button or type it in the text entry - field.

Default web site directory

Choose the default directory for the web site using - Browse... button or type it in the text entry - field.

5.1.3. Researcher Information

Researcher information

Enter your personal information in the corresponding - text entry fields. Although GRAMPS requests information about you, - this information is used only so that it can create valid GEDCOM - output files. A valid GEDCOM file requires information about the files - creator. If you choose, you may leave the information empty, however - all the GEDCOM files you export will not be valid. -

5.1.4. Data Guessing

Surname guessing

This option is not currently implemented. -

5.2. Display

This category contains preferences relevant to - displaying database records and controls in GRAMPS. - It has the following subcategories:

5.2.1. General

Always display the LDS ordinance tabs

Check this box to have LDS ordinance tabs displayed. - If you do not know what LDS is then you probably should not check it. -

Show index numbers in child list

- This option is not currently implemented. -

5.2.2. Dates and Calendar

Display: Date format

Select the display format for the dates - from the available formats listed in this menu. -

Name format

Select the display format for the names - from the available formats listed in this menu. -

Entry: Date format

Select the entry format for the dates - from the available formats listed in this menu. -

Show calendar format selection menu

Check this box to enable calendar format selection - menu when you are entering dates in the Event - Editor dialog. -

5.2.3. Tool and Status Bars

Toolbar

Select the desired appearance of the toolbar icons - using the radio buttons. -

Status bar

Select the desired contents displayed in the - statusbar using the radio buttons. -

5.3. Database

This category contains preferences relevant to the - database itself. It has the following subcategories:

5.3.1. General

Automatically load last database

Check this box to automatically load the last open - database on startup.

Do not compress XML data file

Check this box to disable compression of the XML - data file. Compression significantly reduces the file size. -

Capitalize surnames

Check this box to capitalize surnames entered into the - database.

Autosave interval

Set the interval (in minutes) after which GRAMPS will - automatically save your database. Zero interval completely disables - autosave.

Default database directory

Choose the default directory in which GRAMPS starts - looking when saving the database using Browse.. - or type its path into the text entry field.

5.3.2. Media Objects

Drag and drop from an external source

Choose between a reference and a local copy made when - the object is dropped into the gallery. The reference saves disk - space as it does not copy the object. The local copy makes your - database portable as it does not depend on an external file. Consult - your need to make best choice.

Check Display global properties editor when object is - dropped box to invoke global properties editor after you - drop an external object into the gallery. -

Drag and drop from an internal source

Check Display local properties editor when - object is dropped box to invoke local properties editor - after you drop an internal object into the gallery. -

5.3.3. GRAMPS internal IDs

GRAMPS ID prefixes

Enter ID prefixes for various kinds of database - entries into the corresponding text entry fields. -

Allow internal GRAMPS ID numbers to be - edited

Check this box to enable editing of the internal GRAMPS - ID numbers. Unless you know what you are doing, leave it unchecked. -

5.3.4. Revision Control

Use revision control

Check this box to enable GRAMPS to use revision control - system for your database. If you choose this option, select the - particular revision control system from the menu. -

Prompt for comment on save

Check this box to instruct GRAMPS to prompt you to enter - the comment when you save the database. -

6. About GRAMPS

GRAMPS was written by Donald N. Allingham - (<dallingham@users.sourceforge.net>). - To find more information about GRAMPS, please visit the - GRAMPS Project - Web page.

To report a bug or make a suggestion regarding this application or - this manual, follow the directions in this - document. -

This program is distributed under the terms of the GNU - General Public license as published by the Free Software - Foundation; either version 2 of the License, or (at your option) - any later version. A copy of this license can be found at this - link, or in the file - COPYING included with the source code of this program.

\ No newline at end of file diff --git a/gramps2/doc/gramps-manual/C/gramps.xml b/gramps2/doc/gramps-manual/C/gramps.xml deleted file mode 100644 index 9cc116aad..000000000 --- a/gramps2/doc/gramps-manual/C/gramps.xml +++ /dev/null @@ -1,3134 +0,0 @@ - - - - - - GRAMPS"> - -]> - - -
- - - - &app; Manual V&manrevision; - - 2003 Alex Roitman - 2001 Donald N. Allingham - - - - GRAMPS Project - - &legal; - - - - - Alex - Roitman - - GRAMPS Project -
shura@alex.neuro.umn.edu
- - - - Donald N. - Allingham - - GRAMPS Project -
dallingham@users.sourceforge.net
- - - - - - - - - - - - - - - - - - - - - GRAMPS Manual V&manrevision; - &date; - - Alex Roitman - shura@alex.neuro.umn.edu - - GRAMPS Project - - - - GRAMPS User Manual V1.1 - 2001 - - Donald N. Allingham - dallingham@users.sourceforge.net - - GRAMPS Project - - - - gramps User Manual V1.0 - 2001 - - Donald N. Allingham - dallingham@users.sourceforge.net - - GRAMPS Project - - - - - This manual describes version &appversion; of GRAMPS. - - - Feedback - To report a bug or make a suggestion regarding the &app; application or - this manual, follow the directions in the GNOME Feedback Page. - - - - - - GRAMPS - gramps - - - - - Introduction - The &app; is a genealogical - application. &app; is an acronym for the - Genealogical Research and Analysis Management Programming System. To put - it shortly, it allows you to store, edit, and research genealogical data - using your computer. Its functionality is somewhat common to other - genealogical programs. However, &app; offers - some unique features. - - - Why &app;? - &app; was conceived under the concept - that most genealogy programs were designed to provide the researcher the - capability to input information related to a particular family tree. - Most of these programs have allowed for the arranging and storing of - information consistent with the GEDCOM standards. They usually provide - means for displaying descendant or ancestral relationships by means of - graphical displays, charts, or reports. These may be augmented with - pictures or other media to enhance the data. Most provide for inputting - data on unconnected individuals/families that may or may not have a - relationship to the primary surname being researched. Various other - enhancements may also be provided in the genealogical program that - allows for different degrees of importing and exporting data from other - programs and printing the data contained in the various reports. - - &app;, on the other hand, attempts to - provide all of the common capabilities of these programs, but, more - importantly, to provide an additional capability of integration not common - to these programs. This is the ability to input any bits and pieces of - information directly into &app; and - rearrange/manipulate any/all data events in the entire data base (in any - order or sequence) to assist the user in doing research, analysis and - correlation with the potential of filling relationship gaps. In short, a - tool that provides a way to input all your research into one place and do - your analysis and correlation using the speed, power, and accuracy of your - computer instead of pencils and unmanageable reams of paper. - - - - - - - Getting Started - - - - To Start &app; - You can start &app; in the - following ways: - - - Applications menu - Choose Other - Gramps. - - - Command line - To start &app; - from a command line, type gramps, then - press Return. - - If you would like &app; to open - a specific database or to import a specific file on startup, you can - supply the filename as a command line argument: - - - gramps filename.ged - - - where filename.ged is the name - of the file you want to open/import. - - - - - - - Running &app; for the first time - - [ FIXME: NEED TO RUN Getting Started DRUID to document this section ] - - The first time you run the program, GRAMPS will display its - Getting Started screens. - - -
- &app; Getting Started Window - - - Shows Getting Started Window. -
- - - - - - Choosing a database on startup - If &app; is started without any - database to open, the following window will appear prompting you to - choose what database to open. - - -
- Open Database Window - - - Shows Open Database Window. -
- - - If you would like to open an existing database, check the top radio - button and click OK. You will then be asked to - specify the name of your existing database. If you would like to start - creating your brand new database from scratch right away, choose new XML - database. - - - - - Optional ZODB support - - If either StandaloneZODB or Zope is installed on your system, - &app; will give you the third option of - creating a new ZODB database. You can choose to start your new database - in either XML or ZODB format. Both formats have their strong and weak - points. - - XML stands for eXtensible Markup Language, and is a human readable - structured description of data. It could be easily parsed by other - programs should the need occur. It stores only the data itself. Its weak - point is the relatively low speed of processing large data files. - - ZODB stands for Zope Object Database and provides the full-fledged - database support. ZODB files are not human readable. They contain a - certain overhead to assist working with large data structures. However, - ZODB provides a significant speed-up when the database size is large (over - few thousand people). - - Its is hard to tell which format is better, since this is a typical - tradeoff situation. If you are starting your research then you are likely - to be fine with the regular XML database. If you have tons of data to - import describing thousands upon thousands of people, then you are - probably better of with ZODB. - - - - - - - - Main Window - When you open a database (either existing or brand new), - the following window is displayed. - - -
- &app; Main Window - - - Shows &app; main window. Contains titlebar, menubar, - toolbar, sidebar, display area, statusbar, progress bar, and - scrollbars. Menubar contains File, Edit, View, Bookmarks, - Reports, Tools, Settings, and Help menus. -
- - - The &app; window contains the following elements: - - Menubar - The menubar provides access to all features of - &app; through its menus. - - Toolbar - The toolbar provides access to the most frequently - used functions of &app;. The appearance of - the toolbar can be adjusted in Preferences - dialog. - - Progress bar - The progress bar is located in the lower left corner - of the &app; window. It displays the - progress of time consuming operations, such as opening and saving - large data bases, importing and exporting to other formats, generating - web sites, etc. - - Statusbar - The statusbar is located to the right of the progress - bar, on the very bottom of the &app; window. - It displays information about current &app; - activity and contextual information about the menu items. - The behavior of the Status line can be adjusted in - Preferences dialog. - - Display area - The largest area in the center of the - &app; window is the display area. - It shows certain aspects of genealogical information, depending on the - currently selected View. The following six Views are available - in &app;: - - People View - Family View - Pedigree View - Sources View - Places View - Media View - - - - - - - - - Views - Views are the various ways to display different aspects of - genealogical information, as described below. Since the relevant - information is very broad and non-uniform in both context and modality, - it is best to split it's display into smaller categories, uniform in - context and modality. Each View represents such a split and displays a - certain portion of overall available information. Before the detailed - description of available Views, let us guide you through the ways of - switching between the Views. - - - - Switching Views and Viewing Modes - Depending on the state of the - ViewSidebar - menu item, the View could be switched either in the - sidebar or in the notebook tabs in the top part of the window. - - - - To switch the View while in a Sidebar mode, - click on the desired sidebar icon. - - -
- Sidebar Viewing Mode - - - Shows sidebar viewing mode. -
- - - - To switch the View while in a Notebook mode, - click on the desired notebook tab. - - -
- Tabbed Viewing Mode - - - Shows tabbed viewing mode. -
- - - - - To switch between sidebar and notebook viewing modes, - choose View - Sidebar - from the &app; menu. - - - - - - People View - When &app; opens a database, - the View is set to the People View ( - and ). People View lists individuals - whose data is stored in the database. People View displays people's - Names, &app; ID numbers, - Gender, and - their Birth and Death dates. - The list can be ordered by any field. - - Example: to order list by the Birth date, click on the - Birth date column heading. To order list in - reverse (descending) order, click one more time on the desired column - heading. - - - - Filters - Genealogical databases may contain huge numbers of people. - Since the long lists are hard for humans to handle, - &app; provides a convenient way to limit - the scope of browsing by using the Filter. To save screen space, - Filter controls may be hidden, depending on the state of - View - Filter menu item. - - -
- Filter Controls Displayed - - - Shows filter controls. -
- - - When &app; opens a database, the - Filter is set to the trivial filter called All - people, i.e. no filtering is in effect. To choose a - filter, use a pop-up Filter menu above the - people's list. Once the Filter is chosen, click - Apply in the upper right corner of the - window. The filtering will take effect upon clicking - Apply. To invert the filtering rule, check - the Invert box on the left - of Apply button. - - Example: To show people without children, choose - People with children filter, then check - Invert box, and then click - Apply. To cancel any filtering, set - the filter to All people - and then click Apply. - - Note: even if the Filter controls are not displayed - ( View - Filter menu item is - unchecked), the filtering might still be in place. In other words, - the visibility of the Filter controls is not related to the actual - filtering imposed on the list. This may be a cause of confusion, when - you enable the filtering and then remove the controls from the - display. If in doubt, enable the display of Filter controls by - checking View - Filter menu item and check - what kind of filtering is currently set. - - - - - Alphabetical Tabs - &app; offers another way of - managing long lists of people -- alphabetical tabs. Upon loading a - database, &app; checks for the stored - Family names and breaks the people list into sublists based on the - first letter of their name. The alphabetical tabs are displayed in - the bottom part of the &app; window. - The last tab, Other, stands for unidentified - characters -- all the entries not assigned to any other tab end up - in Other. In particular, people with no family - name will appear under this category. - - - - - - - Family View - Family View displays the Family information of a currently - selected (or Active) person. Specifically, this view shows the - relationships (e.g marriages, partnerships, etc.) of the active - person, his/her parents (or step parents, or guardians, etc), and - his/her children (could be step children, adopted children, etc.). - - - -
- Family View - - - Shows Family View. -
- - - The Active person's data is in the list-box in the upper left - corner of the window. Directly below it, another box lists the Spouse's - data, for each relationship of Active person (can be more than one). - The double-arrow button to the right of the Active person list-box - allows to exchange the currently selected spouse (Current spouse) - with the Active person. Double-clicking on the Active person allows - to edit Active person's data. Double-clicking on the Current spouse - allows to edit their relationship information. To add a spouse, - click + to the right of the spouse box. - To remove Current spouse, click - to the - right of the spouse box. - - The parents of both the Active person and the Current spouse - are listed in the corresponding list-boxes in the right-hand part of - the window (Active person's parents on top, Current spouse parents - on the bottom). Both list-boxes have a set of three buttons on their - right side. The + and - - buttons allow to add and remove parents of the Active person and the - Current spouse, respectively. Clicking -> - makes the family in the corresponding list-box and active family. - That is, it makes the selected Father the Active person, and the - selected Mother the Current spouse. - - The bottom list-box displays children of the Active person and - the Current Spouse. Children's list can be order by the Birth date, - by usual way of clicking on the Birth date column - header. In addition to the Name, - ID, Gender, and - Birth date columns, the list includes - Status column. The pair of status words reflect the - relationship between the child and his Father/Mother (such as Birth, Adoption, - etc.) The three buttons are available on the right side of the - children list-box. The + - and + buttons allow to add and remove - children, respectively. Clicking left arrow button makes - the selected child the Active person. - - - - - Pedigree View - - -
- Pedigree View - - - Shows Pedigree View. -
- - - Pedigree View helps to visualize the place of the Active - person in the tree of its ancestors. Pedigree View shows four - generations, going back in time from the Active person - 1 to his/her parents 1, - to grandparents 1, to great-grandparents - 1. - Each person is denoted by a white box bearing the person's name. - The two lines that converge on the box represent ties with the - person's Father (top line) and mother (bottom line). Solid lines - represent birth relations, while dashed lines represent non-birth - relations (such as adoption, step-parenthood, guardianship, etc.). - When the mouse moves over the white box, it expands to display the - corresponding person's dates of birth and death. When the mouse is - placed over the family line, the line changes color to indicate an - active link: double-clicking on the line makes the corresponding - ancestor the Active person. The display in that case is re-adjusted - to show four generations, starting from a newly selected Active - person. - - The left-hand side of the window shows the left arrow button. - Upon clicking, the button expands to the menu listing the children - of the Active person. Selecting the menu item makes the corresponding - child the Active person. - - The right-hand side of the window shows two right arrow buttons. - When the top button is clicked, the Father of the Active person - becomes Active person. Clicking the bottom button makes the Mother of - the Active person the Active person. Again, the display is re-adjusted - to show four generations, starting from a newly selected Active - person. - - - - - Sources View - - -
- Sources View - - - Shows Sources View. -
- - - Sources View lists the sources of information stored in the - database. This can include various documents (birth, death, and - marriage certificates, etc.), books, films, journals, private diaries, - i.e. virtually anything that can be classified as a source of - information. The sources can be used as the reference for any event - stored in the database. The Source View lists the - Title, ID, and the - Author of the source. All the columns can be - used for sorting the list. The usual rules apply: one click for - ascending order, another click for descending order. - - - - - Places View - - -
- Places View - - - Shows Places View. -
- - - Places View lists the geographical places in which the events - of the database took place. These could be places of birth, death, - marriages of people, as well as their home, employment, education - addresses, or any other conceivable reference to the geographical - location. The Places View lists places' Name, - ID, Church Parish, - City, County, - State, and Country. All of - these can be used for sorting by the usual sorting rules. - - - - - Media View - - -
- Media View - - - Shows Media View. -
- - - Media View is a list of Media Objects used in the database. - Media Objects are any files that relate somehow to the stored - genealogical data. Technically, any file can be stored as a Media - Object. Most frequently, these are images, audio files, animation - files, etc. The list-box on the bottom lists the Name, ID, Type, and - Path to the Media Object. The top part of the GRAMPS window shows - the preview (if available) and the information about the Media - Object. - - - - - - - - - Usage - As commonly encountered in everyday life, in - &app; there is usually more than one way to - accomplish something. The alternatives to some actions will therefore - be listed as appropriate. - - - - Opening Database - To open a database, either choose - FileOpen - or click Open button on the Toolbar. - The Open Database dialog will appear. - Either type the full path into the Database text - entry field, or click Browse... to get the - Open File dialog in which you can select the file - that you want to open. After you have selected the file, click - OK to open it. - - If you have previously opened files with - &app; you can retrieve your past selections - from the drop-down menu by clicking the down arrow button. Finally, if - the Revision Control System (RCS) is enabled in the - Preferences dialog, the check-box - Revert to an older version from RCS - will be available. Check it to revert your database to an older RCS - version. - - Note: the name you type or select should be the directory - (folder) which has your data (data.gramps or data.zodb files) as well as - any possible copies of Media Objects. - - - - - Starting New Database - To start a new database, choose File - New. You will then be - prompted with the Save Database dialog asking - to specify the name under which the new database will be stored. - Choose an empty directory for your new database (create one if - necessary). - - - - - Saving Database - To save changes made to your database, choose - File - Save or click - Save on the Toolbar. The Status line will then - display Saving filename... - message, and the progress bar will advance as the saving progresses. - - - - - Importing GEDCOM Data - Importing GEDCOM data allows you to incorporate the data created in - other genealogical programs into your currently open &app; database. - &app; can import GEDCOM data files from a - number of software packages, as long as they comply with GEDCOM - standards. To import GEDCOM file, choose File - ImportImport from - GEDCOM. You will then be prompted with the - Open File dialog asking to specify the GEDCOM file - name. - - Upon starting the import, &app; will - display the following GEDCOM import dialog with the summary of the - information about the data. The information is updated as the import - progresses. - - -
- GEDCOM Import - - - Shows GEDCOM Import Window. -
- - - - - Exporting GEDCOM Data - Exporting GEDCOM data allows you to share any portion of your - &app; database with other researchers - by way of standard GEDCOM files. To export into GEDCOM file, - choose File - Export - Export to GEDCOM. The following - Export GEDCOM file dialog will appear. - - -
- Export GEDCOM File dialog - - - Shows Export GEDCOM File dialog -
- - - Type the desired GEDCOM filename into the text entry box or - click Browse... to evoke - Save File dialog. Use Filter - pop-up menu to limit the scope of export according to the stated rule. - Choose the desired Encoding of the exported file. - Use Target to select the desired GEDCOM - dialect. Select you copyright statement from the - Copyright menu. Check Do not include - records marked private to disable the output of private - records. Check Restrict data on living people - to limit living people's data to family ties. With this option, - information concerning birth, death, addresses, various events, - etc. will be omitted in the exported GEDCOM file. - - - Upon starting the export, &app; will - display the following GEDCOM export progress window with the progress - bars reflecting the current state of exporting. - - -
- Export GEDCOM progress dialog - - - Shows Export GEDCOM progress dialog. -
- - - - - - Importing and Exporting &app; Packages - &app; provides a way to make your - &app; database completely portable. This might - prove useful, for instance, when you need to move your database to - another machine or to share it with somebody, while retaining all the - features provided by &app;. To accomplish - this, choose File - Export - Export to GRAMPS Package. The - GRAMPS Package Export window will appear. Type - the desired package name into the text entry area or click - Browse... to select the file using the - Save File dialog. The resulting package is - gzip-compressed tar archive (also known as tarball) which contains - gramps database, all local media objects, and copies of all external - media objects. - - To import data from such a package into your &app; database, choose - FileImport - Import from GRAMPS, then select - a package to be imported from the Import from GRAMPS - dialog. - - - - - Editing Data: Quick Start - Editing any portion of data allows you to amend and/or - modify information stored in the database. The available editing - options include editing personal data, relationship data, data about - children and parents, information about sources, places, and media - objects used in the database. In short, any data stored in the - database can be edited! Adding new pieces of information is in fact - creating an appropriate empty data structure and subsequent - editing of that empty structure. - - - - To Add a Person - To add a person to the database, switch to the People View - () and then click - Add on the toolbar. - Enter any data you know about this person into the Edit - Person Dialog (see - for details). To edit information about a person already present - in the database, select an entry you would like to view/modify, - and then click Edit on the toolbar. - - - - - To Specify a Relationship - To specify a relationship, first switch to the Family View - (). Then click + - button on the right of the spouse box. Select a spouse/partner from the - list and specify their relationship using the menu at the bottom. If - necessary, you can add a person to the list by clicking - Add... button. To edit information about - relationship already present in the database, move the mouse over - Spouse box and double-click. - - - - - - To Specify Parents - To specify parents of an active person, first switch to the - Family View (). Then click - + button on the right of the active person's - parents list-box. Select the parents from two lists and specify the - parents' relationships to the active person using menus at the bottom. - You can also specify parents' relationship to each other. - If necessary, you can add a person to the list by clicking - Add... button. - - The top and bottom lists contain males and females, - respectively. By default, &app; will - limit both lists to people who could possibly be the parents (judged - by the date of birth) of the active person. To override this, check - the Show all box for each list. - - - To specify parents of the active person's spouse, switch to the - Family View and then click + button on the - right of the spouse's parents list-box. To edit information about - parents already present in the database, move the mouse over - the corresponding parents' box and double-click. - - - - - To Specify Children - To specify children of an active person, switch to the - Family View () and then - click + button on the - right of the children list-box. Select a child from the list and - specify child's relationship with father and mother using menus - at the bottom. If necessary, you can add a person to the list by - clicking Add... button. - - By default, &app; will - limit the list lists to people who could possibly be the child (judged - by the date of birth) of the active person. To override this, check - the Show all box. - - - - - - To Add Images - You can add images (as well as other media objects) to - individual people, events, sources, places, as well as images - generally related to the database (e.g. group family photos). - - To add images related to a single person, switch to the - People View (), select a person, and - then click Edit on the toolbar to invoke - the Edit Person Dialog - (). Then, select the - Gallery tab, and click - Add... to invoke Select a media - object dialog. Type filename or select a file with the - image, then provide a title for that image. To prevent the file from - being copied into your database directory, check the Do not - make a local copy box. Keep adding images until you are - done. - - To add images related to a relationship (e.g. marriage), - switch to the Family View () and then - double click on the Spouse box invoke Marriage/Relationship - editor dialog. Select the Gallery - tab and click Add... to add an image. - - To add images related to a source or a place, first switch to - the Sources View () or Places - View (), respectively. Then select the - appropriate source or place and then either double click on it - or click Edit on the toolbar to invoke - Source Editor (or Place - Editor) dialog. Select the Gallery - tab and click Add... to add an image. - - Finally, to add images that are generally related to the - database but not limited to any person, relationship, source, or place - in particular, switch to the Media View (). - Then click Add on the toolbar to add an image. - If you have already added any images to any individual galleries, - you will also find the listed in the Media View. - - In any gallery, you can also use Edit... - and Remove buttons to edit image information - and to remove the image reference from that gallery. Note that in all - galleries removing the reference to the image does not remove the image - from the database. To completely remove the image from the database, - delete it from Media View by first selecting it and then - clicking Remove on the toolbar. - - - - - - To Edit Sources and Places - - To add a source or a place to the database, switch to - the appropriate Sources View () or - Places View (). - Then click Add on the toolbar to add a - source/place. Enter the information into the Source - Editor (or Place Editor) dialog. - - - To edit information about sources and places already present - in the database, switch to the appropriate view, select an entry - you would like to view/modify, and then click - Edit on the toolbar. - - - - - - - - Editing Data: Complete Description - This section provides a complete description of all editing - options for all pieces of data in the &app; database. - - - - Edit Personal Information - Editing of personal data can be performed in the - following ways. - - From People View: - Double-click the name of the person whose data you would like - to edit, or select the name by single click and then click - Edit on the toolbar. - - From Family View: - Move the mouse into the Active person box, - then double-click. - - - - With either method, the following Edit - Person dialog will appear: - - -
- Edit Person dialog - - - Shows Edit Person dialog. -
- - - The top of the window shows the name of the person whose - data is being edited. The main part of the window displays nine - notebook tabs containing different categories of available - information. You can bring any tab to the top for viewing - or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking OK - at any time will apply all the changes made in all tabs and close the - dialog window. Clicking Cancel at any time will - close the window without applying any changes. If any of the data - in any tab was modified, the alert window will appear with the - choices of closing the dialog without saving changes, canceling the - initial cancel request, or saving the changes. - - - - The tabs provide the following information categories of - personal data: - - - - General - - General tab allows editing of - the most general information about the person. This includes text - entry fields of Given name, - Family name, Family prefix - (such as de or van), Suffix (e.g. Jr. or III), - Title (e.g. Dr. or Rev.), - Nickname (Bob for Robert), - Type of the name (birth name, married name, etc.) - and Date and Place of birth - and death. Some of these (Family name, - Type, and both Place fields), - in addition to typing the data in, allow to choose the corresponding - contents from the drop-down menus by clicking on a down-arrow button - located immediately to the right of the text entry field. The - available menu choices are formed from the information already stored - in the database. Also, when you start to type within these fields, - &app; will try to guess the remainder of - the text by using the same choices that are available from the - corresponding menu. To accept the highlighted guess and move to - the next field, press Tab. - - - The Gender radio buttons offers - the choice of person's gender between male, - female, and unknown. - The buttons Source... and - Note... allow to add or modify the data about - the sources of the name information and any notes relevant to it. - Similarly, clicking Edit.. buttons located by the - birth and death Date fields allows to edit the - corresponding events of birth and death. - The field ID displays internal - &app; ID number which identifies user in the - database. Finally, the Image area shows the first - image available in the Gallery of this person. - - - - - - Names - - - -
- Edit Person dialog - Names - - - Shows Names Tab of Edit Person dialog. -
- - - Names tab displays information concerning - alternate names of the person and the controls allowing its - modification. The bottom part displays the list of all alternate names - of the person stored in the database. The top part shows the details - of the currently selected name in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an alternate name record from the database. - Note that Edit... and - Delete buttons become available only when - an alternate name is selected from the list. - - - - - - Events - - - -
- Edit Person dialog - Events - - - Shows Events Tab of Edit Person dialog. -
- - - Events tab displays information about - the events relevant to the person and the controls allowing its - modification. The bottom part displays the list of all such events - stored in the database. The top part shows the details - of the currently selected event in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an event record from the database. - Note that Edit... and - Delete buttons become available only when - an event is selected from the list. - - - - - - Attributes - - - -
- Edit Person dialog - Attributes - - - Shows Attributes Tab of Edit Person dialog. -
- - - Attributes tab displays information about - the attributes of the person and the controls allowing its - modification. These could be any personal attributes of a person whose - description naturally fits into Parameter-Value pairs (e.g. enormous - generosity can be stored as the parameter "Generosity" with the - value "Enormous", etc.). The bottom part displays the list of all - attributes stored in the database. The top part shows the details - of the currently selected attribute in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an attribute record from the database. - Note that Edit... and - Delete buttons become available only when - an attribute is selected from the list. - - - - - - Addresses - - - -
- Edit Person dialog - Addresses - - - Shows Addresses Tab of Edit Person dialog. -
- - - Addresses tab displays information about - the addresses of the person and the controls allowing its - modification. The bottom part displays the list of all - addresses stored in the database. The top part shows the details - of the currently selected address in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an address record from the database. - Note that Edit... and - Delete buttons become available only when - an address is selected from the list. - - - - - - Notes - - - -
- Edit Person dialog - Notes - - - Shows Notes Tab of Edit Person dialog. -
- - - Notes tab displays information about - the notes concerning the person. These could be any notes which do not - naturally fit into the Parameter-Value pairs available to Attributes. - To add a note or modify existing notes simply edit the text in the - text entry field. - - - - - - Gallery - - - - - - - Gallery tab displays information about - media objects associated with the person and the controls allowing its - modification. The central part shows the list of all such media objects. - For media object which are valid image files previews of images are - displayed. For other objects such as audio files, movie files, etc. - generic &app; icon is displayed instead. Note that the first available - image in the gallery will be also displayed in the - Image area in the General - tab. The buttons Add..., - Edit..., and Remove allow - to correspondingly add, modify, and remove a media object reference - to this person. Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. - - - - - - Internet - - - -
- Edit Person dialog - Internet - - - Shows Internet Tab of Edit Person dialog. -
- - - Internet tab displays information about - Internet addresses relevant to the person and the controls - allowing its modification. The bottom part displays the list of all - such Internet addresses stored in the database. The top part shows the - details of the currently selected addresses in the list (if any). - The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove an Internet address - record from the database. The button Go allows - to open a web-page with the corresponding address with your default - browser. Note that Edit..., - Delete, and Go buttons - become available only when an address is selected from the list. - - - - - - LDS - - - -
- Edit Person dialog - LDS - - - Shows LDS Tab of Edit Person dialog. -
- - - LDS tab displays information - about LDS ordinances of the person and the controls allowing its - modification. These are LDS baptism, - Endowment, and Sealed to - parents ordinances, as labeled inside the tab. - Each ordinance is described by its date, LDS temple, and Place where - it happened. An additional pop-up menu Parents is - available for the Sealed to parents ordinance. - Each ordinance can further be described by its status through the - selections available in the Status pop-up - menu and can also be referenced by sources and notes via corresponding - Sources... and Note - buttons. - - - - - - - - - Edit Relationship Data - Editing of relationship data is performed in the following - Marriage/Relationship Editor dialog which appears - after double-clicking on the spouse box in the Family View. - - -
- Marriage/Relationship Editor dialog - - - Shows Marriage/Relationship Editor dialog. -
- - - The top of the window shows the names of the people whose - relationship is being edited. The main part of the window displays - six notebook tabs containing different categories of available - information. You can bring any tab to the top for viewing - or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking OK - at any time will apply all the changes made in all tabs and close the - dialog window. Clicking Cancel at any time will - close the window without applying any changes. If any of the data - in any tab was modified, the alert window will appear with the - choices of closing the dialog without saving changes, canceling the - initial cancel request, or saving the changes. - - - The tabs provide the following information categories of - relationship data: - - - - General - - General tab allows editing of the most general - information about the relationship: the relationship type. - The available types (such as married, partners, etc.) can be chosen - from the drop-down Relationship type menu. - The non-editable field ID displays internal &app; - ID number which identifies this relationship in the database. - - - - - - Events - - Events tab displays information about - the events relevant to the relationship and the controls allowing - its modification. The bottom part displays the list of all such events - stored in the database. The top part shows the details - of the currently selected event in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an event record from the database. - Note that Edit... and - Delete buttons become available only when - an event is selected from the list. - - - - - - Attributes - - Attributes tab displays information about - the attributes of the relationship and the controls allowing its - modification. The bottom part displays the list of all such - attributes stored in the database. The top part shows the details - of the currently selected attribute in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an attribute record from the database. - Note that Edit... and - Delete buttons become available only when - an attribute is selected from the list. - - - - - - Notes - - Notes tab displays information about the - notes concerning the relationship. These could be any notes which do - not naturally fit into the Parameter-Value pairs available to - Attributes. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - Gallery - - Gallery tab displays information about - media objects associated with the person and the controls allowing its - modification. The central part shows the list of all such media objects. - For media object which are valid image files previews of images are - displayed. For other objects such as audio files, movie files, etc. - generic &app; icon is displayed instead. The buttons - Add..., Edit..., - and Remove allow to correspondingly add, modify, - and remove a media object reference to this relationship. - Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. - - - - - - LDS - - LDS tab displays information - about LDS Sealed to spouse ordinance - of the person and the controls allowing its - modification. The data can include date, LDS temple, and Place where - it happened. The ordinance can further be described by its status - through the selections available in the Status - pop-up menu and can also be referenced by sources and notes via - corresponding Sources... and - Note buttons. - - - - - - - - Edit Source Data - To edit source data, switch to the Sources View and select the - desired entry in the list of sources. Double-click on that entry or - click Edit on the toolbar to invoke the - following Source Editor dialog: - - -
- Source Editor dialog - - - Shows Source Editor dialog. -
- - - The top of the window shows the Source Editor - title of the dialog. The main part of the window displays four notebook - tabs containing different categories of available information. You can - bring any tab to the top for viewing or editing by clicking on the - appropriate tab heading. The bottom part has OK - and Cancel buttons. Clicking - OK at any time will apply all the changes made - in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - - The tabs provide the following information categories of - source data: - - - - General - - General tab allows editing of the most general - information about the source: its title, author, and publication - information. This information can be typed in the appropriate - text entry fields. - - - - - - Note - - Note tab displays any notes concerning - the source. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - Gallery - - Gallery tab displays information about - media objects associated with the given source and the controls - allowing its modification. The central part shows the list of all - such media objects. For media object which are valid image files - previews of images are displayed. For other objects such as audio - files, movie files, etc., generic &app; icon is displayed instead. - The buttons Add..., - Edit..., and Remove allow - to correspondingly add, modify, and remove a media object reference - to this source. Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. - - - - - - References - - References tab displays information about - database records that refer to this source. If the source is not - referenced from any database record, the tab shows empty list. - If the source is referenced from many records, the tab will list - all of them. The list can be ordered by any of its column headers: - Source type, Object, or - Value. This information cannot be modified from - the Source Editor dialog. Instead, the - corresponding database record (e.g. birth event) has to be brought - up and its source reference edited. - - - - - - - - - Edit Place Data - To edit place data, switch to the Places View and select the - desired entry in the list of places. Double-click on that entry or - click Edit on the toolbar to invoke the - following Place Editor dialog: - - -
- Place Editor dialog - - - Shows Place Editor dialog. -
- - - The top of the window shows the Place Editor - title of the dialog. The main part of the window displays seven - notebook tabs containing different categories of available information. - You can bring any tab to the top for viewing or editing by clicking on - the appropriate tab heading. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - - The tabs provide the following information categories of - place data: - - - - General - - General tab allows editing of the most general - information about the place: title which labels it in the database, - city, church parish, county, state, country, longitude, and latitude. - This information can be typed in the appropriate text entry fields. - - - - - - Other names - - Other names tab displays information concerning - other names by which the place might be known and the controls - allowing its modification. The bottom part displays the list of all - other names of the place stored in the database. The top part shows - the details of the currently selected name in the list (if any). - The buttons Add..., - Edit..., and Delete allow - to correspondingly add, modify, and remove a name record - from the database. Note that Edit... and - Delete buttons become available only when - a name is selected from the list. - - - - - Note - - Note tab displays any notes concerning - the place. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - Sources - - Sources tab displays information about sources - relevant to this place and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete allow - to correspondingly add, modify, and remove a source reference - to this place. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list. - - - - - Gallery - - Gallery tab displays information about - media objects associated with the given place and the controls - allowing its modification. The central part shows the list of all - such media objects. For media object which are valid image files - previews of images are displayed. For other objects such as audio - files, movie files, etc., generic &app; icon is displayed instead. - The buttons Add..., - Edit..., and Remove allow - to correspondingly add, modify, and remove a media object reference - to this source. Note that Edit... and - Remove buttons become available only when - a media object is selected from the list. - - - - - - Internet - - Internet tab displays information about - Internet addresses relevant to the place and the controls - allowing its modification. The bottom part displays the list of all - such Internet addresses stored in the database. The top part shows the - details of the currently selected addresses in the list (if any). - The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove an Internet address - record from the database. The button Go allows - to open a web-page with the corresponding address with your default - browser. Note that Edit..., - Delete, and Go buttons - become available only when an address is selected from the list. - - - - - - References - - References tab displays information about - database records that refer to this place. If the place is not - referenced from any database record, the tab shows empty list. - If the place is referenced from many records, the tab will list - all of them. This information cannot be modified from - the Place Editor dialog. Instead, the - corresponding database record (e.g. birth event) has to be brought - up and its place reference edited. - - - - - - - - Edit Media Data - To edit media data, switch to the Media View and select the - desired entry in the list of sources. Double-click on that entry or - click Edit on the toolbar to invoke the - following Edit Media Properties dialog: - - -
- Edit Media Properties dialog - - - Shows Edit Media Properties dialog. -
- - - The top of the window shows the dialog title. Below the title - is the preview of an object and the summary of its properties (ID, - path, and object type). The central part of the window displays four - notebook tabs containing different categories of available information. - You can bring any tab to the top for viewing or editing by clicking on - the appropriate tab heading. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - - The tabs provide the following information categories of - media object data: - - - - General - - General tab allows to edit the title which labels - this object in the database. The title can be typed in the appropriate - text entry field. If the object is not local (i.e. the corresponding - file does not reside under &app; database directory), the - Make a local copy button is available. - Click it to copy the media into &app; database directory. This will - increase the amount of disk space consumed by &app; database. However, - if the external file is deleted or removed, &app; will still be able - to use the local copy. - - - - - Attributes - - Attributes tab displays information about - the attributes of the media object and the controls allowing its - modification. The bottom part displays the list of all such - attributes stored in the database. The top part shows the details - of the currently selected attribute in the list (if any). The buttons - Add..., Edit..., - and Delete allow to correspondingly add, - modify, and remove an attribute record from the database. - Note that Edit... and - Delete buttons become available only when - an attribute is selected from the list. - - - - - Notes - - Notes tab displays information about the - notes concerning the media object. These could be any notes which do - not naturally fit into the Parameter-Value pairs available to - Attributes. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - References - - References tab displays information about - database records that refer to this media object. If the object is not - referenced from any database record, the tab shows empty list. - If the object is referenced from many records, the tab will list - all of them. The list can be ordered by any of its column headers: - Type, Object, or - Value. This information cannot be modified from - the Media Object Properties Editor dialog. - Instead, the corresponding database record (e.g. birth event) has to - be brought up and its media object reference edited in the gallery - tab. - - - - - - - - Edit Events - Events are edited through the following Event - Editor dialog: - - -
- Event Editor dialog - - - Shows Event Editor dialog. -
- - - The top of the window shows the dialog title including the name - of the person whose event is being edited. The central part of the - window displays four notebook tabs containing different categories of - available information. You can bring any tab to the top for viewing or - editing by clicking on the appropriate tab heading. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - The tabs provide the following information categories of - the event data: - - - General - - General tab allows editing of the most general - information about the event: its type, date, place, cause, and - description. The type can be selected from available types listed - in the Event type drop-down menu. The rest - of the information can be typed in the appropriate text entry fields. - Check the Private record box to mark this event - record as private. This will give you a chance to omit this event from - being included in the reports, if you choose so among the report - generation options. - - - - - Sources - - Sources tab displays information about sources - relevant to this event and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this event. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list. - - - - - Note - - Note tab displays any notes concerning - the event. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - Witnesses - - Witnesses tab displays information about witnesses - relevant to this event and the controls allowing its modification. - The central part displays the list of all such witnesses - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a witness reference - to this event. Note that Edit... and - Delete buttons become available only when - a witness reference is selected from the list. - - - - - - - - Edit Source Information - When adding source references to events, places, etc., - the following dialog appears: - - -
- Source Information dialog - - - Shows Source Information dialog. -
- - - The top of the window shows the dialog title. The central part - displays the source information. The bottom part has - OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - The source can be selected from available sources listed in the - Title drop-down menu. If the source you are - referencing is not present in the database yet, you can enter it into - the database. To do this, click New... button - and enter source information into the invoked Source - Editor dialog. You can also set the details specific for - this particular reference: confidence, volume/file/page. date, text, - and comments. Choose the confidence - level from the Confidence drop-down menu. - The rest of the details can be typed in the appropriate text entry - fields. - - - - - - Edit Alternate Names - Alternate names are edited through the following - Alternate Names Editor dialog: - - -
- Alternate Names Editor dialog - - - Shows Alternate Names Editor dialog. -
- - - The top of the window shows the dialog title including the name - of the person whose alternate name is being edited. The central part - of the window displays three notebook tabs containing different - categories of available information. You can bring any tab to the - top for viewing or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - The tabs provide the following information categories of - the alternate name data: - - - General - - General tab allows editing of the most general - information about the alternate name: given name, family name, family - prefix, suffix, title, and type of the name. The information can be - typed in the appropriate text entry fields. The family name and the - type can be also selected from available choices listed in the - appropriate drop-down menus. - Check the Private record box to mark this name - record as private. This will give you a chance to omit this name from - being included in the reports, if you choose so among the report - generation options. - - - - - Sources - - Sources tab displays information about sources - relevant to this name and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this name. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list. - - - - - Note - - Note tab displays any notes concerning - the name. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - - - - Edit Attributes - Attributes are edited through the following - Attribute Editor dialog: - - -
- Attribute Editor dialog - - - Shows Attribute Editor dialog. -
- - - The top of the window shows the dialog title including the name - of the person whose attribute is being edited. The central part - of the window displays three notebook tabs containing different - categories of available information. You can bring any tab to the - top for viewing or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - The tabs provide the following information categories of - the attribute data: - - - General - - General tab allows editing of the most general - information about the attribute: name of the attribute and its value. - The information can be typed in the appropriate text entry fields. - The attribute name can also be selected from available choices (if any) - listed in the Attribute drop-down menu. - Check the Private record box to mark this - attribute record as private. This will give you a chance to omit - this attribute from being included in the reports, if you choose - so among the report generation options. - - - - - Sources - - Sources tab displays information about sources - relevant to this attribute and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this attribute . Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list. - - - - - Note - - Note tab displays any notes concerning - the attribute . To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - - - Edit Addresses - Addresses are edited through the following - Address Editor dialog: - - -
- Address Editor dialog - - - Shows Address Editor dialog. -
- - - The top of the window shows the dialog title including the name - of the person whose address is being edited. The central part - of the window displays three notebook tabs containing different - categories of available information. You can bring any tab to the - top for viewing or editing by clicking on the appropriate tab heading. - The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without - applying any changes. If any of the data in any tab was modified, - the alert window will appear with the choices of closing the dialog - without saving changes, canceling the initial cancel request, or saving - the changes. - - The tabs provide the following information categories of - the address data: - - - General - - General tab allows editing of the most general - information about the address: date, street address, city or county, - state or province, country, and the postal code. The information can - be typed in the appropriate text entry fields. - Check the Private record box to mark this address - record as private. This will give you a chance to omit this address - from being included in the reports, if you choose so among the report - generation options. - - - - - Sources - - Sources tab displays information about sources - relevant to this address and the controls allowing its modification. - The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete - allow to correspondingly add, modify, and remove a source reference - to this address. Note that Edit... and - Delete buttons become available only when - a source reference is selected from the list. - - - - - Note - - Note tab displays any notes concerning - the address. To add a note or modify existing notes simply edit the - text in the text entry field. - - - - - - - - - Edit Witnesses - Witnesses are edited through the following - Witness Editor dialog: - - -
- Witness Editor dialog - - - Shows Witness Editor dialog. -
- - - The top of the window shows the dialog title. The central part - of the window displays information about the witness. The bottom part - has OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made and close the dialog window. Clicking - Cancel at any time will close the window - without applying any changes. If any of the data was - modified, the alert window will appear with the choices of closing - the dialog without saving changes, canceling the initial cancel - request, or saving the changes. - - The witness name can be entered in two ways, depending on - whether the witness is a person already stored in the database or - not (unrelated person). - - - Person from the database - - If the person's data are stored in a database, click Person - is in the database box. Then ... - -[ FIXME: Need Don to decide which way this will eventually be implemented. ] - - - - - - - Unrelated person - - If the person is not in the database, make sure that - Person is in the database box is unchecked. - Then enter the name or any description of a person into the - Person text entry field. This information - is stored as entered, and this is the only place it is stored in. - In other words, there is no reference to that person in the entire - database except for this witness reference. If the person is in fact - a member of the database, it is advised to user the former method. - - - - - The Comment text area allows to enter - any comments concerning the witness. To add a comment or to modify - existing comments simply edit the text in the text area. - - - - - - - - - Navigation - As long as any database is open, - &app; is focused on a - single person usually referred to as an Active person. This - allows you to view or modify the data concerning this person, - his or her immediate family, etc. Navigating in the database (i.e. - moving from person to person) is in fact nothing else but changing - the Active person. This section describes many alternative ways - to navigate through the database using complex and convenient - interface &app; provides. All these ways - eventually accomplish the same thing, but some are more convenient - than others, depending what you are doing in - &app; at the moment. - - - - Using People View - The most intuitive way to select an active person is - to use the People View. When in the People View, just select the - name of the desired person from the list by clicking that list - entry. The person you have selected becomes active. The statusbar - updates to reflect the change of the active person. - - - - - Using Family View - When in the Family View, you can easily navigate between the - members of the displayed family as follows: - - - To make currently selected spouse the active person, - click double-arrow button to the right of the active person box. - - - To make currently selected parents the active family - (thereby making father the active person and mother the selected - spouse), click right-arrow button to the right of the active person's - parents box. - - To make currently selected spouse's parents - the active family (thereby making father the active person and mother - the selected spouse), click right-arrow button to the right of the - spouse's parents box. - - To make currently selected child the active person, - click left-arrow button to the right of the children box. - - - - - - - - Using Pedigree View - Pedigree View also allows you to move along the family tree. - The benefits of this method is that you can see more than one - generation of the family tree. Also, you can jump directly from a - great-grandson to a great-grandfather without going through the - intermediate generations. - - Note that after changing the active person in the Pedigree - View, the display is re-adjusted to show four generations, starting - from a newly selected Active person. When in the Pedigree View, you - can easily navigate between the members of the displayed family tree - as follows: - - - To make any displayed person the active person, - double click the line that connects to the left side of the - corresponding box. - - To make a child of currently active person (if any) - the active person, click the left arrow button to the left of the - corresponding box. If there is more than one child, the button expands - to the menu listing the children to choose from. - - To move the whole family tree one generation back, - click on the corresponding right arrow button on the right-hand side - of the display area. Clicking the upper button will move the tree - along the paternal line. Clicking the lower button will move the - tree along the maternal line. - - Clicking either of these buttons is completely equivalent to - double-clicking the lines connecting to the left of the corresponding - boxes for father and mother. - - - - - - - Setting Default Person - One and only one person in the database can be selected as the - default person. Once the default person is selected, moving to that - person becomes a matter of a single click, regardless of which view - you are using at the moment. - - To set the default person, first navigate to that person using - any method you like. Then choose - Settings - Default Person. Once this is - done, you can move to the default person from anywhere in the - database by simply clicking Home on the - toolbar. - - - - - - Bookmarking People - Similarly to the default person, you can bookmark other people - from the database to simplify further navigation. To bookmark a person, - first navigate to that person, then choose - Bookmarks - Add bookmark. To move to that - person from anywhere in the database, choose - Bookmarks - Go to bookmark - Person's name - . - - You can manage your bookmarks by choosing - Bookmarks - Edit bookmarks. This opens - the followingEdit Bookmarks dialog with the - list of bookmarks and the controls to modify this list. - - -
- Edit Bookmarks dialog - - - Shows Edit Bookmarks dialog. -
- - - - - - - - - Generating Reports - Reports are the most common form of the output produced by - genealogical research. Majority of genealogical software puts a lot - of emphasis on developing nicely looking reports. &app; is no - exception in this regard: it offers a variety of reports to choose - from. &app; can generate reports in a multitude of open formats, both - text based and graphical. &app; can also produce screen based reports - that are convenient for viewing the summary of your database. - Finally, &app; can generate a web-site suitable for immediate - posting on the Internet. All these are almost infinitely flexible: - you get to design and choose the style for your reports. - - All reports can be accessed through the menu by choosing - Reports - Report Type - Particular - Report. Alternatively, - you can browse the complete selection of available reports along - with their brief descriptions in a Report - Selection dialog evoked by clicking - Reports on the toolbar. - - - - - Graphical Reports - Graphical reports represent information in forms of charts - and graphs. Most of the options are common among graphical reports, - therefore they will be described only once, at the end of this - section. Few options specific to the given report will be - described directly in that report's entry. - - The following graphical reports are currently - available in &app;: - - - - Timeline Graph - This report outputs the list of people with their - lifetimes represented by intervals on a common chronological scale. - Specific options include filter, sorting method, and the title of - the report. - - - Relationship Graph - This report creates complex relationship graph in - GraphViz format. The GraphViz dot tool can - transform the graph into postscript, jpeg, png, vrml, svg, and many - other formats. GraphViz tools are freely available from - GraphViz - site. Specific options include filter for this report - include filter and number of generations considered, as well as - several GraphViz specific options related to pagination, color, - and details of the graph. - - - Descendant Graph - This report generates the graph of people who are - descendants of a currently active person. Specific options include - the format of the displayed entries. - - - Ancestor Chart - This report generates the chart of people who are - ancestors of a currently active person. Specific options include - the number of generations considered and the format of the displayed - entries. - - - - - Common options for graphical reports are the filename of the - output, the format of the output, selected style, and page size and - orientation. - - - - - - Text Reports - Text reports represent the desired information as formatted - text. Most of the options are common among text reports, - therefore they will be described only once, at the end of this - section. Few options specific to the given report will be - described directly in that report's entry. - - The following text reports are currently - available in &app;: - - - - Individual Summary - This report produces a detailed summary on the - active person. The report includes all the facts known to the - database about that person. - - - Family Group Report - This creates a family group report, showing - information on a set of parents and their children. Specific - options: the spouse (available only if the active person has more - than one spouse). - - - Detailed Descendant Report - This report covers in detail the descendants of the - active person. It includes vital (birth and death) as well as - marriages. Specific options: number of forward generations - to consider. - - - Detailed Ancestral Report - This report covers in detail the ancestors of the - active person. It includes vital data (birth and death) as well as - marriages. Specific options: number of backward generations - to consider, as well as a variety of options on what exactly - contents to include. - - - Descendant Report - This report produces brief description - of descendants of the active person. Specific options: number - of forward generations to consider. - - - Complete Individual Report - This report provides individual summaries similar to - that of the Individual Summary report. The advantage of this report - is the specific filter option. Depending on the filter choice (active - person only, his or her descendants, his or her ancestors, or entire - database), the report may contain from one to many individual - summaries. Another option for this report is the inclusion of - source information when listing events. - - - Ahnentafel Report - This report lists the active person and his or her - ancestors along with their vital data. The people are numbered in a - special way which is an established standard called Ahnentafel. - The active person is given number 1. His or her father and mother - have numbers 2 and 3, respectively. This rule holds for every person - while going back in generations: father's parents are numbered 4 and 5, - and mother's parents are numbered 6 and 7, fathers always numbered - with even and mothers with odd numbers. Therefore, for any person - having number N in this tree, the numbers of father and mother - are 2N and 2N+1, respectively. - - - - - - Common options for text reports are the filename of the - output, the format of the output, selected style, and page size and - orientation. For HTML reports, there is no page information. - Instead, HTML options include the choice of the HTML template, - either available in &app; or a custom template defined by you. - - - - - - View - View reports represent overall summaries of the database - information available immediately for on-screen viewing. - The following view reports are currently available in &app;: - - - - Number of ancestors - This report displays the number of ancestors of the - active person. - - - Summary of the database - This report displays the overall statistics concerning - number of individuals of each gender, various incomplete entries - statistics, as well as family and media statistics. - - - - - - - - Web Page - - This report generates web pages, either for a selected - individual (active person) or a set of individuals. The options - for this report are broken down into contents, privacy, and advanced - options. The contents options include the filter (determine the - scope of the database to consider), number of generations to consider, - destination directory for the images, and a link to the index page. - Privacy options allow you to omit private records, restrict - information on living people, to skip images (either all or those of - living people), and to omit comments and text in source information. - Finally, the advanced options allow to include optional &app; ID, - create a GENDEX index, and specify the extension of the resulting - files. - - - - - - - - Running Tools - &app; tools allow you to perform various types of analyses - of your genealogical data. Typically, the tools do not produce - output in form of printouts or files. Instead, they produce screen - output immediately available for the researcher. However, when - appropriate, you can save the result of running a tool into a file. - Tools present one of the major strengths of &app; compared to the most - genealogical software. - - The tools can be accessed through the menu by choosing - Tools - Tool Section - Particular - Tool. Alternatively, - you can browse the complete selection of available tools along - with their brief descriptions in a Tool - Selection dialog evoked by clicking - Tools on the toolbar. - - - - Analysis and Exploration - This section contains tools which analyze and explore the - database, but do not alter it. The following analysis and exploration - tools are currently available in &app;: - - - - Compare individual events - This tool compares events across the selected group of - people. The people for this comparison are chosen with the use of - custom filters. The custom filters can be created in the Custom Filter - Editor (see ). The resulting table produced - by this tool can be saved as a spreadsheet. - - - Interactive descendant browser - This tool builds a tree with the active person being - the root. Children branch from their parents in a usual manner. - Use this tool for a quick glance on a person's descendants. - - - - - - - - - Database Processing - This section contains tools which may modify your database. - The modifications will only be performed upon your explicit consent. - The tools from this section are used most for finding and correcting - errors in the data. The following database processing tools are - currently available in &app;: - - - - Check and repair database - This tool checks the database for integrity problems, - fixing the problems it can. - - - - Extract information from names - This tool searches the entire database and attempts - to extract titles and nicknames that may be embedded in a person's - given name field. - - - - Find possible duplicate people - This tool searches the entire database, looking - for the entries that may represent the same person. - - - - Rename personal event types - This tool allows all the events of a certain name - to be renamed to a new name. - - - - Reorder &app; IDs - This tool reorders the &app; IDs according to the - defaults of &app;. - - - - - - - - - - Utilities - - - This section contains tools allowing to perform a simple - operation on a portion of data. The results can be saved in your - database, but they will not modify your existing data. - The following utilities are currently available in &app;: - - - - Custom Filter Editor - The Custom Filter Editor builds custom filters - that can be used to select people included in reports, exports, - and other tools and utilities. This is in fact a very powerful tool - in genealogical analysis. - - When you launch it, the User defined filters - dialog appears that lists all the filters (if any) previously defined - by you. Click Add... to define a new filter. - Once you have designed your filters, you can edit, test, and delete - selected filters using Edit..., - Test..., and Delete... - buttons, respectively. All the filters displayed in the list will be - automatically saved along with your database and will be available - upon the future runs of &app;. - - Clicking Add... invokes the - following Define filter dialog: - - -
- Define filter dialog - - - Shows Define filter dialog. -
- - - Type the name for your - new filter into the Name field. Enter any - comment that would help you identify this filter in the future - into the Comment field. Add as many rules as you - would like to your filter using Add... button. - Check Invert box to negate the filter rule - (e.g. inverting "has a common ancestor with I1" rule will match - everyone who does not have a common ancestor with that person). - If the filter has more than one rule, choose whether all of them - must apply, only one (either) rule must apply, or exactly one (either) - rule must apply, in order for the filter to generate a match. - - Note that the filters you already designed may be used as a rule - for another filter. This gives you nearly infinite flexibility in - custom-tailoring your selection criteria that can be later used in - most of the exports, reports and some of the tools (such as comparing - individual events). - - - Generate SoundEx codes - This utility generates SoundEx codes for the names of - people in the database. - - - - Relationship calculator - This utility calculates the relationship between - two people from the database. - - - - Verify the database - This utility allows you to verify the database based - on the set of criteria specified by you. - - - - - - - - - - - - - - - Settings - To configure &app;, choose - Settings - Preferences. - The Preferences dialog contains the following - categories: - - - - - - - - - - Usage - This category contains preferences relevant to the - general usage of &app;. It has the following subcategories: - - - - Find - - - - Enable autocompletion - If this box is checked, &app; will attempt to complete - the text as you type it into text entry fields such as family name, - place of birth, etc. Completion is attempted based on the match - between the beginning of the text being typed and the corresponding - data already stored in the database. - - - - - - - - - - Report Preferences - - - - Preferred text format - Select the preferred format for text reports - from the available formats listed in this menu. - - - - Preferred graphical format - Select the preferred format for graphical reports - from the available formats listed in this menu. - - - - Preferred paper size - Select the preferred paper size used for reports - from the available sizes listed in this menu. - - - - Default report directory - Choose the default directory for the reports using - Browse... button or type it in the text entry - field. - - - Default web site directory - Choose the default directory for the web site using - Browse... button or type it in the text entry - field. - - - - - - - - - Researcher Information - - - - Researcher information - Enter your personal information in the corresponding - text entry fields. Although GRAMPS requests information about you, - this information is used only so that it can create valid GEDCOM - output files. A valid GEDCOM file requires information about the files - creator. If you choose, you may leave the information empty, however - all the GEDCOM files you export will not be valid. - - - - - - - - - - Data Guessing - - - - Surname guessing - This option is not currently implemented. - - - - - - - - - - - - Display - This category contains preferences relevant to - displaying database records and controls in &app;. - It has the following subcategories: - - - - General - - - - Always display the LDS ordinance tabs - Check this box to have LDS ordinance tabs displayed. - If you do not know what LDS is then you probably should not check it. - - - - Show index numbers in child list - - This option is not currently implemented. - - - - - - - - - Dates and Calendar - - - - Display: Date format - Select the display format for the dates - from the available formats listed in this menu. - - - - Name format - Select the display format for the names - from the available formats listed in this menu. - - - - Entry: Date format - Select the entry format for the dates - from the available formats listed in this menu. - - - - Show calendar format selection menu - Check this box to enable calendar format selection - menu when you are entering dates in the Event - Editor dialog. - - - - - - - - - Tool and Status Bars - - - Toolbar - Select the desired appearance of the toolbar icons - using the radio buttons. - - - - Status bar - Select the desired contents displayed in the - statusbar using the radio buttons. - - - - - - - - - - - Database - This category contains preferences relevant to the - database itself. It has the following subcategories: - - - - General - - - - Automatically load last database - Check this box to automatically load the last open - database on startup. - - - Do not compress XML data file - Check this box to disable compression of the XML - data file. Compression significantly reduces the file size. - - - - Capitalize surnames - Check this box to capitalize surnames entered into the - database. - - - Autosave interval - Set the interval (in minutes) after which &app; will - automatically save your database. Zero interval completely disables - autosave. - - - Default database directory - Choose the default directory in which &app; starts - looking when saving the database using Browse.. - or type its path into the text entry field. - - - - - - - - Media Objects - - - - Drag and drop from an external source - Choose between a reference and a local copy made when - the object is dropped into the gallery. The reference saves disk - space as it does not copy the object. The local copy makes your - database portable as it does not depend on an external file. Consult - your need to make best choice. - - Check Display global properties editor when object is - dropped box to invoke global properties editor after you - drop an external object into the gallery. - - - - Drag and drop from an internal source - Check Display local properties editor when - object is dropped box to invoke local properties editor - after you drop an internal object into the gallery. - - - - - - - - - &app; internal IDs - - - - GRAMPS ID prefixes - Enter ID prefixes for various kinds of database - entries into the corresponding text entry fields. - - - - Allow internal GRAMPS ID numbers to be - edited - Check this box to enable editing of the internal &app; - ID numbers. Unless you know what you are doing, leave it unchecked. - - - - - - - - - Revision Control - - - - Use revision control - Check this box to enable &app; to use revision control - system for your database. If you choose this option, select the - particular revision control system from the menu. - - - - Prompt for comment on save - Check this box to instruct &app; to prompt you to enter - the comment when you save the database. - - - - - - - - - - - - - - - - - About &app; - &app; was written by Donald N. Allingham - (dallingham@users.sourceforge.net). - To find more information about &app;, please visit the - GRAMPS Project - Web page. - - To report a bug or make a suggestion regarding this application or - this manual, follow the directions in this - document. - - - This program is distributed under the terms of the GNU - General Public license as published by the Free Software - Foundation; either version 2 of the License, or (at your option) - any later version. A copy of this license can be found at this - link, or in the file - COPYING included with the source code of this program. - - -
diff --git a/gramps2/doc/gramps-manual/C/index.html b/gramps2/doc/gramps-manual/C/index.html deleted file mode 100644 index 0e1d66245..000000000 --- a/gramps2/doc/gramps-manual/C/index.html +++ /dev/null @@ -1,222 +0,0 @@ - -GRAMPS User Manual

GRAMPS User Manual

Copyright © 2001 by Donald N. Allingham

Table of Contents
Introduction
Running GRAMPS for the first time.
Getting Started
People View
Editing a person's data
- - - - - - -

Introduction

-

GRAMPS is an acronym for the - Genealogical Research and Analysis Management Programming System. - It was conceived under the concept that most genealogy programs - were designed to provide the researcher the capability to input - information related to a particular family tree. Most of these - programs have allowed for the arranging and storing of information - consistent with the GEDCOM standards. They usually provide a - means for displaying descendant or ancestral relationships by - means of graphical displays, charts, or reports. These may be - augmented with pictures or other media to enhance the data. Most - provide for inputting data on unconnected individuals/families - that may or may not have a relationship to the primary surname - being researched. Various other enhancements may also be provided - in the genealogical program that allows for different degrees of - importing and exporting data from other programs and printing of - the data contained in the various reports. GRAMPS, on the other - hand, attempts to provide all of the common capabilities of these - programs, but, more importantly, to provide a capability not - common to these programs. This is the ability to input any bits - and pieces of information directly into GRAMPS and - rearrange/manipulate any/all data events in the entire data base - (in any order or sequence) to assist the user in doing research, - analysis and correlation with the potential of filling - relationship gaps. In short, a tool that provides a way to input - all your research into one place and do your analysis and - correlation using the speed, power, and accuracy of your computer - instead of pencils and unmanageable reams of paper. -

-

To run GRAMPS, select - ->Programs+ -+ ->Applications+ -+ ->gramps+ -+ + + + + + - from the Main Menu, or type - gramps on the command line. -

-

This document describes version 0.7.3 of - GRAMPS. -

-
- - - - - - - - - - - -
  Next >>>
  Running GRAMPS for the first time.
\ No newline at end of file