jena-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From i..@apache.org
Subject svn commit: r802389 - in /websites/production/jena: ./ content/jena/documentation/serving_data/index.html
Date Wed, 11 Jan 2012 17:02:23 GMT
Author: ijd
Date: Wed Jan 11 17:02:23 2012
New Revision: 802389

Log:
Push user-contributed tweaks to documentation

Modified:
    websites/production/jena/   (props changed)
    websites/production/jena/content/jena/documentation/serving_data/index.html

Propchange: websites/production/jena/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Wed Jan 11 17:02:23 2012
@@ -1 +1 @@
-/websites/staging/jena/trunk:782833-801713
+/websites/staging/jena/trunk:782833-802388

Modified: websites/production/jena/content/jena/documentation/serving_data/index.html
==============================================================================
--- websites/production/jena/content/jena/documentation/serving_data/index.html (original)
+++ websites/production/jena/content/jena/documentation/serving_data/index.html Wed Jan 11
17:02:23 2012
@@ -155,9 +155,8 @@
 
   <div id="content">
     <h1 class="title">Fuseki: serving RDF data over HTTP</h1>
-    <p>Fuseki is a SPARQL server. It provides the REST-style SPARQL HTTP
-Update, and SPARQL Query and SPARQL Update using the SPARQL
-protocol over HTTP.</p>
+    <p>Fuseki is a SPARQL server. It provides REST-style SPARQL HTTP Update, SPARQL
Query,
+and SPARQL Update using the SPARQL protocol over HTTP.</p>
 <p>The relevant SPARQL standards are:</p>
 <ul>
 <li><a href="http://www.w3.org/TR/sparql11-query/" title="http://www.w3.org/TR/sparql11-query/">SPARQL
1.1 Query</a></li>
@@ -165,8 +164,8 @@ protocol over HTTP.</p>
 <li><a href="http://www.w3.org/TR/sparql11-protocol/" title="http://www.w3.org/TR/sparql11-protocol/">SPARQL
1.1 Protocol</a></li>
 <li><a href="http://www.w3.org/TR/sparql11-http-rdf-update/" title="http://www.w3.org/TR/sparql11-http-rdf-update/">SPARQL
1.1 Graph Store HTTP Protocol</a></li>
 </ul>
-<p>These are work-in-progress by the SPARQL working group and while
-the general designs are stable, details may change. Fuseki will
+<p>These are work-in-progress by the SPARQL working group;
+although the general designs are stable, details may change. Fuseki will
 track the draft standards.</p>
 <p>See also:</p>
 <ul>
@@ -186,20 +185,38 @@ track the draft standards.</p>
 <li><a href="#development_system">Development System</a></li>
 </ul>
 <h2 id="download">Download</h2>
-<p><strong>Note</strong> builds will be migrating to the Apache infrastructure
very soon. See the
-<a href="/jena/downloads">downloads page</a> for details.</p>
-<p>Builds are available from the
-<a href="http://openjena.org/repo/org/openjena/fuseki/">Jena Maven repository</a>
-and also the
-<a href="http://openjena.org/repo-dev/org/openjena/fuseki/">development repository</a>.</p>
+<p>Jena builds are in the process of migrating to Apache.
+See the <a href="/jena/downloads">downloads page</a> for details.
+Fuseki builds will be migrating to the Apache infrastructure very soon.
+Snapshot builds are
+available via Apache Maven or can be <a href="https://repository.apache.org/content/repositories/snapshots/org/apache/jena/jena-fuseki/">downloaded
from here</a>.</p>
 <p>Choose the version directory then look for the file
-fuseki-<em>VER</em>.zip. <em>VER</em> for a snapshot includes the
timestamp and
-increment number as generated by maven.</p>
-<p>Fuseki download files</p>
-<p>Filename | Description
-fuseki-<em>VER</em>.zip | Fuseki download, includes everything.
-fuseki-<em>VER</em>-server.jar  |Fuseki server, as an executable jar.
-fuseki-<em>VER</em>-SOH.zip | <a href="soh.html" title="SOH">SOH (SPARQL
Over HTTP)</a> scripts</p>
+fuseki-<em>VER</em>.zip. For snapshots, <code>VER</code> includes
the timestamp and increment
+number as generated by Maven. The most recent build at the time of writing
+(January 2012) is Fuseki 0.21-SNAPSHOT.</p>
+<p><strong>Fuseki download files</strong></p>
+<table>
+<thead>
+<tr>
+<th>Filename</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>fuseki-*VER*.distribution.zip</code></td>
+<td>Fuseki download, includes everything.</td>
+</tr>
+<tr>
+<td><code>fuseki-*VER*-server.jar</code></td>
+<td>Fuseki server, as an executable jar.</td>
+</tr>
+<tr>
+<td><code>fuseki-*VER*-SOH.zip</code></td>
+<td><a href="soh.html" title="SOH">SOH (SPARQL Over HTTP)</a> scripts</td>
+</tr>
+</tbody>
+</table>
 <p>Fuseki requires Java6.</p>
 <h2 id="getting_started">Getting Started</h2>
 <p>This section provides a brief guide to getting up and running with
@@ -228,7 +245,7 @@ download.</p>
 <h2 id="user_interface">User Interface</h2>
 <p>The Fuseki download includes a number of services:</p>
 <ul>
-<li>SPARQL Query, SPARQL Update and file upload to a selected
+<li>SPARQL Query, SPARQL Update, and file upload to a selected
     dataset.</li>
 <li>Link to the documentation (here).</li>
 <li>Validators for SPARQL query and update and for non-RDF/XML
