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 DMU Tab of the eXtyles style pallet. A DMU section, when properly styled, will look something like similar to the image to the right (though possibly not all elements, such as the author line, will be included).

Paragraph Styling

DMU Title (Back) / DMU Title (Front)

The 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. 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

Units (1, 2, 3, 4, 5)

The text of the DMU list items should be styled with the DMU List Item Unit paragraph styles. 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 unit level be used. For example, a DMU List Item Unit 2 should never be the first list item in a DMU section, because level unit 2 items will always be subordinate to level unit 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 Removed

Image Added


DMU Format

During XML export, eXtyles will tag the term and definition of a DMU List ItemUnit. For example, the following List Item unit 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. 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 ItemUnit, 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).

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. That is, in the example to the right, a tagged citation would not be allowed with the DMU term QTstm.