The List of People User Item is a Content Item that creates a list of people and renders it in a Content Chapter. The list may have from one to many columns including data from the person record and/or selected events. You can select people for the list using a Filter, and you may further limit the list based on the number of events that pass filters you define. So, for example, you could create a list that includes everyone who has one or more Address events.
The example below shows the person's name, birth year (from the primary Birth event), and the year and spouse name (from primary Marriage events).
|Bezanson, Eunice W.||1804||1820||Frederick Levy|
|Bezanson, George||1804||Mary Millet|
|Bezanson, Sarah E. E.||1808||1828||David C. Vaughan|
|Millet, Mary||1775||1796||James J. Vaughan|
|Vaughan, Anne||1800||Peter Keiser|
|Vaughan, David||1795||1822||Sarah Bezanson|
|Vaughan, James||1802||1824||Lucy Vaughan|
|Vaughan, James J.||1777||1796||Mary Millet|
|Vaughan, Mary C.||1798||1819||Ambrose Allen|
Eunice Bezanson and Mary Millet have two spouses each, and their entries have "subrows" to include both spouses. The List of People item will include as many subrows as necessary based on the count of qualifying events for each person.
Although not shown in this example, in the actual book the names of included people will be links to their person entries.
Edit List of People
The Edit List of People window controls the properties associated with the User Item.
Enter a title for the User Item.
The window includes a Person Filter list where you add Filter terms to select the people you want to include in the list. The Person Filter is the main filter, but you may also filter people via the Event Fields column item.
The Sort People property determines the sequence of people in the list. The default value is "By name". The other options are "By birth" and "By ID#".
People per Table
The People per Table property determines how many people will be rendered in a single HTML table. When a table has more than this number of rows, it will be split into multiple tables. The default is 100.
The List of People Item uses an HTML table to produce the output. Some reading devices cannot render tables with many rows. To avoid issues on those devices, the results are split into multiple tables.
When the output is split into multiple HTML tables, the split is visible, and column widths may vary. It's best to limit your lists to 100 people or less.
The window also includes a Column Items list where you add one or more items to add columns to the list.
- Add a Person Field item to add data from the person record to the list. Each Person Field item creates one column in the output. See the list of person field choices below.
- Add an Event Fields item to add data from selected events to the list. Each Event Fields item may add one or more columns to the list, and if the person has multiple events that qualify, the list will include a "subrow" for each.
- Add an Spacer item to add an empty column to the list.
The Date Format pull-down menu controls the format of dates rendered by Person Field items. It has the same choices as the date formats property described in the Dates section. The default is "Aaa d Mmm yyy".
The Lifespan Format determines the format of any lifespans that appear in the list. The default value is "b. birth, d. death".
If Add References is checked, Gedcom Publisher will add a list-type reference to each person who is part of the list. This includes people who get a row in the list and does not include other people who might be mentioned via column definitions. The reference will create a link to the person's entry in the list.
If Place Links is checked, any places that appear in the list will include place links as described in the Places Section.
The Class textbox allows you to specify the name of a CSS class that will be added to the list's container. You may use the class in the selector of a User Style to customize the appearance of a particular list.
Person Field items create a single column in the output. To add a Person Field item, click the [+] button under the Column Items list, then select Person Field in the popup menu.
The Heading of a Person Field item is used as the column header for the item.
Select an entry from the Field pull-down menu to set the content of the column. The choices are as follows:
|Name||The person's primary name|
|Given Name||The GivenName field from the person's primary name|
|Surname||The Surname field from the person's primary name|
|Gender||The person's gender|
|ID||The person's ID number|
|Lifespan||The person's lifespan|
|Father||The primary name of the person's father|
|Mother||The primary name of the person's mother|
|Birth Date||The primary birth date of the person|
|Birth Year||The year from the primary birth date of the person|
|Death Date||The primary death date of the person|
|Death Year||The year from the primary death date of the person|
|Last Edited||The last edited date of the person|
|Manual||If you choose Manual, the Value textbox is enabled and you should enter Gedcom Publisher sentence template variables to define the value you want in the column. Use the subject (
Each Event Fields item creates one or more columns in the output. To add an Event Fields item, click the [+] button in the Column Items list, then select Event Fields in the Choose Item Type window.
The Title of an Event Fields item is used only as the item name in the list of items.
The Event Filter list includes multiple properties to select events.
You may filter tags based on the Tag Type and other filter terms that appear in the popup menu when you click the [+] button under the Event Filter list.
If the person has multiple events that pass the filter, the output will include multiple subrows as shown above in the example.
Count of Tags
You may restrict which people are included in the list based on the number of events that qualify for the current Event Fields item using the Minimum Tags and Maximum Tags properties. If the number of selected tags is less than the minimum or more than the maximum, the entire row for the person will be omitted and so the person will not appear in the list.
Each entry you add to the Columns list defines a column in the output. The icons beneath the list follow the same rules as other lists in Gedcom Publisher: use the plus icon to add a column, use the pencil icon to edit a column, etc. The sequence of the columns defines the left-to-right sequence of the output columns.
Each column must have a Heading value, and that value is shown in the column list. The Heading value may or may not appear as the column's heading in the outout.
If Show Heading is checked, the column's Heading will appear in the output.
The Predefined Values pull-down menu provides a series of options to determine the content of the column. The choices are listed on the Tag Sets help page.
If the Predefined Values pull-down menu is set to "Manual", the content of the column is determined by the sentence structure typed into the Value property. You may use any of the person or tag variables to specify the output you want.
If you specify a CSS class name in the Class property, Gedcom Publisher will add a
class parameter to each cell in the column.
Spacer items create a single empty column in the output. To add a Spacer item, click the [Add...] button under the Column Items list, then select Spacer in the Choose Item Type window. A Spacer item will be added to the list immediately; Spacer items have no editable properties, so there is no edit window. You may add and delete Spacer items, and move them up or down in the list, but they have no properties.
If you include Event Fields in the list and a person has more than one qualifying event, the list will include one subrow for each such event. If a list has two or more Event Fields items, the number of subrows will vary according to the events that exist for each person. The example above shows how subrows appear in the output.
When you have multiple Event Fields items, columns for one event may appear to be associated with columns from another event. For example:
|Doe, Jane||1943, John Smith||1930, Massachusetts|
|1967, George Jones||1940, Vermont|
Jane's 1943 Marriage to John Smith is not associated with her appearance on the 1930 Census, and her marriage to George Jones in 1967 is not associated with her appearance on the 1940 Census.
You may use the Spacer item to separate groups of event columns. So, for example, if you add a Spacer item between the Name and Marriage items, and also between the Marriage and Census items, the list above will now look like this:
|Doe, Jane||1943, John Smith||1930, Massachusetts|
|1967, George Jones||1940, Vermont|
The extra spacing helps to separate the column groups.
This page last changed on 12 Mar 2019.