This page should list all the needeed informations to install and use LODr. In case not, please send me an e-mail so that I can update it.

Pre-requirements

• Apache (it may work on other webservers, but has not been tested)
• Ability to manage RewriteRule using a .htaccess file
• PHP5, with curl support
• MySQL (one database is enough)

Install

Once you have downloaded the LODr client, follow the following steps to complete the install process:

• Copy the client in a web accessible directory. You should have a look at the .htaccess file in the lodr folder, and may need to change the RewriteBase depending on your installation folder.
• Copy config_dist.php to config.php and edit the file. The comments should be self-explanatory to let you know what must be changed or not.
• Regarding your FOAF URI, please remind that it *must* be a dereferencable URI returning either a RDF or RDFa representation of yourself, including some foaf:holdsAccount statements related to your online accounts, modeled as in the following example:
  
  <http://apassant.net/alex> foaf:holdsAccount [
      a foaf:OnlineAccount ;
      foaf:accountName "33669349@N00" ;
      foaf:accountServiceHomepage <http://www.flickr.com/> .
  ] .

• As soon as you finished editing config.php, you can go to http://your.hostname/lodrpath/setup. The process might bit a bit long as it creates the databases and initializes the triple store with your existing data;

Finally, in order to regularly fetch new content from your online accounts, you mut run a crontab for the http://your.hostname/lodrpath/update file.

Usage

This section is work in progress and will be improved later

As soon as the aplication is setup, you can browse the list of your tagged data, aggregated from the various services you're using.
A tagcloud provides a way to go to individual tag pages, while different lists can be browsed.

From those lists, you can then see each item individually (modeled using RDFa, so consider installing the Semantic Radar plug-in if you want this data to be discoverable more easily).

For each item, you can set the meanings of your tags by editing the item.
Here, you will be suggested URIs that have already been assigned for each tag in the LODr community and you can so validate of not a URI is a coherent meaning for your tag in the current context or not. If not, you can add a new URI, either manually or by using the Sindice Widget that will appear if you click on 'New URI'.

WARNING !!
If you are using a new URI please be careful this is a resource URI and not a document URI !! For instance, regarding DBpedia, /resource/xxx are resources URI, while /data/xxx or /page/xxx are not !!


Enter you secret key and save.
As soon as your data is validated, it will be pinged to the main LODr server, and you can use one of the existing tool to discover and browse it.
If you added a new URI for a given tag, it will be then suggested to the community when someone will use this tag, according to the architecture principles.