Metadata-Version: 2.0
Name: Products.CMFBibliographyAT
Version: 1.2.1
Summary: Bibliographic references in Plone
Home-page: http://pypi.python.org/pypi/Products.CMFBibliographyAT
Author: Andreas Jung
Author-email: info@zopyx.com
License: GPL
Keywords: web application server zope zope2 cmf plone bibliography
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Products.ATExtensions
Requires-Dist: bibliograph.core
Requires-Dist: bibliograph.parsing
Requires-Dist: bibliograph.rendering
Requires-Dist: pyisbn
Requires-Dist: setuptools
Requires-Dist: zope.app.schema

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

Warning
=======

1.1.x is only to be used with Plone 3.x and 1.2.x is only to be used with Plone 4.x and up.


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 module).

* 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', 'Endnote', 'RIS',  'Medline'
and XML/MODS.  Check out the accompanying files in 'import_samples' to see this
in action.

Currently supported export formats: BibTeX (but see below), 'Endnote', 'RIS'
and 'XML/MODS'.


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


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.

* Plone 3 or Plone 4

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

Authors
=======

* Raphael Ritz (original author)
* Andreas Jung (current maintainer)
* Jens Klein (contributions)

Credits
=======

* The CMFBiblibgraphyAT 1.0/1.1 releases were made possible with 
  funding of the Humboldt University, Berlin



Changelog
=========

1.2.1 (2016-09-28)
------------------

* Include all the files with MANIFEST.in

1.2.0 (2015-12-14)
------------------

* Compability with Plone 4. Macro 'relatedItems' is deprecated https://dev.plone.org/ticket/9985

1.1.5 (unreleased)
------------------

* hedge import case handling

1.1.4 (2013-09-16)
------------------

* packaging problem with 1.1.3 [jensens]

1.1.3 (2013-09-16)
------------------

* Added a zope3 vocabulary factory grabbing all reference types

* fix id cooker control panel string parsing issue.

* added way to let subscriber add at least minor info to the log
  and some code formatting
  [jensens]

* fix migration [kiorky]

* fix some broken asumption about month [kiorky]

* handle some utf-8 decode problems [kiorky]

* fix schema access in subclasses (fix conferences atleast) [kiorky]

* Allow PDF Files, in pdf folders [kiorky]

1.1.2 (2011/07/11)
------------------

* throw an event for each imported entry.
  [jensens]

* fixed import report on write too. Same problem with fullname: it can be 
  unicode.

* fixed import report: for some reason the new report might be uniocde, (maybe in
  Plone 4 username or email is unicode?) but merging it with the old report 
  before storing it failed: old report is utf8 so convert unicode to utf8 if 
  necessary.
  [jensens]

* removed strange (used undefined variables) and superfluos (unused) code. 
  [jensens]

* added a formatter view for the single result-item. this can be overruled by a 
  layer-bond view if one needs a different view on a result item.
  [jensens]  

* moved bibliography_importForm from ControllerPageTemplate to view-class. 
  [jensens]

* added self-contained buildout with test setup. [jensens]

* cleanup import code and other parts of content/folder.py to enable 
  import into subclassed types. [jensens]

1.1.1 (2010/08/22)
------------------
* compatiblity with Plone 4.0rc1

1.1.0 (2010/07/05)
------------------
* final 1.1.0 release

1.1.0b8 (2010/07/05)
--------------------
* fixed handling of non-ascii characters in author names due to incompatible
  Plone API changes in normalizeString(). Now using the unicodedata.normalize()
  functionality which may result in a slightly different id generation.

1.1.0b7 (2010/07/05)
--------------------
* another Plone 3/4 fix incompatibility in transforms/*

1.1.0b6 (2010/06/10)
--------------------
* fixed another Plone 3/4 incompatibility in transforms/*

1.1.0b5 (2010/06/10)
--------------------
* fixed another Plone 3/4 incompatibility in transforms/*

1.1.0b4 (2010/06/10)
--------------------
* fixed Plone 3/4 incompatibility in transforms/*

1.1.0b3 (2010/06/10)
--------------------
* fixed import

1.1.0b2 (2010/05/10)
--------------------
* fixed missing import

1.1.0b1 (2010/05/10)
--------------------
* compatibility with Plone 3 + Plone 4 

1.0.5 (2010-04-22)
------------------
* fixed handling of the 'note' field on the export adapter level

1.0.4 (2010-04-12)
------------------
* removed stupid filtering from bibliography_view making this view completely 
  useless for anonymous visitors

1.0.3 (2010-04-07)
------------------
* exposing installed Bibutils version within the Plone UI (import/export tab of the 
  bibliography management configlet)

1.0.2 (2010-04-01)
------------------
* checking minimum Bibutils version and logging it during the Zope
  startup phase

1.0.1 (2010-03-22)
------------------
* removed stupid role check from bibliograph_search.pt which made
  the bibliographic search unusable for anonymous users

1.0.0 (2010-03-19)
------------------
* final release

1.0.0c2 (2010-03-09)
--------------------
* fixed COINS data for article reference (jtitle -> title)

1.0.0c1 (2010-03-03)
--------------------
* release candidate

1.0.0b13 (2010-02-16)
---------------------
* suffix for generated Endnote exports must be '.enw', not '.end'

1.0.0b12 (2010-02-09)
---------------------
* fix interface decl. for @@export

1.0.0b11 (2010-02-09)
---------------------
* #87 - PDF reference popup did not work
* re-hacked support for support the export of single bibliographic items

1.0.0b10 (2010-02-03)
---------------------
* fixed all unittests
* #81 - fixed strange filtering for anonymous in bibliography_view

1.0.0b9 (2010-01-30)
--------------------
* moved encoding checks directly into checkEncoding()
* handling UTF-8 BOM properly
* removed encoding guessing code - explicit is better than implicit

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



