Learn about bibliographic content in the Plone CMS, and how to easily control the style of your bibliographies with integration of the citationstyles.org project into Plone.
1. Plone for Education:
Bibliographies
Sally Kleinfeldt, Cris Ewing, Carlos de la Guardia
Plone Conference Brasilia
2 October 2013
CC BY Yuri Levchenko - http://www.flickr.com/photos/i8ipod/9280261014/
2. Why Plone?
CC BY Bart Everson - www.flickr.com/photos/editor/6698208975/
19. CMFBibliographyAT
• Create and manage
bibliographic
references
CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/
20. CMFBibliographyAT
• Create and manage
bibliographic
references
• Feature complete
for its niche
CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/
21. CMFBibliographyAT
• Create and manage
bibliographic
references
• Feature complete
for its niche
• Stable - not much
change in 2 years
CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/
23. Details
• Provides 16 different types of references as
AT content types, plus special folder
24. Details
• Provides 16 different types of references as
AT content types, plus special folder
• Personal and aggregated lists
25. Details
• Provides 16 different types of references as
AT content types, plus special folder
• Personal and aggregated lists
• Schema follows BibTeX - LaTeX’s reference
management system
26. Details
• Provides 16 different types of references as
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)
44. Styles in Plone
Bibliographies
• Products.ATBiblioStyles adds support for
Chicago, Harvard, APA, MLA styles
• Python skills required to add new styles
47. Not Enough!
CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/
48. Not Enough!
• A few styles is not
enough for serious
academic use
CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/
49. Not Enough!
• A few styles is not
enough for serious
academic use
• How to easily support
hundreds of styles?
CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/
50. 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
CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/
51. CSL to the Rescue!
CC BY Scott Feldstein - http://www.flickr.com/photos/scottfeldstein/66034401/
56. Citation Style
Language
• http://citationstyles.org/
• XML syntax for defining bibliographic
styles
• 6,500+ styles available on crowd
sourced Github repository
• Styles can be browsed, previewed at
Zotero Style Repository
61. CSL Processors
• citeproc-js
• citeproc-hs
• citeproc-ruby
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
62. CSL Processors
• citeproc-js
• citeproc-hs
• citeproc-ruby
• citeproc-java
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
63. CSL Processors
• citeproc-js
• citeproc-hs
• citeproc-ruby
• citeproc-java
• citeproc-py
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
64. CSL Processors
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
65. CSL Processors
• citeproc-py is... fluid
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
66. CSL Processors
• citeproc-py is... fluid
• Only about 60%
complete
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
67. CSL Processors
• citeproc-py is... fluid
• Only about 60%
complete
• Aimed at Python 3.x
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
68. CSL Processors
• citeproc-py is... fluid
• Only about 60%
complete
• Aimed at Python 3.x
• citeproc-js -
JavaScript CSL
processor in wide
use
CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/
71. The Right Solution
• Standard way to add citation styles
• Used by Zotero, reference management
Firefox plugin
72. The Right Solution
• Standard way to add citation styles
• Used by Zotero, reference management
Firefox plugin
• Add-ons for Drupal and Wordpress
73. The Right Solution
• Standard way to add citation styles
• Used by Zotero, reference management
Firefox plugin
• Add-ons for Drupal and Wordpress
• Need add-on for Plone!
82. 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
83. 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
• Handle actual rendering in-browser on
the client side
101. the moving parts
• @@citations-json browser view
• in any context
• builds iterator
102. the moving parts
• @@citations-json browser view
• in any context
• builds iterator
• renders references
103. the moving parts
• @@citations-json browser view
• in any context
• builds iterator
• renders references
• returns JSON
104. the moving parts
• @@citations-json browser view
• in any context
• builds iterator
• renders references
• returns JSON
105. 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
122. CMFBibliographyAT
Problems
• Big, old fashioned,
complicated
• CMF layer, Archetypes
CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/
123. CMFBibliographyAT
Problems
• Big, old fashioned,
complicated
• CMF layer, Archetypes
• Not Collection friendly
CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/
124. CMFBibliographyAT
Problems
• Big, old fashioned,
complicated
• CMF layer, Archetypes
• Not Collection friendly
• Major rewrite would be
huge
CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/