XML coversheet: Difference between revisions

From STMDocs
Jump to navigation Jump to search
Line 181: Line 181:


;<span style="color:orange">corresp_author</span>
;<span style="color:orange">corresp_author</span>
Contains corresponding author's email id which needs to appear in proof and the id to which the proof to be send. When this is same, only <code><corresp_author id="corresp-1"><email>alf@peerj.com</email></corresp_author></code> is enough. But when it is different, <code>type="proofto"</code> attribute should be used.  
Contains corresponding author's email id which needs to appear in proof and the id to which the proof to be send. When this is same, only <code><corresp_author id="corresp-1"><email>alf@peerj.com</email></corresp_author></code> is enough. But when it is different, the id to which proof to be send should be coded inside <corresp_author> and add <code>type="proofto"</code> attribute.


<geshi lang="xml">
<geshi lang="xml">

Revision as of 10:00, 27 December 2012

<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 information are tagged properly.
  2. This can easily be generated from manuscript submission systems without any re-keying.
  3. This can be used for booking in an article in any XML compliant production tracking system.
  4. The tagged information can be extracted or re-used in subsequent stages of production.
  5. Since the original data is used, typos can be avoided which eliminates further checking of metadata while proof-reading.
  6. Using XSLT, these coversheets can be rendered in a browser.

Specimen

You may download a specimen XML coversheet and RVMS.xsd from here.

XML coversheet and RVMS.xsd

Elements and attributes

purchase_order

Top-level element

<geshi lang="xml"> <purchase_order

  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:noNamespaceSchemaLocation="RVMS.xsd">

</geshi>

order_meta

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

publisher

Publisher's name. For example PeerJ.

order_date

The date on which the purchase order is created.

timestamp

The timestamp shall 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

The milestone (or stage) for which 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 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 journal id here, usually 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 provided by the publisher, usually numerals 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>

article_categories

Contains the subject groups.

subj_group[@subj_group_type]

Give the subject group type.

subject

Contains the subject.

<geshi lang="xml">

 <article_categories>
   <subj_group subj_group_type="heading">
     <subject>Agricultural Science</subject>
       <subject>Animal Behavior</subject>
       <subject>Allergy and Clinical Immunology</subject>
       <subject>Anaesthesiology and Pain Management</subject>
   </subj_group>
 </article_categories>

</geshi>

copyright[@year]

The copyright year and copyright owner of the article.

<geshi lang="xml">

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

</geshi>

article_type

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="REP">Research Paper</article_category>

</geshi>

article_title

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

<article_title>First PeerJ Article</article_title>

</geshi>

alt_title

Alternate title.

<geshi lang="xml">

<alt_title>First PeerJ Article</alt_title>

</geshi>

contrib_group

Contains the list of authors.

contrib[@id,@contrib-type]

Contributors id, type (author, editor etc.) and their name.

name

Holds author name.

surname

Surname.

email

Email id of the contributor.

xref[@reftype, @rid]

Link the contributor with his affiliation. The ref-type can be aff, corresp etc.

aff[@id]

Affiliation part.

label

Label of the affiliation.

addr-line

Address line.

author-notes

Notes related to contributors.

corresp_author

Contains corresponding author's email id which needs to appear in proof and the id to which the proof to be send. When this is same, only <corresp_author id="corresp-1"><email>alf@peerj.com</email></corresp_author> is enough. But when it is different, the id to which proof to be send should be coded inside <corresp_author> and add type="proofto" attribute.

<geshi lang="xml">

 <contrib_group>
   <contrib id="author-1" contrib-type="author">
     <name>
       <surname>Eaton</surname>
       <given_names>Alfred B G</given_names>
     </name>
     <email>alf@peerj.com</email>
     <xref ref-type="aff" rid="aff-1">1</xref>
     <xref ref-type="corresp" rid="corresp-1">*</xref>
   </contrib>
 </contrib_group>
 <aff id="aff-1">
   <label>1</label>
   <addr-line>Department of Test, University of Test, Test City, Testland</addr-line>
 </aff>
 <author-notes>
   <corresp_author id="corresp-1"><email>alf@peerj.com</email></corresp_author>
   <corresp_author id="corresp-2" type="proofto"><email>alf@peerj.com</email></corresp_author>
 </author-notes>

</geshi>

history_date

Has an attribute type. The values shall 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>