You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by ij...@apache.org on 2012/01/11 17:50:45 UTC
svn commit: r1230140 -
/incubator/jena/site/trunk/content/jena/documentation/serving_data/index.mdtext
Author: ijd
Date: Wed Jan 11 16:50:44 2012
New Revision: 1230140
URL: http://svn.apache.org/viewvc?rev=1230140&view=rev
Log:
Applied suggested Fuseki documentation edits from Rich Morin
Modified:
incubator/jena/site/trunk/content/jena/documentation/serving_data/index.mdtext
Modified: incubator/jena/site/trunk/content/jena/documentation/serving_data/index.mdtext
URL: http://svn.apache.org/viewvc/incubator/jena/site/trunk/content/jena/documentation/serving_data/index.mdtext?rev=1230140&r1=1230139&r2=1230140&view=diff
==============================================================================
--- incubator/jena/site/trunk/content/jena/documentation/serving_data/index.mdtext (original)
+++ incubator/jena/site/trunk/content/jena/documentation/serving_data/index.mdtext Wed Jan 11 16:50:44 2012
@@ -1,8 +1,7 @@
Title: Fuseki: serving RDF data over HTTP
-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.
+Fuseki is a SPARQL server. It provides REST-style SPARQL HTTP Update, SPARQL Query,
+and SPARQL Update using the SPARQL protocol over HTTP.
The relevant SPARQL standards are:
@@ -11,8 +10,8 @@ The relevant SPARQL standards are:
- [SPARQL 1.1 Protocol](http://www.w3.org/TR/sparql11-protocol/ "http://www.w3.org/TR/sparql11-protocol/")
- [SPARQL 1.1 Graph Store HTTP Protocol](http://www.w3.org/TR/sparql11-http-rdf-update/ "http://www.w3.org/TR/sparql11-http-rdf-update/")
-These are work-in-progress by the SPARQL working group and while
-the general designs are stable, details may change. Fuseki will
+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.
See also:
@@ -34,24 +33,24 @@ See also:
## Download
-**Note** builds will be migrating to the Apache infrastructure very soon. See the
-[downloads page](/jena/downloads) for details.
-
-Builds are available from the
-[Jena Maven repository](http://openjena.org/repo/org/openjena/fuseki/)
-and also the
-[development repository](http://openjena.org/repo-dev/org/openjena/fuseki/).
+Jena builds are in the process of migrating to Apache.
+See the [downloads page](/jena/downloads) for details.
+Fuseki builds will be migrating to the Apache infrastructure very soon.
+Snapshot builds are
+available via Apache Maven or can be [downloaded from here](https://repository.apache.org/content/repositories/snapshots/org/apache/jena/jena-fuseki/).
Choose the version directory then look for the file
-fuseki-*VER*.zip. *VER* for a snapshot includes the timestamp and
-increment number as generated by maven.
+fuseki-*VER*.zip. For snapshots, `VER` 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.
-Fuseki download files
+**Fuseki download files**
Filename | Description
-fuseki-*VER*.zip | Fuseki download, includes everything.
-fuseki-*VER*-server.jar |Fuseki server, as an executable jar.
-fuseki-*VER*-SOH.zip | [SOH (SPARQL Over HTTP)](soh.html "SOH") scripts
+--------- | -----------
+`fuseki-*VER*.distribution.zip` | Fuseki download, includes everything.
+`fuseki-*VER*-server.jar` |Fuseki server, as an executable jar.
+`fuseki-*VER*-SOH.zip` | [SOH (SPARQL Over HTTP)](soh.html "SOH") scripts
Fuseki requires Java6.
@@ -82,7 +81,7 @@ The server logging goes to the console:
The Fuseki download includes a number of services:
-- SPARQL Query, SPARQL Update and file upload to a selected
+- SPARQL Query, SPARQL Update, and file upload to a selected
dataset.
- Link to the documentation (here).
- Validators for SPARQL query and update and for non-RDF/XML
@@ -93,7 +92,7 @@ For the control panel:
1. In a browser, go to
[http://localhost:3030/](http://localhost:3030/ "http://localhost:3030/")
2. Click on "Control Panel
-3. Select the dataset (if set up above there is only one choice).
+3. Select the dataset (if set up above, there is only one choice).
The page offers SPARQL operations and file upload acting on the
selected dataset.
@@ -200,31 +199,34 @@ argument is used.
The full choice of dataset forms is:
-Fuseki Dataset Descriptions
---mem
+**Fuseki Dataset Descriptions**
+
+--`mem`
Create an empty, in-memory (non-persistent) dataset.
---file=FILE
+--`file=FILE`
Create an empty, in-memory (non-persistent) dataset, then load FILE
into it.
---loc=DIR
+--`loc=DIR`
Use an existing TDB database. Create an empty one if it does not
exist.
---desc=assemblerFile
+--`desc=assemblerFile`
Construct a dataset based on the general assembler description.
---config=ConfigFile
+--`config=ConfigFile`
Construct one or more service endpoints based on the
[configuration description](#Fuseki_Configuration_File).
+
A copy of TDB is included in the standalone server. An example
assembler file for TDB is in tdb.ttl.
-Fuseki Server Arguments
---help
+**Fuseki Server Arguments**
+
+--`help`
Print help message.
---port=*number*
+--`port=*number*`
Run on port *number* - default is 3030.
---host=*name*
+--`host=*name*`
Listen only to a specific network interface.
---update
+--`update`
Allow update. Otherwise only read requests are served (ignored if a
configuration file is given).
@@ -243,21 +245,21 @@ PUR/POST/DELETE enabled).
fuseki-server --update --mem /dataset
runs the server on port 3030 with an in-memory dataset. It can be
-accessed via the appropriate protocol at URLs:
+accessed via the appropriate protocol at the following URLs:
-- SPARQL query: http://localhost:3030/dataset/query
-- SPARQL update: http://localhost:3030/dataset/update
-- SPARQL HTTP update: http://localhost:3030/dataset/data
+- SPARQL query: `http://localhost:3030/dataset/query`
+- SPARQL update: `http://localhost:3030/dataset/update`
+- SPARQL HTTP update: `http://localhost:3030/dataset/data`
The [SPARQL Over HTTP](soh.html "SOH") scripts take care of naming
-and protocol details. For example, to load in a file data.rdf:
+and protocol details. For example, to load in a file `data.rdf`:
s-put http://localhost:3030/dataset/data default data.rdf
## Fuseki Server and TDB
Fuseki include a built-in version of TDB. Run the server with the
---desc argument
+`--desc` argument
fuseki-server --desc tdb.ttl /dataset
@@ -351,7 +353,7 @@ Some useful prefix declarations:
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.
+with its datasets.
[] rdf:type fuseki:Server ;
# Server-wide context parameters can be given here.