Products.CMFBibliographyAT 1.0.0b8

Bibliographic references in Plone

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 (and there won’t be one)

• 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.

Dependencies

• Bibutils (optional) http://www.scripps.edu/~cdputnam/software/bibutils to extend the range of supported import/output formats. Bibutils is mandatory for any kind of export/import. Minimum version is Bibutils 4.6.

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

• Bugtracker: http://plone.org/products/cmfbibliographyat/issues

• For questions or for giving feedback: please ask on the plone-biblio mailing list: https://mail.das-netzwerkteam.de/mailman/listinfo/plone-biblio

Changes

1.0.0b8 (2010-01-29)

• minor but critical bugfix in input encoding checker

1.0.0b7 (2010-01-29)

• re-added selection for input encoding on the import form

• added through-the-ZMI property portal_properties -> extensions_properties -> available_input_encodings

• added strong encoding check for uploaded data

1.0.0b6 (2010-01-28)

• using UTF-8 output encoding for all renderers except BibTeX (ASCII/LaTeX notation)

• cleanup (internal/UI) of encoding related issues

1.0.0b5 (2010-01-25)

• fixed installation/uninstallation issues in setuphandler.py and exportimport handler

1.0.0b4 (2010-01-22)

• fixed issues related to the input encoding of RIS files

• added note on input encodings related to RIS files to the input form

1.0.0b3 (2010-01-20)

• fixed API name clash for getProperty()

1.0.0b2 (2010-01-20)

• removed “docs” tab from configuration panel (since it was empty)

• added portal_properties/cmfbibat_properties as replacement for persistent perferences for parsers/renderers (#82)

• added updateProperty(), getProperty(), isParserEnabled(), isRendererEnabled() methods to portal_bibliography

• fixed several forms dealing with the parser/renderer preferences

1.0.0b1 (2010-01-10)

• 1.0.0 beta 1 release

1.0.0a7 (2009-12-19)

• fix for error #36

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’)