Extension:RDFIO

Introduction
This extension extends the RDF import and export functionality in Semantic MediaWiki by providing import of arbitrary RDF triples (not only OWL ontologies, as was the case before), and a SPARQL endpoint that allows write operations.

Technically, RDFIO implements the PHP/MySQL based triple store (and its accompanying SPARQL Endpoint) provided by the ARC2 library. For updating wiki pages with new triples on import/sparql update, the SMWWriter extension is used.

The RDF import stores the original URI of all imported RDF entities (in a special property), which can later be used by the SPARQL endpoint, instead of SMW's internal URIs, which thus allows to expose the imported RDF data "in its original formats", with its original URIs. This allows to use SMW as a collaborative RDF editor, in workflows together with other semantic tools, from which it is then possible to "export, collaboratively edit, and import again", to/from SMW.

This extensions was developed as part of a Summer of Code 2010 project. The project description can be found here. See also the status page, with info on how you can follow the project.

Demo

 * Screencast: Demonstrating RDF import and SPARQL update with RDFIO
 * Screencast: Sensible wiki titles on RDF import with "pseudo RDF namespaces"

Alternative triple store connectors
One of the features of RDFIO is to connect Semantic MediaWiki with a triple store. There are (already) a few extensions that offer this feature. See SPARQLExtension for a nice overview of triple store connector features. (The idea behind RDFIO goes beyond providing a triple store connector though, by also extending the RDF import functionality).

Download
SVN Checkout URL (or browse): http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/RDFIO/

About this instruction
Disclaimer: This manual currently mainly supports Ubuntu, but contributed hints on how to do the same things in Windows, we will gladly include.

Commandline code snippets for Ubuntu are now included in order to simplify things. These are not guaranteed to work or be the best option in all circumstances though! (See website of each respecive software/extension for full details)

Installing MediaWiki
This is if you don't have a Semantic MediaWiki installation: cd wiki/ svn checkout http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0/phase3/. chmod a+w config/
 * Create a MySQL database and a user, with phpMyAdmin or similar.
 * To check out the MediaWiki 1.16 version, do:

mv config/LocalSettings.php.
 * Go to your wiki (e.g. http://localhost/wiki) and enter the installation options, including the database and user that you created above.
 * Run the installation
 * In the commandline again, in the wiki/ folder:
 * Access your wiki again (e.g. http://localhost/wiki)

Installing Semantic MediaWiki
cd wiki/extensions sudo rm -r .svn

The last line is because we will check out another repository to this folder: svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SemanticMediaWiki/

Add the following lines (modify the base url of course, to something like "localhost", if you are running on your local machine) to your LocalSettings.php file: /* SMW */ include_once("$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php"); enableSemantics('your-server-domain-name');
 * 1) Make sure to configure this correctly, otherwise some
 * 2) functionality of the SPARQL endpoint will not work:

/* Show the factbox on bottom of pages */ $smwgShowFactbox = SMW_FACTBOX_NONEMPTY;
 * Important: Make sure to configure the server domain name, above, correctly!
 * Log in to the wiki as a super user
 * Go to the article Special:SMWAdmin
 * Click "Initialise or upgrade tables"
 * Done!
 * (More info on download and installation)

Installing RDFIO
... assuming that you have a working Semantic MediaWiki installation (Tested with MW *1.16* and later).

It is STRONGLY recommended that you use the latest version from the svn trunk, since that is what this extension is tested against continually!

cd wiki/extensions svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SMWWriter/ svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/PageObjectModel svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/RDFIO
 * Install SMWWriter and PageObjectModel and RDFIO, according to instructions on this page, or run the following commands:


 * Include lines for SMWWriter and PageObjectModel don't have to be added, since RDFIO adds them for you!

LocalSettings.php configuration
/************************** *                       * *         RDF IO         * *                       * **************************/
 * Add the following lines to LocalSettings.php:

require_once("$IP/extensions/RDFIO/RDFIO.php");

$rdfiogUseNSPrefixInWikiTitleForProperties = false; $rdfiogUseNSPrefixInWikiTitleForEntities = true;
 * 1) Configuration ######################################
 * 2) You may modify the following settings to your liking #

$rdfiogBaseURIs = array;
 * 1) An associative array with base uris as keys and corresponding
 * 2) prefixes as the items. Example:
 * 3) array(
 * 4)       "http://example.org/someOntology#" => "ont1",
 * 5)       "http://example.org/anotherOntology#" => "ont2"

$rdfiogQueryByOrigURI = true; $rdfiogOutputOrigURIs = true;
 * 1) Query by /Output Original URIs in SPARQL Endpoint
 * 2) (overrides settings in HTML Form)

$rdfiogQueryByEquivURI = false; $rdfiogOutputEquivURIs = false;
 * 1) Query by /Output Equivalent URIs SPARQL Endpoint
 * 2) (overrides settings in HTML Form)

$rdfiogPropertiesToUseAsWikiTitle = array( 'http://semantic-mediawiki.org/swivt/1.0#page',  'http://www.w3.org/2000/01/rdf-schema#label',  'http://purl.org/dc/elements/1.1/title',  'http://www.w3.org/2004/02/skos/core#preferredLabel',  'http://xmlns.com/foaf/0.1/name',  'http://www.nmrshiftdb.org/onto#spectrumId' );

