Keywords, Abbreviations, and Glossaries

eXtyles will automatically parse keywords, abbreviations, and glossary paragraphs to XML keyword groups or definition lists, according to certain standard editorial styles. In particular, they must be segmented consistently into their various elements.

Keywords

Unless otherwise specified in your export filter, the strongest symbols to separate keywords are semicolons, em dashes, and bullets. These characters are highly unlikely to occur within the text of a single keyword. If eXtyles finds one of these characters within the keywords paragraph, if will use that character to separate the paragraph into individual keywords. If eXtyles fails to find either semicolons or bullets in the keyword paragraph, it will try weaker characters in an attempt to parse the list. These characters are tabs, em spaces, commas (followed by a space), and slashes with spaces on either side.

The following Word paragraph will be correctly processed during XML export:

Keywords: bone marrow-derived macrophages; dihydrofolate; site-directed mutagenesis

to yield the following XML:

<kwd-group>
<title><bold>Keywords:</bold> </title>
<kwd>bone marrow-derived macrophages</kwd>
<kwd>dihydrofolate</kwd>
<kwd>site-directed mutagenesis</kwd>
</kwd-group>

eXtyles will also automatically parse specialized keyword vocabularies such as PACS, OCIS, or JEL codes.

Abbreviations

For the purposes of eXtyles, an "Abbreviations" paragraph is a list of two or more term–definition pairs in a single paragraph.

For parsing of abbreviations, eXtyles uses strong and weak characters in turn to attempt to separate the paragraph into its elements. The strong characters are tabs, (semi)colons, and em dashes. Weak characters are en dashes and commas. Consistent use of strong separator characters is crucial to obtaining accurate XML.

Examples of Abbreviations paragraphs that will yield correct XML include:

ExPEC, extra-intestinal pathogenic Escherichia coli; SSTI, skin and soft-tissue infection; UTI, urinary tract infection.

ExPEC — extra-intestinal pathogenic Escherichia coli: SSTI — skin and soft-tissue infection: UTI — urinary tract infection.

These various styles will yield the following XML:

<def-list list-type="simple" list-content="abbreviations">
<def-item>
<term>ExPEC</term>
<def><p>extra-intestinal pathogenic <italic>Escherichia coli</italic></p></def>
</def-item>
<def-item>
<term>SSTI</term>
<def><p>skin and soft-tissue infection</p></def>
</def-item>
<def-item>
<term>UTI</term>
<def><p>urinary tract infection</p></def>
</def-item>
</def-list>

The characters that are used to separate the abbreviation and definition and the abbreviation–definition pairs generally cannot be used within an abbreviation or definition. For example, the following abbreviations list would not be parsed correctly because a comma appears in the first definition:

Abbreviations: ExPEC, extra-intestinal, pathogenic Escherichia coli; UTI, urinary tract infection.

Glossary

For the purposes of eXtyles, a "Glossary" is a multi-paragraph list with one term–definition pair per paragraph. This definition allows rather more flexibility in style. As with abbreviations, consistent use of a strong separator character is crucial to obtaining accurate XML. The glossary section must always appear in the <back> section of your XML.

The following paragraphs would parse to give correct XML:

1) Term in bold

ExPEC Extra-intestinal pathogenic Escherichia coli

SSTI Skin and soft-tissue infection

UTI Urinary tract infection

2) Tab separating term and definition

ExPEC   Extra-intestinal pathogenic Escherichia coli

SSTI      Skin and soft-tissue infection

UTI        Urinary tract infection

3) Colon, equal sign, or other "strong" separator separating term and definition

ExPEC: Extra-intestinal pathogenic Escherichia coli

SSTI: Skin and soft-tissue infection

UTI: Urinary tract infection

These various styles each yield the following XML:

<glossary>
<def-list>
<def-item>
<term>ExPEC</term>
<def><p>Extra-intestinal pathogenic <italic>Escherichia coli</italic></p></def>
</def-item>
<def-item>
<term>SSTI</term>
<def><p>Skin and soft-tissue infection</p></def>
</def-item>
<def-item>
<term>UTI</term>
<def><p>Urinary tract infection</p></def>
</def-item>
</def-list>
</glossary>

Definition List

Similar to a "Glossary" (described above), a "Definition List" is a multi-paragraph list with one term–definition pair per paragraph. As with abbreviations and glossary entries, consistent use of a strong separator character is crucial to obtaining accurate XML. A Definition List is exactly the same as as a Glossary except that a definition list can occur in-line in the body text, while a glossary must appear in the backmatter.

© 2021 Atypon Systems. All Rights Reserved.

Icons made by Freepik from Flaticon are licensed under CC 3.0 BY