XML coversheet

From STMDocs
Jump to navigation Jump to search

<Back

Introduction

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.

What is XML coversheet?

XML coversheet means, coversheets in XML format which are accompanied with the manuscript for typesetting. Metadata is tagged using XML elements.

Advantages of XML coversheets

XML coversheet poses lot of advantages.

  1. All meta informations are tagged properly.
  2. This can be easily generated from the manuscript submission systems without any re-keying.
  3. This can be used for booking in an article in any XML complaint production tracking system.
  4. The tagged informations can be extracted or re-used in the further stages of production.
  5. Since the original data is used, typos can be avoided and eliminates the further checking of metadata while proof-reading.
  6. Using XSLT, these coversheets can be rendered.

Specimen

You may download a specimen XML coversheet from here.

XML coversheet

Elements and attributes

purchase_order

Top-level element

order_meta

To hold the details regarding the particular order which may include publisher's name, order_date, due_date, stage.

<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>

publisher

Publisher's name. For example PeerJ.

order_date

The date on which the purchase order is created.

timestamp

The timestamp should be in the format 2012-12-18T12:24:12.000.

due_date

The date on which the proof is due back to the publisher.

stage

This is to say for which milestone stage the purchase order is sent. This has two attributes namely step and version.

<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>

article

Holds the metadata related to the article. The main elements are journal_meta, article_meta, manuscript_meta, other_info, remarks

journal_meta

Contains journal_id, journal_name, issn

journal_id

Provide the journal id here. Normally four or five letter journal code. For example, SPMI for Superlattices and Microstructures.

journal_name

Provide full name of the journal.

issn

This has an attribute type with values epub and ppub. epub is for online issn and ppub 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>

article_meta

Details related to the article like doi, copyright, corresponding author etc.

article_id[@pubid]

Article id which the publisher provides. Normally integers only.

<geshi lang="xml">

<article_id type="pubid">001</article_id>

</geshi>

article_id[@doi]

The DOI of the article.

<geshi lang="xml">

<article_id type="doi">10.1111/PeerJ.2012.001</article_id>

</geshi>

copyright[@year]

The copyright year and copyright owner of the article.

<geshi lang="xml">

<copyright year="2012">PeerJ</copyright>

</geshi>

article_category

The type attribute should hold two or three letters abbreviation for each article type. For example RP for Research Papers, EDI for Editorial etc. For example <geshi lang="xml">

<article_category type="RP">Research Paper</article_category>

</geshi>

article_title

Full title of the article. <geshi lang="xml">

<article_title>First PeerJ Article</article_title>

</geshi>

first_author

Give the first author's name.

<geshi lang="xml">

<first_author>John Smith</first_author>

</geshi>

corr_author

This element has a type attribute with values proofto, inarticle and all.

    proofto — Author to whom the proof should be sent.

    inarticle — Corresponding author's details which needs to appear in the document.

    all — This is used when the corresponding author's details which should come in the article and the proof should be sent to is same.

name

Name of the corresponding author.

email

Email of 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>

history_date

Has an attribute type. The values will be received, revised and accepted.

<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>

copy-edit-content

This element has one attribute required. The values are yes or no.

<geshi lang="xml">

<copy-edit-content required="no"/>

</geshi>

supplemental_info

Holds information regarding supplemental material.

file

Details of supplemental material.

filename

Filename of the supplemental material.

type

File format. Audio, Video etc.

title

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>


manuscript_meta

To hold details of the manuscript submitted.

no_mns_pages

Number of manuscript pages submitted.

<geshi lang="xml">

<no_mns_pages>12</no_mns_pages>

</geshi>

source

Source file submitted. TeX, Word or PDF.

<geshi lang="xml">

TeX

</geshi>

figures

Contain one or more figure details.

figure

Contains figure_nr, figure_type and fig_parts

figure_nr

Figure number. Figure 1, Figure 2 etc.

figure_type

Should be COLOUR or BW

figure_parts

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>

tables

Number of tables.

<geshi lang="xml">

<tables>1</tables>

</geshi>

other_info

Contains fastrack and proof_to_author.

fastrack

If the article is fastrack, give YES, otherwise NO.

proof_to_author

If the proof need not be send to the author, then please give NO. Otherwise YES.

<geshi lang="xml">

 <other_info>
   <fastrack>YES</fastrack>
   <proof_to_author>YES</proof_to_author>
 </other_info>

</geshi>

remarks

Any special remarks to the setter can be added here.

<geshi lang="xml">

 <remarks>
  Any special remarks to the typesetter.
 </remarks>

</geshi>