1rapper(1)                   General Commands Manual                  rapper(1)
2
3
4

NAME

6       rapper - Raptor RDF parsing and serializing utility
7

SYNOPSIS

9       rapper [OPTIONS] INPUT-URI [INPUT-BASE-URI]
10

EXAMPLE

12       rapper -o ntriples http://planetrdf.com/guide/rss.rdf
13       rapper -i rss-tag-soup -o rss-1.0 pile-of-rss.xml http://example.org/base/
14       rapper --count http://example.org/index.rdf
15

DESCRIPTION

17       The  rapper  utility  allows  parsing  of RDF content by the Raptor RDF
18       parser toolkit emitting the results as RDF triples in a choice of  syn‐
19       taxes.   The INPUT-URI can be a file name, '-' for standard input or if
20       Raptor is built with a WWW  retrieval  library,  a  general  URI.   The
21       optional  INPUT-BASE-URI  is  used  as  the document parser base URI if
22       present otherwise defaults to the IINPUT-URI.  A value of '-' means  no
23       base URI.
24

OPTIONS

26       rapper uses the usual GNU command line syntax, with long options start‐
27       ing with two dashes (`-') if supported  by  the  getopt_long  function.
28       Otherwise the short options are only available.
29
30       -h, --help
31              Show a summary of the options.
32
33       -i, --input FORMAT
34              Set  the  input  FORMAT  to  one of 'rdfxml' (RDF/XML, default),
35              'ntriples' (N-Triples, see below), 'turtle' (Turtle, see  below)
36              or  'rss-tag-soup'  (RSS Tag Soup).  The RSS Tag Soup parser can
37              turn the many XML RSS formats and Atom 0.3 into RDF triples.
38
39              The list of parsers depends on how libraptor(3) was built.   The
40              list  of supported parsers is given in the help summary given by
41              -h.
42
43       -I, --input-uri URI
44              Set the input/parser base URI or use value '-' for no base.  The
45              default is the INPUT-URI argument value.
46
47       -o, --output FORMAT
48              Set  the  output  FORMAT  to  'ntriples'  (N-Triples,  default),
49              'rdfxml' (RDF/XML), 'rdfxml-abbrev' (RDF/XML with abbreviations)
50              or 'rss-1.0' (RSS 1.0, also an RDF/XML syntax).
51
52              The  list  of serializers depends on how libraptor(3) was built.
53              The list of supported serializers is given in the  help  summary
54              given by -h.
55
56       -O, --output-uri URI
57              Set the output/serializer base URI or use value '-' for no base.
58              The default is the input base uri, either set  by  the  argument
59              INPUT-BASE-URI or via options -I, --input-uri URI
60
61       -c, --count
62              Only count the triples and produce no other output.
63
64       -e, --ignore-errors
65              Ignore  errors,  do  not  emit  the messages and try to continue
66              parsing.
67
68       -f, --feature FEATURE[=VALUE]
69              Set a parser or serializer feature FEATURE to a value, or  to  1
70              if  VALUE  is  omitted, Use -f help to get lists of valid parser
71              and serializer features.
72
73              If the form -f 'xmlns:prefix="uri"'  is  used,  the  prefix  and
74              namespace  uri  given  will  be set for serializing.  The syntax
75              matches XML in that either or both of prefix or uri can be omit‐
76              ted.
77
78       -g, --guess
79              Guess  the parser to use from the source-URI rather than use the
80              -i FORMAT.
81
82       -q, --quiet
83              No extra information messages.
84
85       -r, --replace-newlines
86              Replace newlines in multi-line literals with spaces.
87
88       -s, --scan
89              Scan for <rdf:RDF> element in the RDF/XML source content.
90
91       --show-graphs
92              Print graph names (URIs) as they are seen in  the  input.   This
93              only  has a meaning for parsers that support graph names such as
94              the TRiG parser.
95
96       --show-namespaces
97              Print namespaces as they are seen in the input.
98
99       -t, --trace
100              Print URIs retrieved during parsing.  Especially useful for mon‐
101              itoring what the guess and GRDDL parsers are doing.
102
103       -w, --ignore-warnings
104              Ignore warnings, do not emit the messages.
105
106       -v, --version
107              Print the raptor version and exit.
108

EXAMPLES

110       rapper        -q       -i       ntriples       -o       rdfxml       -f
111       'xmlns:rss="http://purl.org/rss/1.0/"'    -f    'xmlns:ex="http://exam
112       ple.org/"' tests/test.nt
113       rapper  -q  -o  rdfxml  -f  'xmlns:rdfs="http://www.w3.org/2000/01/rdf-
114       schema#"' tests/rdf-schema.rdf 'http://www.w3.org/2000/01/rdf-schema#'
115

CONFORMING TO

117       RDF/XML Syntax (Revised), W3C Recommendation, http://www.w3.org/TR/rdf-
118       syntax-grammar/ ⟨http://www.w3.org/TR/rdf-syntax-grammar/
119
120       N-Triples,  in  RDF  Test Cases, Jan Grant and Dave Beckett (eds.), W3C
121       Recommendation,            http://www.w3.org/TR/rdf-testcases/#ntriples
122http://www.w3.org/TR/rdf-testcases/#ntriples⟩
123
124       Turtle     Terse     RDF     Triple     Language,     Dave     Beckett,
125       http://www.dajobe.org/2004/01/turtle/
126http://www.dajobe.org/2004/01/turtle/
127
128       RDFA  in  XHTML:  Syntax and Processing, Ben Adida, Mark Birbeck, Shane
129       McCarron and Steven Pemberton (eds.), W3C Candidate Recommendation,  20
130       June       2008      http://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/
131http://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/
132
133       RDF Site Summary  (RSS)  1.0,  2000-12-06  http://purl.org/rss/1.0/spec
134http://purl.org/rss/1.0/spec
135

SEE ALSO

137       libraptor(3),raptor-config(1)
138

CHANGES

140   1.4.16
141       Added  -I/--input-uri  and  -O/--output-uri to set the input and output
142       (parser and serializer) base URIs separately.
143
144   1.4.15
145       Added -t/--trace to do URI traces.
146
147   1.4.5
148       Updated to add serializer rdfxml-abbrev
149
150   1.4.3
151       Updated potential parser and serializers and described -f for  defining
152       namespaces.
153
154   1.3.0
155       Added -f for features.
156       Added -g for guessing the parser to use.
157
158   1.1.0
159       Removed -a, --assume since rdf:RDF is now always optional.
160

AUTHOR

162       Dave Beckett - http://www.dajobe.org/http://www.dajobe.org/
163
164
165
166                                  2007-08-19                         rapper(1)
Impressum