$smwgOWLFullExport = true;
 * 1) Needed in order to allow user defined properties for
 * 2) property articles (which is needed by the RDF import)

$rdfiogAllowRemoteEdit = false;
 * 1) Allow edit operations via SPARQL from remote services

cd wiki/extensions/SemanticMediaWiki/libs wget http://code.semsol.org/source/arc.tar.gz tar -zxvf arc.tar.gz
 * Optional: Edit the $rdfiogPropertiesToUseAsWikiTitle array according to your liking.
 * Download the ARC2 library from here, then extract and place it in `wiki/extensions/SemanticMediaWiki/libs/arc`, so that the file `ARC2.php` is placed in the `arc` folder. Command line syntax:
 * (RDFIO adds include lines for SMWWriter and ARC)
 * Log in to your wiki as a super user
 * Edit the main page and add the following wiki snippet, which will give you links to the main functionality with RDFIO:
 * ARC2Admin
 * RDFImport
 * SPARQLEndpoint
 * Browse to http://[your-domain]/wiki/Special:ARC2Admin
 * Click the "Setup" button is to set up the database tables.
 * Note: If you already have semantic annotations in your wiki, you need to go to the article "Special:SMWAdmin" in your wiki, and click "Start updating data", and let it complete, in order for the data to be available in the SPARQL endpoint.
 * Create the article "MediaWiki:Smw_uri_blacklist" and make sure it is empty (you might need to add some nonsense content like { – }).
 * Now, try adding some semantic data to wiki pages, and then check the database (using phpMyAdmin e.g.) to see if you get some triples in the table named `arc2store_triple`
 * Access the SPARQL endpoint at http://[url-to-your-wiki]/Special:SPARQLEndpoint
 * Access the RDF Import screen at http://[url-to-your-wiki]/Special:RDFImport

How to apply a patch in Windows
(Kindly contributed by Oleg Simakoff - osimakoff at gmail.com)

Patching Instructions for Windows (XP, Vista, 7) users. Note: the following instructions assume that you have installed TortoiseSVN Subversion Client.
 * Information: http://tortoisesvn.tigris.org/
 * Download: http://tortoisesvn.net/downloads


 * 1) obtain a `[patch-filename].patch` file
 * 2) copy file into directory containing the files to be patched
 * 3) right-click on a `[patch-filename].patch` file to bring up a menu and select `[TortoiseSNV] | [Apply patch...]`
 * 4) your selection will bring up a `[TortoiseMerge]` window and `[File Patches]`
 * 5) right-click on a file you would like to patch to preview, patch selected or patch all files
 * 6) after patching is done, press `[Save]` to save your work.

Dependencies

 * Semantic MediaWiki Extension
 * SMWWriter Extension
 * Page Object Model Extension (Dependency of SMWWriter)
 * ARC2 RDF library for PHP.

Bugs, new feature request and contact information
Please reports bugs and feature requests in Bugzilla. General feedback can be given at the here on the talk page.

Change Log

 * 0.5.0 - 2010-09-17 - Numerous fixes to make remote SPARQL querying work (See repository updates for a list of all commits).
 * Improved file hierarchy
 * Made querying and output of/querying by Original URIs and Equivalent URIs configurable from LocalSettings.php in SPARQL endpoint (So this can be turned on for remote queries too)
 * In total five new configurable settings for LocalSettings.php (see here for full list):
 * $rdfiogQueryByOrigURI = true;
 * $rdfiogOutputOrigURIs = true;
 * $rdfiogQueryByEquivURI = false;
 * $rdfiogOutputEquivURIs = false;
 * $rdfiogAllowRemoteEdit = false;
 * Lots of serious bug fixes encountered when making SPARQL querying from Bioclipse/Jena work
 * 0.4.0 - 2010-08-16
 * Support for configuring extra namespace prefixes in LocalSettings.php
 * More options in RDF Import screen
 * Output SPARQL resultset as default for remote queries, and HTML for form queries
 * Enable output as Original URI/Equivalent URI also for XML Resultset output format
 * Refactorings (Merged EquivalentURIHandler and SMWBatchWriter classes, Broke out RDFIOPageHandler in separate file)
 * Many bugfixes
 * 0.3.0 - 2010-07-30 - Added output filtering options and other improvements.
 * Option to query by Equivalent URI
 * Refined SPARQL Endpoint screen
 * Option to output all Equivalent URIs (For RDF/XML format only)
 * Option to filter properties by ontology (when outputting equivalent URIs) by specified an URL to an OWL ontology definition. (For RDF/XML format only).
 * Much improved processing of SPARQL queries
 * Various refactoring
 * Fixed various bugs
 * Initialize query variable (r150)
 * Don't delete Original URI properties etc when deleting other facts (r151)
 * Fixed error in isURL check (r153)
 * 0.2.0 - 2010-07-20 - Important security improvements
 * Checking for appropriate user rights on all special pages
 * Improved code structure and comments
 * Various small fixes
 * 0.1.0 - 2010-07-21 - First release