نام (NAME)

rdfproc - ابزار پردازشگر RDF ردلند

خلاصه دستور (SYNOPSIS)

rdfproc [options] store-name command arg...

مثال‌ها (EXAMPLES)

rdfproc test parse http://planetrdf.com/guide/rss.rdf
rdfproc test print
rdfproc test serialize ntriples

توضیحات (DESCRIPTION)

ابزار rdfproc امکان تجزیه، پرس‌وجو، دستکاری و سریال‌سازی محتوای RDF را با استفاده از کتابخانه Redland RDF فراهم می‌کند. store-name نام مخزن Redland است که معمولاً یک شناسه کوتاه می‌باشد. آرگومان‌های command متغیر بوده و در بخش «دستورها (COMMANDS)» در ادامه توضیح داده شده‌اند.

گزینه‌ها (OPTIONS)

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

-h, --help: نمایش خلاصه‌ای از گزینه‌ها.
-c, --contexts: استفاده از یک مخزن همراه با بافتارهای (contexts) ردلند.
-n, --new: ایجاد یک مخزن جدید و بازنویسی روی هر مخزن موجود با همین نام.
-o, --output FORMAT: تنظیم FORMAT خروجی برای توالی‌های سه‌تایی‌ها (triples)، مانند خروجی جستجو (دستور find) به یک سریال‌ساز Redland. برای مشاهده فهرست کامل قالب‌های پشتیبانی‌شده از -h یا -o help استفاده کنید.
-p, --password: خواندن گزینه ذخیره‌سازی 'password' از ورودی استاندارد. با پایان خط ('\n') یا پایان فایل (EOF) خاتمه می‌یابد. این معادل تنظیم آن با استفاده از -t یا --storage-options است، اما نیازی به افشای گذرواژه در فهرست آرگومان‌ها ندارد.
-q, --quiet: عدم نمایش پیام‌های اطلاعاتی (که به stderr ارسال می‌شوند).
-r, --results FORMAT: تنظیم قالب نحو نتایج پرس‌وجو. برای مشاهده فهرست کامل قالب‌های نتایج پرس‌وجو از -h یا -r help استفاده کنید.

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

-s, --storage TYPE: تنظیم نوع ذخیره‌سازی Redland (پیش‌فرض 'hashes'). اگر متغیر محیطی RDFPROC_STORAGE_TYPE تنظیم شده باشد، نوع ذخیره‌سازی ارائه‌شده در اینجا اولویت داشته و جایگزین آن خواهد شد. برای مشاهده فهرست کامل قالب‌های نتایج پرس‌وجو از -h یا -s help استفاده کنید.
-t, --storage-options OPTIONS: تنظیم گزینه‌ها برای ذخیره‌سازی Redland؛ پیش‌فرض "hash-type='bdb',dir='.'" برای مطابقت با ذخیره‌سازی پیش‌فرض "hashes" است. برای انواع ذخیره‌سازی مانند 'mysql' که به گزینه‌های اضافی نیاز دارند، معمولاً مقداری مانند "host='hostname',database='dbname',user='abc',password='pass'" خواهد بود. اگر متغیر محیطی RDFPROC_STORAGE_OPTIONS تنظیم شده باشد، گزینه‌های ذخیره‌سازی ارائه‌شده در اینجا پس از آن اعمال خواهند شد.
-v, --version: چاپ نسخه Redland و خروج.
-V, --verbose: نمایش پیام‌های اطلاعاتی در stderr.

دستورها (COMMANDS)

در هر جا که یک گره مجاز باشد، مانند NODE، SUBJECT، PREDICATE یا OBJECT در زیر، از روش‌های مکاشفه‌ای ساده برای حدس زدن اینکه کدام شناسه‌های گره خالی (blank node)، URI یا لیترال (literal) هستند استفاده می‌شود (برای افزودن یک گزاره با لیترال، از add-typed استفاده کنید). اگر مورد با _: آغاز شود، یک شناسه گره خالی در نظر گرفته می‌شود؛ در غیر این صورت، اگر با الگوی something:// مطابقت داشته باشد، به عنوان یک URI فرض می‌شود، و در غیر این صورت یک لیترال است. لیترال‌ها تنها به عنوان مفعول (object) گزاره‌ها مجاز هستند و گره‌های خالی به عنوان محمول (predicate) مجاز نیستند.

