[librdf-linkeddata-perl] 03/04: Improve README.Debian. Closes: bug#755954. Thanks to Kjetil Kjernsmo.

[Jonas Smedegaard]

This is an automated email from the git hooks/post-receive script.

js pushed a commit to branch master
in repository librdf-linkeddata-perl.

commit f4b25bf4e36db0d7bcb7c15dd5cf4e5ff34b9394
Author: Jonas Smedegaard <dr at jones.dk>
Date:   Tue Aug 5 12:22:15 2014 +0200

    Improve README.Debian. Closes: bug#755954. Thanks to Kjetil Kjernsmo.
---
 debian/README.Debian | 39 +++++++++++++++++++++++++++++++++++----
 1 file changed, 35 insertions(+), 4 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
index 07b5ad8..5be898e 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,6 +1,38 @@
 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
 ------------------------------
@@ -8,12 +40,11 @@ Integrate with a PSGI frontend
 RDF::LinkedData uses PSGI.  Debian packaging currently does not
 integrate with any specific PSGI implementation.
 
-The most minimal PSGI setup is to invoke the following:
+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
 
-after setting the environment variable RDF_LINKEDDATA_CONFIG to point at
-your configuration, see Plack::App::RDF::LinkedData for example.
-
 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.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/librdf-linkeddata-perl.git