====== MOAT Server ======



===== About =====

MOAT Server is a application that serves [[index|tag meanings]] (in HTML, JSON or RDF/XML, using content negociation) for any [[http://moat-project.org/moat/ns#Tag|Tag]] you request.
The server is shipped without any data, which means that users have first to define meanings for their tags (thanks to the [[clients]] they use, that will then update the server information) to efficiently use it, using data available on the Semantic Web, especially from the [[http://linkeddata.org|Linked Data]] initiative.

Example:
  * http://tags.moat-project.org/tag/paris (Tag URI - content-negociated) 
  * http://tags.moat-project.org/tag/paris/html (HTML description of meanings)
  * http://tags.moat-project.org/tag/paris/rdf (RDF/XML description of meanings)
  * http://tags.moat-project.org/tag/paris/json (JSON description of meanings)
  * http://tags.moat-project.org/tag/paris/json/light (same, without the foaf:maker)

In order to upload new meanings to a server, you should send the URL of an RDF file containing a list of meanings for a given tag, eg: http://apassant.net/drupal/drupal-5.5/?q=moat/tag/paris with the following API call:
  * http://tag_server_base/?import=url
 
Some server could require a key to let you upload files, in that case, the API call is
  * http://tag_server_base/?import=url&key=key_value


===== Public servers =====

  * MOAT demo server ([[http://arc.semsol.org|ARC2]]-based)
    * http://tags.moat-project.org/
    * key: tagging

===== Server software =====

==== Requirements ====

The server can be plugged on the top of any RDF store that support the [[http://www.w3.org/TR/rdf-sparql-query/|SPARQL]] query language, and a way to add triples (either via a specific API or using [[http://jena.hpl.hp.com/~afs/SPARQL-Update.html|SPARUL]] LOAD instruction), thanks to a "Connector" class.
In order to be easily deployed, MOAT server is currently shipped with connectors for [[http://arc.semsol.org/|ARC2]] and for the [[http://threestore.sf.net|3Store]] API.

==== Download ====

Latest version of the server can be downloaded [[files/moat-server-2008-01-21.tgz|here]] (2008-01-21)

==== Credits / Licence ====

  * By [[http://apassant.net|Alexandre Passant]]
  * (c) 2008 [[http://rd.edf.fr|Electricité de France]] - Released under "Modified" BSD licence

==== Changelog ====

  * 2008-01-21
    * Optional 'key' parameter to restict import of new meaning files

  * 2008-01-19 
    * Initial release


==== TODO / Bugs ====

 * Chek if the uploaded files are valid:
    * valid RDF (RDF/XML only supported ?)
    * respect ontology definition
    * do not import useless data