advertisement

Overview

The Exhibits Section includes properties related to images and other external documents attached to records in the GEDCOM file.

General Properties

Alternate Folder

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.

Steps

  1. In MS Windows, create a folder where you will put the alternate image files.
  2. In GedSite, use the [Alternate Folder...] button to select the folder created in step 1. Save the GedSite file.
  3. 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:
    1. Use MS Windows to make an exact copy of an image file, and place the copy in the Alternate Folder.
    2. 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.

Embed Position

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.

Exhibit Groups

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 for controlling whether exhibits of that type are Ignored, Linked, or Embedded. Some of the exhibit types also have other properties.

Exhibit Type Exhibit Group
Images
  • The primary image linked to a person
  • Other images linked to a person
  • Images linked to an event
  • Images linked to a source
  • Images linked to a citation
  • Images linked to a place
Text
  • The primary text linked to a person
  • Other text linked to a person
  • Text linked to an event
  • Text linked to a source
  • Text linked to a citation
  • Text linked to a place
Documents

Ignore and Link
choices only

  • The primary document file linked to a person
  • Other document files linked to a person
  • Document files linked to an event
  • Document files linked to a source
  • Document files linked to a citation
  • Document files linked to a place
Audio
  • The primary audio file linked to a person
  • Other audio files linked to a person
  • Audio files linked to an event
  • Audio files linked to a source
  • Audio files linked to a citation
  • Audio files linked to a place
Video
  • The primary video file linked to a person
  • Other video files linked to a person
  • Video files linked to an event
  • Video files linked to a source
  • Video files linked to a citation
  • Video files linked to a place

Exhibit Group Options

For each of the exhibit groups, you can choose one of the following three options:

Choice Result
Ignore The exhibits will not be included in the output.
Link 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.

Embed  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.

Image Properties

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.

Caption Preference

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.

Text Properties

There are no properties related to text exhibits except for the Ignore, Link, or Embed properties described above.

Document Properties

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.

Audio Properties

There are no properties related to audio exhibits except for the Ignore, Link, or Embed properties described above.

Video Properties

There are no properties related to video exhibits except for the Ignore, Link, or Embed properties described above.

File Location

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.

Sort

GedSite sorts exhibits by date when a date is available. The date is taken from one of three places:

  1. A date that is included somewhere in the filename, if that date is in the format "yyyy-mm-dd", "yyyy.mm.dd", or "yyyy_mm_dd".

    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 "00".

  2. 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
  3. 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.

On This Page