Table 1

Content Tagging Principles

  • Elements: Use an element to tag what is seen, i.e., visible content.
  • Attributes: Use an attribute to describe data of the element or about publishing.
  • Define attribute values consistently: all lowercase, hyphens instead of underscores
  • All true content that is rendered should be present and visible in the XML.
  • Stick with the facts…“Say what you know.” What are the facts you know about the content. Do not manipulate content with “filler” information to suit a process. For example, do not set a bogus “day” in a date if there is no day as commonly found with cover dates.
  • Always strive to name the content for what it is. That is, use the markup that best identifies the content. For example, a running head is a print artifact and the shortened title is really, from a content perspective, a “short title” not a running head.

From: How Well Do You Know Your Data? Converting an Archive of Proprietary Markup Schemes to JATS: A Case Study

Cover of Journal Article Tag Suite Conference (JATS-Con) Proceedings 2012
Journal Article Tag Suite Conference (JATS-Con) Proceedings 2012 [Internet].
© Copyright 2012 Authors. This article is distributed under a Creative Commons Attribution 3.0 Unported License.

The copyright holder grants the U.S. National Library of Medicine permission to archive and post a copy of this paper on the Journal Article Tag Suite Conference proceedings website.

NCBI Bookshelf. A service of the National Library of Medicine, National Institutes of Health.