نام (NAME)

rapper - ابزار تجزیه و سریال‌سازی RDF رپتور

خلاصه دستور (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)

ابزار rapper امکان تجزیه محتوای RDF را از طریق جعبه‌ابزار تجزیه‌کننده RDF Raptor فراهم می‌آورد و نتایج را به‌صورت سه‌تایی‌های RDF (سه‌بخشی‌ها) در قالب‌های نگارشی گوناگون منتشر می‌کند. شناسه INPUT-URI می‌تواند نام یک فایل باشد، یا کاراکتر '-' برای ورودی استاندارد، یا در صورتی که رپتور با کتابخانه بازیابی وب (WWW retrieval) ساخته شده باشد، یک URI عمومی. شناسه اختیاری INPUT-BASE-URI در صورت وجود، به‌عنوان URI پایه برای تجزیه‌کننده سند استفاده می‌شود، در غیر این صورت به‌طور پیش‌فرض همان مقدار INPUT-URI در نظر گرفته می‌شود. مقدار '-' به معنای عدم وجود URI پایه است.

گزینه‌ها (OPTIONS)

دستور rapper از نحو معمول خط فرمان گنو (GNU) پیروی می‌کند، که در آن گزینه‌های طولانی در صورت پشتیبانی تابع getopt_long با دو خط تیره (`-') شروع می‌شوند. در غیر این صورت فقط گزینه‌های کوتاه در دسترس خواهند بود.

-h, --help: نمایش خلاصه‌ای از گزینه‌ها.
-i, --input FORMAT: تنظیم قالب ورودی 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 تبدیل کند.

: فهرست تجزیه‌کننده‌ها بستگی به نحوه ساخت libraptor(3) دارد. فهرست تجزیه‌کننده‌های پشتیبانی‌شده در خلاصه راهنمای ارائه‌شده با -h آمده است.

-I, --input-uri URI: تنظیم URI پایه ورودی/تجزیه‌کننده، یا استفاده از مقدار '-' برای بدون پایه بودن. مقدار پیش‌فرض برابر با مقدار آرگومان INPUT-URI است.
-o, --output FORMAT: تنظیم قالب خروجی FORMAT روی 'ntriples' (N-Triples، پیش‌فرض)، 'rdfxml' (RDF/XML)، 'rdfxml-abbrev' (RDF/XML همراه با اختصارات) یا 'rss-1.0' (RSS 1.0، که خود یک نحو RDF/XML است).

: فهرست سریال‌سازها بستگی به نحوه ساخت libraptor(3) دارد. فهرست سریال‌سازهای پشتیبانی‌شده در خلاصه راهنمای ارائه‌شده با -h آمده است.

-O, --output-uri URI: تنظیم URI پایه خروجی/سریال‌ساز، یا استفاده از مقدار '-' برای بدون پایه بودن. مقدار پیش‌فرض برابر با URI پایه ورودی است که یا توسط آرگومان INPUT-BASE-URI یا از طریق گزینه -I, --input-uri URI تنظیم شده باشد.
-c, --count: تنها شمارش سه‌تایی‌ها بدون تولید هیچ خروجی دیگری.
-e, --ignore-errors: نادیده گرفتن خطاها، عدم ارسال پیام‌ها و تلاش برای ادامه تجزیه.
-f, --feature FEATURE[=VALUE]: تنظیم یک ویژگی تجزیه‌کننده یا سریال‌ساز FEATURE به یک مقدار مشخص، یا به ۱ در صورتی که VALUE ذکر نشده باشد. از -f help برای دریافت فهرست ویژگی‌های معتبر تجزیه‌کننده و سریال‌ساز استفاده کنید.

: در صورت استفاده از قالب -f 'xmlns:prefix="uri"' پیشوند و uri فضای نام ارائه‌شده برای سریال‌سازی تنظیم می‌شوند. این نحو با XML مطابقت دارد، به‌طوری که هر یک از prefix یا uri یا هر دو می‌توانند حذف شوند.

-g, --guess: حدس زدن تجزیه‌کننده مناسب بر اساس source-URI به‌جای استفاده از -i FORMAT.
-q, --quiet: عدم نمایش پیام‌های اطلاعاتی اضافه.
-r, --replace-newlines: جایگزینی نویسه‌های خط جدید (newline) در داده‌های متنی چندخطی با فاصله.
--show-graphs: چاپ نام گراف‌ها (URIها) به‌محض مشاهده در ورودی. این گزینه فقط برای تجزیه‌کننده‌هایی معنادار است که از نام گراف‌ها پشتیبانی می‌کنند، مانند تجزیه‌کننده TRiG.
--show-namespaces: چاپ فضاهای نام به‌محض مشاهده در ورودی.
-t, --trace: چاپ URIهای بازیابی‌شده در حین تجزیه. به‌ویژه برای نظارت بر عملکرد تجزیه‌کننده‌های guess و GRDDL بسیار مفید است.
-w, --ignore-warnings: نادیده گرفتن هشدارها و عدم انتشار پیام‌های آن‌ها.
-v, --version: چاپ نسخه raptor و خروج.

مثال‌ها (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