Figure Captions and Table Titles
- Jenny Seifert (Unlicensed)
Figure Captions
eXtyles includes four distinct paragraph styles for figure captions: Figure Caption, Figure Caption Additional Paragraph, TOC Figure Caption, and Figure Alt Text.
Note
eXtyles does not require that all of these versions of the caption be used for every image in the document: only Figure Caption is required. Whether the other caption styles are used is at the discretion of the USGS; however, note that because the automated InDesign layout software (Typefi) will use the TOC Figure caption to generate the list of figures in the front matter, it may be advisable to include that in the document.
- Figure Caption is used to style the full caption of the image as it will appear next to the image in the body of the document.
- Figure Caption Additional Paragraph is used to style subsequent paragraphs of a caption, if there are more than one. Do not use Figure Caption to style additional paragraphs of the figure caption.
- TOC Figure Caption is the version of the caption that will be used to generate the list of figures in the front matter in the PDF. This caption is often (but does not have to be) different from the primary caption. This paragraph style, when used, will export to <p content-type="toc"> in the <caption> for the figure in the XML (see the following sample).
- Figure Alt Text is the version of the caption that is written to achieve accessibility standards. For example, this version of the caption is what will be read by screen readers, and so on. This paragraph style, when used, will export to <long-desc> in the <caption> for the figure in the XML (see the following sample).
Local formatting such as bold and italic can not be used in an accessibility caption for a figure. To avoid parsing errors, be sure to proof carefully captions that are styled as Figure Alt Text and remove any local formatting before XML export.
The following example shows how these styles should be used (see Figures, Tables, and Sidebars for more information about what the XML these styles will produce).
Note that the order in which these versions of the captions are placed is important for XML export. If all variations are used, the order shown in the above image must be used.
Table Titles
eXtyles includes two distinct styles for table titles: Table Title and TOC Table Title. As with figure captions, titles styled as TOC Table Title will be used to generate a list of tables in the front matter in the PDF.
The following example shows how these styles should be used (see Figures, Tables, and Sidebars for more information about the XML these styles will produce).
