Overview
You may add Person References items to the Person Entry list to include links to other pages where the person appears. For example, if a person appears in a List of People which has the Add References property checked, that person's Person References will include a link to the List of People.
Person References are assigned a type based on the item that creates the reference, and you may select the type of entries you want to appear. See Type Selections.
Each of the items that create references include properties that control whether the reference is created or not. For example, if the Add References property of the List of People User Item is checked, then the List of People will add references for each person included in the list. Otherwise, it will not.
Links to other people based on relationships or shared events do not appear in a Person References list. Those links are created by relationships or shared events in the GEDCOM file.
Limitation
In Gedcom Publisher, Person Entries are created when the chapter to which they belong is processed. References created by an item in a later chapter, or later in the same chapter, will have no effect.
Properties
Title
Enter the text that you want to appear as the label for the person references.
Singular or Plural Title
The Person References item may produce zero, one, or more items in a list on a Person Page entry. Some people may have zero entries, in which case there is no output from this Person Entry item. Other people may have one item in the list, while still others may have more than one.
If you want to use a singular title when a person's list has one item, and a plural title when a person's list has more than one item, add both titles to the Title property and separate the singular title from the plural title with the || characters. For example, Reference||References.
Enabled
See Enabled in the Common Properties section of the User Items help page.
Type Selections
| Type Checkbox | If checked, includes references from: |
|---|---|
| Link | Person Links |
| List | Lists of People |
List Type
The List Type pull-down menu determines the format of the list of references. The choices are:
| Value | Example Output |
|---|---|
| Comma Separated | Descendants of John Doe, World War I Veterans |
| Row Separated | Descendants of John Doe World War I Veterans |
| Semicolon Separated | Descendants of John Doe; World War I Veterans |
New Container
When New Container is checked, the output of this item will be placed in a new container. When New Container is unchecked, which is the default, the output of this item may be added to an existing container if the output of a previous Person Entry Item uses the same container type as this item.
- If you want to merge the output of the Person References item with a previous Person Entry Item, leave New Container unchecked.
- If you want the Person References item to close the prior container and open a new container, add a checkmark to New Container.
Details
When a Person Entry Item creates content of the same type as the previous content, the new content is added to the same container as the previous content.
For example, when using a grid-type Format, the Links and Person References items both create a row with two columns in a table. The table is the container. If the output of the Person References item follows immediately after the output of the Links item, the output of the Person References item will be added to the same table that contains the Links content.
If you prefer that the Person References item starts a new container, add a checkmark to the New Container property. Typically, creating a new container will add vertical space between the prior output and the current output.
See: New Container Item
CSS and User Styles
Person Entry items that produce lists include a CSS class name for each each row in the output of the item. This makes it possible to apply User Styles to the output of those items.
The class name for Person References items is "pe-item-person-references".