Specification:Ahnentafel Report

From Gramps
Jump to: navigation, search

Specification for Ahnentafel Report. (More properly, "Áhnenlist Report". 'Áhnentafel' translates from German to 'ancestry table' and this report is not in tabular form.)

Task Status
Specification draft finished
Approval obtained
Implementation finished

Introduction

The Ahnentafel report shows the ancestry of a particular person. Starting with the Active Person, the ancestry (birth parents) of each generation are traced.


Example/Screenshot

An example:

Ahnentafel Example.png

and a sample in pdf format


Specification

Document Sections

The report consists of two sections, the document title, and the generations.

Document Title

The document will be titled "Ahnentafel Report for <NAME>", where <NAME> is determined by the display settings of the program, using the unsorted display algorithm. This is typically "Firstname Lastname", but can be override by the Preferences settings.

Generation Sections

Each generation is listed in its own section. Each section will be labeled "Generation X" where X represents the generational number. The Active Person will be the only person in "Generation 1". Each subsequent generation can have up to twice as many members as the previous generation.

Individual Entry Contents

Each entry will consist of a single paragraph, and should contain the following contents:

  • Person number.
  • Person's name.
  • Birth Information, if available.
  • Death Information, if available.
  • Burial Information, if available

Person Number

Each person in each generation will have a number assigned to him or her. The first person, determined will be numbered as 1. The parents of each person will be numbered according to the following algorithm:

   person = n
   father = 2n
   mother = 2n+1

The number will be terminated with a period, and separated from the Person's name by a tab.

Person's Name

The person's name will be listed in bold typeface. It will be in sorted display format, which is typically "Lastname, Firstname". The name will be terminated with a period, and separated from the next item by either a single space or by a new line.

Birth Information

The birth information will contain the birth date and place of birth if available. If neither are available, the birth information will be skipped.

The place name will be taken from the Place Name field of the associated Place. If the Place exists, but the associated Place Name is not defined, a name will be derived from the other fields if possible. If this is not possible, the report will act as if no Place is defined.

The date format will be determined by the selected data format preference in the program. This preference can be changed under the Preferences dialog.

The format of the sentence will depend on the available information. If both the date and place of birth are know, the sentence will be in the format of:

<Firstname> was born on <exact_date> in <place>.

or

<Firstname> was born <inexact_date> in <place>.

If only the date is know, the the sentence will be in the format of:

<Firstname> was born on <exact_date> in <place>.

or

<Firstname> was born <inexact_date> in <place>.

If only the place is known, then the format will be:

<Firstname> was born in <place>.

The sentence will be separated from subsequent sentences by a single space.

Death Information

The death information will contain the date of death and place of death if available. If neither are available, the death information will be skipped.

The format of the sentence will depend on the available information. If both the date and place of death are know, the sentence will be in the format of:

He died on <exact_date> in <place>.

or

He died <inexact_date> in <place>.

If only the date is know, the the sentence will be in the format of:

He died on <exact_date> in <place>.

or

He died <inexact_date> in <place>.

If only the place is known, then the format will be:

He died in <place>.

If the person is female, the "He" will be replaced with "She". If the gender is unknown, then the "He" will be replaced by "This person". The sentence will be separated from subsequent sentences by a single space.

Burial Information

The burial information will contain the date of burial and place of burial if available. If neither are available, the burial information will be skipped.

The format of the sentence will depend on the available information. If both the date and place of burial are know, the sentence will be in the format of:

He was buried on <exact_date> in <place>.

or

He was buried <inexact_date> in <place>.

If only the date is know, the the sentence will be in the format of:

He was buried on <exact_date> in <place>.

or

He buried <inexact_date> in <place>.

If only the place is known, then the format will be:

He was buried in <place>.

If the person is female, the "He" will be replaced with "She". If the gender is unknown, then the "He" will be replaced by "This person". The sentence will be separated from subsequent sentences by a single space.

Sample Entry

A sample entry should look as below. Since two options exist, both options are shown.

1. Garner, Lewis Anderson. Lewis Anderson was born on 6/21/1855 in Great Falls, MT. He died on 6/28/1911 in Twin Falls, ID. He was buried on 7/1/1911 in Twin Falls, ID.

or

1. Garner, Lewis Anderson.
Lewis Anderson was born on 6/21/1855 in Great Falls, MT. He died on 6/28/1911 in Twin Falls, ID. He was buried on 7/1/1911 in Twin Falls, ID.

Report Options

The report will have three options.

  1. Number of generations. This option will be an integer value that will indicate the maximum number of generations that will be included in the report. The default value will be 10.
  2. Page break after each generation. This option will be a True/False value that will indicate if a new page should be started after every generation.
  3. Newline after the name.