Skip to main content

Bibliographic references in Plone

Project description

CMFBibliographyAT

CMFBibliographyAT is the Archetypes based version of CMFBibliograhy. It enables handling of references to (scientific) publications in Plone. It provides a ‘Bibliography Folder’ content type dedicated to holding reference objects of various kinds, like for ‘articles’, ‘books’, ‘preprints’, ‘techreports’, contributions to collections, … The folder supports import/export of BibTeX formated files.

In addition the package adds a ‘bibliography’ action to the portal tabs and it provides a BibliographyTool called ‘portal_bibliography’ through which you can manage the renderers and parsers for the import/export functionality.

Installation

  • Add Products.CMFBibliographyAT to the eggs option of your buildout.cfg file and re-run buildout.

  • Either choose the CMFBibliographyAT extension profile while creating a new Plone site or install it through the add-on control panel within the Plone UI

What it does

CMFBibliography provides various new content types:

  • Bibliography Entries: Highly structured content objects to hold bibliographic data referencing a publication. The schema is derived from BibTeX (LaTeX’s bibliography handling modul).

  • Bibliography Folder: Enhanced ‘Skinned Folder’ with some import/import functionality (available through the ‘import’ tab).

Allowed content types are restricted to reference types.

Currently supported import formats are ‘BibTeX’ and ‘Medline’. Check out the accompanying files in ‘import_samples’ to see this in action.

Currently supported export formats: BibTeX (but see below)

Under the folder’s ‘defaults’ tab you can (i) specify default links for authors of references with the folder and (ii) define a ranking for the references within the folder. Through the ranking it is possible to control which references will be returned when “asking” the folder for its ‘Top(n)’ references (see the bibliography folder’s source code for more).

In addition CMFBibliographyAT adds two field indexes (‘Authors’ and ‘publication_year’) and three meta data fields (‘Authors’, ‘publication_year’, and ‘Source’) to the portal catalog (if not present) to provide the ‘bibliography’ action which is added to the portal tabs (if you don’t want this, go to ‘portal_bibliography > Actions’ and tick off its visibility).

Known issues

  • There is no migration path from the old CMFBibliography (not AT based) to the new one (AT based; CMFBibliographyAT) yet.

  • If you upgrade to Archetypes 1.3.x you should also upgrade CMFBibliographyAT to a version newer than Mai 25th 2004 (from the CVS 0.4 version) or the meta and portal types might be wrong.

  • CMFBibliographyAT is known not to work with Plone’s ‘portal_factory’ due to the way in which the ‘More Authors’ feature is implemented (you will lose the author information if you use ‘portal_factory’ - XXX: I think this was fixed by moving to ATExtensions for the authors field.

Dependencies

Extensions

  • ATBiblioList: An add-on to CMFBibliographyAT that lets organise bibliographical references into selection lists and have them printed in a “ready to publish” style.

  • AmazonTool: Supports import of bibliographic data from Amazon’s database by calling their web service per ISBN provided.

Resources

Changes

1.0.0a6 (2009-12-19)

  • added support for using portal_factory

1.0.0a5 (2009-12-18)

  • fixed Amazon link for ISBN-13 numbers

1.0.0a4 (2009-12-18)

  • BibTeX export adapter did not provide ‘publication_month’

1.0.0a3 (2009-12-18)

  • fixed bug in PMI migration code

  • increased the length of some string fields for better usability

  • migration code for PMID

  • relaxed some test due to test failures (XML BOM)

1.0.0a1 (2009-12-12)

  • added ‘pyisbn’ dependency

  • added ISBN validation support to the ‘identifiers’ field

  • made orginal ‘isbn’ field invisible

  • added 0.9 -> 1.0 migration code for copying the ‘isbn’ field value into the ‘identifiers’ field

  • the filename generated by the @@export view now ends with the proper suffix according to the selected export format

  • the export adapter did work with keywords (using ‘subject’ instead of ‘keywords’)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Products.CMFBibliographyAT-1.0.0a6.tar.gz (307.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page