add SUBJECT PREDICATE OBJECT [CONTEXT]: افزودن سه‌تایی داده‌شده به گراف، در بافتار اختیاری Redland در صورتی که گره CONTEXT مشخص شده باشد.
add-typed SUBJECT PREDICATE OBJECT OBJECT-LANG OBJECT-URI [CONTEXT]: افزودن سه‌تایی با مفعول لیترال دارای نوع‌داده به گراف، در بافتار اختیاری Redland در صورتی که CONTEXT مشخص شده باشد.
arc SUBJECT OBJECT
arcs SUBJECT OBJECT: نمایش یک گره/تمام گره‌هایی که با سه‌تایی‌های (SUBJECT, ?, OBJECT) مطابقت دارند.
arcs-in NODE: نمایش تمام ویژگی‌های سه‌تایی‌هایی که NODE به عنوان فاعل (subject) آن‌ها است.
arcs-out NODE: نمایش تمام ویژگی‌های سه‌تایی‌هایی که NODE به عنوان مفعول (object) آن‌ها است.
contains SUBJECT PREDICATE OBJECT: بررسی اینکه آیا سه‌تایی داده‌شده در گراف وجود دارد یا خیر.
contexts: فهرست کردن تمام بافتارها در گراف (در صورتی که بافتارها فعال باشند).
find SUBJECT|- PREDICATE|- OBJECT|- [CONTEXT]: یافتن سه‌تایی‌های منطبق با گزاره داده‌شده که در آن - نشان‌دهنده یک جای خالی است که با هر گره‌ای تطابق می‌یابد. اگر CONTEXT مشخص شده باشد، جستجو تنها برای سه‌تایی‌های موجود در آن گره بافتار انجام می‌شود.
has-arc-in NODE ARC: بررسی اینکه سه‌تایی‌ای با NODE به عنوان فاعل و ARC به عنوان محمول وجود دارد یا خیر.
has-arc-out NODE ARC: بررسی اینکه سه‌تایی‌ای با NODE به عنوان مفعول و ARC به عنوان محمول وجود دارد یا خیر.
parse URI|FILENAME [SYNTAX| [BASE URI]]: تجزیه نحو در URI به درون گراف با استفاده از SYNTAX که می‌تواند یکی از موارد rdfxml (پیش‌فرض، RDF/XML)، ntriples، turtle، rss-tag-soup (برای تمام RSS و Atomها)، grddl و guess (برای استفاده از سرنخ‌های محتوا و اطلاعات پروتکل جهت تشخیص آن) باشد. (این فهرست سریع‌تر از این صفحه راهنما تغییر می‌کند). اگر FILENAME یک فایل موجود باشد، URI مناسب برای آن تولید خواهد شد. در صورتی که تجزیه با خطا مواجه شود، کد خروجی غیر صفر خواهد بود.
parse-stream URI|FILENAME [SYNTAX [BASE URI [CONTEXT]]: تجزیه جریانی نحو در URI به درون گراف با استفاده از SYNTAX که می‌تواند یکی از موارد rdfxml (پیش‌فرض، RDF/XML) یا ntriples باشد. اگر FILENAME یک فایل موجود باشد، URI مناسب برای آن تولید خواهد شد. اگر URI اختیاری CONTEXT داده شده باشد، سه‌تایی‌ها به آن بافتار اضافه می‌شوند. در صورتی که تجزیه با خطا مواجه شود، کد خروجی غیر صفر خواهد بود.
print: چاپ سه‌تایی‌های گراف در قالبی ساده با نمایش گره‌های بافتار در صورت وجود.
query NAME|- URI|- QUERY-STRING: اجرای پرس‌وجوی QUERY-STRING در زبان NAME که بسته به پرس‌وجو مقادیر متغیرها، یک مقدار بولی یا یک گراف RDF را برمی‌گرداند. زبان پرس‌وجو می‌تواند 'sparql' یا 'rdql' باشد.
remove SUBJECT PREDICATE OBJECT [CONTEXT]: حذف سه‌تایی داده‌شده از گراف، در بافتار اختیاری Redland در صورتی که CONTEXT مشخص شده باشد.
remove-context CONTEXT: حذف تمام سه‌تایی‌های موجود در گراف با بافتار Redland به نام CONTEXT.
serialize [SYNTAX [URI [MIME-TYPE]]]: سریال‌سازی گراف به یک نحو با SYNTAX، URI یا نوع رسانه اینترنتی/نوع MIME مشخص. در صورتی که هیچ‌یک از موارد فوق داده نشود، پیش‌فرض RDF/XML (NAME با مقدار "rdfxml"، و نوع MIME با مقدار "application/rdf/xml") است. گزینه دیگر "ntriples" (بدون نوع MIME) است.
source PREDICATE OBJECT
sources PREDICATE OBJECT: نمایش یک گره/تمام گره‌هایی که با سه‌تایی‌های (?, PREDICATE, OBJECT) مطابقت دارند.
target SUBJECT PREDICATE
targets SUBJECT PREDICATE: نمایش یک گره/تمام گره‌هایی که با سه‌تایی‌های (SUBJECT, PREDICATE, ?) مطابقت دارند.

محیط (ENVIRONMENT)

می‌توان متغیر RDFPROC_STORAGE_OPTIONS را به جای استفاده از گزینه -t, --storage-options OPTIONS برای تعیین گزینه‌های ذخیره‌سازی تنظیم کرد. هنگامی که هر دو مشخص شوند، گزینه‌های خط فرمان در آخر اعمال می‌شوند و تقدم دارند.

می‌توان متغیر RDFPROC_STORAGE_TYPE را به جای استفاده از گزینه -s, --storage TYPE برای تعیین نوع ذخیره‌سازی تنظیم کرد. هنگامی که هر دو مشخص شوند، نوع ذخیره‌سازی ارائه‌شده از طریق خط فرمان استفاده خواهد شد.

سازگاری با استانداردها (CONFORMING TO)

RDF/XML Syntax (Revised), توصیه‌نامه W3C، http://www.w3.org/TR/rdf-syntax-grammar

N-Triples, in RDF Test Cases, Jan Grant and Dave Beckett (eds.) توصیه‌نامه W3C، http://www.w3.org/TR/rdf-testcases/#ntriples

همچنین ببینید (SEE ALSO)

redland(3), libraptor(3), rapper(1)

نویسندگان (AUTHORS)

Dave Beckett - http://www.dajobe.org