Introduction
The Article Authoring Tag Set creates a standardized format for new journal articles that can be used by authors to submit publications to journals and to archives such as PubMed Central. While in theory the document scope is the same as for the Publishing Tag Set, in practice Authoring defines elements and attributes that describe the content of typical research-style journal articles.
This is a Tag Set optimized for authorship of new journal articles, where regularization and control of content is important, and where it is useful rather than harmful to have only one way to tag a structure. Therefore Authoring is more prescriptive than descriptive and includes many elements whose content must occur in a specified order.
Since an author is assumed to be creating and submitting an article for submission to a journal or journals, no publishing history or journal-specific information has been included in this Authoring Tag Set.
Since no assumptions can be made concerning the processing software or editorial situation that will receive an article authored in this Tag Set, tagging that forces specific formatting has also been avoided. There is no way for an author to number his/her lists explicitly, for example, or to manually number the cited references, since many journals have their own citation policies and publication styles. Numbers for the cited references must be generated by the publisher’s software to match editorial policy and established practice.
Documentation
The complete documentation for this Tag Set is available in the Tag Library http://dtd.nlm.nih.gov/articleauthoring/tag-library/. The structure and suggested usage of the Tag Library is described in the How to Use (Read Me First) section.
A Frequently Asked Questions page is available.
Available Schemas
In addition to the DTD format, the Tag Set is also available as a W3C XML schema and as a RELAX NG schema. Both are generated directly from the DTD and neither is intended for maintenance. See the individual schema pages for more information.
Getting the Files
All of the Tag Set files are available by anonymous FTP: ftp://ftp.ncbi.nih.gov/pub/archive_dtd/articleauthoring/.
The files are directly available through the following links:
DTD: ftp://ftp.ncbi.nih.gov/pub/archive_dtd/article_authoring/3.0/article-authoring-dtd-3.0.zip
W3C XML schema: ftp://ftp.ncbi.nih.gov/pub/archive_dtd/article_authoring/3.0/article-authoring-xsd-3.0.zip
RELAX NG schema: ftp://ftp.ncbi.nih.gov/pub/archive_dtd/article_authoring/3.0/article-authoring-rng-3.0.zip
Each schema is also available through the web at the following stable URIs. Please note that not all browsers will display these files properly, but the files are viewable in XML or text editors.
DTD: http://dtd.nlm.nih.gov/articleauthoring/3.0/articleauthoring3.dtd
W3C XML schema: http://dtd.nlm.nih.gov/articleauthoring/3.0/xsd/articleauthoring3.xsd
RELAX NG schema: http://dtd.nlm.nih.gov/articleauthoring/3.0/rng/articleauthoring3.rng
Versions
The current version of the Article Authoring Tag Set is v3.0.
Version 3.0 was released on November 21, 2008. A detailed explanation of the changes from version 2.3 is available in the v3.0 Change Report.
Version 2.3 is available here: http://dtd.nlm.nih.gov/archiving/2.3/
Version 2.2 is available here: http://dtd.nlm.nih.gov/archiving/2.2/
Version 2.1 is available here: http://dtd.nlm.nih.gov/archiving/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 Tag Suite, its version number is also 2.1.
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.
Any suggestions for changes to the Tag Set or documentation should be made through the Journal Article Tag Set Comment Form at the Mulberry Technologies site.
Related Tag Sets
The Archiving Tag Set, created from the Tag Suite, is less prescriptive than the Publishing Tag Set. It enables archives to capture but structural and semantic components and does not enforce any particular sequence or textual format.
The Journal Publishing Tag Set, created from the Tag Suite, is more prescriptive than the Archiving Tag Set. It is optimized for use by publishers and archives interested in regularizing their data.
The NCBI Book Tag Set was designed to accommodate tagging for books as part of the NCBI Bookshelf project.
Individuals wanting to submit citations and abstracts for inclusion in PubMed/MEDLINE should use the PubMed Journal Article DTD. See the Information for Publishers re: XML Tagged Data on the PubMed web site.
Tools
All of the tools described in this section are available at http://dtd.nlm.nih.gov/tools/.
NLM has created an XSL transform that converts data in any version of the Archiving Tag Set into version 3.0 of the Tag Set. Information about customizing and using the transform is available in the transform’s documentation.
The following tools work only with versions of the Tag Set prior to 3.0. NLM will release versions of these tools to work with 3.0 as they become available.
HTML Preview Tool – Includes an XSL transform to generate HTML from Archive and Interchange XML and a Cascading Style Sheet to support it.
XSL-FO Preview Tool – XSL transform to generate readable formatted pages from Archive and Interchange XML.
XML Information
Links to general information on XML, XSLT, Unicode™, and XLink are available on the XML Resources page.
|
National Center for Biotechnology Information Last updated: November 21, 2008 |
