Versions Compared

Old Version 3

changes.mady.by.user Jenny Seifert (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Jenny Seifert (Unlicensed)

Saved on

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

Paragraph Styling

DMU

Title

Head 1 (Back) / DMU

Title

Head 1 (Front)

The DMU Title Head 1 (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 Units (1, 2, 3, 4, 5)

The text of the DMU items should be styled with the DMU 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 items it is important that the proper unit level be used. For example, a DMU Unit 2 should never be the first item in a DMU section, because unit 2 items will always be subordinate to 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 RemovedImage Added


DMU Format

Term and Definition

During XML export, eXtyles will tag the term and definition of a DMU Unit. For example, the following 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 Qvof3Qal      Unconsolidated sedimentary deposits—Include alluvium, beach- and bay-filling deposits, gravel, and sand

Code Block
languagexml
<def-item><term><styleditem>
<term><styled-content style-type="normal"><private-char description="FGDCGeoAge" name="Quaternary"/></styled-content><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><content style-type="normal"><private-char description="FGDCGeoAge" name="a"/></styled-content><styled-content style-type="normal"><private-char description="FGDCGeoAge" name="l"/></styled-content></term>
<def><p><bold>Unconsolidated sedimentary deposits</bold>&#x2014;Include alluvium, beach- and bay-filling deposits, gravel, and sand</p></def>
</def-item>

You can see that the term, Qof1Qal, 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)<term> > and the description of the term is correctly tagged as <def>. However, this is only achieved if a tab is used after between the term and definition in the Word document.

Tip
titleTip

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

FGDCGeoAge Font Mapping

When the FGDCGeoAge font is applied to text, the font attribute will be captured in the XML so that the text can be rendered correctly in the PDF. In the previous example, the term Qal, which in the Word document has the FGDCGeoAge font applied, will export as styled content in the XML:

Code Block
languagexml
<private-char description="FGDCGeoAge" name="Quaternary"/></styled-content><styled-content style-type="normal"><private-char description="FGDCGeoAge" name="a"/></styled-content><styled-content style-type="normal"><private-char description="FGDCGeoAge" name="l"/></styled-content>


Note
titleNote

This font mapping behavior applies to anywhere the FGDCGeoAge is used in the Word document, not just the DMU sections.

Map Labels

Occasionally map label or other identifiers will appear at the end of a term in a DMU section. These identifiers may need to be set in a different front from the rest of the DMU text. The use of the eXtyles Map Label character style will facilitate this design requirement.

For example, in the following unit, the text “FID 783” will need to be set in Arial font in the PDF. In the Word document it has had the Map Label character style applied.

Image Added

The Map Label character style must be manually applied to the content; that is, there is no eXtyles Advanced Process that will automatically style this content. When the style is used, when the document is exported to XML the following is achieved, where the label is tagged as <named-content>:

Code Block
<def-item>
<term>a0a1, p0a1, s0a1´</term><def><p><bold>A.D. 1984 flow</bold>&#x2014;Aphanitic ‘a‘ā, with <1% olivine phenocrysts 1-2 mm in size. Vents were distributed along 15-km segment of NERZ between 9,350- and 12,400-ft elev. Most fissures are west of map area at higher elevations. <named-content content-type="map-label">FID 783</named-content></p></def>
</def-item>

The Map Label character style can be used anywhere in the text (not just the DMU section).


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.