Skip to main content

Gedcom editor

The Gedcom editor is one of the three main editors of Ancestris.

en-gedcom.png

The philosophy of the Gedcom editor comes from the will to be transparent and to be based on the way the Gedcom standard structures genealogical information.

Information transparency where the user sees 100% of the information stored in his genealogy, which makes it easy to store and control all of the data.

Willingness to comply 100% with the Gedcom standard for a better sustainability of ones work

The advantage is to have all the information for any entity in a structured form.

While both the Aries and Cygnus editors are visual and graphical, the Gedcom editor displays information in a text mode. This can be confusing for a beginner but it provides a lot of trust later on. This is because the Gedcom editor directly manipulates the hierarchical organization of the different entities in the Gedcom file using Gedcom labels and syntax.

It gives access to all the possibilities of the standard.

It displays only one entity at a time, from any category (individual, family, source, etc.). It allows you to modify the current entity (individual, family, etc.) as precisely as possible.

This makes it extremely simple to use, but requires time to adapt.

There is a solution for everyone, and Ancestris users often choose to use two main editors: Cygnus + Gedcom, or Aries + Gedcom. Some prefer to use only the Gedcom editor. Here is a comparison of the 3 editors if you still had to make a choice.

  Cygnus Gedcom Aries
Focus The individual and his close environment The Gedcom standard

Completeness of
information

Ease of use ++ +++ +
Ergonomics +++ + +++
Coverage of needs 80% 100% 100%
Data Transparency + +++ ++
Efficiency +++ + +
Editable Gedcom entities Many All All
Compliance with Gedcom standard 100% 100% 100%

 

Description

The Gedcom editor is divided horizontally into two areas.

  • The upper area displays the tree structure of the different properties of the currently selected entity and allows you to select one of them.
  • The lower area displays the details of the property selected in the upper zone, for consultation or edition.

At the top of the editor there is a specific toolbar.

 

Property Tree

The upper area displays a succession of lines, each of which corresponds to a property.

These different lines are organized in a tree-like manner: properties can depend on a superior property to describe its characteristics.

Tree structure

In accordance with the Gedcom standard, the entity's main line is placed at the top of the list. It displays the reference containing its ID number, and the label corresponding to the category. All other lines depend on this main line.

It is imperative to make sure that each line keeps its place in the tree structure because each line:

  • qualifies its higher level line. Example: birth qualifies an individual, date of birth qualifies a birth.
  • potentially carries lower level lines. Example: birth is described by a date and a place.
  • is in a particular order in relation to other lines of the same level and the same higher line. Example: the order of children for a family.

Horizontal and vertical scrollbars are displayed when necessary. However, in order to facilitate reading without having to use them, the tree structure is equipped with flaps allowing to show or hide certain properties.  It goes without saying that hiding a line also hides the lines hierarchically below it.

Property Icons

For a better visibility, each beginning of a line in the tree displays the icon corresponding to the label associated with this line. Then follow the tag itself and its value.

If the icon has a navigation indicator like this : entitelink.jpg, i.e. a small white square containing a short arrow pointing to the upper left corner, this means that the property is a link to another entity, and it can be double-clicked to display the related entity (individual, family, source, etc.).

For more details on the different icons associated with the properties, see the Tags page.

Italic properties

Some properties may appear in italic. These are properties that are not actually in the Gedcom file but are inferred when Ancestris opens the genealogy.

Example : you can see below that the GIVN label for the first name, and the SURN label for the last name, are in italic. They do not exist in the Gedcom file, but Ancestris derived them from the NAME label, which is in the Gedcom file.

en-italic_properties.png

Unknown or misplaced properties

When the icon is a question mark, questionmark.jpgit means that the label of the property is unknown or misplaced in the tree structure, according to the Gedcom standard.

Invalid properties

When the icon is an warning sign warning.jpg, it means that the value of the property is not valid, in accordance with the Gedcom standard.

