The Exhibits Section includes properties related to images and other external documents attached to records in the GEDCOM file. Your genealogy program may refer to exhibits as "media items" or other terms to describe images or other external documents.
If Alternate Folder is set to the path to a folder, GedSite searches the folder for GedSite-specific versions of exhibit files. If you want to use one version of an image with your genealogy program, and a different version with GedSite, put a file with the same name as the original in this folder.
This feature is intended for the case where you have a high-resolution image that works well with printed output, but doesn't look good on a web page because it's too large and also takes a long time to download. Put a web optimized version of the exhibit in the Alternate Folder and GedSite will use the alternate.
GedSite will search the Alternate Folder for a file with the same filename and filetype. If that file is not found, it will search for a file with the same name and one of the common web image types (JPG, GIF, PNG). This feature allows you to substitute a JPG file for a TIF, for example.
- In MS Windows, create a folder where you will put the alternate image files.
- In GedSite, use the [Alternate Folder...] button to select the folder created in step 1. Save the GedSite file.
- In an image editor, make smaller copies of one or more large image files. Be careful not to alter the original file. Here's an approach I recommend:
- Use MS Windows to make an exact copy of an image file, and place the copy in the Alternate Folder.
- Use an image editor to reduce the size of the image file that is in the Alternate Folder.
That approach avoids ever opening the original file in an image editor, and that makes it unlikely you'll mistakenly save the smaller version over the original.
After following the steps above, when you make the site, GedSite will use the alternate image files in place of the associated exhibits.
Pressing the [Reset] button will clear the current Alternate Folder path value.
When Embed Position is set to After text, which is the default, embedded exhibits are inserted after the text of their parent record. So, for example, an exhibit attached to a tag will be inserted after the text for the tag.
When Embed Position is set to Before text, embedded exhibits are inserted before the text of their parent record.
Embed Position currently applies only to exhibits attached to tags.
Linked exhibits are not affected by the Embed Position property. Linked Exhibits are always inserted after the text associated with the parent record.
The remaining properties are divided into groups by exhibit type: images, text, documents, audio, and video. For each of those types, there are a set of pull-down menu properties, with one menu for each genealogy record where an exhibit may be attached. The pull-down menus determine whether exhibits of that type are Ignored, Linked, or Embedded.
- The Primary Person group is for exhibits that are attached to a person record and are the primary exhibit. The Primary Person exhibit is used when there are multiple exhibits but the output requires one exhibit to be given precedence. Primary Person exhibits appear in the Person Entry. They appear ahead of any Person exhibits.
- The Person group is for exhibits that are attached to a person record and but are not the primary exhibit. Person exhibits appear in the Person Entry. They appear after the Primary Person exhibits, if any.
- The Event group is for exhibits that are attached to an event. Event exhibits appear with the event in a Tag Set in the Person Entry.
- The Family group is for exhibits that are attached to a family.
Family events appear in the Parent Section in the Person Entry if they are attached to the family that contains the parents of the current person.
Family events appear in the Family Section in the Person Entry if they are attached to a family where the current person is a parent.
If any person in the family is alive, and Limit Details for Living People is checked, the family exhibits for that family are suppressed.
- The Source group is for exhibits that are attached to a source. Source exhibits appear after the source text on a source page.
- The Citation group is for exhibits that are attached to a citation. Citation exhibits appear after the citation text in the citation list in a Person Entry.
- The Place group is for exhibits that are attached to a place. Place exhibits appear on a place information page. See the Places Section for more information about Place Information pages.
Some exhibit types also have other properties.
|Exhibit Type||Exhibit Group|
Ignore and Link
Exhibit Group Options
For each of the exhibit groups, you can choose one of the following three options:
|Ignore||The exhibits will not be included in the output.|
GedSite will create an icon link to the exhibit.
For images and text, the link leads to a page that GedSite creates to hold the exhibit contents.
For other exhibit types, GedSite will make a link directly to the exhibit file. The user's web browser will decide what to do when the user clicks on such a link. For PDF files, for example, the browser will typically open Adobe Reader AKA Acrobat Reader.
GedSite uses the exhibit caption as the "tooltip" text that some browsers display when you position the mouse over the icon.
The exhibit content will be inserted directly on the page where the parent record (person, tag, citation, source, or place) appears.
For some exhibit types, the content cannot be inserted directly on an HTML page. For those exhibits, GedSite will make a link directly to the exhibit file. For example, a PDF file cannot be inserted on a web page, so GedSite will make a link to the exhibit file.
In addition to the Ignore, Link, or Embed properties described above, image-related properties include:
Person Image Alignment
The Person Image Alignment property controls the alignment of embedded image exhibits attached to people.
Other Image Alignment
The Other Image Alignment property controls the alignment of embedded image exhibits except exhibits attached to people.
Resize Embedded Images
If Resize Embedded Images is checked, the Resized Width and Resized Height properties are enabled and GedSite will enforce a maximum size on embedded image exhibits using those values. If an image exceeds the Embedded Width or Embedded Height, GedSite will resize the image to fit within those limits before embedding the image on the page. The user can click the image or the lightbox icon (if available) to open the full size version.
When GedSite resizes the image, it retains the aspect ratio of the original image.
GEDCOM files include a TITL record which is typically the caption for an image. Image files may also include caption text.
If Caption Preference is set to Favor Exhibit, GedSite will use the GEDCOM TITL record value as the image caption. If there is no TITL record value, GedSite will use the caption from the image file. Favor Exhibit is the default value.
If Caption Preference is set to Favor Image File, GedSite will use the caption from the image file as the image caption. If there is no caption in the image file, GedSite will use the GEDCOM TITL record value.
Optimize Image Files
If Optimize Image Files is checked, GedSite will reduce the dimensions of image exhibits and reduce the length of image exhibit files. All image exhibit dimensions will be reduced to the maximum width and height, and the image quality will be reduced until the file length is below the value in the Target File Length property.
The Optimized Width and Optimized Height properties define the maximum pixel dimension in the given direction. When GedSite resizes the image, it makes a copy where the larger dimension is determined by either the width or height value you supply, and the other value is set such that the copy retains the aspect ratio of the original. It's usually best to have the Optimized Width be the more restrictive of the two so that a very long image will not be unreasonably thin.
Target File Length is expressed in kilobytes, so entering "200" means 200 times 1024, or 204,800 bytes.
Optimizing images may dramatically increase the execution time of the Make Site command. However, smaller images are advantageous because they reduce the size of your web site and reduce the size of web pages.
To eliminate the performance impact of using Optimize Image Files, you can manually optimize image files and store the optimized copies in the Alternate Folder.
Cached Images Folder
When Optimize Image Files is checked and you make the site, GedSite saves a copy of the optimized image files in the Cached Images folder. When you subsequently make the site again, GedSite will re-use the cached files. That reduces the performance impact of using Optimized Image Files because the image files do not have to be optimized, only copied.
If you change the Optimized Width or Optimized Height property, when you re-make the site, GedSite will disregard cached image files that are different from the new dimensions and re-optimize the image files.
If you change the Target File Length and make the value lower, when you re-make the site, GedSite will disregard cached image files that are larger than the new Target File Length value and re-optimize the image.
If you change the Target File Length and make the value higher, when you re-make the site, GedSite will not re-optimize cached image files that are smaller than the new limit. If you want such images re-optimized, you must remove those image files from the Cached Images folder manually.
There are no properties related to text exhibits except for the Ignore, Link, or Embed properties described above.
There are no properties related to document exhibits except for the Ignore, Link, or Embed properties described above. The Embed option is not available for document exhibits.
There are no properties related to audio exhibits except for the Ignore, Link, or Embed properties described above.
There are no properties related to video exhibits except for the Ignore, Link, or Embed properties described above.
If the path to a media file starts with
https://, the path is treated as a URL and the exhibit is treated as an external document.
Also, if the path to a media file has the extension ".url", GedSite will assume the file is an MS Windows URL shortcut file, read a URL from the given file, and treat the media file as a URL exhibit.
When making the site, GedSite will insert a link to the given URL where the exhibit would normally appear.
If the file location specified in the GEDCOM file is a relative path, GedSite assumes the path is relative to the location of the GEDCOM file.
GedSite sorts exhibits by date when a date is available. The date is taken from one of three places:
- A date that is included somewhere in the filename, if that date is in the format "
yyyy.mm.dd", or "
The date must be all numeric except for the delimiter characters. The date should be separated from other text in the filename by a space, a comma, a dash, or parentheses. You may not use "
/" or "
\" as the delimiter because those characters are not allowed in Windows filenames.
Dates may appear at the start, in the middle, or at the end of the filename.
GedSite will detect the dates in all the following example filenames. These are only examples; other variations will also work.
- Start of filename, separated by dashes:1878-04-28 James Jones.jpg
- End of filename, separated by underscores:James Jones 1878_04_28.jpg
- Middle of filename, surrounded by spaces:James Jones 1894-06-09 Graduation.jpg
- Middle of filename, surrounded by parentheses:James Jones (1894-06-09) Graduation.jpg
- Start of filename, separated by dashes, year and month only:1902-11-00-Smith,Doe Wedding.jpg
- Start of filename, separated by dashes, year only:1964-00-00-Jane Doe Will.jpg
As shown in two of the examples, you may use partial dates (dates missing a day, or day and month), but missing parts should be entered as "
- Start of filename, separated by dashes:
- The date stored within the metadata for the image file, if any.
GedSite will use the the first of these metadata fields that has a date:
- IPTC: DateCreated
- EXIF: IFD0 ImageDateTime
- XMP: CreateDate
- The date stored with the GEDCOM record for the exhibit, if any. The "Change Date" for an exhibit (CHAN.DATE) is ignored; in most programs, that represents the last time the exhibit / media object was edited in the program, not the date of the item itself.
If a date is found in more than one of the locations listed above, the date from #1 above takes precedence over #2, and if #1 is not present, #2 takes precedence over #3.
If no date is available, the sort sequence is determined by the exhibit record sequence in the data file.
GedSite supports codes you can assign to exhibits to modify exhibit processing. The codes are described below. Some of the codes override the behavior specified in the associated Exhibit Group for the exhibit.
The mechanism for assigning an Exhibit Code to an exhibit varies according to the application that wrote the exhibit file, and unfortunately, most applications do not provide a means to assign an exhibit code. See the entry for the application you use on the Application Compatibility help page for more information.
|Code||Description and Example|
|Exhibit-Ignore||GedSite will ignore the image even if the associated Exhibit Group option is set to Embed or Link. Use this option to ignore selected images when the default behavior is to embed or link.|
|Exhibit-Link||GedSite will link the image even if the associated Exhibit Group option is set to Embed. Use this code to link selected images when the default behavior is to embed.|
|Exhibit-Embed||GedSite will embed the image even if the associated Exhibit Group option is set to Link. Use this code to embed selected images when the default behavior is to link.|
|Exhibit-Embed-Left||Exhibit-Embed-Left is a variation of Exhibit-Embed where the image will float left even if the default for embedded exhibits is set to float right or centered.|
|Exhibit-Embed-Center||Exhibit-Embed-Center is a variation of Exhibit-Embed where the image will be centered even if the default for embedded exhibits is set to float left or float right.|
|Exhibit-Embed-Right||Exhibit-Embed-Right is a variation of Exhibit-Embed where the image will float right even if the default for embedded exhibits is set to float left or centered.|
Note: If the associated Exhibit Group option is set to Ignore, using the codes listed above will have no effect. You can use the codes to override Embed or Link, but you can not use them to override Ignore.
This page last changed on 17 Jun 2019.