SYNOPSIS
rapper [OPTIONS] INPUT-URI [INPUT-BASE-URI]EXAMPLE
rapper -o ntriples http://planetrdf.com/guide/rss.rdf
rapper -i rss-tag-soup -o rss-1.0 pile-of-rss.xml http://example.org/base/
rapper --count http://example.org/index.rdf
DESCRIPTION
The rapper utility allows parsing of RDF content by the Raptor RDF parser toolkit emitting the results as RDF triples in a choice of syntaxes. The INPUT-URI can be a file name, '-' for standard input or if Raptor is built with a WWW retrieval library, a general URI. The optional INPUT-BASE-URI is used as the document parser base URI if present otherwise defaults to the INPUT-URI. A value of '-' means no base URI.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.- -h, --help
- Show a summary of the options.
- -i, --input FORMAT
- Set the input 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 and Atom 0.3 into RDF triples.
- 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.
- -I, --input-uri URI
- Set the input/parser base URI or use value '-' for no base. The default is the INPUT-URI argument value.
- -o, --output FORMAT
- Set the output 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).
- 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.
- -O, --output-uri URI
- Set the output/serializer base 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 -I, --input-uri URI
- -c, --count
- Only count the triples and produce no other output.
- -e, --ignore-errors
- Ignore errors, do not emit the messages and try to continue parsing.
- -f, --feature FEATURE[=VALUE]
- Set a parser or serializer feature FEATURE to a value, or to 1 if VALUE is omitted, Use -f help to get lists of valid parser and serializer features.
- If the form -f 'xmlns:prefix="uri"' is used, the prefix and namespace uri given will be set for serializing. The syntax matches XML in that either or both of prefix or uri can be omitted.
- -g, --guess
- Guess the parser to use from the source-URI rather than use the -i FORMAT.
- -q, --quiet
- No extra information messages.
- -r, --replace-newlines
- Replace newlines in multi-line literals with spaces.
- --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.
- --show-namespaces
- Print namespaces as they are seen in the input.
- -t, --trace
- Print URIs retrieved during parsing. Especially useful for monitoring what the guess and GRDDL parsers are doing.
- -w, --ignore-warnings
- Ignore warnings, do not emit the messages.
- -v, --version
- Print the raptor version and exit.
EXAMPLES
rapper -q -i ntriples -o rdfxml -f 'xmlns:rss=http://purl.org/rss/1.0/' -f 'xmlns:ex=http://example.org/' tests/test.nt
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#'
CONFORMING TO
RDF/XML Syntax (Revised), W3C Recommendation, http://www.w3.org/TR/rdf-syntax-grammar/N-Triples, in RDF Test Cases, Jan Grant and Dave Beckett (eds.), W3C Recommendation, http://www.w3.org/TR/rdf-testcases/#ntriples
Turtle Terse RDF Triple Language, Dave Beckett, http://www.dajobe.org/2004/01/turtle/
RDFA in XHTML: Syntax and Processing, Ben Adida, Mark Birbeck, Shane McCarron and Steven Pemberton (eds.), W3C Candidate Recommendation, 20 June 2008 http://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/
RDF Site Summary (RSS) 1.0, 2000-12-06 http://purl.org/rss/1.0/spec
CHANGES
2.0.0
Removed -a option that did nothing.Removed -m option from rapper but it was never documented here.
Removed -n option that was long hidden.
Removed -s option that was equivalent to -f scanForRDF
1.4.16
Added -I/--input-uri and -O/--output-uri to set the input and output (parser and serializer) base URIs separately.1.4.15
Added -t/--trace to do URI traces.1.4.5
Updated to add serializer rdfxml-abbrev1.4.3
Updated potential parser and serializers and described -f for defining namespaces.1.3.0
Added -f for features.Added -g for guessing the parser to use.