Redland Raptor RDF syntax library
C Perl Other
Pull request Compare This branch is 900 commits behind dajobe:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<html xmlns="">
  <title>Raptor RDF Syntax Library</title>
  <link rel="meta" type="application/rdf+xml" title="DOAP" href="raptor.rdf" />

<h1 style="text-align:center">Raptor RDF Syntax Library</h1>
<h2 style="text-align:center"><a href="">Dave Beckett</a></h2>


<p><a href="">Raptor</a>
is a free software / Open Source C library that provides
a set of parsers and serializers that
generate Resource Description Framework (RDF) triples
by parsing syntaxes or serialize the triples into a syntax.
The supported parsing syntaxes are RDF/XML, N-Quads, N-Triples, TRiG, Turtle,
RSS tag soup including all versions of RSS, Atom 1.0 and 0.3, GRDDL
and microformats for HTML, XHTML and XML and RDFa.  The
serializing syntaxes are RDF/XML (regular, and abbreviated),
Atom 1.0, GraphViz, JSON, N-Quads, N-Triples, RSS 1.0 and XMP.

<p>Raptor was designed to work closely with the
<a href="">Redland RDF library</a>
(<b>R</b>DF <b>P</b>arser <b>T</b>oolkit f<b>o</b>r <b>R</b>edland)
but is entirely separate.  It is a portable library that works
across many POSIX systems (Unix, GNU/Linux, BSDs, OSX, cygwin, win32).

<p>A summary of the changes can be found in the
<a href="NEWS.html">NEWS</a> file,
detailed API changes in the <a href="RELEASE.html">release notes</a>
and file-by-file changes in the <a href="ChangeLog">ChangeLog</a>.

<p>Details of upgrading from Raptor 1 as described in the
<a href="UPGRADING.html">Upgrading document</a>.

<li>Designed to integrate well with <a href="">Redland</a></li>
<li>Parses content on the web if <a href="">libcurl</a>, <a href="">libxml2</a> or BSD libfetch is available.</li>
<li>Supports all RDF terms including datatyped and XML literals</li>
<li>Optional features including parsers and serialisers can be selected at configure time.</li>
<li>Language bindings to Perl, PHP, Python and Ruby when used via Redland</li>
<li>No memory leaks</li>
<li>Standalone <a href="rapper.html">rapper</a> RDF parser utility program</li>

<p>Known bugs and issues are recorded in the
<a href="">Redland issue tracker</a>.


<h3>RDF/XML Parser</h3>

<p>A Parser for the standard
<a href="">RDF/XML syntax</a>.
<li>Fully handles the <a href="">RDF/XML syntax updates</a> for <a href="">XML Base</a>, <code>xml:lang</code>, RDF datatyping and Collections.</li>
<li>Handles all RDF vocabularies such as <a href="">FOAF</a>, <a href="">RSS 1.0</a>, <a href="">Dublin Core</a>, <a href="">OWL</a>, <a href="">DOAP</a></li>
<li>Handles <code>rdf:resource</code> / <code>resource</code> attributes</li>
<li>Uses <a href="">libxml</a> XML parser</li>

<h3>N-Quads Parser</h3>

<p>A parser for the
<a href="">N-Quads</a>
extension to N-Triples, providing an optional 4th context graph term
at the end of the line when a triple is associated with a  named graph.

<h3>N-Triples Parser</h3>

<p>A parser for the
<a href="">N-Triples</a>
syntax as defined by the 
<a href="">W3C RDF Core working group</a>
for the <a href="">RDF Test Cases</a>.

<h3>Turtle Parser</h3>

<p>A parser for the
<a href="">Turtle Terse RDF Triple Language</a>
syntax, designed as a useful subset of
<a href="">Notation 3</a>.

<h3>TRiG Parser</h3>

<p>A parser for the
<a href="">TriG - Turtle with Named Graphs</a>

<p>The parser is alpha quality and may not support the entire TRiG

<h3>RSS "tag soup" parser</h3>

<p>A parser for the multiple XML RSS formats that use the elements
such as channel, item, title, description in different ways.
Attempts to turn the input into
<a href="">RSS 1.0</a>
RDF triples.  True <a href="">RSS 1.0</a>,
as a full RDF vocabulary, is best parsed by the RDF/XML parser.
It also generates triples for RSS enclosures.

