View source

==New Stuff==
MBGLab--Papers-Master : https://docs.google.com/spreadsheet/ccc?key=0AiiHlTECOi8edGhzSXlZZzEyRThQeDB6R0pRc0FvcGc&hl=en_US#gid=0


==Old Stuff==
{|
| '''<font color="993333">Lists of Papers:</font>'''
|
|
[http://papers.gersteinlab.org/papers-tags.htm XML tags]
|-
| '''<font color="993333">XML Dumps:</font>'''
|
|
[http://papers.gersteinlab.org/papers.xml Main Papers] / [http://papers.gersteinlab.org/papers-before-1997.xml Before 1997] / [http://papers.gersteinlab.org/NCBIData.xml Medline results]
|-
| '''<font color="993333">Zip Archives:</font>'''
|
|
[http://papers.gersteinlab.org/e-print.zip E-print]<sup>†</sup> directory (>1.2 GB) / [http://papers.gersteinlab.org/papers/papers.zip Papers] (>590 MB)
|-
|
|
| align="center" |
† [http://www.gersteinlab.org/misc/permissions.html '''Please see our copyright statement''']
|}

<blockquote>

==Automatic generation of publication documents from SpreadSheet==

====[ [http://papers.gersteinlab.org return to index] ] [ [http://papers.gersteinlab.org/papers_template Update Pages] ] [ [http://papers.gersteinlab.org/papers/papersdoc.htm Code Documentation] ][ [http://papers.gersteinlab.org/papers/xml/zip.html Zip Archives] ] [ [http://papers.gersteinlab.org/webstats/ Web Stats] ]====

<font size="3" face="arial, Helvetica, sans-serif"> '''Introduction and guidelines:''' All papers are defined by a unique "labid" such as "pgenes-nar" or "genome-transposon-nature". Ideally, the labid should contain the abbreviated subject and journal name as shown. Each paper has a directory named with the labid in /web/e-print. This directory should contain a file named <tt>citation.xml</tt> containing reference information for the paper. To add a paper, you simply need to create the proper e-print directory and citation.xml file, then invoke the scripts to regenerate the PubMed listing and indices. These can all be accomplished using the web forms and scripts located [/papers_template here.]

Each citation.xml file consits of a series of tags contained within a <tt><UniqueData></tt> element. The value of each tag is specified within the body of the element. Each file should have at least a <tt><labid></tt> tag. Two examples are available, one for a [samples/citation.xml paper listed in PubMed], and one for a [samples/citation2.xml paper from a non-PubMed journal] containing more complete citation information.

Here is a list of the tags and their meanings:

<blockquote>

<UniqueData> - enclosing element for all the tags<br />
<PMID> - PubMed id<br />
<labtitle> - title of the article<br />
<labcite> - citation of the article (author, journal, year, etc)<br />
<Authors> - authors in [First Initial] [Lastname], ... format<br />
<Journal> - journal that the article appeared in (may also be specified by <MedlineTA>)<br />
<Year> - year the article was published<br />
<Volume> - volume of the journal that article appeared in<br />
<Pages> - pages of the volume that the article appeared in (may also be specifed by <MedlinePgn> or <bookdata>)<br />
<ignore/> - whether the article should appear in the main index<br />
<labid> - id by which to refer to the article<br />
<website> - supplemental website<br />
<website2> - second supplemental website<br />
<sortval> - relative ordering of the article on the main index (high = early)<br />
<preprint> - URL of the preprint file<br />
<target> - currently reserved for NESG papers<br />
<subject> - currently reserved for NESG papers<br />
<grant> - specifies the grant(s) funding the paper (e.g. "cegs,keck")<br />
</blockquote>

The tags can conceptually be divided into two groups: ones such as PMID and labitle, which serve to identify the paper, and tags such as website and subject which supply supplemental information about the paper. There are three ways to identify a paper (in order of decreasing precedence):

# PMID
# labtitle, labcite
# labtitle, Authors, Journal and optionally Year, Volume and Pages

For the proper display of the paper, at least on of these methods must be specified in citation.xml. You should always include the PMID if a paper is known to be listed in PubMed. Option 2 should be used for papers that are in press.

The other group of tags supplies additional information about the paper specified by the first group of tags. All of these tags are optional, however used of <tt><grant></tt> and <tt><preprint> </tt> is strongly encouraged. (Please consult Mark for guidelines on citing grants.)

'''CGI and Perl scripts:''' These are invoked from a password-protected directory on the server ([/papers_template click here to access]). You can view the source code [scripts here]. The most important script that most people will use is <tt>papers.cgi</tt>. This simply invokes two other scripts:

* <tt>importEprint.sh</tt> creates the directory <tt>/web/papers/skel</tt> which is used for collecting citation info later on. It will back up the existing copy of <tt>/web/papers</tt> to <tt>/web/papers_template/backup/skel_DATE.tar.gz</tt>, which can later be recovered.
* <tt>papers.pl</tt> is a script that takes a main XML file containing a list of articles in NCBI format, and collects information contained in the copies citation.xml files found in <tt>/web/papers/skel</tt> which specify supplimental information for the articles in the main file. It will add any papers not in the list downloaded from the NCBI to the overall list, which is saved in the file <tt>/web/papers/papers.xml</tt>. The following files are produced by this script:  

<blockquote>
/web/papers/index.html<br/>
/web/papers/paper-tags.htm<br/>
/web/papers/paper-ids.htm<br/>
/web/papers/papers-simple.html<br/>
/web/papers/papers.xml<br/>
/web/papers/[labid]/index.html<br/>
/web/papers/grant/index.html<br/>
/web/papers/grant/[grantid].html<br/>
</blockquote>

The other scripts of importance:

* <tt>downloadXML.cgi</tt> obtains a complete listing of Mark's publications from PubMed. This is a non-trivial task (and currently relies on the NCBI not changing any aspect of their site). The downloaded file is <tt>/web/papers/NCBIData.xml</tt>. This script should be invoked whenever a new paper is published.
* <tt>rollback.cgi</tt> recovers an earlier copy of <tt>/web/papers</tt> in case of disaster. Backups are stored in <tt>/web/papers_template/backup </tt>.