rapper(1) General Commands Manual rapper(1) نام (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 همچنین ببینید (SEE ALSO) libraptor(3), raptor-config(1) تغییرات (CHANGES) 2.0.0 گزینه -a که کاری انجام نمی‌داد حذف شد. گزینه -m از rapper حذف شد، اما هرگز در اینجا مستند نشده بود. گزینه -n که مدتی طولانی پنهان بود حذف شد. گزینه -s که معادل -f scanForRDF بود حذف شد. 1.4.16 گزینه‌های -I/--input-uri و -O/--output-uri برای تنظیم جداگانه URIهای پایه ورودی و خروجی (تجزیه‌کننده و سریال‌ساز) اضافه شدند. 1.4.15 گزینه -t/--trace جهت ردگیری URI اضافه شد. 1.4.5 برای افزودن سریال‌ساز rdfxml-abbrev به‌روزرسانی شد. 1.4.3 تجزیه‌کننده و سریال‌سازهای بالقوه به‌روز شدند و -f برای تعریف فضاهای نام شرح داده شد. 1.3.0 گزینه -f برای ویژگی‌ها اضافه شد. گزینه -g برای حدس زدن تجزیه‌کننده مناسب اضافه شد. 1.1.0 گزینه‌های -a, --assume حذف شدند زیرا rdf:RDF اکنون همیشه اختیاری است. نویسنده (AUTHOR) Dave Beckett - http://www.dajobe.org 2010-04-28 rapper(1)