bibliograph.parsing

bibliograph.parsing

Each 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_type |Yes |the type of content referenced by this entry | +---------------------+-----------+---------------------------------------------------+ |title |Yes |the title of the content referenced by this entry | +---------------------+-----------+---------------------------------------------------+ |abstract |No |short description or summary of the content | | | | referenced by this entry | +---------------------+-----------+---------------------------------------------------+ |publisher |? |name of the publishing company | +---------------------+-----------+---------------------------------------------------+ |publication_year |? |year in which the content was published | +---------------------+-----------+---------------------------------------------------+ |publication_month|? |month in which the content was published | +---------------------+-----------+---------------------------------------------------+ |publication_url |? |fully-qualified url pointing to an online version | | | | of the content | +---------------------+-----------+---------------------------------------------------+ |authors |Yes |list of dictionaries, one for each author of the | | | | content. 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) | +---------------------+-----------+---------------------------------------------------+ |journal |No |Title of the journal in which the content appears | +---------------------+-----------+---------------------------------------------------+ |volume |No |Volume of the periodical in which the content | | | | appears | +---------------------+-----------+---------------------------------------------------+ |number |No |Number of the periodical in which the content | | | | appears | +---------------------+-----------+---------------------------------------------------+ |pages |No |Page numbers within the given volume:number of the | | | | periodical in which the content appears | +---------------------+-----------+---------------------------------------------------+

Requirements

• requires Bibutils 4.6 or higher

Configuration

bibliograph.parsing honors the environment variable FIX_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. the anotate field will be filtered out through Bibutils).

Sources

Formats for input files have been gleaned from a number of sources:
RIS: http://www.refman.com/support/risformat_intro.asp

Contributors

• Paul Bugni, [e-mail], author
• Cris Ewing, [e-mail], author
• Raphael Ritz, [e-mail], parsers
• Andreas Jung, [e-mail], bug fixes

Change history

1.0.1 (2011-02-10)

bibtex.py: add spaces to mname if more than one part is left for mname

1.0.0 (2010-03-19)

• final release

1.0.0c2 (2010-03-09)

• .end -> enw changed for proper format detection

1.0.0c1 (2010-03-03)

• release candidate

1.0.0b5 (2010-02-01)

• fixed RIS tests due to changes in bibliograph.core related to RIS parameters

1.0.0b4 (2010-01-31)

• introducing FIX_BIBTEX environment variable to enable bib2bib transformation in order to make BibTeX parsing more robust

1.0.0b3 (2010-01-31)

• made BibTeX parser more robust

1.0.0b2 (2010-01-30)

• fixed failing endnote parser test

1.0.0b1 (2010-01-28) ?===================

• new numbering schema
• minor tweaks

0.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 encoding
• updated tests with utf-8 encoded input data

0.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 files

0.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 tests

0.1.0 (2008-09-04)

• Created package with ZopeSkel
• Ported all parsers from Products.CMFBibliographyAT
• Removed all CMF / Zope2 / Plone dependencies
• Removed obsolete/unused parsers: [CitationManager, IBSS, ISBN, pyblbibex]
• Fixed broken EndNote parser
• Established reliable checkFormat() methods for existing parsers
• Extended parser test coverage