Skip to content

Basic JATS document template generator plugin for OJS

License

Notifications You must be signed in to change notification settings

pkp/jatsTemplate

Repository files navigation

JATS Template Plugin

This plugin permits OJS to use a basic JATS XML document generated from the OJS metadata and full-text extraction in cases where a better JATS XML document is not available.

It is intended to be used in concert with the OAI JATS plugin (available at https://github.com/pkp/oaiJats) to deliver JATS via OAI for journals that do not have better JATS XML available.

Note that the JATS XML this plugin delivers it not intended for publication i.e. using Lens Reader -- considerable additional improvement and quality control would be required before the document is suitable for that purpose.

Tag Definition Support Unit-tests
journal-id Short code or abbreviation used as an identifier for a journal. 🆗 🆗
journal-title-group Container element for the titles of the journal in which the article was published. 🆗 🆗
journal-title Full title of the journal in which the article was published. 🆗 🆗
trans-title-group Container element for translated and transliterated titles. 🆗 🆗
trans-title Title of a document or document part that has been translated into a language other than that of the original publication. When a document is published simultaneously in more than one language, one language must be chosen for the title and all other document titles become translated titles. 🆗 🆗
abbrev-journal-title Short form of the title of the journal in which an article is published. 🆗 🆗
publisher Container element for information about the person, company, or other entity that published a work. 🆗 🆗
publisher-name Name of the person, company, or other entity that published a work. 🆗 🆗
issn International Standard Serial Number, the international code that uniquely identifies a serial publication title. 🆗 🆗
article-meta Container element for information concerning the article that identifies or describes the article. 🆗 🆗
article-id Unique external identifier assigned to an article. 🆗 🆗
article-categories Container element for elements that may be used to group articles into related clusters, for example, by subject matter or by series. 🆗 🆗
subj-group Container element for the subject matter designations describing a document’s content or a component document’s content. Subjects are used to organize documents into groupings (potentially hierarchical groupings) for display or print. 🆗 🆗
subject Name of one subject or topic used to describe an article. Such topics and groupings of topics are typically used to provide headings for groups of documents or document components in a printed, or online, generated Table of Contents. 🆗 🆗
title-group Container element to hold the various titles for a document or a document component. 🆗 🆗
article-title Full title of an article. 🆗 🆗
contrib-group Container element for one or more contributors and information about those contributors. 🆗 🆗
contrib Container element for information about a single author, editor, or other contributor. 🆗 🆗
email Electronic mail address of a person or institution. 🆗 🆗
xref Reference to an object within the document (for example, a table, a bibliographic citation). 🆗 🆗
name Container element for the component elements of personal names 🆗 🆗
surname Surname of a person. 🆗 🆗
given-names All given names of a person, such as the first name, middle names, maiden name if used as part of the married name, etc. 🆗 🆗
aff Name of an institution or organization (for example, university, corporation) with which a contributor is affiliated. 🆗 🆗
institution Name of an institution or organization (for example, a university or corporation). 🆗 🆗
fpage Page number on which a document starts. 🆗 🆗
lpage Page number on which a document ends. 🆗 🆗
permissions Container element for copyright and license information for the entire article or for the object which contains the element. 🆗 🆗
copyright-statement Copyright notice or statement, suitable for printing or display. 🆗 🆗
copyright-year The year of copyright. 🆗 🆗
copyright-holder Name of the organizational or personal entity that holds a copyright. 🆗 🆗
self-uri URI for another version of a document. This element may be used when the document is available in multiple forms (for example, printed article and in its expanded version with additional graphics available online). 🆗 🆗
kwd-group Container element for one set of keywords (such as s, s, or s) used to describe a document. 🆗 🆗
kwd A keyword is a finding aid used to record one subject term, key phrase, abbreviation, indexing word, taxonomic structure, or other expression that is associated with a whole structure (such as an article). Keywords can be used for identification, searching, and indexing purposes. A keyword element () may contain a repetition of words found in the structure, or it may contain broader terms, narrower terms, related terms, or taxonomic identifiers used to find the structure in a search or provide semantic classification of the text by mapping a specific structure to a taxonomy. 🆗 🆗
counts Container element for counts of a document (for example, number of tables, number of figures, number of words). 🆗 🆗
page-count Total number of pages in a work in print; by convention, each page or partial page is counted as one. Electronic-only works do not traditionally have page counts. 🆗 🆗
body Main textual portion of the document that conveys the narrative content. 🆗 🆗
p Textual unit or block; a textual paragraph. 🆗
back Material published with an article but following the narrative flow. 🆗 🆗
ref-list List of bibliographic references for a document or document component. 🆗
ref One item in a bibliographic list. 🆗
mixed-citation Bibliographic description of a work. Includes a combination of bibliographic reference elements and untagged text. Spacing and punctuation are preserved. 🆗

Installation

This plugin should be available from the Plugin Gallery within OJS.

Automated Tests

./lib/pkp/lib/vendor/bin/phpunit ./plugins/generic/jatsTemplate/tests/functional/ArticleTest.php --configuration lib/pkp/tests/phpunit.xml
./lib/pkp/lib/vendor/bin/phpunit ./plugins/generic/jatsTemplate/tests/functional/ArticleFrontTest.php --configuration lib/pkp/tests/phpunit.xml
./lib/pkp/lib/vendor/bin/phpunit ./plugins/generic/jatsTemplate/tests/functional/ArticleBackTest.php --configuration lib/pkp/tests/phpunit.xml
./lib/pkp/lib/vendor/bin/phpunit ./plugins/generic/jatsTemplate/tests/functional/ArticleBodyTest.php --configuration lib/pkp/tests/phpunit.xml