Debian-specific RDF::LinkedData usage notes
===========================================

Example demo-setup usage
------------------------

It is possible to run this system with a one-liner on the command line:

  PERLRDF_STORE="Memory;path/to/some/data.ttl" plackup -host localhost /usr/share/librdf-linkeddata-perl/rdf_linkeddata.psgi

where a file is loaded into a memory store on startup and the server
is started with a default config. The subjects of the triples in the
file has to start with http://localhost:5000/ for this to work. It is
recommended you use @base in the Turtle file for this, something like:

  @base <http://localhost:5000/> .
  </foo> a :Bar .

A more elaborate example uses the perlrdf package to load data into a
persistent SQLite store:

  export PERLRDF_STORE="DBI;mymodel;DBI:SQLite:database=rdf.db"
  perlrdf make_store
  perlrdf store_load path/to/some/data.ttl
  plackup -host localhost /usr/share/librdf-linkeddata-perl/rdf_linkeddata.psgi

Configuration file
------------------

An example configuration file can be found in the module
Plack::App::RDF::LinkedData. You may use this to start your own
configuration. Once you have found a good place to store it, you need
to set the variable RDF_LINKEDDATA_CONFIG to point at your
configuration,


Integrate with a PSGI frontend
------------------------------

RDF::LinkedData uses PSGI.  Debian packaging currently does not
integrate with any specific PSGI implementation.

In addition to the demo usage outlined in the first section, the most
minimal PSGI setup is to invoke the following after you've created a
configuration as above:

    plackup /usr/share/librdf-linkeddata-perl/rdf_linkeddata.psgi

For production use there are many options either with a dedicated PSGI
server like twiggy or starman, or using bindings to CGI, FCGI or uWSGI.
