Uploaded on

Websites targeted at academic audiences can serve a variety of purposes, but no matter what the discipline, bibliographic references are a common theme. Plone has supported online bibliographies for …

Websites targeted at academic audiences can serve a variety of purposes, but no matter what the discipline, bibliographic references are a common theme. Plone has supported online bibliographies for many years - the CMFBibliographyAT add-on supports a number of different export and import formats and 16 different reference types. However Plone's current bibliography toolkit has been limited in the ways that references can be styled and used in citations.

CSL - citation style language - defines an XML syntax for defining bibliographic styling, which is used by many systems including add-ons for Drupal and Wordpress. In this talk we will describe a new add-on (collective.citationstyles) that lets Plone produce formatted bibliographies and citations by using the formatting instructions provided by CSL styles in conjunction with the bibliography content types. we will also discuss the status of plans for upgrading CMFBibliographyAT.

More in: Technology
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads

Views

Total Views
116
On Slideshare
0
From Embeds
0
Number of Embeds
3

Actions

Shares
Downloads
1
Comments
0
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 1. Plone for Education: Bibliographies Sally Kleinfeldt Plone Symposium Midwest 18 June 2014 CC BY Yuri Levchenko - http://www.flickr.com/photos/i8ipod/9280261014/ Wednesday, June 18, 14
  • 2. Why Plone for Edu? CC BY Bart Everson - www.flickr.com/photos/editor/6698208975/ Wednesday, June 18, 14
  • 3. Fundamentals Wednesday, June 18, 14
  • 4. Fundamentals • Secure Wednesday, June 18, 14
  • 5. Fundamentals • Secure • Robust permission system Wednesday, June 18, 14
  • 6. Fundamentals • Secure • Robust permission system • Accessible (Section 508) Wednesday, June 18, 14
  • 7. Fundamentals • Secure • Robust permission system • Accessible (Section 508) • Scaleable (users, pages) Wednesday, June 18, 14
  • 8. Fundamentals • Secure • Robust permission system • Accessible (Section 508) • Scaleable (users, pages) • Diazo theming with HTML, CSS Wednesday, June 18, 14
  • 9. Fundamentals • Secure • Robust permission system • Accessible (Section 508) • Scaleable (users, pages) • Diazo theming with HTML, CSS • Custom types and workflows Wednesday, June 18, 14
  • 10. Add-ons Wednesday, June 18, 14
  • 11. Add-ons • LDAP/Active Directory integration Wednesday, June 18, 14
  • 12. Add-ons • LDAP/Active Directory integration • Subsites for departments, faculties Wednesday, June 18, 14
  • 13. Add-ons • LDAP/Active Directory integration • Subsites for departments, faculties • Calendaring tools Wednesday, June 18, 14
  • 14. Add-ons • LDAP/Active Directory integration • Subsites for departments, faculties • Calendaring tools • Fundraising/CRM (Salesforce.com) Wednesday, June 18, 14
  • 15. Add-ons • LDAP/Active Directory integration • Subsites for departments, faculties • Calendaring tools • Fundraising/CRM (Salesforce.com) • Faculty/Staff Directory Wednesday, June 18, 14
  • 16. Add-ons • LDAP/Active Directory integration • Subsites for departments, faculties • Calendaring tools • Fundraising/CRM (Salesforce.com) • Faculty/Staff Directory • Bibliographies Wednesday, June 18, 14
  • 17. Bibliographies for Plone since 2005 Wednesday, June 18, 14
  • 18. CMFBibliographyAT CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/ Wednesday, June 18, 14
  • 19. CMFBibliographyAT • Create and manage bibliographic references CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/ Wednesday, June 18, 14
  • 20. CMFBibliographyAT • Create and manage bibliographic references • Feature complete for its niche CC BY Moyan Brenn - http://www.flickr.com/photos/aigle_dore/6365101775/ Wednesday, June 18, 14
  • 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/ Wednesday, June 18, 14
  • 22. Details Wednesday, June 18, 14
  • 23. Details • Provides 16 different types of references as AT content types, plus special folder Wednesday, June 18, 14
  • 24. Details • Provides 16 different types of references as AT content types, plus special folder • Personal and aggregated lists Wednesday, June 18, 14
  • 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 Wednesday, June 18, 14
  • 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) Wednesday, June 18, 14
  • 27. Examples http://www.weigelworld.org/research/publications Wednesday, June 18, 14
  • 28. Examples http://www.weigelworld.org/research/publications Wednesday, June 18, 14
  • 29. Examples http://www.doaks.org/resources/seals/seals-bibliography Wednesday, June 18, 14
  • 30. Examples http://www.upress.umn.edu/ (staging site) Wednesday, June 18, 14
  • 31. Editing Wednesday, June 18, 14
  • 32. Built-in Search Wednesday, June 18, 14
  • 33. Faceted Navigation Wednesday, June 18, 14
  • 34. Style Wars! CC BY Jill Carlson - www.flickr.com/photos/jill_carlson/9704689913/ Wednesday, June 18, 14
  • 35. Different Discipline Different Style Wednesday, June 18, 14
  • 36. Different Discipline Different Style APA Wednesday, June 18, 14
  • 37. Different Discipline Different Style APA Wednesday, June 18, 14
  • 38. Different Discipline Different Style APA CSE Wednesday, June 18, 14
  • 39. Different Discipline Different Style APA CSE Wednesday, June 18, 14
  • 40. Different Discipline Different Style APA CSE MLA Wednesday, June 18, 14
  • 41. Different Discipline Different Style APA CSE MLA Wednesday, June 18, 14
  • 42. Different Discipline Different Style APA CSE MLA Etc... Wednesday, June 18, 14
  • 43. Styles in Plone Bibliographies Wednesday, June 18, 14
  • 44. Styles in Plone Bibliographies • Products.ATBiblioStyles adds support for Chicago, Harvard, APA, MLA styles Wednesday, June 18, 14
  • 45. Styles in Plone Bibliographies • Products.ATBiblioStyles adds support for Chicago, Harvard, APA, MLA styles • Python skills required to add new styles Wednesday, June 18, 14
  • 46. Example http://www.es.utoronto.ca/Members/anderson/anderson_bib/ Wednesday, June 18, 14
  • 47. Example http://www.es.utoronto.ca/Members/anderson/anderson_bib/ Wednesday, June 18, 14
  • 48. Not Enough! CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/ Wednesday, June 18, 14
  • 49. Not Enough! • A few styles is not enough for serious academic use CC BY Cherry Ride - http://www.flickr.com/photos/cherryride/5466972761/ Wednesday, June 18, 14
  • 50. 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/ Wednesday, June 18, 14
  • 51. 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/ Wednesday, June 18, 14
  • 52. CSL to the Rescue! CC BY Scott Feldstein - http://www.flickr.com/photos/scottfeldstein/66034401/ Wednesday, June 18, 14
  • 53. Citation Style Language Thank you Lawrence Loewe and Symposium Midwest 2013! Wednesday, June 18, 14
  • 54. Citation Style Language Wednesday, June 18, 14
  • 55. Citation Style Language • http://citationstyles.org/ Wednesday, June 18, 14
  • 56. Citation Style Language • http://citationstyles.org/ • XML syntax for defining bibliographic styles Wednesday, June 18, 14
  • 57. Citation Style Language • http://citationstyles.org/ • XML syntax for defining bibliographic styles • 6,500+ styles available on crowd sourced Github repository Wednesday, June 18, 14
  • 58. 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 Wednesday, June 18, 14
  • 59. Zotero Style Repository Wednesday, June 18, 14
  • 60. CSL Processors CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 61. CSL Processors • citeproc-js CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 62. CSL Processors • citeproc-js • citeproc-hs CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 63. CSL Processors • citeproc-js • citeproc-hs • citeproc-ruby CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 64. CSL Processors • citeproc-js • citeproc-hs • citeproc-ruby • citeproc-java CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 65. CSL Processors • citeproc-js • citeproc-hs • citeproc-ruby • citeproc-java • citeproc-py CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 66. CSL Processors CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 67. CSL Processors • citeproc-py is... fluid CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 68. CSL Processors • citeproc-py is... fluid • Only about 60% complete CC BY Ray Larabie - http://www.flickr.com/photos/27117620@N06/6243443814/ Wednesday, June 18, 14
  • 69. 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/ Wednesday, June 18, 14
  • 70. 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/ Wednesday, June 18, 14
  • 71. The Right Solution Wednesday, June 18, 14
  • 72. The Right Solution • Standard way to add citation styles Wednesday, June 18, 14
  • 73. The Right Solution • Standard way to add citation styles • Used by Zotero, reference management system and Firefox plugin Wednesday, June 18, 14
  • 74. The Right Solution • Standard way to add citation styles • Used by Zotero, reference management system and Firefox plugin • Add-ons for Drupal and Wordpress Wednesday, June 18, 14
  • 75. The Right Solution • Standard way to add citation styles • Used by Zotero, reference management system and Firefox plugin • Add-ons for Drupal and Wordpress • Need add-on for Plone! Wednesday, June 18, 14
  • 76. Thank You to Our Sponsors Wednesday, June 18, 14
  • 77. Our Sponsors Wednesday, June 18, 14
  • 78. Our Sponsors • Needed bibliography styling Wednesday, June 18, 14
  • 79. Our Sponsors • Needed bibliography styling • Agreed to pool resources Wednesday, June 18, 14
  • 80. Our Sponsors • Needed bibliography styling • Agreed to pool resources • Jazkarta chipped in too... Wednesday, June 18, 14
  • 81. Not Pseudo-APA Style Wednesday, June 18, 14
  • 82. But Real APA Style! Wednesday, June 18, 14
  • 83. collective.citationstyles Wednesday, June 18, 14
  • 84. collective.citationstyles • Integration of CSL styles into Plone Wednesday, June 18, 14
  • 85. collective.citationstyles • Integration of CSL styles into Plone • Control panel to upload style xml files Wednesday, June 18, 14
  • 86. collective.citationstyles • Integration of CSL styles into Plone • Control panel to upload style xml files • Allow selection of site-wide “default” style Wednesday, June 18, 14
  • 87. 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 Wednesday, June 18, 14
  • 88. 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 Wednesday, June 18, 14
  • 89. collective.citationstyles Wednesday, June 18, 14
  • 90. collective.citationstyles Is Usable • Can import CSL styles • Can select default style • Will render individual references • Will render Bibliography Folders Wednesday, June 18, 14
  • 91. Samples CC-BY BartEverts: http://www.flickr.com/photos/barteverts/3068747619 Wednesday, June 18, 14
  • 92. Citation Styles Control Panel Wednesday, June 18, 14
  • 93. Bibliography Folder: Selecting a Style Wednesday, June 18, 14
  • 94. Bibliography Folder: Displaying a Style Wednesday, June 18, 14
  • 95. Individual Reference: CSL + Custom View Wednesday, June 18, 14
  • 96. Things We’d Like to Add Wednesday, June 18, 14
  • 97. Things We’d Like to Add • Editor style selection tab • Browser views for collections • Automatic processing of inline citations • Replacement of existing CMFBib views? Wednesday, June 18, 14
  • 98. CMFBibliographyAT Problems CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/ Wednesday, June 18, 14
  • 99. CMFBibliographyAT Problems • Big, old fashioned, complicated CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/ Wednesday, June 18, 14
  • 100. CMFBibliographyAT Problems • Big, old fashioned, complicated • CMF layer, Archetypes CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/ Wednesday, June 18, 14
  • 101. CMFBibliographyAT Problems • Big, old fashioned, complicated • CMF layer, Archetypes • Grew organically, new features pasted on CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/ Wednesday, June 18, 14
  • 102. CMFBibliographyAT Problems • Big, old fashioned, complicated • CMF layer, Archetypes • Grew organically, new features pasted on • Not Collection friendly CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/ Wednesday, June 18, 14
  • 103. CMFBibliographyAT Problems • Big, old fashioned, complicated • CMF layer, Archetypes • Grew organically, new features pasted on • Not Collection friendly • Major rewrite would be huge CC BY Stuart Seeger - http://www.flickr.com/photos/stuseeger/216598424/ Wednesday, June 18, 14
  • 104. CMFBibliographyAT Way Forward CC BY Dave Bleasdale - http://www.flickr.com/photos/sidelong/4564071208/ Wednesday, June 18, 14
  • 105. CMFBibliographyAT Way Forward • Find sponsors CC BY Dave Bleasdale - http://www.flickr.com/photos/sidelong/4564071208/ Wednesday, June 18, 14
  • 106. CMFBibliographyAT Way Forward • Find sponsors • Schedule rewrite sprint CC BY Dave Bleasdale - http://www.flickr.com/photos/sidelong/4564071208/ Wednesday, June 18, 14
  • 107. Rewrite Sponsors • Plone Foundation • German University Consortium • Jazkarta • Others? Wednesday, June 18, 14
  • 108. Rewrite Architecture • Take advantage of existing standards • Display layer - use Javascript CSL processor • Storage layer - use Dexterity types with MODS XML storage, the LOC standard bibutils works from • Management layer - use Plone Wednesday, June 18, 14
  • 109. Rewrite Approach • Inventory CMFBib + add-ons features • Prioritize features to re-implement • Implement each feature in the appropriate layer Wednesday, June 18, 14
  • 110. Rewrite is Essential • Archetypes is going away • Many academic sites use this tool Wednesday, June 18, 14
  • 111. Demo Wednesday, June 18, 14
  • 112. Discussion? Wednesday, June 18, 14
  • 113. The Moving Parts Wednesday, June 18, 14
  • 114. The Moving Parts • Iterator Wednesday, June 18, 14
  • 115. The Moving Parts • Iterator • An adapter Wednesday, June 18, 14
  • 116. The Moving Parts • Iterator • An adapter • Iterates over context Wednesday, June 18, 14
  • 117. The Moving Parts • Iterator • An adapter • Iterates over context • yields IBibliographicReferences Wednesday, June 18, 14
  • 118. The Moving Parts • Iterator • An adapter • Iterates over context • yields IBibliographicReferences Wednesday, June 18, 14
  • 119. The Moving Parts Wednesday, June 18, 14
  • 120. The Moving Parts • Renderer Wednesday, June 18, 14
  • 121. The Moving Parts • Renderer • a utility Wednesday, June 18, 14
  • 122. The Moving Parts • Renderer • a utility • pass in IBibliographicReference Wednesday, June 18, 14
  • 123. The Moving Parts • Renderer • a utility • pass in IBibliographicReference • extracts values Wednesday, June 18, 14
  • 124. The Moving Parts • Renderer • a utility • pass in IBibliographicReference • extracts values • CMFBib -> CSL Wednesday, June 18, 14
  • 125. The Moving Parts • Renderer • a utility • pass in IBibliographicReference • extracts values • CMFBib -> CSL • returns python dict Wednesday, June 18, 14
  • 126. The Moving Parts • Renderer • a utility • pass in IBibliographicReference • extracts values • CMFBib -> CSL • returns python dict Wednesday, June 18, 14
  • 127. The Moving Parts Wednesday, June 18, 14
  • 128. The Moving Parts • @@citations-json browser view Wednesday, June 18, 14
  • 129. The Moving Parts • @@citations-json browser view • in any context Wednesday, June 18, 14
  • 130. The Moving Parts • @@citations-json browser view • in any context • builds iterator Wednesday, June 18, 14
  • 131. The Moving Parts • @@citations-json browser view • in any context • builds iterator • renders references Wednesday, June 18, 14
  • 132. The Moving Parts • @@citations-json browser view • in any context • builds iterator • renders references • returns JSON Wednesday, June 18, 14
  • 133. The Moving Parts • @@citations-json browser view • in any context • builds iterator • renders references • returns JSON Wednesday, June 18, 14
  • 134. 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 Wednesday, June 18, 14