Skip to main content

The Platform for Experimental Collaborative Ethnography (PECE)

Project description

Platform for Experimental Ethnography (PECE)

A collective inquiry in to complex conditions. Development sponsored by Rensselaer Polytechnic Institute (RPI).

About

The PECE add-on for Plone is a research tool, currently in use by RPI but available to anyone doing similar research. It features Dexterity Content Types and a Collective Cover integration to enable the creation of an “Asthma File”: a collectively developed document containing artifacts and annotations.

Installation

To install PECE functionality on your Plone site, add collective.pece to your list of Plone “instance eggs” in your buildout.cfg file. Run Buildout and restart Plone. Create a new Plone site with the add-on selected:

screenshot1.png

Or add the functionality to an existing site:

screenshot2.png

After installation, you should be able to add 6 new content types to your Plone site:

screenshot8.png

Usage

Follow these steps to begin using the PECE functionality in your Plone site.

Add a Question

Questions facilitate Annotations of Artifacts when researchers respond to them in context. Before you do anything else, add an Asthma Question to your site.

screenshot4.png

Create Artifacts

An “Asthma File” is produced via the assembly of artifacts and annotations. So next, add some artifacts to your site. E.g.:

Audio artifact

screenshot9.png

Document artifact

Image artifact

screenshot5.png

Video artifact

screenshot10.png

Create an Asthma File

Now we can create an Asthma File, which is a collaborative document consisting of multiple Artifacts, Annotations, etc. Made possible via the use of Collective Cover. [1]

screenshot6.png screenshot7.png

Zotero Integration

This add-on provides experimental integration with zotero.com, currently in proof-of-concept stage i.e. there is API connectivity and nothing else. We are waiting for community input to help us decide the first feature.

To configure the demo view, set the following environment variables in your shell before running Plone e.g.:

$ export ZOTERO_API_KEY=dFXmvyQvLMQpdfNs
$ export ZOTERO_LIBRARY_ID=1234
$ export ZOTERO_LIBRARY_TYPE=group

Then check: http://localhost:8080/Plone/@@zotero.

Known Issues

feedparser

PyZotero’s feedparser version spec conflicts with Plone, see: https://github.com/urschrei/pyzotero/issues/29. To work around this issue, override Plone’s feedparser version spec in your buildout.cfg e.g.:

[versions]
feedparser = 5.1.3

documentviewer

collective.documentviewer’s Dexterity integration is in alpha stage, see:

Changelog

0.0.7 - 09/15/2013

  • Rename annotation -> asthma_annotation

  • Rename response -> asthma_response

  • Add richtext field to response, fixes #1

  • Reorder artifact content type fields

  • Rename artifact primary fields to file_

  • Add artifact-view to display menu

0.0.6 - 09/13/2013

  • Fix package error

0.0.5 - 09/13/2013

  • Rename reserved word “dublin_core-named” fields from dublin_core_<fieldname> to <fieldname>_

  • Rename package: rpi.asthma_files_site -> collective.pece

  • Remove logo customization, part II: template-overrides directory removed

  • Rename question content type id -> asthma_question

  • Add tests

  • Add more documentation

  • Add preliminary Zotero integration

  • Add collective.documentviewer integration

0.0.4 - 09/02/2013

  • Add more documentation

  • Change title/id generation on all artifacts to use INameFromFileName behavior

0.0.3 - 08/28/2013

  • Remove new-style (Diazo) theme

0.0.2 - 08/25/2013

  • Add empty registry

  • Remove dep on p.a.theming

  • Add preliminary installation and usage documentation.

  • Rename menu item: (Asthma) Question -> Asthma Question.

  • Remove logo customization until Diazo theme is completed/supported.

0.0.1 - 08/21/2013

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.pece-0.0.7.zip (853.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page