plone for education: bibliographies

Plone for Education: Bibliographies

Sally Kleinfeldt, Cris Ewing, Carlos de la GuardiaPlone Conference Brasilia

2 October 2013

CC BY Yuri Levchenko - http://www.flickr.com/photos/i8ipod/9280261014/

http://www.flickr.com/photos/i8ipod/9280261014/

http://www.flickr.com/photos/i8ipod/9280261014/

Why Plone?

CC BY Bart Everson - www.flickr.com/photos/editor/6698208975/

http://www.flickr.com/photos/editor/6698208975/

http://www.flickr.com/photos/editor/6698208975/

Fundamentals

Fundamentals• Secure


• Robust permission system



• Accessible (Section 508)




• Scaleable (users, pages)





• Diazo theming with HTML, CSS





• Diazo theming with HTML, CSS

• Custom types and workflows

Add-ons

Add-ons• LDAP/Active Directory

integration


integration

• Subsites for departments, faculties


integration


• Calendaring tools


integration



• Fundraising/CRM (Salesforce.com)


integration




• Faculty/Staff Directory


integration




• Faculty/Staff Directory

• Bibliographies

Bibliographies for Plone since 2005

CMFBibliographyAT

CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/

http://www.flickr.com/photos/aigle_dore/6365101775/


CMFBibliographyAT

• Create and manage bibliographic references




CMFBibliographyAT


• Feature complete for its niche




CMFBibliographyAT


• Feature complete for its niche

• Stable - not much change in 2 years




Details

Details

• Provides 16 different types of references as AT content types, plus special folder

Details


• Personal and aggregated lists

Details



• Schema follows BibTeX - LaTeX’s reference management system

Details



• Schema follows BibTeX - LaTeX’s reference management system

• Supports several import and export formats, easy to add new ones (Zope utilities)

Exampleshttp://www.weigelworld.org/research/publications

http://www.weigelworld.org/research/publications

http://www.weigelworld.org/research/publications

Exampleshttp://www.doaks.org/resources/seals/seals-bibliography

http://www.doaks.org/resources/seals/seals-bibliography

http://www.doaks.org/resources/seals/seals-bibliography

Exampleshttp://www.upress.umn.edu/ (staging site)

http://www.upress.umn.edu

http://www.upress.umn.edu

Editing

Built-in Search

Style Wars!

CC BY Jill Carlson - www.flickr.com/photos/jill_carlson/9704689913/

http://www.flickr.com/photos/jill_carlson/9704689913/

http://www.flickr.com/photos/jill_carlson/9704689913/

Different Discipline Different Style


APA


APA

CSE


APA

CSE

MLA


APA

CSE

MLA

Etc...

Styles in Plone Bibliographies


• Products.ATBiblioStyles adds support for Chicago, Harvard, APA, MLA styles


• Products.ATBiblioStyles adds support for Chicago, Harvard, APA, MLA styles

• Python skills required to add new styles

Examplehttp://www.es.utoronto.ca/Members/anderson/anderson_bib/

http://www.es.utoronto.ca/Members/anderson/anderson_bib/

http://www.es.utoronto.ca/Members/anderson/anderson_bib/

Not Enough!

CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/

http://www.flickr.com/photos/cherryride/5466972761/


Not Enough!• A few styles is not

enough for serious academic use






• How to easily support hundreds of styles?






• How to easily support hundreds of styles?

• A problem all bibliographic tools have to solve




CSL to the Rescue!

CC BY Scott Feldstein - http://www.flickr.com/photos/scottfeldstein/66034401/

http://www.flickr.com/photos/scottfeldstein/66034401/

http://www.flickr.com/photos/scottfeldstein/66034401/

Citation Style Language


• http://citationstyles.org/

http://citationstyles.org




• XML syntax for defining bibliographic styles






• 6,500+ styles available on crowd sourced Github repository






• 6,500+ styles available on crowd sourced Github repository

• Styles can be browsed, previewed at Zotero Style Repository



Zotero Style Repository

CSL Processors

CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/

http://www.flickr.com/photos/27117620@N06/6243443814/


CSL Processors

• citeproc-js




CSL Processors

• citeproc-js

• citeproc-hs




CSL Processors

• citeproc-js

• citeproc-hs

• citeproc-ruby




CSL Processors

• citeproc-js

• citeproc-hs

• citeproc-ruby

• citeproc-java




CSL Processors

• citeproc-js

• citeproc-hs

• citeproc-ruby

• citeproc-java

• citeproc-py




CSL Processors




CSL Processors• citeproc-py is... fluid





• Only about 60% complete






• Aimed at Python 3.x






• Aimed at Python 3.x

• citeproc-js - JavaScript CSL processor in wide use




The Right Solution

The Right Solution• Standard way to add citation styles


• Used by Zotero, reference management Firefox plugin



• Add-ons for Drupal and Wordpress



• Add-ons for Drupal and Wordpress

• Need add-on for Plone!

Thank You to Our Sponsors

Our Sponsors

Our Sponsors

• Needed bibliography styling

Our Sponsors

• Needed bibliography styling

• Agreed to pool resources

collective.citationstyles


• Integration of CSL styles into Plone



• Control panel to upload style xml files




• Allow selection of site-wide “default” style





• Allow editor selection of style per-context





• Allow editor selection of style per-context

• Handle actual rendering in-browser on the client side

the moving parts

the moving parts

• Iterator

the moving parts

• Iterator

• An adapter

the moving parts

• Iterator

• An adapter

• Iterates over context

the moving parts

• Iterator

• An adapter

• Iterates over context

• yields IBibliographicReferences

the moving parts

the moving parts• Renderer


• a utility


• a utility

• pass in IBibliographicReference


• a utility


• extracts values


• a utility


• extracts values

• CMFBib -> CSL


• a utility


• extracts values

• CMFBib -> CSL

• returns python dict

the moving parts

the moving parts

• @@citations-json browser view

the moving parts


• in any context

the moving parts


• in any context

• builds iterator

the moving parts


• in any context

• builds iterator

• renders references

the moving parts


• in any context

• builds iterator

• renders references

• returns JSON

the moving parts• citeproc-setup viewlet

• load citeproc-js core javascript

• configure rendering engine

• get bibliography item JSON via AJAX

• replace standard CMFBibAT representation with rendered view

• No-JS and error fallback to standard

Samples

CC-BY BartEverts: http://www.flickr.com/photos/barteverts/3068747619

collective.citationstylesStatus


Usable


• can import CSL styles

Usable



• can select default style

Usable




• will render individual references

Usable




• will render individual references

• will render Bibliography Folders

Usable


Not Feature Complete


• adding default styles (ootb)

• adding editor style selection tab

• adding browser views for collections

Not Feature Complete


Things We’d Like to See


• dynamic style selection for viewers

• automatic processing of inline citations

• replacement of existing CMFBib views?

Things We’d Like to See

CMFBibliographyATProblems

CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/

http://www.flickr.com/photos/stuseeger/216598424/



• Big, old fashioned, complicated






• CMF layer, Archetypes







• Not Collection friendly







• Not Collection friendly

• Major rewrite would be huge




CMFBibliographyATWay Forward

CC BY Dave Bleasdale - http://www.flickr.com/photos/sidelong/4564071208/

http://www.flickr.com/photos/sidelong/4564071208/



• Find sponsors





• Find sponsors

• Schedule rewrite sprint




[email protected]

@crisewing

mailto:[email protected]


