OpenLink Structured Data Editor (OSDE) Extension
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
AUTHORS
COPYING
CREDITS
LICENSE
README.md
prepare_chrome.sh
prepare_ff.sh

README.md

OpenLink Structured Data Editor

Intro

The OpenLink Structured Data Editor (OSDE) is a tool for creating and editing structured data using RDF Language sentences/statements. It is available here as a plugin for Google Chrome, Mozilla Firefox and Opera web browsers (support for additional browsers like Apple Safari and Microsoft Edge is under construction), and elsewhere in a webserver-hosted form.

In any of these forms, OSDE creates and enables creation and editing of data using abstract subject → predicate → object or entity → attribute → value notation. Once constructed, data can be saved to local or remote storage as RDF-Turtle documents. Full document access requires that HTTP-accessible host servers support at least one of the following open standards:

Data stored as RDF-Turtle documents can be further transformed to other formats (JSON-LD, CSV, OData, Microdata, RDF/XML, RDF/JSON, etc.) using a variety of transformation tools and services.

License

Copyright 2014-2019 OpenLink Software

This software is licensed under the GNU General Public License (see COPYING).

Note: the only valid version of the GPL license as far as this project is concerned is the original GNU General Public License Version 2, dated June 1991.

Why is OSDE Important?

The World Wide Web (or simply, the Web) was originally conceived as a Read-and-Write medium, but even now, with user-created content filling many web surfers' screens, most usage remains Read-Only.

OSDE bolsters the growing Write dimension by letting users create structured data using the familiar File Create → Save → Share pattern, without forcing a document storage location, i.e., documents created with OSDE may be stored to the desktop or to virtually anywhere in the cloud.

Features of OSDE

  • There is no assumption that Structured Data will be created in English; i.e., structured data can be annotated with language tags identifying the natural language of each annotation. (For example, if annotating in English, you would put “en” in the lang field, when prompted.)
  • Shared Ontologies/Vocabularies may be imported to ease data entry.
  • Sentence predicate types are intelligently suggested, driven by Ontology/Vocabulary lookups.
  • Automatic profile lookup — if authenticated via WebID+TLS protocol — provides default document storage locations and (eventually) other preferences.
  • A variety of EDIT views are scoped to Statements, Entities, Attribute Names, and Attribute Values. Users can switch between these views to suit their own editing modality preferences.
  • Documents may be saved (or downloaded) to local or cloud storage.
  • Cloud Storage supports multiple HTTP-based storage protocols (WebDAV, LDP, SPARQL Graph Protocol, SPARQL 1.1 Update).
  • Hosted deployment may be through Apache, IIS, Node.js, Tomcat, OpenLink Virtuoso, or any other HTTP Server.
  • OSDE is 100% Javascript.
  • OSDE is made available as Open Source.

New features and fixes

v1.1.3, 2017-11-21

  • Fix — Copy and Paste of RDF-Turtle or JSON-LD via “Direct Input” feature
  • Add — Load Turtle or JSON-LD documents from Filesystem
  • Add — Default WebID may be set via interaction with YouID extension, if also present — this sets the identity used for “Save” and “Save As” operations

Deployment

To deploy this extension on your local machine you can either clone the git source tree or download a source archive and then install the extension into your Chrome or Opera browser on the same system.

Clone the git source tree

Clone the sources from github using the following commands:

$ cd src
$ git clone https://github.com/OpenLinkSoftware/osde

which will automatically download the latest develop branch.

Download a source archive

Download and extract a .tar.gz or .zip from either one of the stable releases or directly from one of the following links:

Install the extension in Chrome

You can get the latest public release from the Chrome store.

To install the latest development build manually, take the following steps:

  1. Open the Chrome browser
  2. Select from menu: ChromePreferencesExtensions
  3. Check the [X] Developer mode box
  4. Choose the option Load unpacked extension...
  5. Navigate to the folder containing the extracted source code
  6. Press the Select button

Install the extension in Opera

You can get the latest public release from the Chrome store.

To install the latest development build manually, take the following steps:

  1. Open the Opera browser
  2. In address bar type in opera:extensions
  3. Press the Developer Mode button
  4. Choose the option Load unpacked extension...
  5. Navigate to the folder containing the extracted source
  6. Press the Select button

Install the extension in Firefox

Download the Firefox OSDE .zip file and extract the .xpi file.

To install this extension manually in Firefox v28+, use the following steps:

  1. Open the Firefox browser
  2. In address bar type: about:config
  3. Press the I'll be careful, i promise button
  4. Search for xpinstall.signatures.required
  5. Double click that line so the value is set to false
  6. In address bar type: about:addons
  7. Click on the Gear icon and select Install Add-On from file... from the menu
  8. Navigate to the directory where you extracted the OSDS_FF.xpi file, select this file and press the Open button
  9. Press the install button

How do I use OSDE?

Overview

Metaphorically, as in the real-word:

  1. You write sentences to a document (e.g., a page in a book).
  2. Sentences in a page are grouped by paragraphs. OSDE groups statements by attribute (predicate) to emulate this concept.
  3. A document may be part of a collection — like one of many pieces of paper in a folder, pages in a chapter, or chapters in a book. When writing to a SPARQL server, OSDE treats each document as a named graph.

Somewhat more elaborately —

  • You write "entity → attribute → value" or "subject → predicate → object" sentences/statements to a document, which is identified by an HTTP-scheme URL.
  • Entity and Attribute (or, if you prefer RDF parlance, Subject and Predicate) are each identified by an HTTP URI, which may be absolute or relative to the document. Value (a/k/a Object) may be either a literal string or a URI.
  • Sentence/Statement collections are grouped by Attribute (Predicate), and this is the basis for optimistic concurrency hashes constructed for handling multi-user editing activity against the same document.

You can get started by creating a brand new document or applying edits to an existing document.

Using an existing OSDE Instance, Local or Hosted

Basic Usage

  1. Set a location for your document. This could be a folder to contain a new document, or the target document itself.

  2. Open your document from its location.

  3. Add or edit RDF Language statements using any of the view options — defaults are Statements, Entities, Attributes, Values. Configuration options let you change these to Statements, Subjects, Predicates, Objects.

  4. Save your document to your desktop (via download link) or to a remote cloud location that supports one of:

  5. Done.

Demonstration of Turtle Input

  1. Start OSDE with a New Document. PNG of OSDE demo starting point

  2. From the Action menu, select Input Turtle Directly. Paste or type your Turtle, and click Import. PNG of OSDE demo Turtle input

  3. Inspect and/or edit the imported data in Statements view. PNG of OSDE demo Statements view

  4. Inspect and/or edit the imported data in Entities (Subjects) view. PNG of OSDE demo Entities (Subjects) view

  5. Inspect and/or edit the imported data in Attributes (Predicates) view. PNG of OSDE demo Attributes (Predicates) view

  6. Inspect and/or edit the imported data in Values (Objects) view. PNG of OSDE demo Values (Objects) view

Usage Screencasts

Here are a couple of silent screencasts showing OSDE in action, through loose coupling to the OpenLink Structured Data Sniffer (OSDS), which exposes OSDE as its Annotation feature.

  • OpenLink RDF Editor Demo -- Open Data Flow

    Open Data Flow Demo Video

  • OSDS & OSDE Integration Demo — Beyond Bookmarking Annotation Feature

    Beyond Bookmarking Annotation Feature Demo Video