.\"                                      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"
.SH "نام (NAME)"
rapper \- ابزار تجزیه و سریال‌سازی RDF رپتور
.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
.fi
.SH "توضیحات (DESCRIPTION)"
ابزار
.B rapper
امکان تجزیه محتوای RDF را از طریق جعبه‌ابزار تجزیه‌کننده RDF
.B Raptor
فراهم می‌آورد و نتایج را به‌صورت سه‌تایی‌های RDF (سه‌بخشی‌ها) در قالب‌های نگارشی گوناگون منتشر می‌کند. شناسه
.I INPUT-URI
می‌تواند نام یک فایل باشد، یا کاراکتر
.RB ' \- '
برای ورودی استاندارد، یا در صورتی که رپتور با کتابخانه بازیابی وب (WWW retrieval) ساخته شده باشد، یک URI عمومی. شناسه اختیاری
.I INPUT-BASE-URI
در صورت وجود، به‌عنوان URI پایه برای تجزیه‌کننده سند استفاده می‌شود، در غیر این صورت به‌طور پیش‌فرض همان مقدار
.I INPUT-URI
در نظر گرفته می‌شود. مقدار
.RB ' \- '
به معنای عدم وجود URI پایه است.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B rapper
از نحو معمول خط فرمان گنو (GNU) پیروی می‌کند، که در آن گزینه‌های طولانی در صورت پشتیبانی تابع
.I getopt_long
با دو خط تیره (`-') شروع می‌شوند. در غیر این صورت فقط گزینه‌های کوتاه در دسترس خواهند بود.
.TP
.B \-h, \-\-help
نمایش خلاصه‌ای از گزینه‌ها.
.TP
.B \-i, \-\-input FORMAT
تنظیم قالب ورودی
.I FORMAT
روی یکی از مقادیر 'rdfxml' (RDF/XML، پیش‌فرض)، 'ntriples' (N-Triples، به زیر مراجعه کنید)، 'turtle' (Turtle، به زیر مراجعه کنید) یا 'rss-tag-soup' (RSS Tag Soup). تجزیه‌کننده RSS Tag Soup می‌تواند انواع گوناگون قالب‌های XML RSS، Atom 0.3 و Atom 1.0 را به سه‌تایی‌های RDF تبدیل کند.
.IP
فهرست تجزیه‌کننده‌ها بستگی به نحوه ساخت
.BR libraptor (3)
دارد. فهرست تجزیه‌کننده‌های پشتیبانی‌شده در خلاصه راهنمای ارائه‌شده با
.B \-h
آمده است.
.TP
.B \-I, \-\-input-uri URI
تنظیم
.I URI
پایه ورودی/تجزیه‌کننده، یا استفاده از مقدار '-' برای بدون پایه بودن. مقدار پیش‌فرض برابر با مقدار آرگومان INPUT-URI است.
.TP
.B \-o, \-\-output FORMAT
تنظیم قالب خروجی
.I FORMAT
روی 'ntriples' (N-Triples، پیش‌فرض)، 'rdfxml' (RDF/XML)، 'rdfxml-abbrev' (RDF/XML همراه با اختصارات) یا 'rss-1.0' (RSS 1.0، که خود یک نحو RDF/XML است).
.IP
فهرست سریال‌سازها بستگی به نحوه ساخت
.BR libraptor (3)
دارد. فهرست سریال‌سازهای پشتیبانی‌شده در خلاصه راهنمای ارائه‌شده با
.B \-h
آمده است.
.TP
.B \-O, \-\-output-uri URI
تنظیم
.I URI
پایه خروجی/سریال‌ساز، یا استفاده از مقدار '-' برای بدون پایه بودن. مقدار پیش‌فرض برابر با URI پایه ورودی است که یا توسط آرگومان INPUT-BASE-URI یا از طریق گزینه
.B \-I, \-\-input-uri URI
تنظیم شده باشد.
.TP
.B \-c, \-\-count
تنها شمارش سه‌تایی‌ها بدون تولید هیچ خروجی دیگری.
.TP
.B \-e, \-\-ignore-errors
نادیده گرفتن خطاها، عدم ارسال پیام‌ها و تلاش برای ادامه تجزیه.
.TP
.B \-f, \-\-feature FEATURE[=VALUE]
تنظیم یک ویژگی تجزیه‌کننده یا سریال‌ساز
.I FEATURE
به یک مقدار مشخص، یا به ۱ در صورتی که
.I VALUE
ذکر نشده باشد. از
.B "\-f help"
برای دریافت فهرست ویژگی‌های معتبر تجزیه‌کننده و سریال‌ساز استفاده کنید.
.IP
در صورت استفاده از قالب
.BR "\-f 'xmlns:" \fIprefix\fP=\(dq\fIuri\fP\(dq'
پیشوند و uri فضای نام ارائه‌شده برای سریال‌سازی تنظیم می‌شوند. این نحو با XML مطابقت دارد، به‌طوری که هر یک از
.I prefix
یا
.I uri
یا هر دو می‌توانند حذف شوند.
.TP
.B \-g, \-\-guess
حدس زدن تجزیه‌کننده مناسب بر اساس source-URI به‌جای استفاده از
.BR "\-i FORMAT" .
.TP
.B \-q, \-\-quiet
عدم نمایش پیام‌های اطلاعاتی اضافه.
.TP
.B \-r, \-\-replace-newlines
جایگزینی نویسه‌های خط جدید (newline) در داده‌های متنی چندخطی با فاصله.
.TP
.B \-\-show-graphs
چاپ نام گراف‌ها (URIها) به‌محض مشاهده در ورودی. این گزینه فقط برای تجزیه‌کننده‌هایی معنادار است که از نام گراف‌ها پشتیبانی می‌کنند، مانند تجزیه‌کننده TRiG.
.TP
.B \-\-show-namespaces
چاپ فضاهای نام به‌محض مشاهده در ورودی.
.TP
.B \-t, \-\-trace
چاپ URIهای بازیابی‌شده در حین تجزیه. به‌ویژه برای نظارت بر عملکرد تجزیه‌کننده‌های guess و GRDDL بسیار مفید است.
.TP
.B \-w, \-\-ignore-warnings
نادیده گرفتن هشدارها و عدم انتشار پیام‌های آن‌ها.
.TP
.B \-v, \-\-version
چاپ نسخه raptor و خروج.
.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),
.BR raptor-config (1)
.SH "تغییرات (CHANGES)"
.SS 2.0.0
گزینه
.B \-a
که کاری انجام نمی‌داد حذف شد.
.LP
گزینه
.B \-m
از rapper حذف شد، اما هرگز در اینجا مستند نشده بود.
.LP
گزینه
.B \-n
که مدتی طولانی پنهان بود حذف شد.
.LP
گزینه
.B \-s
که معادل
.B "\-f scanForRDF"
بود حذف شد.
.SS 1.4.16
گزینه‌های
.B \-I/\-\-input-uri
و
.B \-O/\-\-output\-uri
برای تنظیم جداگانه URIهای پایه ورودی و خروجی (تجزیه‌کننده و سریال‌ساز) اضافه شدند.
.SS 1.4.15
گزینه
.B \-t/\-\-trace
جهت ردگیری URI اضافه شد.
.SS 1.4.5
برای افزودن سریال‌ساز rdfxml-abbrev به‌روزرسانی شد.
.SS 1.4.3
تجزیه‌کننده و سریال‌سازهای بالقوه به‌روز شدند و
.B \-f
برای تعریف فضاهای نام شرح داده شد.
.SS 1.3.0
گزینه
.B \-f
برای ویژگی‌ها اضافه شد.
.br
گزینه
.B \-g
برای حدس زدن تجزیه‌کننده مناسب اضافه شد.
.SS 1.1.0
گزینه‌های
.B "\-a, \-\-assume"
حذف شدند زیرا rdf:RDF اکنون همیشه اختیاری است.
.br
.SH "نویسنده (AUTHOR)"
Dave Beckett \-
.UR http://www.dajobe.org
http://www.dajobe.org
.UE
.br