XML coversheet: Difference between revisions

From STMDocs
Jump to navigation Jump to search
No edit summary
(Removing all content from page)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Main Page|<Back]]


==<span style="color:green">Introduction</span>==
River Valley have a XML complaint production tracking system known as `RVMS' which means `River Valley Management System'. It can import XML coversheets and bookin a new job. It can render the coversheet. So we request XML coversheets from our clients.
==<span style="color:green">What is XML coversheet?</span>==
XML coversheet means, coversheets in XML format which are accompanied with the manuscript for typesetting. Metadata is tagged using XML elements.
==<span style="color:green">Advantages of XML coversheets</span>==
XML coversheet poses lot of advantages.
# All meta information are tagged properly.
# This can easily be generated from manuscript submission systems without any re-keying.
# This can be used for booking in an article in any XML compliant production tracking system.
# The tagged information can be extracted or re-used in subsequent stages of production.
# Since the original data is used, typos can be avoided which eliminates further checking of metadata while proof-reading.
# Using XSLT, these coversheets can be rendered in a browser.
===<span style="color:green">Specimen</span>===
You may download a specimen XML coversheet from here.
[http://download.river-valley.com/RVMS/XML_Coversheet.xml XML coversheet]
===<span style="color:green">Elements and attributes</span>===
;<span style="color:orange">purchase_order</span>
Top-level element
<geshi lang="xml">
<purchase_order
  xmlns="http://www.river-valley.com/xml/schema/purchase_order/2012.1/RVMS"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.river-valley.com/xml/schema/purchase_order/2012.1/RVMS
  http://www.river-valley.com/xml/schema/purchase_order/2012.1/RVMS.xsd"
  schema-version="2012.1">
</geshi>
;<span style="color:orange">order_meta</span>
To hold the details about an order which may include publisher's name, order_date, due_date, stage.
;<span style="color:orange">publisher</span>
Publisher's name. For example <code>PeerJ</code>.
;<span style="color:orange">order_date</span>
The date on which the purchase order is created.
;<span style="color:orange">timestamp</span>
The timestamp shall be in the format <code>2012-12-18T12:24:12.000</code>.
;<span style="color:orange">due_date</span>
The date on which the proof is due back to the publisher.
;<span style="color:orange">stage</span>
The milestone (or stage) for which the purchase order is sent. This has two attributes namely <code>step</code> and <code>version</code>.
<geshi lang="xml">
<order_meta>
  <publisher>PeerJ</publisher>
  <order_date>
    <timestamp>2012-12-18T12:24:12.000</timestamp>
  </order_date>
  <due_date>
    <timestamp>2012-12-31T12:24:12.000</timestamp>
  </due_date>
  <stage step="proof" version="1"/>
</order_meta>
</geshi>
;<span style="color:orange">article</span>
Holds metadata related to the article. The main elements are <code>journal_meta, article_meta, manuscript_meta, other_info, remarks</code>
;<span style="color:orange">journal_meta</span>
Contains <code>journal_id, journal_name, issn</code>
;<span style="color:orange">journal_id</span>
Provide journal id here, usually four or five letter journal code. For example, <code>SPMI</code> for <code>Superlattices and Microstructures</code>.
;<span style="color:orange">journal_name</span>
Provide full name of the journal.
;<span style="color:orange">issn</span>
This has an attribute <code>type</code> with values <code>epub</code> and <code>ppub</code>. <code>epub</code> is for online issn and <code>ppub</code> is for print issn.
<geshi lang="xml">
  <journal_meta>
    <journal_id>peerj</journal_id>
    <journal_name>Journal of PeerJ</journal_name>
    <issn type="ppub">xxxx-xxxx</issn>
    <issn type="epub">yyyy-yyyy</issn>
  </journal_meta>
</geshi>
;<span style="color:orange">article_meta</span>
Details related to the article like doi, copyright, corresponding author etc.
;<span style="color:orange">article_id[@pubid]</span>
Article id provided by the publisher, usually numerals only.
<geshi lang="xml">
<article_id type="pubid">001</article_id>
</geshi>
;<span style="color:orange">article_id[@doi]
The DOI of the article.
<geshi lang="xml">
<article_id type="doi">10.1111/PeerJ.2012.001</article_id>
</geshi>
;<span style="color:orange">copyright[@year]</span>
The copyright year and copyright owner of the article.
<geshi lang="xml">
<copyright year="2012">PeerJ</copyright>
</geshi>
;<span style="color:orange">article_category</span>
The <code>type</code> attribute should hold two or three letters abbreviation for each article type. For example <code>RP</code> for <code>Research Papers</code>, <code>EDI</code> for <code>Editorial</code> etc. For example
<geshi lang="xml">
<article_category type="RP">Research Paper</article_category>
</geshi>
;<span style="color:orange">article_title</span>
Full title of the article.
<geshi lang="xml">
<article_title>First PeerJ Article</article_title>
</geshi>
;<span style="color:orange">first_author</span>
First author's name.
<geshi lang="xml">
<first_author>John Smith</first_author>
</geshi>
;<span style="color:orange">corr_author</span>
This element has a <code>type</code> attribute with values <code>proofto</code>, <code>inarticle</code> and <code>all</code>.
&nbsp;&nbsp;&nbsp; <code>proofto</code> &mdash; Author to whom the proof should be sent.
&nbsp;&nbsp;&nbsp; <code>inarticle</code> &mdash; Corresponding author's details which needs to appear in the document.
&nbsp;&nbsp;&nbsp; all &mdash; This is used when the corresponding author's details which should come in the article and the proof should be sent to is same.
;<span style="color:orange">name</span>
Name of the corresponding author.
;<span style="color:orange">email</span>
Email of the corresponding author.
<geshi lang="xml">
<corr_author type="proofto">
  <name>Dr. Mary John</name>
  <email>m.john@reference.com</email>
</corr_author>
<corr_author type="inarticle">
  <name>Dr. John Smith</name>
    <email>j.smith@university.com</email>
</corr_author>
</geshi>
OR
<geshi lang="xml">
<corr_author type="all">
  <name>Dr. Mary John</name>
  <email>m.john@reference.com</email>
</corr_author>
</geshi>
;<span style="color:orange">history_date</span>
Has an attribute <code>type</code>. The values shall be <code>received, revised</code> and <code>accepted</code>.
<geshi lang="xml">
<history_date type="received">
  <date day="15" month="12" yr="2012"/>
</history_date>
<history_date type="revised">
  <date day="16" month="12" yr="2012"/>
</history_date>
<history_date type="accepted">
  <date day="17" month="12" yr="2012"/>
</history_date>
</geshi>
;<span style="color:orange">copy-edit-content</span>
This element has one attribute <code>required</code>. The values are <code>yes</code> or <code>no</code>.
<geshi lang="xml">
<copy-edit-content required="no"/>
</geshi>
;<span style="color:orange">supplemental_info</span>
Holds information regarding supplemental material.
;<span style="color:orange">file</span>
Details of supplemental material.
;<span style="color:orange">filename</span>
Filename of the supplemental material.
;<span style="color:orange">type</span>
File format. Audio, Video etc.
;<span style="color:orange">title</span>
Caption to the supplemental material.
<geshi lang="xml">
  <supplemental_info>
    <file>
      <filename>Supplemental001S1</filename>
      <type>MOV</type>
      <title>This is video file.</title>
    </file>
    <file>
      <filename>Supplemental001S2</filename>
      <type>WAV</type>
      <title>This is an audio file.</title>
    </file>
  </supplemental_info>
</geshi>
;<span style="color:orange">manuscript_meta</span>
To hold details of the manuscript submitted.
;<span style="color:orange">no_mns_pages</span>
Number of manuscript pages submitted.
<geshi lang="xml">
<no_mns_pages>12</no_mns_pages>
</geshi>
;<span style="color:orange">source</span>
Source file submitted. TeX, Word or PDF.
<geshi lang="xml">
<source>TeX</source>
</geshi>
;<span style="color:orange">figures</span>
Contain one or more figure details.
;<span style="color:orange">figure</span>
Contains <code>figure_nr, figure_type</code> and <code>fig_parts</code>
;<span style="color:orange">figure_nr</span>
Figure number. Figure 1, Figure 2 etc.
;<span style="color:orange">figure_type</span>
Should be <code>COLOUR</code> or <code>BW</code>
;<span style="color:orange">figure_parts</span>
Option element. Should be provided if that particular figure has part figures. Enter the number of figure parts.
<geshi lang="xml">
  <figures>
    <figure>
      <figure_nr>1</figure_nr>
      <figure_type>COLOUR</figure_type>
      <fig_parts>4</fig_parts>
    </figure>
    <figure>
      <figure_nr>2</figure_nr>
      <figure_type>BW</figure_type>
    </figure>
  </figures>
</geshi>
;<span style="color:orange">tables</span>
Number of tables.
<geshi lang="xml">
<tables>1</tables>
</geshi>
;<span style="color:orange">other_info</span>
Contains <code>fastrack</code> and <code>proof_to_author</code>.
;<span style="color:orange">fastrack</span>
If the article is fastrack, give <code>YES</code>, otherwise <code>NO</code>.
;<span style="color:orange">proof_to_author</span>
If the proof need not be send to the author, then please give <code>NO</code>. Otherwise <code>YES</code>.
<geshi lang="xml">
  <other_info>
    <fastrack>YES</fastrack>
    <proof_to_author>YES</proof_to_author>
  </other_info>
</geshi>
;<span style="color:orange">remarks</span>
Any special remarks to the setter can be added here.
<geshi lang="xml">
  <remarks>
  Any special remarks to the typesetter.
  </remarks>
</geshi>

Latest revision as of 12:06, 23 February 2013