Tagging Keywords

Keywords are words and phrases used to name an article’s or section’s key concepts for search and retrieval purposes. Typically an author, publisher, or indexing service will assign a small number of key terms to expand lookup beyond full text, to point up the most important topics described in an article, or to map an article to a taxonomy. Indexers assigning keywords can make sure that someone searching for “this topic” will find this article or section, even if the exact words are not present in the text. Thus keywords may be key words taken from the text, from an outside vocabulary or taxonomy, or selected by authors, indexers, or publishers.
In this Tag Set, keywords come in sets (<kwd-group>), each of which may come from a particular source or ontology (such as “author-created” or the “MeSH Subject Headings”). The sets are named using the @kwd-group-type attribute. Here are some sample tagged keywords that a contributor chose as best describing an article:
<kwd-group kwd-group-type="author-created">
  <kwd>acid precipitation</kwd>
  <kwd>acid rainfall</kwd>    
  <kwd>smelting region</kwd>
  <kwd>Aluminum residues</kwd>
  <kwd>Sulphur dioxide</kwd>
  <kwd>Copper-nickel smelters</kwd>
Tagging Complex/Compound Keywords
Keywords can possess an internal structure of their own; for example, a keyword may include both a textual phrase and its corresponding code (“863 Icelandic sagas”). Many styles of such compound keywords can be handled in this Tag Set with the <compound-kwd> element, which is modeled as a series of repeatable parts (<compound-kwd-part>). These parts can differentiate a text/code pair, divide a coded keyword into multiple code segments, describe a hierarchy, and name a variety of other compound structures. The @content-type attribute on the <compound-kwd-part> element is used to name each part, describe the role it plays, or otherwise define how each part functions within the keyword as a whole.
Keywords with Codes
The simplest case of a compound keyword is a keyword that includes both a textual phrase and its corresponding code, for example, “863 Icelandic sagas”. Both the code and the text can be tagged as keywords parts (<compound-kwd-part>) inside the element <compound-kwd>, with the @content-type attribute used to name the role or type of each part:
<kwd-group kwd-group-type="ISO-463">
      content-type="ISO-463-text">Icelandic sagas</compound-kwd-part>
Abbreviation and Expansion Keywords
Compound keywords can also be used to handle keywords that hold an abbreviation and its expansion. Both the abbreviation and the expansion are tagged as <compound-kwd-part> in a single <compound-kwd>. The @kwd-group-type attribute on <kwd-group>, which is sometimes used to name the source or the descriptor for the keywords, can be used instead to name the type of information, such as “abbreviations”. For example:
<kwd-group kwd-group-type="abbreviations">
    <compound-kwd-part content-type="abbrev">WT</compound-kwd-part>
    <compound-kwd-part content-type="expansion">WildType</compound-kwd-part>
    <compound-kwd-part content-type="abbrev">CFU</compound-kwd-part>
    <compound-kwd-part content-type="expansion">Colony-forming unit</compound-kwd-part>
Tagging Nested or Hierarchical Keywords
Some publishers assign hierarchical topics to articles. For example, a publisher might tag selected topics (“Blood–brain barrier”), nested inside themes (“Cellular and Molecular Biology”), grouped into larger units like “Neuroscience”, and grouped into still larger units such as “Biological Sciences”, forming the following hierarchy:
Biological Sciences
      Cellular and Molecular Biology
         Blood–brain barrier
Hierarchical (nested) keywords structures, while still rare, are becoming more common as taxonomies are used to tag keywords for articles. Each <nested-kwd> contains a single keyword and any levels of nesting under that keyword. Since nested keywords are recursive, these lower levels are inside an inner <nested-kwd>. The same example is used below to show how nested keywords work:
<kwd-group kwd-group-type="author" xml:lang="en">
    <kwd>Biological Sciences</kwd>
        <kwd>Cellular and Molecular Biology</kwd>  
          <kwd>Blood&ndash;brain barrier</kwd> 
Keywords from a Formal Taxonomy
If the content of a keyword or group of keywords contains terms from a thesaurus (ontology, taxonomy, term-list, vocabulary, industry glossary, thesaurus, or other known term source), the JATS vocabulary attributes can be used to name the vocabulary, providing additional semantics for the term. The keyword semantic source named should be named when it is a formal ontology and can be named when it is an informal field of study.

Vocabulary Naming Attributes

Two JATS vocabulary attributes name the controlled or uncontrolled vocabulary. They can be used on individual keywords (<kwd>, <compound-kwd>, <compound-kwd>) or on groups of keywords to refer to each of the keywords in the group (<kwd-group>).
Name of the controlled or uncontrolled vocabulary, taxonomy, ontology, index, database, term list, thesaurus, industry glossary or similar that is the source of the keyword term. For example, a keyword might be taken from the IPC Codes (“ipc”), MESH headings (“mesh”), or NISO CRediT, Contributor Roles Taxonomy (“credit”). For an uncontrolled keyword term, the value might be an area of study such as “medical-devices” or merely the word “uncontrolled”.
Unique identifier of the vocabulary, such as (but not limited to) a URI or DOI. For example, for Dublin Core (DCC), the identifier might be “http://dublincore.org/documents/2012/06/14/dces/”.

Keyword Term Naming Attributes

Two JATS vocabulary attributes name the term from a controlled or uncontrolled vocabulary. They are be used on individual keywords (<kwd>, <compound-kwd>, <compound-kwd>) to further identify the semantics of the term.
Where the @vocab and @vocab-identifier attributes described above identify the vocabulary (ontology, taxonomy, etc.) of a keyword, these two vocabulary attributes identify the individual term from such a controlled or an uncontrolled vocabulary:
The content of the element is the free prose version of the vocabulary or taxonomic term. The @vocab-term attribute holds the canonical version of the same term, as it appears in the vocabulary. For example, if the @vocab-term attribute value was “digitized-vor”, the element might contain a display text such as “Digitized Version of Record”.
The unique identifier of the term within a specific vocabulary, such as (but not limited to) an item number, a URI, DOI, etc.