Versions Compared

Key

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

The key to obtaining correct XML is for the Word file to be correctly structured. In addition to the correct use of Word paragraph and character styles and paragraphs not appearing in "forbidden" locations, certain document elements need to be structured appropriately for the XML to be correct.

eXtyles is designed to identify various sub-elements within certain paragraph styles automatically. This not only saves you time but also reduces the number of styles that your configuration requires. Cases where eXtyles automatically tags content on export are illustrated in the following sections.

Table of Contents

Authors and Collaborators

Author Names

The eXtyles Advanced Process for Author Processing will parse paragraphs with author names into their constituent elements (surname, given names, initials, prefixes, and suffixes) as well as identifying organizational authors. eXtyles can also distinguish between various types of contributors (e.g., authors and editors) depending on context in the document.

The author list must be reviewed after running Author Processing to ensure that the various elements have been correctly identified. Certain situations can cause problems for Author Processing in the standard eXtyles configuration: names in non-Western order (i.e., Surname Given-Names); multi-word surnames separated by spaces; unusual or non-standard degree names.

Errors in Author Processing can be corrected by careful hand tagging.

Please be aware that degree names must be explicitly listed in an eXtyles data file. If you find that a degree is not shaded with the correct color, then it’s likely that it is not listed in the eXtyles data file and instead eXtyles misapplied the au_orgname character style. When this happens, please fix the character style manually and report the missing degree to eXtyles-support@inera.com.

Introductory text in an author paragraph, such as "By" or "Edited by", must also be styled as au_prefix.

Author Affiliations

Author affiliations can be edited as one affiliation per paragraph, or as multiple affiliations in a single paragraph.

In the "one affiliation per paragraph" style, when superscript letters, numbers, or symbols are used to link affiliations to authors, the linking character must be at the start of the affiliation paragraph.

The following author list and affiliations will parse correctly:

Brian A. Peterson1, J. Adam Beeco2, Sharolyn J. Anderson2, & Damon Joyce2

1Kansas State University, Manhattan, Kansas

2National Park Service, Natural Sounds and Night Skies Division, Fort Collins, Colorado

This style makes good use of space if multiple authors share affiliations. The example yields the following XML:

Code Block
breakoutModewide
languagexml
<contrib-group content-type="authors">
<contrib contrib-type="author"><string-name><given-names>Brian A.</given-names><x> </x><surname>Peterson</surname></string-name><xref ref-type="aff" rid="aff1"><sup>1</sup></xref><x>, </x></contrib>
<contrib contrib-type="author"><string-name><given-names>J. Adam</given-names><x> </x><surname>Beeco</surname></string-name><xref ref-type="aff" rid="aff2"><sup>2</sup></xref><x>, </x></contrib>
<contrib contrib-type="author"><string-name><given-names>Sharolyn J.</given-names><x> </x><surname>Anderson</surname></string-name><xref ref-type="aff" rid="aff2"><sup>2</sup></xref><x>, &amp; </x></contrib>
<contrib contrib-type="author"><string-name><given-names>Damon</given-names><x> </x><surname>Joyce</surname></string-name><xref ref-type="aff" rid="aff2"><sup>2</sup></xref></contrib>
<aff id="aff1"><label>1</label><institution>Kansas State University</institution>, <addr-line>Manhattan, Kansas</addr-line></aff>
<aff id="aff2"><label>2</label><addr-line>National Park Service</addr-line>, <institution>Natural Sounds and Night Skies Division</institution>, <addr-line>Fort Collins, Colorado</addr-line></aff>
</contrib-group>