Changes

Jump to: navigation, search

Drumbeat/Attribution generator Functional Specification

162 bytes added, 19:54, 23 November 2010
OpenAttribute: Functional Specification
=OpenAttribute: Functional Specification= Authors: Laura F. Hilliger (laura@bigfunarts.com)<br>Creation Date:11/22/2010<br>Last Updated: 11/22/2010<br>Version: 0.1
'''Authors'''<br>
[[#8|8 Recommended Approaches]]<br>[[#9|9 Open Issues]]
<br>  == '''1. Project Overview'''<br> == <br>Open Attribute is a project to build attribution generators for Creative Commons licensed content. The project is to build simple tools for a range of platforms so that re-using and attributing open content is as easy as cut and paste. <br> For more, see the [http://etherpad.mozilla.com:9000/OpenAttribute-one-page-overview one-page project description here].<br>  == '''2. Models'''<br> == <br>Two models currently exist for this open attribution tool. Both models are limited by their own technical use cases instigating the creation of two separate code solutions. The models define no special functions for any additional user models.
'''[[|]]1. Project Overview'''<br>Open Attribute is a project to build attribution generators for Creative Commons licensed content. The project is to build simple tools for a range of platforms so that re-using and attributing open content is as easy as cut and paste. <br> For more, see the [http://etherpad.mozilla.com:9000/OpenAttribute-one-page-overview one-page project description here].<br>
'''[[|]] === 2. Models'''1 Add On<br>Two models currently exist for this open attribution tool. Both models are limited by their own technical use cases instigating the creation of two separate code solutions. The models define no special functions for any additional user models. ===
[[|]]2.1 Add On<br>The Add On is defined as a browser extension, which, when installed, allows the user to pull available RDFa data and format it into the proper attribution. When no RDFa data is available, metadata should be generated from other sources NEEDS TO BE INVESTIGATED. When neither RDFa or alternative metadata exist, the add on should pull appropriate data (alt tags, HTML) using class or id names. The method of pulling non metadata must be specific for each interface (see Ch. 3), meaning that an interface detection method will be necessary. The Add On will also allow for manual entry of attribution data when RDFa or metadata does not exist. The manual entry option should also exist when pulling non metadata, as the HTML may not be properly formatted for attribution.
The Add On's use scenario will be specifically click a button in the browser. A sidebar appears with the formatted attribution in plain text and HTML. The Add On's use case will be pulling content from the web to a personal document (see Ch. 4).
[[|]]=== <br> === === 2.2 Plugin<br>=== The Plugin is defined as an external code snippet created for use with specific PHP based, open source platforms. These platforms will be: Wordpress, Drupal, Joomla, Zotero, dSpace, ccMixter. The plugin will be created and tested using Wordpress. Iterations of the plugin for the other listed platforms will be forthcoming after successful Wordpress trials. The plugin will also allow for manual entry of attribution data when RDFa or metadata does not exist. The manual entry option should also exist when pulling non metadata, as the HTML may not be properly formatted for attribution.
The Plugin's use scenario will be specifically click a button that appears on the content landing page or the download page. A pop-up (e.g., using ajax or javascript) offers plain text and HTML options for copying and pasting the attribution. The Plugin's use case will be pulling content from the web to the web (see Ch. 4).
== <br>'''[[|]]3. Use Cases'''<br>[[|]]== === <br>3.1 Image to Personal Document<br>[[|]]=== === <br>3.1.1 Copying Images<br>=== The user finds an image that he/she would like to use in a personal document. The user copies the image to the clipboard. The attribution information is copied with the image. Upon pasting the image, attribution information is printed below the image with the same width as the image and using left alignment.<br>[[|]]<br> ==== 3.1.2 Downloading Images<br>==== The user finds an image that he/she would like to use in a personal document. The user downloads the image. The attribution information is stored in the image file as metadata. (this works for sure with JPG, investigate GIF, PNG file formats)  <br> === 3.2 Text to Personal Document<br> === The user finds a piece of text that he/she would like to use in a personal document. The user copies the text and upon paste the text is formatted into quotation style with attribution information appearing in italics two points smaller and aligned right of the quotation.  <br> == 3.3 Video to Personal Document<br> == === <br>3.3.1 Copying Video<br> === The user finds a video that he/she would like to use in a personal document. The user tries to copy the video to the clipboard. The attribution information is copied with the video location information. Upon pasting, attribution and a link will be printed to the document.<br> ==== <br>3.3.2 Downloading Video<br> ==== The user finds a video that he/she would like to use in a personal document. The user downloads the video. The attribution information is stored in the video file as metadata.
3.2 Text to Personal Document<br>The user finds a piece of text that he/she would like to use in a personal document. The user copies the text and upon paste the text is formatted into quotation style with attribution information appearing in italics two points smaller and aligned right of the quotation.
=== 3.3 Video to Personal Document<br>3.3.1 Copying Video<br>The user finds a video that he/she would like to use in a personal document. The user tries to copy the video to the clipboard. The attribution information is copied with the video location information. Upon pasting, attribution and a link will be printed 4 Manual Entry to the document.Web (Add On)<br>3.3.2 Downloading Video<br>The user finds a video that he/she would like to use in a personal document. The user downloads the video. The attribution information is stored in the video file as metadata. ===
3.4 Manual Entry to Web (Add On)<br>The user clicks the button to begin the attribution process, when no RDFa, metadata or suitable HTML is found, the Add On opens a form. The form includes entry for the title of the work being attributed, attribution name (e.g., author, company, username), source URL for the attributed work, CC license name, CC license URL, existing copyright notices. Optional attribution elements are the URL for the author site and contact information for additional permissions.
3.5 Image to Web<br>The user finds an image that he/she would like to use on the web. The user copies the image to the clipboard. The attribution information is copied with the image. Upon pasting the image, attribution information is printed below the image with the same width as the image and using left alignment. Additionally, the image itself is linked to the original source.
Confirm
9,624
edits

Navigation menu