summaryrefslogtreecommitdiff
path: root/README.html
blob: 0664b301b9764183c03f48302b255f9c02766832 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/2000/REC-xhtml1-20000126/DTD/xhtml1-transitional.dtd">
<html>
<head>
  <title>Raptor RDF Parser Toolkit</title>
</head>
<body bgcolor="#ffffff" text="#000085">

<h1 align="center">Raptor RDF Parser Toolkit</h1>
<h2 align="center"><a href="http://purl.org/net/dajobe/">Dave Beckett</a><br /><a href="http://www.ilrt.bristol.ac.uk/">Institute for Learning and Research Technology</a><br /><a href="http://www.bristol.ac.uk/">University of Bristol</a></h2>
  

<h2>OVERVIEW</h2>

<p><a href="http://www.redland.opensource.ac.uk/raptor/">Raptor</a>
is the
<b>R</b>DF <b>P</b>arser <b>T</b>oolkit f<b>o</b>r
<a href="http://www.redland.opensource.ac.uk/"><b>R</b>edland</a>
written in C consisting of two parsers for the RDF/XML and N-Triples
syntaxes for RDF. Raptor is designed to work efficiently when used
with Redland but is entirely separate.
</p>

<p>This library is mature and <b>Beta</b> quality - there are some
known conformance issues and the APIs are unlikely to change.  See
the <a href="TODO.html">to do list</a> for more information.  Changes
can be found in the <a href="NEWS.html">NEWS</a> file or more
detailed changes in the <a href="ChangeLog">ChangeLog</a>.</p>

<h2>PARSERS</h2>

<h3>RDF/XML Parser</h3>

<p>A Parser for the <a href="http://www.w3.org/TR/rdf-syntax-grammar/">RDF/XML syntax</a> as updated by the <a href="http://www.w3.org/2001/sw/RDFCore/">W3C RDF Core working group</a>.</p>

<ul>
<li>Designed to integrate well with <a href="http://www.redland.opensource.ac.uk/">Redland</a></li>
<li>Handles <a href="http://www.w3.org/TR/rdf-syntax-grammar/">RDF/XML syntax updates</a> for <a href="http://www.w3.org/TR/xmlbase/">XML Base</a>, <code>xml:lang</code> and RDF datatyping.</li>
<li>Generates <a href="http://www.w3.org/TR/rdf-testcases/#ntriples">N-Triples</a> supporting XML literals, language tagging and datatypes</li>
<li>Handles <code>rdf:resource</code> / <code>resource</code> attributes</li>
<li>Uses <a href="http://expat.sourceforge.net/">expat</a> and/or (GNOME) <a href="http://xmlsoft.org/">libxml</a> XML parsers as available or required</li>
<li>Optional features can be selected at run time.</li>
<li>(Perl, Python, Java, Tcl, Ruby, PHP interfaces when used via Redland)</li>
<li>No memory leaks</li>
<li>Fast</li>
</ul>

<p>The remaining issues are recorded in the
<a href="TODO.html">to do list</a>.</p>


<h3>NTRIPLES PARSER</h3>

<p>A parser for the
<a href="http://www.w3.org/TR/rdf-testcases/#ntriples">N-Triples</a>
syntax as used by the 
<a href="http://www.w3.org/2001/sw/RDFCore/">W3C RDF Core working group</a>
for the <a href="http://www.w3.org/TR/rdf-testcases/">RDF Test Cases</a>.
</p>


<h2>DOCUMENTATION</h2>

<p>The API is described in the <em>libraptor.3</em> UNIX manual page.
It is demonstrated in the <em>rapper.1</em> utility program which
shows how to call the parser and get back the triples.  When Raptor
is used inside
<a href="http://www.redland.opensource.ac.uk/">Redland</a>,
the Redland documentation explains
how to call the parser and contains several example programs.</p>

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


<h2>SOURCES</h2>

<p>The packaged sources are available from
<a href="http://www.redland.opensource.ac.uk/dist/source/">http://www.redland.opensource.ac.uk/dist/source/</a> (master site) and also from the
<a href="http://sourceforge.net/projects/librdf/">SourceForge site</a>.
There are 
<a href="http://www.redland.opensource.ac.uk/dist/snapshots/source/">nightly snapshots</a> of the development version which is can also be browsed via
<a href="http://cvs.ilrt.org/cvsweb/redland/raptor/">CVSweb</a>.
</p>


<h2>LICENSE</h2>

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


<h2>MAILING LISTS</h2>

<p>The
<a href="http://www.redland.opensource.ac.uk/lists/">Redland mailing lists</a>
discusses the development and use of Raptor and Redland as well as
future plans and announcement of releases.</p>

<hr />

<p>Copyright 2001-2003 <a href="http://purl.org/net/dajobe/">Dave Beckett</a>, <a href="http://www.ilrt.bristol.ac.uk/">Institute for Learning and Research Technology</a>, <a href="http://www.bristol.ac.uk/">University of Bristol</a></p>

</body>
</html>