Overview
The Name Icons Section is a list of Name Icon items. Each Name Icon controls the addition of a user-selected icon to a person's name in one or more locations in the site. You may add icons to identify something important about the person, such as military service, family associations, etc. You specify a filter to describe the subset of people for whom the icon should appear.
The icon may be added to some or all of the following name contexts:
- The subject's name at the top of a person entry
- A parent's name in the Parent Section
- A child's name in a Family Section
- A person's name in the name index
In each case, the icon may appear before or after the person's name.
Add one or more Name Icon entries to the list in the Name Icons section using the [+] button beneath the list.
Here is an example showing a Name Icon added before a name in the name index.
Name Icon Properties
Title
The Title property identifies the User Item in the User Items list. The Title has no other purpose for Name Icon items.
Enabled
The Enabled checkbox controls whether or not the Name Icon is processed when GedSite is making the site. If Enabled is unchecked, the Name Icon is ignored.
Image
Click the Image button to select the image file you want to use as an icon. GedSite will open a standard Windows "open file" dialog window. Use the navigation controls in that dialog window to move to the folder that contains the image you want to use. Select the image file, then click the [Open] button. GedSite will display the image.
You may use graphic files with the extension PNG, JPG/JPEG, or GIF. Choose images that are small. 16px by 16px is usually best.
GedSite includes two dozen icons you are free to use in your site. The [Image] button will open to the folder that contains those icons, but you are not limited to those choices. If you do not want to use one of the icons included with GedSite, use the navigation controls in that dialog window to move to the folder that contains the image you want to use.
Image File Handling
Immediately after you select the image file, GedSite will respond as follows:
- If the image file is located outside the Input (-i) folder, GedSite copies the image file to the
ui(user images) subfolder of the Input (-i) folder. - If the image file is located in a subfolder of the Input (-i) folder, including the
ui(user images) subfolder or any other subfolder, GedSite uses that image file and does not copy it. - If the image file is located in the Input (-i) folder, and not in a subfolder, GedSite copies the image file to the
ui(user images) subfolder of the Input (-i) folder.
The processing described above allows you to define subfolders under the Input (-i) folder to organize or categorize images. However, you must create the subfolders manually and copy the image files into the Input (-i) folder subfolders manually before you click the [Image...] button to choose the image.
If GedSite makes a copy of the image file, the original date is retained.
In any instance where GedSite makes a copy of the image file, if you subsequently change the original image file, the change will not be reflected in the site contents. You must edit the Image User Item and re-select the original file to update the copy used by the site. Optionally, you may manually update the copy of the file that is stored in a subfolder of the Input (-i) folder.
Person Filter
Add Filter terms to the Person Filter list to select the people whose names should include the current icon.
Name Contexts
You may select zero, one, or more name contexts using the following checkbox properties:
- Subject Name – The subject's name at the top of a person entry
- Parent Name – A parent's name in the Parent Section
- Child Name – A child's name in a Family Section
- Index Name – A person's name in the name index
If you leave all the checkboxes unchecked, the icon will not be added to any names. However, if you supply a description, the icon will appear in the Name Icons Table if you add one to the site. You may use this technique to explain icons that are not added to names, but appear elsewhere in the site.
Position
The Position pull-down menu controls whether the icon appears before or after the person's name. The default is before the name.
Description
Use the Description to describe the meaning of the icon. If you use the Name Icons Table User Item, the Description will appear in the table that describes the name icons.
Tooltip
Use the Tooltip to enter a brief explanation of the icon.
URL
Enter a URL if you want the icon to be a link to the URL you specify.
If you link to a page that is part of your site, you must use a prefix before the filename of the HTML page to make a valid relative URL. For example, if you have a page on your site with the filename "jones-family.htm", add the prefix "../up/" in the URL value, i.e., "../up/jones-family.htm".