diff options
Diffstat (limited to 'utils/rapper.1')
| -rw-r--r-- | utils/rapper.1 | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/utils/rapper.1 b/utils/rapper.1 new file mode 100644 index 0000000..43459df --- /dev/null +++ b/utils/rapper.1 @@ -0,0 +1,192 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" +.\" rapper.1 - Raptor RDF parsing and serializing utility manual page +.\" +.\" Copyright (C) 2002-2010 David Beckett - http://www.dajobe.org/ +.\" Copyright (C) 2002-2005 University of Bristol - http://www.bristol.ac.uk/ +.\" +.TH rapper 1 "2010-04-28" +.\" Please adjust this date whenever revising the manpage. +.SH NAME +rapper \- Raptor RDF parsing and serializing utility +.SH SYNOPSIS +.B rapper +.RB [ OPTIONS ] +.IR "INPUT-URI" +.IR "[INPUT-BASE-URI]" +.SH EXAMPLE +.nf +.B rapper -o ntriples http://planetrdf.com/guide/rss.rdf +.br +.B rapper -i rss-tag-soup -o rss-1.0 pile-of-rss.xml http://example.org/base/ +.br +.B rapper --count http://example.org/index.rdf +.SH DESCRIPTION +The +.B rapper +utility allows parsing of RDF content by the +.B Raptor +RDF parser toolkit emitting the results as RDF triples in +a choice of syntaxes. The \fIINPUT-URI\fR can be a file name, '-' +for standard input or if Raptor is built with a WWW retrieval +library, a general URI. The optional \fIINPUT-BASE-URI\fR is used as the +document parser base URI if present otherwise defaults to the \fIINPUT-URI\fR. +A value of '-' means no base URI. +.SH OPTIONS +rapper uses the usual GNU command line syntax, with long +options starting with two dashes (`-') if supported by the +getopt_long function. Otherwise the short options are only available. +.TP +.B \-h, \-\-help +Show a summary of the options. +.TP +.B \-i, \-\-input FORMAT +Set the input +.I FORMAT +to one of 'rdfxml' (RDF/XML, default), 'ntriples' +(N-Triples, see below), 'turtle' (Turtle, see below) +or 'rss-tag-soup' (RSS Tag Soup). The RSS Tag Soup parser +can turn the many XML RSS formats, Atom 0.3 and Atom 1.0 into RDF +triples. +.IP +The list of +parsers depends on how libraptor(3) was built. The list of +supported parsers is given in the help summary given by \-h. +.TP +.B \-I, \-\-input-uri URI +Set the input/parser base +.I URI +or use value '-' for no base. +The default is the INPUT-URI argument value. +.TP +.B \-o, \-\-output FORMAT +Set the output +.I FORMAT +to 'ntriples' (N-Triples, default), 'rdfxml' (RDF/XML), 'rdfxml-abbrev' +(RDF/XML with abbreviations) or 'rss-1.0' (RSS 1.0, also an RDF/XML syntax). +.IP +The list of +serializers depends on how libraptor(3) was built. The list of +supported serializers is given in the help summary given by \-h. +.TP +.B \-O, \-\-output-uri URI +Set the output/serializer base +.I URI +or use value '-' for no base. +The default is the input base uri, either set by the argument +INPUT-BASE-URI or via options +.B \-I, \-\-input-uri URI +.TP +.B \-c, \-\-count +Only count the triples and produce no other output. +.TP +.B \-e, \-\-ignore-errors +Ignore errors, do not emit the messages and try to continue parsing. +.TP +.B \-f, \-\-feature FEATURE[=VALUE] +Set a parser or serializer feature +.I FEATURE +to a value, or to 1 if +.I VALUE +is omitted, +Use \-f help to get lists of valid parser and serializer features. +.IP +If the form \-f 'xmlns:\fIprefix\fP=\(dq\fIuri\fP\(dq' is used, +the prefix and namespace uri given will be set for serializing. +The syntax matches XML in that either or both of \fIprefix\fP +or \fIuri\fP can be omitted. +.TP +.B \-g, \-\-guess +Guess the parser to use from the source-URI rather than use +the \-i FORMAT. +.TP +.B \-q, \-\-quiet +No extra information messages. +.TP +.B \-r, \-\-replace-newlines +Replace newlines in multi-line literals with spaces. +.TP +.B \-\-show-graphs +Print graph names (URIs) as they are seen in the input. This only +has a meaning for parsers that support graph names such as the TRiG parser. +.TP +.B \-\-show-namespaces +Print namespaces as they are seen in the input. +.TP +.B \-t, \-\-trace +Print URIs retrieved during parsing. Especially useful for +monitoring what the guess and GRDDL parsers are doing. +.TP +.B \-w, \-\-ignore-warnings +Ignore warnings, do not emit the messages. +.TP +.B \-v, \-\-version +Print the raptor version and exit. +.SH "EXAMPLES" +.br +.B rapper -q -i ntriples -o rdfxml -f 'xmlns:rss="http://purl.org/rss/1.0/"' -f 'xmlns:ex="http://example.org/"' tests/test.nt +.br +.B rapper -q -o rdfxml -f 'xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"' tests/rdf-schema.rdf 'http://www.w3.org/2000/01/rdf-schema#' +.SH "CONFORMING TO" +\fIRDF/XML Syntax (Revised)\fR, +W3C Recommendation, +.UR http://www.w3.org/TR/rdf-syntax-grammar/ +http://www.w3.org/TR/rdf-syntax-grammar/ +.UE + +\fIN-Triples\fR, in \fIRDF Test Cases\fR, Jan Grant and Dave Beckett (eds.), +W3C Recommendation, +.UR http://www.w3.org/TR/rdf-testcases/#ntriples +http://www.w3.org/TR/rdf-testcases/#ntriples +.UE + +\fITurtle Terse RDF Triple Language\fR, Dave Beckett, +.UR http://www.dajobe.org/2004/01/turtle/ +http://www.dajobe.org/2004/01/turtle/ +.UE + +\fIRDFA in XHTML: Syntax and Processing\fR, Ben Adida, Mark Birbeck, +Shane McCarron and Steven Pemberton (eds.), +W3C Candidate Recommendation, 20 June 2008 +.UR http://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/ +http://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/ +.UE + +\fIRDF Site Summary (RSS) 1.0\fR, 2000-12-06 +.UR http://purl.org/rss/1.0/spec +http://purl.org/rss/1.0/spec +.UE +.SH SEE ALSO +.BR libraptor(3), raptor-config(1) +.SH CHANGES +.SS 2.0.0 +Removed \-a option that did nothing. +.LP +Removed \-m option from rapper but it was never documented here. +.LP +Removed \-n option that was long hidden. +.LP +Removed \-s option that was equivalent to \-f scanForRDF +.SS 1.4.16 +Added \-I/\-\-input-uri and \-O/\-\-output\-uri to set the input and output +(parser and serializer) base URIs separately. +.SS 1.4.15 +Added \-t/\-\-trace to do URI traces. +.SS 1.4.5 +Updated to add serializer rdfxml-abbrev +.SS 1.4.3 +Updated potential parser and serializers and described \-f for +defining namespaces. +.SS 1.3.0 +Added \-f for features. +.br +Added \-g for guessing the parser to use. +.SS 1.1.0 +Removed \-a, \-\-assume since rdf:RDF is now always optional. +.br +.SH AUTHOR +Dave Beckett - +.UR http://www.dajobe.org/ +http://www.dajobe.org/ +.UE +.br |