You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@marmotta.apache.org by wi...@apache.org on 2013/02/22 10:25:55 UTC
svn commit: r1448958 - in /incubator/marmotta/site/trunk/content:
markdown/client-library.md markdown/download.md markdown/ldcache.md
markdown/ldclient.md markdown/ldpath.md markdown/sesame.md site.xml
Author: wikier
Date: Fri Feb 22 09:25:55 2013
New Revision: 1448958
URL: http://svn.apache.org/r1448958
Log:
added new section for libraries (MARMOTTA-114)
Added:
incubator/marmotta/site/trunk/content/markdown/client-library.md
incubator/marmotta/site/trunk/content/markdown/ldcache.md
incubator/marmotta/site/trunk/content/markdown/ldclient.md
incubator/marmotta/site/trunk/content/markdown/ldpath.md
incubator/marmotta/site/trunk/content/markdown/sesame.md
Modified:
incubator/marmotta/site/trunk/content/markdown/download.md
incubator/marmotta/site/trunk/content/site.xml
Added: incubator/marmotta/site/trunk/content/markdown/client-library.md
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/markdown/client-library.md?rev=1448958&view=auto
==============================================================================
--- incubator/marmotta/site/trunk/content/markdown/client-library.md (added)
+++ incubator/marmotta/site/trunk/content/markdown/client-library.md Fri Feb 22 09:25:55 2013
@@ -0,0 +1,23 @@
+# Marmotta Client Library
+
+A convenient option to use the Marmotta for Linked Data development is to build
+applications based on the Marmotta Client Library. The Marmotta Client Library
+provides an API abstraction around the Marmotta web services, available for
+different programming languages.
+
+## Java
+
+@@TODOO
+
+## PHP
+
+@@TODOO
+
+## Javascript
+
+@@TODOO
+
+## Shell
+
+@@TODOO
+
Modified: incubator/marmotta/site/trunk/content/markdown/download.md
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/markdown/download.md?rev=1448958&r1=1448957&r2=1448958&view=diff
==============================================================================
--- incubator/marmotta/site/trunk/content/markdown/download.md (original)
+++ incubator/marmotta/site/trunk/content/markdown/download.md Fri Feb 22 09:25:55 2013
@@ -1,3 +1,3 @@
-# Getting Apache Marmotta
+# Download Marmotta
@@TODOO
Added: incubator/marmotta/site/trunk/content/markdown/ldcache.md
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/markdown/ldcache.md?rev=1448958&view=auto
==============================================================================
--- incubator/marmotta/site/trunk/content/markdown/ldcache.md (added)
+++ incubator/marmotta/site/trunk/content/markdown/ldcache.md Fri Feb 22 09:25:55 2013
@@ -0,0 +1,3 @@
+# LDCache
+
+@@TODOO
Added: incubator/marmotta/site/trunk/content/markdown/ldclient.md
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/markdown/ldclient.md?rev=1448958&view=auto
==============================================================================
--- incubator/marmotta/site/trunk/content/markdown/ldclient.md (added)
+++ incubator/marmotta/site/trunk/content/markdown/ldclient.md Fri Feb 22 09:25:55 2013
@@ -0,0 +1,3 @@
+# LDClient
+
+@@TODOO
Added: incubator/marmotta/site/trunk/content/markdown/ldpath.md
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/markdown/ldpath.md?rev=1448958&view=auto
==============================================================================
--- incubator/marmotta/site/trunk/content/markdown/ldpath.md (added)
+++ incubator/marmotta/site/trunk/content/markdown/ldpath.md Fri Feb 22 09:25:55 2013
@@ -0,0 +1,77 @@
+# LDPath
+
+LDPath is a simple path-based query language, similar to XPath or SPARQL Property
+Paths, that is particularly well-suited for querying and retrieving resources
+from the Linked Data Cloud by following RDF links between resources and servers.
+
+For example, the following path query would select the names of all friends of the context resource:
+
+ foaf:knows / foaf:name :: xsd:string
+
+## Introduction
+
+LDPath library is a collection of generic libraries that are independent of the
+underlying RDF implementation. Currently, there are backends for sesame, for RDF
+files, and for Linked Data. You can easily implement your own backends by implementing
+a straightforward interface (RDFBackend).
+
+LDPath can serve many different purposes. It can e.g. serve as
+
+* a simple query language for selecting nodes or values in your own triple store programmatically from Java
+* a query language for transparently querying resources in the Linked Data Cloud and following links between datasets
+* a foundation for templating languages to render results based on RDF or Linked Data
+* a foundation for building a semantic search index (used e.g. in the Linked Media Framework and in Apache Stanbol)
+* a query language for experimenting with the Linked Data Cloud
+
+## Modules
+
+The LDPath project consists of a collection of modules that can be combined as needed. We have grouped the modules in core modules, backends, and extensions. Modules are available in our Maven repository, see MavenArtifacts.
+
+@@TODO@@: this needs to be updated
+
+### Core Modules
+
+The following modules are the core modules of LDPath and are needed in every situation:
+
+* ldpath-api: contains interfaces used by the language; needed for custom extensions
+* ldpath-core: contains the core, backend-independent implementation of the LDPath language, including parser and evaluator; expects some backend implementation to be present.
+
+### Backend Modules
+
+We provide a number of backends that are ready-to-use in your own projects. Implementing
+a backend is usually straightforward and involves mainly implementing the RDFBackend
+interface. RDFBackend makes use of Java Generics , so you are able to always use the
+data model of your backend directly. The following backends are provided by the
+distribution:
+
+* ldpath-backend-sesame: a generic backend implementation for Sesame repositories. A Sesame repository can be passed over on initialisation
+* ldpath-backend-jena: a generic backend implementation for Jena models. A Jena model can be passed over on initialisation
+* ldpath-backend-file: a file-based backend implementation allowing you to query the contents of an RDF file
+* ldpath-backend-linkeddata: a sophisticated backend implementation that queries and caches resources on the Linked Data Cloud
+
+### Extension Modules
+
+Based on LDPath, we have implemented a number of extension modules. Some are part
+of other projects like the Linked Media Framework or Apache Stanbol. Part of the
+LDPath project itself are currently the following modules:
+
+* ldpath-template: implements an extension of the FreeMarker template engine that allows constructing templates with LDPath statements for inserting and iterating over values (example template); this module is backend-independent
+* ldpath-template-linkeddata: a backend implementation for ldpath-template that allows querying over the Linked Data Cloud; provides only a command-line tool for processing templates
+
+## Specification
+
+The [LDPath language specification](http://wiki.apache.org/marmotta/LDPath)
+is available on the wiki.
+
+## Usage
+
+The library is provided as Maven artifact, you you would need to declare a
+dependency like:
+
+ <dependency>
+ <groupId>org.apache.marmotta</groupId>
+ <artifactId>marmotta-ldpath</artifactId>
+ <version>3.0.0-incubating-SNAPSHOT</version>
+ </dependency>
+
+
Added: incubator/marmotta/site/trunk/content/markdown/sesame.md
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/markdown/sesame.md?rev=1448958&view=auto
==============================================================================
--- incubator/marmotta/site/trunk/content/markdown/sesame.md (added)
+++ incubator/marmotta/site/trunk/content/markdown/sesame.md Fri Feb 22 09:25:55 2013
@@ -0,0 +1,6 @@
+# Sesame Tools
+
+Marmotta is build on top of [Sesame OpenRDF](http://www.openrdf.org). Therefore
+we have build a set of tools for a more convenience usage within Marmotta.
+
+@@TODOO
Modified: incubator/marmotta/site/trunk/content/site.xml
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/content/site.xml?rev=1448958&r1=1448957&r2=1448958&view=diff
==============================================================================
--- incubator/marmotta/site/trunk/content/site.xml (original)
+++ incubator/marmotta/site/trunk/content/site.xml Fri Feb 22 09:25:55 2013
@@ -65,7 +65,14 @@
<item name="Privacy" href="privacy.html" />
</menu>
<!--<menu ref="parent" inherit="bottom" />-->
- <menu name="Documentation" ref="reports" inherit="top" />
+ <menu name="Project" ref="reports" inherit="top" />
+ <menu name="Libraries">
+ <item name="Client Library" href="client-library.html" />
+ <item name="LDCache" href="ldcache.html" />
+ <item name="LDClient" href="ldclient.html" />
+ <item name="LDPath" href="ldpath.html" />
+ <item name="Sesame Tools" href="sesame.html" />
+ </menu>
<menu name="The ASF">
<item name="The Apache Software Foundation" href="http://www.apache.org" />
<item name="Apache Incubator" href="http://incubator.apache.org" />