XML coversheet: Difference between revisions

From STMDocs
Jump to navigation Jump to search
(Removing all content from page)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[PeerJ|<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.
# All meta informations are tagged properly.
# This can be easily generated from the manuscript submission systems without any re-keying.
# This can be used for booking in an article in any XML complaint production tracking system.
# The tagged informations can be extracted or re-used in the further stages of production.
# Since the original data is used, typos can be avoided and eliminates the further checking of metadata while proof-reading.
# Using XSLT, these coversheets can be rendered.
===Specimen===
You may download a specimen XML coversheet from here.
[http://download.river-valley.com/RVMS/XML_Coversheet.xml XML coversheet]
===Elements and attributes===
;purchase_order
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>
;order_meta
To hold the details regarding the particular order which may include publisher's name, order_date, due_date, stage.
;publisher
Publisher's name. For example <code>PeerJ</code>.
;order_date
The date on which the purchase order is created.
;timestamp
The timestamp should be in the format <code>2012-12-18T12:24:12.000</code>.
;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 <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>
;article
Holds the metadata related to the article. The main elements are <code>journal_meta, article_meta, manuscript_meta, other_info, remarks</code>
;journal_meta
Contains <code>journal_id, journal_name, issn</code>
;journal_id
Provide the journal id here. Normally four or five letter journal code. For example, <code>SPMI</code> for <code>Superlattices and Microstructures</code>.
;journal_name
Provide full name of the journal.
;issn
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>
;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 <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>
;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 <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.
;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 <code>type</code>. The values will 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>
;copy-edit-content
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>
;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">
<source>TeX</source>
</geshi>
;figures
Contain one or more figure details.
;figure
Contains <code>figure_nr, figure_type</code> and <code>fig_parts</code>
;figure_nr
Figure number. Figure 1, Figure 2 etc.
;figure_type
Should be <code>COLOUR</code> or <code>BW</code>
;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 <code>fastrack</code> and <code>proof_to_author</code>.
;fastrack
If the article is fastrack, give <code>YES</code>, otherwise <code>NO</code>.
;proof_to_author
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>
;remarks
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