Using pods

About pods

These frequently used dialog boxes have an interface designed to simplify your work:

  • Conditional text pod

  • Cross-references pod

  • Marker pod

  • Fonts pod

  • Insets pod

  • Variables pod

View full size graphic
Explaining the pod interface
Select document

Pod-specific toolbar buttons

Search pod entries

Arrow on column headers indicates sort order

Pod list area.

Details of each instance include location. You can customize the location using Pods Location Criteria dialog box.

About the pod list area

The Select pop-up displays a list of all open documents, including books and DITA maps. If you select All Open Docs, the pod list area displays all the variables from all the open documents. If you select a specific open document, the pod list area displays variables from the selected document even when you switch to other open documents. The pod list area continues to display the list of instances from the selected document.

If you select the Current option, the pod list area displays the list of instances from the selected document. The list area refreshes when you switch between open documents. However, when you switch between pods, you may need to click the Refresh button.

If you select an open document

  • Single-click an instance in the pod to display the corresponding instance in the document. For example, if you select an image instance from the Insets pod, the corresponding image is also selected in the document view.

  • Double-click an instance to do the following for each pod:

    Conditional text pod
    Displays the Add/Edit Condition Tag panel for the selected condition.

    Cross-references pod
    Displays the Cross-Reference panel for editing the selected cross-reference.

    Markers pod
    Displays the Marker panel so that you can edit the selected marker definition.

    Fonts pod
    Displays the Replace Font panel for selecting a replacement font.

    Insets pod
    Displays the Object Properties panel for the selected inset.

    Variables pod
    Adds the selected variable at the insertion point in the current document.

  • Click a column name to sort the data in the list area in ascending or descending order.

Setting pod location criteria

The pod location criteria determine what should be displayed in the pod list area for an instance by way of identifying its location in the document.

For example, you can define two Paragraph tags that should be displayed as the location identifier for a marker. FrameMaker searches backwards for the first match of the first Paragraph tag that you have specified and displays it in the pod. Suppose you specify the first Paragraph tag as Topic_Title in the Location Criteria dialog box. FrameMaker locates a marker and traverses backwards to display the first topic title in which the marker occurs. If you specify the second Paragraph tag as Article_Name, then FrameMaker displays the exact article name to which the topic belongs.

Pod location criteria
In structured interface, you can specify either the paragraph styles or the element names. In unstructured FrameMaker, you can only specify paragraph styles.

Specify the first paragraph style.

Specify the second paragraph style.

  1. Choose File > Preference > Pods Location Criteria.

  2. Select Element Name if you want the pod to display the element names in which the instance is located.

  3. Specify valid element names and click OK.

For example, select Paragraph Style and specify head 2 and head 3 in the Style 1 and Style 2 boxes. In the Markers pod, for each instance of a marker, the first head 2 and head 3 it occurs under is displayed in the pod.

View full size graphic
The Markers pod displays the setting for marker location
Marker is selected in the document view

Paragraph styles that you specify in Pod Location Criteria

Markers pod displays the first head3 title and head2 title in which the marker occurs.