plone for education: bibliographies

Plone for Education: Bibliographies

Sally Kleinfeldt, Cris EwingPlone Conference Brasilia

2 October 2013

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

Why Plone?

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

Fundamentals

Fundamentals• Secure

• Robust permission system

• Accessible (Section 508)

• Scaleable (users, pages)

• Diazo theming with HTML, CSS

• Custom types and workflows

Add-ons

Add-ons• LDAP/Active Directory

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/

CMFBibliographyAT• Create and manage

bibliographic references

• 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

AT content types, plus special folder• Personal and aggregated lists

AT content types, plus special folder• Personal and aggregated lists• Schema follows BibTeX - LaTeX’s reference

management system

AT content types, plus special folder• Personal and aggregated lists• 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

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

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

Editing

Built-in Search

Style Wars!

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

Different Discipline Different Style

Etc...

Styles in Plone Bibliographies

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

Styles in Plone Bibliographies

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

Not Enough!

CC BY Cherry Ride - 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?

• A problem all bibliographic tools have to solve

CSL to the Rescue!

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

Citation Style Language

• http://citationstyles.org/

• http://citationstyles.org/ • XML syntax for defining bibliographic

styles

styles• 6,500+ styles available on crowd

sourced Github repository

styles• 6,500+ styles available on crowd

sourced Github repository• Styles can be browsed, previewed at

Zotero Style Repository

CSL Processors

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

CSL Processors• citeproc-js

• citeproc-hs

• citeproc-ruby

• citeproc-hs

• citeproc-ruby

• citeproc-java

• 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

• citeproc-js - JavaScript CSL processor in wide use

The Right Solution

The Right Solution• Standard way to add citation styles

The Right Solution• Standard way to add citation styles• Used by Zotero, reference management

Firefox plugin

Firefox plugin• Add-ons for Drupal and Wordpress

Firefox plugin• Add-ons for Drupal and Wordpress• Need add-on for Plone!

Thank You to Our Sponsors

Our Sponsors

• Needed bibliography styling

Our Sponsors

• Needed bibliography styling • Agreed to pool resources

collective.citationstyles

• Integration of CSL styles into Plone

• Integration of CSL styles into Plone• Control panel to upload style xml files

• Integration of CSL styles into Plone• Control panel to upload style xml files• Allow selection of site-wide “default” style

• 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

• 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• Handle actual rendering in-browser on

the client side

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

• Iterator• An adapter• Iterates over context• yields IBibliographicReferences

The Moving Parts

The Moving Parts• Renderer

• a utility

• a utility• pass in

IBibliographicReference

IBibliographicReference• extracts values

• CMFBib -> CSL

• CMFBib -> CSL• returns python dict

The Moving Parts

• @@citations-json browser view

The Moving Parts

• @@citations-json browser view• in any context

The Moving Parts

• @@citations-json browser view• in any context• builds iterator

The Moving Parts

• @@citations-json browser view• in any context• builds iterator• renders references

The Moving Parts

• @@citations-json browser view• in any context• builds iterator• renders references• returns JSON

The Moving Parts

• @@citations-json browser view• 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

collective.citationstylesStatusUsable

• can import CSL styles

Usable

• can import CSL styles• can select default style

Usable

• can import CSL styles• can select default style• will render individual references

Usable

• can import CSL styles• can select default style• 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/

• Big, old fashioned, complicated

• CMF layer, Archetypes

• Not Collection friendly

• Major rewrite would be huge

CMFBibliographyATWay Forward

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

• Find sponsors

• Find sponsors• Schedule rewrite sprint

Questions?cris@crisewing.com

@crisewing

plone for education: bibliographies

different types of references

examples http

citation style language

example http

styles available

new styles

hundreds of styles

moyan brenn http

Technology

best. plone. ever! presenting plone 3

plone handouts

plone screenshots

eu-osha: nuestra experiencia con plone - plone day 2012

troubleshooting plone

mastering plone documentation...mastering plone...

bibliographies (2)

annotated bibliographies

mrs price descriptors *annotated bibliographies; audiovisual...

burma bibliographies

plone for education: bibliographies

about plone - enfold systems, the plone experts

angularjs & plone

plone and drupal -- cms coexistance in higher education

plone server

referencing & bibliographies

iterating plone

jon stahl best plone ever presenting plone 3

plone cono sur: creating a plone users group from scratch

systems analysis and education research literature...