Article Authoring Tag Set


Introduction

The National Center for Biotechnology Information (NCBI), a center of the National Library of Medicine (NLM), created the Article Authoring Tag Set with the intent of providing a common format for the authoring of journal articles in XML.

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.

The Authoring Tag Set was created version 2.1 of the Tag Suite, so it began life as Version 2.1. The Authoring Tag Set is tighter and more prescriptive than any of the other Tag Sets as it was intended to make a smaller, more manageable subset of the elements for use in an XML editor.

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/articleauthoring/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 Article Authoring DTD.

Elements Section

Descriptions of the elements used in the Article Authoring 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 Article Authoring 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/article_authoring.

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

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

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

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

Updates

Version

The current version of the Article Authoring DTD is v2.3.

Version 2.3 was released on March 28, 2007. A detailed explaination 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/2.2/

Version 2.1 is available here: http://dtd.nlm.nih.gov/2.1/. Version 2.1 was the first release of the Article Authoring DTD. Because it was based on Version 2.1 of the Archive and Interchange DTD Suite, its version number is also 2.1.

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.

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.

Related DTDs

This DTD was constructed using the modules in the Archiving and Interchange DTD Suite. It is related closely to the Journal Publishing DTD.

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