Anomalies are detected from criteria defined in the Ancestris preferences, Extension pane, Validation tab are only visible from the Cygnus editor.

In the following example, the date and place of death are invalid because their values are empty. Indeed, in the Gedcom standard, a line with a label cannot be without a value.

anomalie.jpg

Getting information on a property

When hovering over a line with the mouse, a tooltip appears describing what the property is used for.

In the following example, hovering over the line PLAC Brookline, , Norfolk displays this:

en-gedcom-information.png

Details of the selected property

The lower area displays the details for viewing or changing the values of the property selected in the upper area.

It can display several elements:

  • The description of the entity, via the blueprint corresponding to the type of entity
  • The events of the individual's name to be entered on several fields
  • A value to be entered for the type of event where it applies
  • A date
  • A small text to enter for a note
  • The gender of an individual to be indicated among a given choice
  • A multimedia file
  • Etc.

The first line in the details area of the selected property is the name of this property, the tag name.

For example here, the property birth:

en-gedcom-birth-detail.png

When the selected property is a link to another entity, this first line is actually a button, as here for a link to its parents:

en-gedcom-family-detail.png

In this case, a click on the button selects the property in the related entity, the child in the parents' family in the example above.

A double-click in the lower area has the same effect.

 

Toolbar

en-gedcom-title.png

The toolbar has a "handle" on the left hand side which allows to move it, and to put it in vertical or horizontal position, on one of the sides of the window.

Then there is a pin button that can be in the raised or pressed position. This freezes the editor on the displayed entity when another entity is selected elsewhere in Ancestris.

The next button is the cursor button:

  • When it is pressed, the selection of another entity or property in Ancestris will force the focus on the relevant input field in the property detail panel of the Gedcom editor. 
    Example: pressing the TAB key to select the name (NAME) will place the cursor on the last name field in the details panel. Also, clicking the name field in the table view will do the same. Clicking a date in the table view will place the cursor in the first field of the date in the details panel.
    In this case, it is possible to move from fields to fields with the TAB key in the tree view of the Gedcom editor.
  • Conversely, if the cursor button is not pressed, when selecting a property, the focus remains on the entity clicked, or the property clicked in the tree view of the Gedcom editor. It is then possible to move with the up and down keys of the keyboard.
    In this case, it is possible to move in the table view from one entity to the next using the arrow keys as well.

Then the toolbar displays the full name of the selected individual.

 

Usage

The main usage of the Gedcom editor is to visualise the entity data and to change it: you can select, navigate, add, move, copy or delete a property.

The actions to be carried out in the property details area at the bottom depend on the selected property: enter a place, date, simple value, etc. or modify the display blueprint of the entity.

Selection of a property

The selection of a property line is done naturally by clicking on it.

The lower area instantly displays the details of the selected property, with a view to edit it, or simply to visualize it.

Navigation to another entity

A navigation is possible in the Gedcom editor.

When a property line has a navigation icon entitelink.jpg, a double-click on this line displays in the entity related to that property.

To return to the display of the previous entity, you can use the navigation arrows in the toolbar.

Adding a property

Adding a property can be done using the Context Menu, action Add Property, and selecting the label in the sub-menu that appears. The right click must be made on the line which is up one level in the hierarchically, so that the new entity will be attached to it.

When the sub-menu does not contain the property you are looking for, it is probably because it is not allowed there.

Some sub-properties are automatically added. When you need a sub-property, you have to redo the manipulation with a right click on the corresponding property.

Once a property has been added, its fields must be filled in with the appropriate information.

Multimedia file - Add a media property using drag and drop

It is possible to add a Media property directly from the file explorer of your computer through drag-and-drop.
It is actually possible to drag-and-drop a media from other software too (e.g. digiKam, etc)

To do this, simply drag and drop the file from the file explorer to the Gedcom Editor tree. You see below the black line just before releasing the mouse. Once the click is released, the property file.jpg will be added as a sub-property of obje.jpg.