<p>This parser also provides support for the Atom 1.0 syndication
format defined in IETF
<a href="">RFC 4287</a>

<h3>GRDDL and microformats parser</h3>

<p>A parser/processor for
<a href="">Gleaning Resource Descriptions from Dialects of Languages (GRDDL)</a>
syntax, W3C Recommendation of 2007-09-11 which allows reading XHTML
and XML as RDF triples by using profiles in the document that declare
XSLT transforms from the XHTML or XML content into RDF/XML or other
RDF syntax which can then be parsed.  It uses either an XML or
a lax HTML parser to allow HTML tag soup to be read.

<p>The parser passes the all the GRDDL tests as of Raptor 1.4.16.

<p>The parser also handles hCard and hReview using public XSL sheets.

<h3>RDFa parser</h3>

<p>A parser for
<a href="">RDFa</a>
(W3C Candidate Recommendation 20 June 2008) implemented via
<a href="">librdfa</a>
linked inside Raptor, written by Manu Sporny of Digital Bazaar,
licensed with the same license as Raptor.

<p>As of Raptor 1.4.18 the RDFa parser passes all of the RDFa
<a href="">test suite</a>
except for 4 tests.


<h3>RDF/XML Serializer</h3>

<p>A serializer to the standard
<a href="">RDF/XML syntax</a>
as revised by the
<a href="">W3C RDF Core working group</a>
in 2004.   This writes a plain triple-based RDF/XML serialization with
no optimisation or pretty-printing.

<p>A second serializer is provided using several of the RDF/XML
abbreviations to provide a more compact readable format, at the cost
of some pre-processing.  This is suitable for small documents.

<h3>N-Quads Serializer</h3>

<p>A serializer to the
<a href="">N-Quads</a>
extension to N-Triples, providing an optional 4th context graph term
at the end of the line when a triple is associated with a  named graph.

<h3>N-Triples Serializer</h3>

<p>A serializer to the
<a href="">N-Triples</a>
syntax as used by the 
<a href="">W3C RDF Core working group</a>
for the <a href="">RDF Test Cases</a>.

<h3>Atom 1.0 Serializer</h3>

<p>A serializer to the Atom 1.0 syndication format defined in IETF
<a href="">RFC 4287</a>.

<h3>JSON Serializers</h3>

<p>Two serializers for to write triples encoded in JSON, one
(<code>json</code>) in a resource-centric abbreviated form <a
like Turtle or RDF/XML-Abbreviated; the other a triple-centric format
(<code>json-triples</code>) based on the SPARQL results in JSON format.

<h3>GraphViz DOT Serializer</h3>

<p>An serializer to the GraphViz
<a href="">DOT format</a>
which aids visualising RDF graphs.

<h3>RSS 1.0 Serializer</h3>

<p>A serializer to the
<a href="">RDF Site Summary (RSS) 1.0</a>

<h3>Turtle Serializer</h3>

<p>A serializer for the
<a href="">Turtle Terse RDF Triple Language</a>

<h3>XMP Serializer</h3>

<p>An alpha quality serializer to the Adobe XMP profile of RDF/XML
suitable for embedding inside an external document.


<p>The public API is described in the
<a href="libraptor.html">libraptor.3</a> UNIX manual page.
It is demonstrated in the
<a href="rapper.html">rapper</a>
utility program which shows how to call the parser and write
the triples in a serialization.  When Raptor is used inside
<a href="">Redland</a>,
the Redland documentation explains
how to call the parser and contains several example programs.
There are also further examples in the <tt>example</tt> directory
of the distribution.

<p>To install Raptor see the <a href="INSTALL.html">Installation document</a>.


<p>The packaged sources are available from
<a href=""></a> (master site) and also from the
<a href="">SourceForge site</a>.
The development GIT sources can also be
<a href="">browsed at GitHub</a>
or checked out at git://



<p>This library is free software / open source software released
under the LGPL (GPL) or Apache 2.0 licenses.  See 
<a href="LICENSE.html">LICENSE.html</a> for full details.

<h2>Mailing Lists</h2>

<p>The <a href="">Redland mailing lists</a>
discusses the development and use of Raptor and Redland as well as
future plans and announcement of releases.

<hr />

<p>Copyright (C) 2000-2012 <a href="">Dave Beckett</a><br />Copyright (C) 2000-2005 <a href="">University of Bristol</a></p>