Journal Publishing Tag Set


Introduction

The National Center for Biotechnology Information (NCBI), a center of the National Library of Medicine (NLM), created the Journal Publishing Tag Set with the intent of providing a common format for the creation of journal content in XML.

For journals that have not selected an SGML/XML model, NCBI will encourage the use of this Tag Set's Document Type Definition (DTD) version to define the incoming data for PubMed Central, the U.S. National Library of Medicine's digital archive of life sciences journal literature.

Ancestry

The Tag Set was constructed using the modules of the Archiving and Interchange Tag Suite and has been modeled along the same philosophical lines as the Archiving and Interchange Tag Set, which is a Tag Set for interchange and storage of journal material. However, because this is a publishing Tag Set optimized for the creation of new material, the Tag Set is far smaller (fewer elements and fewer choices in many contexts) than the full Journal Archiving and Interchange Tag Set. The philosophy for the interchange Tag Set was to accept as many varied forms of as many structures as possible. The philosophy of this Tag Set is to prefer a single structural form, or at least a single style of tagging to simplify the creation of content in XML.

PubMed/MEDLINE

If you want to submit citations and abstracts to NLM for inclusion in PubMed/MEDLINE, use the PubMed Journal Article DTD. Detailed information is available from the PubMed Web site: Information for Publishers re: XML Tagged Data.

Documentation

The complete documentation for the Document Type Definition (DTD) version of this Tag Set is available in the tag library http://dtd.nlm.nih.gov/publishing/tag-library.

The Tag Library contains the following sections:

Introduction

An introduction to the contents of this Tag Library, to the design philosophy and intended usage of the Journal Publishing DTD.

Elements Section

Descriptions of the elements used in the Journal Publishing DTD.

Attributes Section

Descriptions of the attributes in the DTD modules.

Parameter Entity Section

Names (with occasional descriptions) and contents of the Parameter Entities in the DTD modules.

Context Table

Listings of where each element may be used. All elements are given in a simple alphabetical list. There is a single table for the elements from all the Suite modules that are called from the DTD.

Document Hierarchy Diagrams

Tree-like graphical representations of the content of many elements. This can be a fast visual way to determine the structure of an article or of any element within an article.

Full Article Samples

Two full articles are provided in both PDF form and in XML according to this DTD. These are provided to help users understand the relationship between the article as displayed and the XML version of the article.

Index by Tag Name

Index of element descriptions, alphabetically by tag name (element-type name).

Index by Element Name

Index of element descriptions, alphabetically by element name (the longer, more descriptive name).

DTD Section

Copies of the Journal Archiving and Interchange DTD, its customization module, and the full Archiving and Interchange DTD Suite of XML DTD modules described in the Tag Library.

Also, the DTD modules themselves are well commented.

Frequently Asked Questions

A Frequently Asked Questions page is available.

Getting the Files

The DTD files and W3C Schema version are available by anonymous FTP: ftp://ftp.ncbi.nih.gov/pub/archive_dtd/publishing.

A direct link to the files is available: ftp://ftp.ncbi.nih.gov/pub/archive_dtd/publishing/2.3/journal-publishing-dtd-2.3.zip and ftp://ftp.ncbi.nih.gov/pub/archive_dtd/publishing/2.3/journal-publishing-xsd-2.3.zip and ftp://ftp.ncbi.nih.gov/pub/archive_dtd/publishing/2.3/journal-publishing-rng-2.3.zip.

The DTD is available on the Web: http://dtd.nlm.nih.gov/publishing/2.3/journalpublishing.dtd

The W3C XML Schema is available on the Web: http://dtd.nlm.nih.gov/publishing/2.3/xsd/journalpublishing.xsd

The RELAX NG Schema is available on the Web: http://dtd.nlm.nih.gov/publishing/2.3/rng/journalpublishing.rng

Updates

Version

The current version of the Journal Publishing DTD is v2.3.

Version 2.3 was released on March 28, 2007. A detailed explanation of the changes from version 2.2 is available in the v2.3 Change Report.

Version 2.2 is available here: http://dtd.nlm.nih.gov/publishing/2.2/.

Version 2.1 is available here: http://dtd.nlm.nih.gov/publishing/2.1/.

Version 2.0 is available here: http://dtd.nlm.nih.gov/publishing/2.0/.

Version 1.1 is available here: http://dtd.nlm.nih.gov/publishing/1.1/.

Version 1.0 is available here: http://dtd.nlm.nih.gov/publishing/1.0/.

W3C XML Schema Version

A W3C XML Schema has been generated from the DTD. The Schema version describes the same content model as the DTD. Information is available on the W3C XML Schema page.

RELAX NG Schema Version

A RELAX NG Schema has been generated from the DTD. The Schema version describes the same content model as the DTD. Information is available on the RELAX NG Schema page.

Feedback

Please submit all questions or comments to publishing-dtd@ncbi.nlm.nih.gov.

This is a public mailing list. More information on the list is available: http://www.ncbi.nlm.nih.gov/mailman/listinfo/publishing-dtd.

If you are interested in making a new version of the DTD, please see the Archiving and Interchange DTD Suite site for information about creating a new DTD from the Suite of DTD modules.

Any suggestions for changes to the Tagset or documentation should be made through the Journal Article Tag Set Comment Form at the Mulberry Technolgies site.

Coding Examples

Examples of tables and citations using the Journal Publishing DTD are provided in this section. The citation examples illustrate fully tagged National Library of Medicine citations. The table examples demonstrate a wide array of style-compliant tables.

Tools

NLM has created an XSL transform to HTML for previewing content in the Archiving and Interchange DTD and a Cascading Style Sheet to support it.

An XSL-FO transform is available for previewing content in the Journal Publishing DTD.

Related DTDs

This DTD was constructed using the modules in the Archiving and Interchange DTD Suite.

If you want to submit citations and abstracts to NLM for inclusion in PubMed/MEDLINE, use the PubMed Journal Article DTD. Detailed information is available from the PubMed Web site: Information for Publishers re: XML Tagged Data.

NCBI has also created a DTD for textbooks from the modules. Details are here: Book DTD.

XML Information

Links to general information on XML, XSLT, Unicode™, and XLink are available on the XML Resources page.


PubMed Central
NCBI | NLM | NIH
Department of Health & Human Services
Freedom of Information Act | Disclaimer
Last updated: March 27, 2007