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, Gedcom Publisher searches the folder for Gedcom Publisher-specific versions of exhibit files. If you want to use one version of an image with your genealogy program, and a different version with Gedcom Publisher, 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 Gedcom Publisher will use the alternate.

Gedcom Publisher 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 Gedcom Publisher, use the [Alternate Folder...] button to select the folder created in step 1. Save the Gedcom Publisher 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 book, Gedcom Publisher 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 and text. 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. Image exhibits 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

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 Gedcom Publisher will create an icon link to the exhibit.

For images and text, the link leads to a page that Gedcom Publisher creates to hold the exhibit contents.

For other exhibit types, Gedcom Publisher 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.

Gedcom Publisher 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, Gedcom Publisher will make a link directly to the exhibit file. For example, a PDF file cannot be inserted on a web page, so Gedcom Publisher 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 Gedcom Publisher will enforce a maximum size on embedded image exhibits using those values. If an image exceeds the Embedded Width or Embedded Height, Gedcom Publisher 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 Gedcom Publisher 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, Gedcom Publisher will use the GEDCOM TITL record value as the image caption. If there is no TITL record value, Gedcom Publisher will use the caption from the image file. Favor Exhibit is the default value.

If Caption Preference is set to Favor Image File, Gedcom Publisher will use the caption from the image file as the image caption. If there is no caption in the image file, Gedcom Publisher will use the GEDCOM TITL record value.

Optimize Image Files

If Optimize Image Files is checked, Gedcom Publisher 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 Gedcom Publisher 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 Book command. However, many e-book readers have limited capacities and it's best to reduce the size of the EPUB file by reducing the size of images.

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 book, Gedcom Publisher saves a copy of the optimized image files in the Cached Images folder. When you subsequently make the book again, Gedcom Publisher 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 book, Gedcom Publisher 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 book, Gedcom Publisher 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 book, Gedcom Publisher 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.

File Location

If the file location specified in the GEDCOM file is a relative path, Gedcom Publisher assumes the path is relative to the location of the GEDCOM file.

Sort

Gedcom Publisher 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.

    Gedcom Publisher 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.

    Gedcom Publisher 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