en-gedcom-drag-n-drop-photo.png

Multimedia file - External disk

Whatever your system, if you use drag and drop above, you should see how to specify the name of an external file.

On Windows, it is also possible to write the file with 3 slashes as follows: file:///E:\images\image.jpg where E is the external drive.

On Linux, it is enough to indicate the name of the disk as it is mounted on your system, which may vary from one distribution to another. For example :

en-gedcom-external-file.png

Multimedia file - Internet link

You just have to indicate the classic URL of the file:  https://www.siteweb.com/images/image.jpg.

Multimedia file - Local and found

Ancestris helps you quickly identify is a file is local and if it exists on disk. Two user defined tags are used for this

  • _LOCAL is '1' if file is local, '0' otherwise.
  • _FOUND is '1' if local file exists on disk or is file is remote, '0' if local file is not found.

These values are read only and are updated when the Gedcom file is opening and when the FILE property is edited or checked for validation.

 

Moving or copying a property

Classically, moving and copying a property is obtained via the Context Menu, whose right click must be made on the line concerned by the current processing, or by Drag&Drop.

Through the context menu

  • To move a property, command Cut, then command Paste, with a new right click on the line to receive the moved property.
  • To copy a property, command Copy, then command Paste, with a new right click on the line to receive the copied property.

By Drag / Drop

en-gedcom-move-property.png

Order of children, and properties in general

You can order the children in the desired order this way. Ancestris will keep the order displayed in the file.

This method applies to the order of all properties.

Deleting a property

To delete a property line, right-click on the line to be deleted and choose Delete the selected properties. As usual, a confirmation window is displayed before the command is executed.

It is obvious that the deletion of a line also deletes the lines hierarchically placed below this line.

Confirming an entry and saving the genealogy

Changes made in the lower part of the window need to be confirmed in order to be saved.

As soon as a piece of information is modified, the following buttons appear at the bottom right of the editor. Simply click OK to validate, or Cancel to cancel: 

okcancel.jpg

These buttons may not appear. This is the case for users who prefer to automate this confirmation when navigating to another entity. This is a setting in the Preferences, Edit pane and in the Editor section.

en-gedcom-confirm.png

Warning: in both cases, with or without clicking OK, your changes are not yet saved in your file on disk. But if you try to quit Ancestris, it will warn you and ask you to save all your changes.

Modification of a place

When you want to modify a place selected in the properties of the Gedcom Editor, there are two ways to enter or modify this place. This display mode is chosen in the Preferences, Editor pane, in the section concerning places.

  • Display all places jurisdictions on a single line:

en-gedcom-place-one-line.png

  • Display the place with one jurisdictions per line:

en-gedcom-place-multiple-lines.png

Auto-complete

As you can see above, for each field it is possible to display the list of values already entered by using the drop-down list.

The other possibility is to start typing a place name, and Ancestris will offer you all the places starting with these first entered characters. This is called "auto-complete". This makes sure the same places get spelt the same way and it saves typing time.

You can also see why displaying on a single line can be more efficient. It then allows you to enter all the jurisdictions of the place in one go.

Global change of all identical places

It is sometimes necessary to apply a place correction to all identical places.

The Gedcom Editor not only tells you how many places are identical, it also lets you spread a correction to all the others at the same time.

To do this, check the box below the place fields:

en-gedcom-place-multiple-lines-replicate.png

The confirmation window asks you to confirm.

en-gedcom-place-confirm.png

Then validate your modification by clicking on Yes.

 

Modification of the display of entities

When the entity first line is selected in the upper part, the one with the identification number, the corresponding blueprint is displayed in the lower part.

To change this blueprint, just right-click on the current blueprint and choose "Change display". Here is the part of the window corresponding to the change of the display in the Gedcom Editor for all individuals.

en-gedcom-change-blueprint.png

The Blueprint window appears. Follow the instructions in the corresponding blueprint page.