@@ -239,7 +256,7 @@ download.</p>
 <li>In a browser, go to
     <a href="http://localhost:3030/" title="http://localhost:3030/">http://localhost:3030/</a></li>
 <li>Click on "Control Panel</li>
-<li>Select the dataset (if set up above there is only one choice).</li>
+<li>Select the dataset (if set up above, there is only one choice).</li>
 </ol>
 <p>The page offers SPARQL operations and file upload acting on the
 selected dataset.</p>
@@ -336,32 +353,27 @@ accessible over HTTP.</p>
 <p>The server will service read requests only unless the --update
 argument is used.</p>
 <p>The full choice of dataset forms is:</p>
-<p>Fuseki Dataset Descriptions
---mem
-Create an empty, in-memory (non-persistent) dataset.
---file=FILE
-Create an empty, in-memory (non-persistent) dataset, then load FILE
-into it.
---loc=DIR
-Use an existing TDB database. Create an empty one if it does not
-exist.
---desc=assemblerFile
-Construct a dataset based on the general assembler description.
---config=ConfigFile
-Construct one or more service endpoints based on the
-<a href="#Fuseki_Configuration_File">configuration description</a>.
-A copy of TDB is included in the standalone server. An example
+<p><strong>Fuseki Dataset Descriptions</strong></p>
+<ul>
+<li><code>--mem</code> <br /> Create an empty, in-memory (non-persistent)
dataset.</li>
+<li><code>--file=FILE</code> <br />
+    Create an empty, in-memory (non-persistent) dataset, then load FILE
+    into it.</li>
+<li><code>--loc=DIR</code> <br />Use an existing TDB database. Create
an empty one if it does not
+    exist.</li>
+<li><code>--desc=assemblerFile</code> <br /> Construct a dataset
based on the general assembler description.</li>
+<li><code>--config=ConfigFile</code> <br /> Construct one or more
service endpoints based on the
+    <a href="#Fuseki_Configuration_File">configuration description</a>.</li>
+</ul>
+<p>A copy of TDB is included in the standalone server. An example
 assembler file for TDB is in tdb.ttl.</p>
-<p>Fuseki Server Arguments
---help
-Print help message.
---port=<em>number</em>
-Run on port <em>number</em> - default is 3030.
---host=<em>name</em>
-Listen only to a specific network interface.
---update
-Allow update. Otherwise only read requests are served (ignored if a
-configuration file is given).</p>
+<p><strong>Fuseki Server Arguments</strong></p>
+<ul>
+<li><code>--help</code> <br /> Print help message.</li>
+<li><code>--port=*number*</code> <br /> Run on port <em>number</em>
- default is 3030.</li>
+<li><code>--host=*name*</code> <br /> Listen only to a specific network
interface.</li>
+<li><code>--update</code> <br /> Allow update. Otherwise only read
requests are served (ignored if a configuration file is given).</li>
+</ul>
 <h2 id="security_and_access_control">Security and Access Control</h2>
 <p>Fuseki does not offer any security and access control itself.
 Authentication and control of the number of concurrent request can
@@ -376,21 +388,21 @@ PUR/POST/DELETE enabled).</p>
 
 
 <p>runs the server on port 3030 with an in-memory dataset. It can be
-accessed via the appropriate protocol at URLs:</p>
+accessed via the appropriate protocol at the following URLs:</p>
 <ul>
-<li>SPARQL query: http://localhost:3030/dataset/query</li>
-<li>SPARQL update: http://localhost:3030/dataset/update</li>
-<li>SPARQL HTTP update: http://localhost:3030/dataset/data</li>
+<li>SPARQL query: <code>http://localhost:3030/dataset/query</code></li>
+<li>SPARQL update: <code>http://localhost:3030/dataset/update</code></li>
+<li>SPARQL HTTP update: <code>http://localhost:3030/dataset/data</code></li>
 </ul>
 <p>The <a href="soh.html" title="SOH">SPARQL Over HTTP</a> scripts take
care of naming
-and protocol details. For example, to load in a file data.rdf:</p>
+and protocol details. For example, to load in a file <code>data.rdf</code>:</p>
 <div class="codehilite"><pre> <span class="n">s</span><span class="o">-</span><span
class="n">put</span> <span class="n">http:</span><span class="sr">//</span><span
class="n">localhost:3030</span><span class="sr">/dataset/</span><span
class="n">data</span> <span class="n">default</span> <span class="n">data</span><span
class="o">.</span><span class="n">rdf</span>
 </pre></div>
 
 
 <h2 id="fuseki_server_and_tdb">Fuseki Server and TDB</h2>
 <p>Fuseki include a built-in version of TDB. Run the server with the
---desc argument</p>
+<code>--desc</code> argument</p>
 <div class="codehilite"><pre><span class="n">fuseki</span><span
class="o">-</span><span class="n">server</span> <span class="o">--</span><span
class="n">desc</span> <span class="n">tdb</span><span class="o">.</span><span
class="n">ttl</span> <span class="o">/</span><span class="n">dataset</span>
 </pre></div>
 
@@ -481,7 +493,7 @@ split to allow for commentary.</p>
 <h3 id="server_section">Server Section</h3>
 <p>Order of the file does not matter to the machine, but it's useful
 to start with the server description, then each of the services
-with it's datasets.</p>
+with its datasets.</p>
 <div class="codehilite"><pre><span class="o">[]</span> <span class="n">rdf:type</span>
<span class="n">fuseki:Server</span><span class="err"> </span><span
class="p">;</span>
    <span class="c1"># Server-wide context parameters can be given here.</span>
    <span class="c1"># For example, to set query timeouts: on a server-wide basis:</span>



Mime
View raw message