Overview
When adding links to web sites, keep in mind some e-readers may not be able to display a web page.
The Links item in the Person Entry list controls the addition of the filtered links in the Person Entry. When a person passes the filter associated with a link, the link is added to the Person Entry.
Properties
Title
Enter the text that you want to appear as the label for the list of links produced by this item. The title will not appear if the subject does not pass the filters for any of the Links.
Singular or Plural Title
The Links 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, Link||Links.
Enabled
The Enabled checkbox controls whether or not the Links Person Entry is processed when Gedcom Publisher is making the Person Entry. If Enabled is unchecked, the Links Item and all the items in its Links list property are ignored.
Links
Add one or more items to the Links list, either Link or Link to Person items.
For example, if you add three items to the list, Gedcom Publisher will add up to three links to each person entry. If someone passes the filters for all three items, that person will have three links in their person entry.
List Type
The List Type pull-down menu determines the format of the list of links. The choices are:
| Value | Example Output |
|---|---|
| Comma Separated | Link 1, Link 2 |
| Row Separated | Link 1 Link 2 |
| Semicolon Separated | Link 1; Link 2 |
New Container
Please see New Container in the Details section.
Link Item
You may add one or more Link Items to the Links list. Each Link Item describes a conditional HTML link. Gedcom Publisher will add the link to the Person Entry if the current subject passes the item's Person Filter.
Properties
Title
The Title property defines the text of the link. It also identifies the item in the Links list.
Enabled
The Enabled checkbox controls whether or not the Link Item is processed when Gedcom Publisher is making the Person Entry. If Enabled is unchecked, the Link Item is ignored.
URL
The URL property identifies the destination for the link.
Person Filter
Specify a filter using the Person Filter property. Gedcom Publisher will only add the link for people who pass the filter.
Link to Person Item
You may add one or more Link to Person Items to the Links list. Each Link to Person Item describes a conditional link to the Person Entry of someone else in the book. Gedcom Publisher will add the link to the Person Entry if the current subject passes the item's Person Filter.
Properties
ID
Use the ID property to specify the person whose Person Entry is the target of the link. You may use the [Picklist...] button to set the ID number.
Title
The Title property defines the text of the link. It also identifies the item in the Links list.
Gedcom Publisher will automatically set the Title text to the name of the target person whenever you change the ID property. If you want to set the link text yourself, key the text after changing the ID property.
Enabled
The Enabled checkbox controls whether or not the Link to Person Item is processed when Gedcom Publisher is making the Person Entry. If Enabled is unchecked, the Link to Person Item is ignored.
Person Filter
Specify a filter using the Person Filter property. Gedcom Publisher will only add the link for people who pass the filter.
Details
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 Links item with a previous Person Entry Item, leave New Container unchecked.
- If you want the Links item to close the prior container and open a new container, add a checkmark to New Container.
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 Person References and Links items both create a row with two columns in a table. The table is the container. If the output of the Links item follows immediately after the output of the Person References item, the output of the Links item will be added to the same table that contains the Person References content.
If you prefer that the Links 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 Links items is "pe-item-links".