The items on the eXtyles Insert Tag menu allow greater control over the XML output. The USGS eXtyles Insert Tag menu includes tags for common reference types and tags for the specific handling of certain types of objects, such as figures and boxes.

Further, eXtyles for USGS includes tags that are required to support an automated InDesign layout process using the Typefi software. Those tags are described in detail in this section, and pertain primarily to the size and layout of images and tables.

Reference Tags

The first section of the Insert Tag menu consists of tags for various reference types (Book Reference, Conference Reference, etc.) to allow the type of reference to be tagged manually if the eXtyles Bibliographic Reference Processing fails to identify the reference type correctly, even when the reference is correctly copy edited. To use these tags, follow these steps:

• Remove the incorrect tags from the start and end of the problematic reference. The safest way to do this is to place the cursor immediately after the tag and use the Backspace key twice to first highlight and then delete the tag.
• Highlight the entire paragraph with the reference.
• Select the appropriate reference type from the Insert Tag menu.

After applying the tag manually, you may add additional markup to the reference with Word character styles as necessary.

Object Tags

Following the Reference Tags, three object tags are available on the Insert Tag menu. During XML export, these tags enable eXtyles to act in specific ways on certain objects.

Graphic Tag

The Graphic tag should be used when a figure's <graphic> pointer in the XML must be named in some way other than the established convention. For example, if you must name an image "CoverPhoto-Ostrich", insert the Graphic tag after the photo's caption, and add the file name between the open and close <graphic> tags. For example,

This is a photo of an ostrich<graphic>CoverPhoto-Ostrich</graphic>

The information in the Graphic tags will overwrite the figure-naming convention that eXtyles applies to all images, and in the XML the graphic pointer will become:

<graphic xlink:href="CoverPhoto-Ostrich"/>

Figure Panels Tag

Sometimes a figure may have multiple image files (panels), particularly when it is in multiple parts. For example, an author might have created figures 1A, 1B, 1C, and 1D, each as a separate file. In this situation, you will need four <graphic> elements in the XML.

This can be done by using the Insert Tag item on the eXtyles Menu to insert a Figure Panels tag at the end of the figure caption, which inserts a tag like this:

<panel></panel>

If each panel is a separate image file, type in the letter of the last panel, like this:

Figure 1. Conceptual model of linkages among physical and biological processes along the coast to assess climate-induced changes.<panel>d</panel>

The resulting XML will look like this:

<fig id="fig01" position="float" fig-type="figure">
<label>Figure 1</label><caption><p>Conceptual model of linkages among physical and biological processes along the coast to assess climate-induced changes.</p></caption>
<graphic xlink:href="ofr2015_fig01a"/>
<graphic xlink:href="ofr2015_fig01b"/>
<graphic xlink:href="ofr2015_fig01c"/>
<graphic xlink:href="ofr2015_fig01d"/>
</fig>

Or, if in the same example, panel A is one file, panels B and C are one file, and panel D is one file (i.e., only three image files), use the Figure Panels tag like this:

Figure 1. Conceptual model of linkages among physical and biological processes along the coast to assess climate-induced changes.<panel>a,bc,d</panel>

The resulting XML will look like this:

<fig id="fig01" position="float" fig-type="figure">
<label>Figure 1</label><caption><p>Conceptual model of linkages among physical and biological processes along the coast to assess climate-induced changes.</p></caption>
<graphic xlink:href="ofr2015_fig01a"/>
<graphic xlink:href="ofr2015_fig01bc"/>
<graphic xlink:href="ofr2015_fig01d"/>
</fig>

Box Type Tag

In some cases, you may have boxes for which you would like a unique content-type attribute. This can be set easily in eXtyles using the Box Type tag found on the eXtyles Insert Tag menu. By adding this tag at the end of a box title, and placing the box type in between the tags, eXtyles will convert that information into the content-type attribute on export.

For example, this content in the Word file (Styled with the paragraph style Sidebar Title):

Other Hosts of Adult Baylisascaris procyonis<box-type>Feature</box-type>

yields this XML:

<boxed-text id="ba" content-type="Feature">
<caption><title>Other Hosts of Adult <italic>Baylisascaris procyonis</italic></title></caption>

Single Column Tag

When you have content that must be laid out as a single column, the Single Column tag can be added after the Head 1 preceding the single-column section. This will result in a processing instruction in the XML that will indicate to Typefi that the following section should be set single column.

For example, the following Head 1:

Causative Agent<SingleColumn></SingleColumn>

results in this XML:

<sec>
<title>Causative Agent<?single column?></title>

Size and Caption Tags for Figures and Tables

The eXtyles tag menu includes tags that, when used, will produce processing instructions (PIs) in the XML that an automated InDesign layout program such as Typefi can use to ensure that images, tables, and sidebars/boxes are properly sized and placed in the PDF. PIs look like this in the XML: <?Figure Small?>

Note that during the manuscript preparation stage of production (during which eXtyles is used) you may not know what the size or layout of images and tables will be. These tags are not required to export valid XML, and so you can create XML that can be used for layout without the use of these tags. However, if you are then asked to add them by the layout artist, note the following.

Figure Small, Figure Medium, and Figure Large

When used, these tags will tell the layout software how large to size the image. The tags should be placed at the end of the figure caption. For example, a large image would have the following caption:

Figure 1. Location of study area, selected sampling sites, and data-summary reaches in the upper Clark Fork Basin, Montana; the Milltown Reservoir/Clark Fork River Superfund Site includes the reaches from sampling site 8 to sampling site 22.<Fig_Large></Fig_Large>

<fig id="fig01" position="float" fig-type="figure"><?Figure Large?><label>Figure 1</label><caption><p>Location of study area, selected sampling sites, and data-summary reaches in the upper Clark Fork Basin, Montana; the Milltown Reservoir/Clark Fork River Superfund Site includes the reaches from sampling site 8 to sampling site 22.</p></caption><graphic xlink:href="tac16-1008_fig01"/></fig>

Figure Landscape, Figure Spread, and Figure Oversize

Use these tags at the end of the captions for figures that will be set landscape, across a spread, or that will be oversize (e.g., extend beyond the margins).

Caption Tags

Use these tags to indicate where relative to the image the caption should be placed. For example, to the left or right of the image, or at the top or bottom.

Image Width Tags

Use these tags to indicate the width of the image; that is, whether it should be a half or whole page in width, or somewhere in between (intermediate).

Table Size Tags: Small, Medium, Large, and Spread

When used, these tags will tell the InDesign layout software how large to size the table. The tags should be placed at the end of the table title. For example, a small table would have the following title:

Table 1. Naming conventions applicable to identifiers, files, programs, namespaces, and modules in any programming language.<Tbl_Med></Tbl_Med>

<label>Table 1</label><caption><title>Naming conventions applicable to identifiers, files, programs, namespaces, and modules in any programming language.<?Table Med?></title></caption>

Sidebar Size Tags: Small, Medium, and Large

When used, these tags will tell the InDesign layout software how large to size sidebars or boxes. The tags should be placed at the end of the first line of sidebar/box text (i.e., title, heading, or box text). For example, a large sidebar may have the following title:

Schematic Cross Section of a Typical Subduction Zone.<Sidebar_Small></Sidebar_Small>

<boxed-text id="ba"><?Sidebar Small?>
<caption><title>Schematic Cross Section of a Typical Subduction Zone.</title></caption>
.....</boxed-text>