Overview

This page describes the Exhibits Section options. For other information about how Second Site processes exhibits, see the Exhibits page.

The Exhibits section allows the user to choose how exhibits are handled.

Output Folder

The Output Folder property controls the output folder for exhibit files. When Second Site builds the site, it finds exhibit files based on the file path that is stored in the TMG project. It copies each exhibit file to the exhibit output folder to make it possible to publish the site without recreating the user's particular method of organizing exhibit files. The result is a self-contained site where all the necessary files, including exhibit files, are under the Output (-o) folder or one of its subfolders.

There are three choices in the Output folder setting pull-down menu:

Choice Result
Child of output folder The exhibit files will be copied to a subfolder named "exhibits" in the Output (-o) folder. For example, if your SDF file is named mysite.sdf, then the folder will be named mysite-o/exhibits.
Same as output folder The exhibit files will be copied to the Output (-o) folder.
Peer of output folder The exhibit files will be copied to a "-x" folder in the same folder that contains the Output (-o) folder. Second Site assigns the folder the same name as the SDF file with a "-x" suffix, e.g., if your SDF file is named mysite.sdf then the folder will be named mysite-x.

This is not a good choice if you plan to copy the site to removable media. The folder layout of the removable media will not allow a folder to be a peer of the root folder, so the exhibit links will not work.

The default value is Child of output folder, and I strongly recommend that you leave it set that way.

Exhibits Linked for Witnesses

If Exhibits Linked for Witnesses is checked, Second Site will convert embedded exhibits to linked exhibits when processing exhibits attached to events and where the subject is a witness to the event.

If Include Back-Links is checked, which is the default, Second Site will add links to exhibit pages back to the person pages of people linked to the exhibit.

This option only affects linked image exhibits attached to people, events, and sources.

Enable SS-IGNORE

If Enable SS-IGNORE is checked, which is the default, Second Site will not include exhibits where the Exhibit Code [:SS-IGNORE:] is included in the Description field of the exhibit.

If Enable SS-IGNORE is unchecked, Second Site will include exhibits even if [:SS-IGNORE:] is included in the Description field of the exhibit.

Exhibit Groups

The remaining properties are divided into groups by exhibit type: images, text, video, and audio. 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

(External exhibits
only)

  • 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

(External and
internal exhibits
only)

  • 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
Audio

(External exhibits
only)

  • 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

(External exhibits
only)

  • 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 A link to the exhibit will be included in the output. For images, a camera icon is used for the link. For text, a document icon is used for the link. The link leads to a page that Second Site creates for the image or text. For exhibits where the content cannot be embedded on a web page, Second Site will make the link directly to the document. The user's web browser will decide what to when the user clicks on such a link. For PDF files, for example, the browser will open Adobe Reader AKA Acrobat Reader.

Second Site uses the exhibit caption as the "tooltip" text that some browsers display when you position the mouse over the icon.

Embed  The exhibits will be inserted directly in the output.

Second Site supports special codes you can place in the Description field of TMG's Exhibit record to override the Embed and Link options. Using those codes, you can set the option to either Embed or Link, but override that choice for selected images. See the Exhibit Codes on the Second Site-Only Formatting Codes page.

Image Exhibits

Note Second Site supports external image exhibits only. TMG Utility will convert internal images to external images, and will also create resized images for the Alternate Image Folder.

Index Icon for Primary Image

If Index Icon for Primary Image is checked, Second Site will add an icon to the left of each name in the index if the person has a primary image and if the Primary Person Image property is either Embed or Link. The default is checked. The default icon is . The icon filename is "picidx.gif".

Resize Embedded Images

If Resize Embedded Images is checked, the Embedded Width and Embedded Height properties are enabled and Second Site will enforce a maximum size on embedded image exhibits. If an image exceeds the Embedded Width or Embedded Height, Second Site 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 Second Site resizes the image, it retains the aspect ratio of the original image.

Alternate Image Folder

If Alternate Image Folder is set to the path to a folder, Second Site searches the folder for Second Site-specific versions of exhibit files. If you want to use one version of an image with TMG, and a different version with Second Site, put a file with the same name as the original in this folder.

This feature is specifically designed 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 Image Folder and Second Site will use the alternate.

You may set the value by keying the path in the textbox, or you may set it by clicking the [Set Alternate Image Folder] button.

Second Site will search the Alternate Image 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 images types (JPG, GIF, PNG). This feature allows you to substitute a JPG file for a TIF, for example.

For audio and video exhibits, Second Site uses the Alternate Image Folder for both substitute versions and additional formats. See the Video Exhibits section of the Exhibits help page for an explanation.

Images from Alternate Folder Only

If Images from Alternate Folder Only is checked, Second Site will ignore image exhibits unless the exhibit has an alternate version in the Alternate Image Folder. You can use this option to limit the image exhibits on your site to the contents of the Alternate Images Folder only.

Image Size Options

The Resize Embedded Images and Alternate Image Folder features can be used together. Second Site selects the image file based on the path stored in the TMG exhibit record. If there is an Alternate Image Folder, and a file of the same name exists in that folder, Second Site replaces the original with the alternate. After choosing an image file, Second Site evaluates the Resize Embedded Images options and resizes the image if necessary. When an image is resized as a result of the Resize Embedded Images option and there is an alternate, the lightbox will display the alternate version.

As a result of the processing steps described above, you may use the Resize Embedded Images feature to control the layout of the page and the Alternate Image Folder feature to avoid downloading huge images.

Use Special Instructions as Alt Text

If Use Special Instructions as Alt Text is checked, Second Site will use the text from the Special Instructions field of the image's IPTC headers as the Alt Text for Exhibit images. The IPTC headers do not define a field for Alt Text, so this property exists to indicate you want to use the Special Instructions field for that purpose. The default value is unchecked.

This property also applies to images that Second Site processes that are not exhibits.

Include Author Credit

If Include Author Credit is checked, Second Site will add include the Creator field from the IPTC record to the display of images. The Creator field is sometimes labeled the Author field, and is the first subfield in the IPTC ByLine. Unfortunately, there is some variation between software programs regarding the labels for IPTC fields, so it is hard to predict how the field will be labeled in the software you use. In Photoshop, the label is "Author", but that may vary by Photoshop version.

Text Exhibits

Text Is Preformatted

If Text Is Preformatted is checked, Second Site will wrap text exhibits with the <PRE> and </PRE> HTML tags. Browsers do not wrap text that appears between <PRE> and </PRE> tags. The default is unchecked.

On This Page

See also:

  • Stylesheets.System.Exhibits