Metadata-Version: 1.0
Name: bibliograph.parsing
Version: 0.2.1dev-r104350
Summary: Parsers for bibliograph packages
Home-page: http://svn.plone.org/svn/collective/bibliograph.parsing/
Author: Paul Bugni, Cris Ewing
Author-email: plone-biblio@das-netzwerkteam.de
License: ZPL 2.1
Description: .. 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, pbugni@u.washington.edu, Author
        - Cris Ewing, cewing@u.washington.edu, Author
        - Raphael Ritz, r.ritz@biologie.hu-berlin.de, Parsers
        
        Download
        ********
        
Keywords: bibtex bibliography xml endnote ris bibutils parsers
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
