What is OSDI?

The Inclusion Engine is a data-focussed content publication and management system.

Why use OSDI?

The Inclusion Engine offers the following features & benefits:

• Uniformity: bringing consistent appearance to multiple webpages in multiple hosted sites.
• Data-Enrichment: page impressions blend content, data and metadata from the RDF quadstore.
• Compatibility: other applications such as VSP scripts and ODS-Wiki can avail themselves of the same skin and data-embedding.
• Philosophy: the framework sits atop Virtuoso, which provides underlying web-server, built-in HTML5-aware version of Tidy, the XSLT engine, the database, the site configuration, the tables for caching and more.

How do I use OSDI?

Content

The most frequently used (but not only) workflow takes its sources from DAV, transforms them to HTML including blending data and metadata from the webserver and stores the results in a cache table for speedy repeat access.

Using the Conductor:

• Install the VAD package
• Configure a vhost with a rewrite rule on the top-level / vdir to invoke /DAV/VAD/inclusion-engine/common/index.vsp?url=$S1.
• Add a vdir /skin/clean/ mapped to /DAV/VAD/inclusion-engine/skins/clean/.
• Designate a DAV collection to act as source for the site HTML content files, e.g. /DAV/mysite/ with a content/ collection within it. Upload an index.html to /DAV/mysite/content/.
• In the Conductor, configure the Inclusion Engine by adding a site - a combination of short friendly name, base web URL (https://mysite/) and base DAV location (/DAV/mysite/).
• Point a browser at https://mysite/ and see what happens.

Data

Data Islands

These are machine-readable, suited to SEO metadata rather than human consumption, presented in multiple serialization formats such as JSON-LD, Turtle, HTML5-microdata and RDFa.

By default, all these data-islands are enabled and the OSDI executes a query of the form
SPARQL DESCRIBE <{URL}>;
for every page impression, subject to configuration options.

Embedded SPARQL Queries

OSDI facilitates surfacing RDF data as a visible aspect of the page content. The query resultset is expressed in the HTML DOM with accessor functions and the jQuery-templates library included to transform the presentation.

For example:

            prefix schema: 
            select distinct ?graph ?s ?p ?o {
              graph ?graph {?s ?p ?o .}
              bind(?s=<http://schema.org/name> )
            }
            order by ?graph ?p ?o
            limit 50