Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Description of Map Units (DMU) sections that appear in some USGS documents are often more complex than standard abbreviations lists or glossaries; for example, they often contain subheadings and citations. To support this complexity, DMU sections have a unique set of paragraph styles that must be carefully applied to produce valid and correct XML.


Panel
titleIn this section

Table of Contents




Although DMU sections can appear at either the start or end of the document, DMU-specific styles are located on the Back1 Tab of the eXtyles style pallet. A DMU section, when properly styled, will look something like the image to the right.

Paragraph Styling

Definitions

DMU Title (

Front

Back) /

Definitions

DMU Title (

Back

Front)

The Definitions DMU Title (Front or Back) style should be used to style the Description of Map Units title, depending on where the section falls in the document (either at the front or the back of the document).

DMU Authors

The DMU Authors paragraph style should be used to style the author line, if present, for a DMU section.

Definitions List Subhead 1 and 2

Although infrequent, authors for a DMU section must be styled using this paragraph style; do not use Chapter Author.

DMU Body Text

The DMU Body Text style can be used to style any discursive text (headnote) that may appear at the start of the DMU section. This will be text that is likely introductory or explanatory in content, and is not a DMU List Item.

DMU Headings (1, 2, 3, 4)

If the DMU section contains subheadings (as in the example), use these styles regardless of whether the DMU section is at the start or end of the document.

DMU List Item (1, 2, 3, 4, 5)

The text of the DMU list item items should be styled with the DMU List Item paragraph stylestyles. Do not use the regular Definition List Item paragraph style for this section, else citation matching will pass over the content.

Further, to accurately capture the hierarchy of the list items it is important that the proper list item level be used. For example, a DMU List Item 2 should never be the first list item in a DMU section, because level 2 items will always be subordinate to level 1 items.

DMU Continued Paragraph

Use this to style a paragraph that is a continuation of a list item; that is, a list item that is more than one paragraph would use the proper DMU List Item style for the first paragraph, and DMU Continued Paragraph for all subsequent paragraphs that are part of the list item.

Image Added

DMU Format

During XML export, eXtyles will tag the term and definition of a DMU List Item. For example, the following List Item will produce the subsequent XML:

Qof1      Old alluvial-fan deposits, Unit 1 (upper to middle Pleistocene)—Brownish sandy and gravelly sediment occurring along east-central edge of map area. Unit deposited as thin veneers on erosional strath surfaces incised into unit Qvof3

Code Block
languagexml
<def-item><term><styled-content style-type="normal"><private-char description="FGDCGeoAge" name="Quaternary"/></styled-content>of<sub>1</sub> </term><def><p><bold>Old alluvial-fan deposits, Unit 1 (upper to middle Pleistocene)</bold>—Brownish sandy and gravelly sediment occurring along east-central edge of map area.
Image Removed
 Unit deposited as thin veneers on erosional strath surfaces incised into unit Qvof<sub>3</sub></p></def></def-item>

You can see that the term, Qof1, is tagged in the XML as <term> (with the correct font mapping, <private-char description="FGDCGeoAge" name="Quaternary"/>, which is captured in the XML if the FGDCGeoAge font is used in the Word document). However, this is only achieved if a tab is used after the term in the Word document.

Tip
titleTip

To ensure that the XML correctly captures the term and definition of a DMU List Item, tabs must be used after the term in the Word document.


DMU and Citation Matching

eXtyles Citation Matching will run on a properly styled DMU section (see the image to the right). However, note that in

Warning

In an eXtyles workflow, tagged (i.e., styled with the turquoise eXtyles cite_bib character style) citations are not supported in a term of the definition paragraph.

In

That is, in the example to the right,

notice that the (Conrad 1839) citation has had the cite_bib character style removed (using Ctrl + Space). To avoid parsing errors during XML Export, you must ensure that no tagging remains on any citations that appear within the term of the definition paragraph, or move those citations from the bold term to within the body of the definition.Image Removed

a tagged citation would not be allowed with the DMU term QTstm.





Image Added