Package: bibliograph.parsing
bibliograph.parsingEach parser accepts input from a given bibliographic reference format and outputs
a list of python dictionaries, one for each entry listed in the input source.  Each
of these dictionaries will contain some  number of the following fields:Field Name:Required:Description of Field Contentsx:reference_typeYesthe type of content referenced by this entrytitleYesthe title of the content referenced by this entryabstractNoshort description or summary of the contentreferenced by this entrypublisher?name of the publishing companypublication_year?year in which the content was publishedpublication_month?month in which the content was publishedpublication_url?fully-qualified url pointing to an online versionof the contentauthorsYeslist of dictionaries, one for each author of thecontent.  The dictionaries will contain three
items: ‘firstname’ (given name), ‘lastname’
(surname, family name), middlename (any name or
names in-between the first and last names)journalNoTitle of the journal in which the content appearsvolumeNoVolume of the periodical in which the contentappearsnumberNoNumber of the periodical in which the contentappearspagesNoPage numbers within the given volume:number of theperiodical in which the content appearsRequirementsrequires Bibutils 4.6 or higherConfigurationbibliograph.parsinghonors the environment variableFIX_BIBTEX. If set, the module
will clean up BibTeX import data through the “bib2xml | xml2bib” pipeline in order cleanup
up improper or misformatted BixTeX data. However you may lose some data (e.g. theanotatefield will be filtered out through Bibutils).SourcesFormats for input files have been gleaned from a number of sources:
RIS:http://www.refman.com/support/risformat_intro.aspContributorsPaul Bugni,pbugni@u.washington.edu, authorCris Ewing,cewing@u.washington.edu, authorRaphael Ritz,r.ritz@biologie.hu-berlin.de, parsersAndreas Jung,info@zopyx.com, bug fixesChange history1.0.1 (2011-02-10)bibtex.py: add spaces to mname if more than one part is left for mname1.0.0 (2010-03-19)final release1.0.0c2 (2010-03-09).end -> enw changed for proper format detection1.0.0c1 (2010-03-03)release candidate1.0.0b5 (2010-02-01)fixed RIS tests due to changes in bibliograph.core related to RIS parameters1.0.0b4 (2010-01-31)introducing FIX_BIBTEX environment variable to enable bib2bib transformation
in order to make BibTeX parsing more robust1.0.0b3 (2010-01-31)made BibTeX parser more robust1.0.0b2 (2010-01-30)fixed failing endnote parser test1.0.0b1 (2010-01-28)
?===================
- new numbering schema
- minor tweaks0.2.3 (2010-01-22)added explicit input encoding check for RIS files since bib.core expects
from now on RIS input data with UTF-8 encodingupdated tests with utf-8 encoded input data0.2.2 (2009-12-12)now dealing correctly with all TeX escapings (and restored
the escaping support of old versions)0.2.1 (2009-12-05)fixed keywords import of BibTex files0.2.0 (2009-12-04)added BibTeX parsing support for identifiers (ISBN, ASIN, PURL, URN, ISSN, DOI)BibTeX parser no deals correctly with keys containing a dash like ‘date-modified’added more tests0.1.0 (2008-09-04)Created package with ZopeSkelPorted all parsers from Products.CMFBibliographyATRemoved all CMF / Zope2 / Plone dependenciesRemoved obsolete/unused parsers: [CitationManager, IBSS, ISBN, pyblbibex]Fixed broken EndNote parserEstablished reliable checkFormat() methods for existing parsersExtended parser test coverage