Introduction

These Tagging Guidelines describe PubMed Central's preferred XML tagging style for journal article submissions in the NLM Journal Publishing DTD or the NISO JATS Journal Publishing DTD. Users of this document should have an understanding of XML and a basic familiarity with the DTD.

The Guidelines now include style rules for data tagged in both versions 2.3 and 3.0 of the NLM Journal Publishing DTD as well as version 1.0 of the NISO JATS Journal Publishing DTD. Where style rules differ among the versions, the rules are displayed in colored boxes to distinguish them. The "DTD Version Rule Selection" controls on the left navigation menu allow you to turn on or off all rules for any version. Additionally, in each item where the rules differ, there are links to toggle the version-specific rules on and off.

Tagging Guidelines Organization

The Tagging Guidelines are described in three separate sections. Each section describes separate rules that must be followed when creating PMC-style compliant XML. Many of the rules are related and often contain links to other sections."

In addition to these three sections, all updates to the Tagging Guidelines are documented in the Update History.

General Tagging Practice

These style rules apply to structured data tagging at a very broad level and include formatted text, math, and special characters.

Document Objects

This section describes specific parts of XML documents like figures and author/affiliation relationships. It references specific elements and includes examples of XML tagging.

Elements

This section describes style rules for specific XML elements and their attributes. Only elements for which PMC has a style rule are described in this section. Refer to the Tag Library for descriptions of all elements available in the DTD.

Occasionally the Tagging Guidelines and the Tag Libraries have different tagging instructions or examples. In those cases, tag submissions to PMC according to the examples in the Tagging Guidelines which always describe PMC’s preferred style.

Tools and Resources

PMC has provided the following tools and resources for use with the Tagging Guidelines.

Tagging Guidelines Email List

The Tagging Guidelines and Style Checker are updated periodically, in an effort to make the PMC archive more robust, improve the quality of the XML submitted, and ensure stability for future retrieval. PubMed Central announces these periodic changes through our pmc-tagging-guidelines email list. To subscribe, please visit http://www.ncbi.nlm.nih.gov/mailman/listinfo/pmc-tagging-guidelines.

Style Checker

This web-based tool provides a detailed report of all items in an XML file that do not comply with PMC style. The report will list items as either warnings or errors.

The Style Checker is also available for download as a set of XSL stylesheets. The downloadable version has the same functionality as the web-based version but it can be run locally. If you are unfamiliar with running XSL stylesheets against XML data, please use the web-based version.

Fully-Tagged Samples

2.3

Fully-tagged articles in compressed format are available for download here. They are also available individually:

These articles have been adapted from the version in the PMC archive for tagging illustrations only. The full citation of the original article is included at the top of each article.

3.0

Fully-tagged articles in compressed format are available for download here. They are also available individually:

These articles have been adapted from the version in the PMC archive for tagging illustrations only. The full citation of the original article is included at the top of each article.

1.0

Fully-tagged articles in compressed format are available for download here. They are also available individually:

These articles have been adapted from the version in the PMC archive for tagging illustrations only. The full citation of the original article is included at the top of each article.

Fully-Tagged Citations

2.3

This page shows reference citations tagged in the NLM format and complying with PMC style. The examples are all tagged using the <nlm-citation> element, but PMC style does allow use of the <citation> element as well.

3.0

This page shows reference citations tagged in the NLM format and complying with PMC style. The examples include tagging for both <element-citation> and <mixed-citation> for each citation. PMC has no preference of one element over the other.

1.0

This page shows reference citations tagged in the NLM format and complying with PMC style. The examples include tagging for both <element-citation> and <mixed-citation> for each citation. PMC has no preference of one element over the other.