bibliograph.parsing 0.2.1dev-r104350

Parsers for bibliograph packages

.. contents::

.. bibliograph.parsing
---------------------

Package contains parsers for different bibliographic formats. It provides
utilities to call the parsers. Currently supported formats are: bibtex,
endnote, medline, xml (mods), and ris.

Homepage: http://pypi.python.org/pypi/bibliograph.parsing

Code repository: http://svn.plone.org/svn/collective/bibliograph.parsing/

Change history
**************

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

Detailed Documentation
**********************

bibliograph.parsing Package Readme
=========================

Overview
--------

Parsers for bibliograph packages

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 Contents:
|-------------------|-----------|---------------------------------------------------
|'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
|-------------------|-----------|---------------------------------------------------


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

Download
********