.\"                                      Hey, EMACS: -*- nroff -*-
.\"
.\" rdfproc.1 - Redland RDF processor utility manual page
.\"
.\" Copyright (C) 2003-2010 David Beckett - http://www.dajobe.org
.\" Copyright (C) 2003-2005 University of Bristol - http://www.bristol.ac.uk
.\"
.TH rdfproc 1 "2010-08-29"
.\" Please adjust this date whenever revising the manpage.
.SH "نام (NAME)"
rdfproc \- ابزار پردازشگر RDF ردلند
.SH "خلاصه دستور (SYNOPSIS)"
.B rdfproc
.RB [ options ]
.IR "store-name"
.IR "command"
.IR "arg..."
.SH "مثال‌ها (EXAMPLES)"
.nf
.B rdfproc test parse http://planetrdf.com/guide/rss.rdf
.br
.B rdfproc test print
.br
.B rdfproc test serialize ntriples
.br
.SH "توضیحات (DESCRIPTION)"
ابزار
.B rdfproc
امکان تجزیه، پرس‌وجو، دستکاری و سریال‌سازی محتوای RDF را با استفاده از کتابخانه
.B Redland
RDF فراهم می‌کند. \fIstore-name\fR نام مخزن Redland است که معمولاً یک شناسه کوتاه می‌باشد. آرگومان‌های \fIcommand\fR متغیر بوده و در بخش «دستورها (COMMANDS)» در ادامه توضیح داده شده‌اند.
.SH "گزینه‌ها (OPTIONS)"
دستور rdfproc از نحو معمول خط فرمان گنو (GNU) استفاده می‌کند، به طوری که در صورت پشتیبانی توسط تابع getopt_long، گزینه‌های طولانی با دو خط تیره (\(aq\-\-\(aq) آغاز می‌شوند. در غیر این صورت، تنها گزینه‌های کوتاه در دسترس خواهند بود.
.TP
.B \-h, \-\-help
نمایش خلاصه‌ای از گزینه‌ها.
.TP
.B \-c, \-\-contexts
استفاده از یک مخزن همراه با بافتارهای (contexts) ردلند.
.TP
.B \-n, \-\-new
ایجاد یک مخزن جدید و بازنویسی روی هر مخزن موجود با همین نام.
.TP
.B \-o, \-\-output \fIFORMAT\fR
تنظیم FORMAT خروجی برای توالی‌های سه‌تایی‌ها (triples)، مانند خروجی جستجو (دستور find) به یک سریال‌ساز Redland.
برای مشاهده فهرست کامل قالب‌های پشتیبانی‌شده از \-h یا \-o help استفاده کنید.
.TP
.B \-p, \-\-password
خواندن گزینه ذخیره‌سازی \(aqpassword\(aq از ورودی استاندارد. با پایان خط (\(aq\en\(aq) یا پایان فایل (EOF) خاتمه می‌یابد. این معادل تنظیم آن با استفاده از \-t یا \-\-storage-options است، اما نیازی به افشای گذرواژه در فهرست آرگومان‌ها ندارد.
.TP
.B \-q, \-\-quiet
عدم نمایش پیام‌های اطلاعاتی (که به stderr ارسال می‌شوند).
.TP
.B \-r, \-\-results \fIFORMAT\fR
تنظیم قالب نحو نتایج پرس‌وجو.
برای مشاهده فهرست کامل قالب‌های نتایج پرس‌وجو از \-h یا \-r help استفاده کنید.
.IP
فهرست دقیق قالب‌ها بستگی به این دارد که libraptor(3) با چه امکاناتی ساخته شده است، اما مقدار صحیح در پیام راهنمای دستور با \-h مشخص می‌شود.
.TP
.B \-s, \-\-storage \fITYPE\fR
تنظیم نوع ذخیره‌سازی Redland (پیش‌فرض \(aqhashes\(aq).
اگر متغیر محیطی RDFPROC_STORAGE_TYPE تنظیم شده باشد، نوع ذخیره‌سازی ارائه‌شده در اینجا اولویت داشته و جایگزین آن خواهد شد.
برای مشاهده فهرست کامل قالب‌های نتایج پرس‌وجو از \-h یا \-s help استفاده کنید.
.TP
.B \-t, \-\-storage-options \fIOPTIONS\fR
تنظیم گزینه‌ها برای ذخیره‌سازی Redland؛ پیش‌فرض "hash-type=\(aqbdb\(aq,dir=\(aq.\(aq" برای مطابقت با ذخیره‌سازی پیش‌فرض "hashes" است. برای انواع ذخیره‌سازی مانند \(aqmysql\(aq که به گزینه‌های اضافی نیاز دارند، معمولاً مقداری مانند "host=\(aqhostname\(aq,database=\(aqdbname\(aq,user=\(aqabc\(aq,password=\(aqpass\(aq" خواهد بود.
اگر متغیر محیطی RDFPROC_STORAGE_OPTIONS تنظیم شده باشد، گزینه‌های ذخیره‌سازی ارائه‌شده در اینجا پس از آن اعمال خواهند شد.
.TP
.B \-v, \-\-version
چاپ نسخه Redland و خروج.
.TP
.B \-V, \-\-verbose
نمایش پیام‌های اطلاعاتی در stderr.
.SH "دستورها (COMMANDS)"
در هر جا که یک گره مجاز باشد، مانند \fINODE\fP، \fISUBJECT\fP، \fIPREDICATE\fP یا \fIOBJECT\fP در زیر، از روش‌های مکاشفه‌ای ساده برای حدس زدن اینکه کدام شناسه‌های گره خالی (blank node)، URI یا لیترال (literal) هستند استفاده می‌شود (برای افزودن یک گزاره با لیترال، از add-typed استفاده کنید). اگر مورد با _: آغاز شود، یک شناسه گره خالی در نظر گرفته می‌شود؛ در غیر این صورت، اگر با الگوی something:// مطابقت داشته باشد، به عنوان یک URI فرض می‌شود، و در غیر این صورت یک لیترال است. لیترال‌ها تنها به عنوان مفعول (object) گزاره‌ها مجاز هستند و گره‌های خالی به عنوان محمول (predicate) مجاز نیستند.
.IP "\fBadd \fISUBJECT\fP \fIPREDICATE\fP \fIOBJECT\fP \fI[CONTEXT]\fP\fR"
افزودن سه‌تایی داده‌شده به گراف، در بافتار اختیاری Redland در صورتی که گره \fICONTEXT\fR مشخص شده باشد.

.IP "\fBadd-typed \fISUBJECT\fP \fIPREDICATE\fP \fIOBJECT\fP \fIOBJECT-LANG\fP \fIOBJECT-URI\fP \fI[CONTEXT]\fP\fR"
افزودن سه‌تایی با مفعول لیترال دارای نوع‌داده به گراف، در بافتار اختیاری Redland در صورتی که \fICONTEXT\fR مشخص شده باشد.

.IP "\fBarc \fISUBJECT\fP \fIOBJECT\fP\fR"
.IP "\fBarcs \fISUBJECT\fP \fIOBJECT\fP\fR"
نمایش یک گره/تمام گره‌هایی که با سه‌تایی‌های (\fISUBJECT\fP, ?, \fIOBJECT\fP) مطابقت دارند.

.IP "\fBarcs-in \fINODE\fP\fR"
نمایش تمام ویژگی‌های سه‌تایی‌هایی که \fINODE\fP به عنوان فاعل (subject) آن‌ها است.

.IP "\fBarcs-out \fINODE\fP\fR"
نمایش تمام ویژگی‌های سه‌تایی‌هایی که \fINODE\fP به عنوان مفعول (object) آن‌ها است.

.IP "\fBcontains \fISUBJECT\fP \fIPREDICATE\fP \fIOBJECT\fP\fR"
بررسی اینکه آیا سه‌تایی داده‌شده در گراف وجود دارد یا خیر.

.IP "\fBcontexts\fR"
فهرست کردن تمام بافتارها در گراف (در صورتی که بافتارها فعال باشند).

.IP "\fBfind \fISUBJECT\fP|- \fIPREDICATE\fP|- \fIOBJECT\fP|- [\fICONTEXT\fP]\fR"
یافتن سه‌تایی‌های منطبق با گزاره داده‌شده که در آن - نشان‌دهنده یک جای خالی است که با هر گره‌ای تطابق می‌یابد. اگر \fICONTEXT\fP مشخص شده باشد، جستجو تنها برای سه‌تایی‌های موجود در آن گره بافتار انجام می‌شود.

.IP "\fBhas-arc-in \fINODE\fP \fIARC\fP\fR"
بررسی اینکه سه‌تایی‌ای با \fINODE\fP به عنوان فاعل و \fIARC\fP به عنوان محمول وجود دارد یا خیر.

.IP "\fBhas-arc-out \fPNODE\fP \fIARC\fP\fR"
بررسی اینکه سه‌تایی‌ای با \fINODE\fP به عنوان مفعول و \fIARC\fP به عنوان محمول وجود دارد یا خیر.

.IP "\fBparse \fIURI|FILENAME\fP [\fISYNTAX|\fP [\fIBASE URI\fP]]\fR"
تجزیه نحو در \fIURI\fP به درون گراف با استفاده از \fISYNTAX\fP که می‌تواند یکی از موارد \fIrdfxml\fP (پیش‌فرض، RDF/XML)، \fIntriples\fP، \fIturtle\fP، \fIrss-tag-soup\fP (برای تمام RSS و Atomها)، \fIgrddl\fP و \fIguess\fP (برای استفاده از سرنخ‌های محتوا و اطلاعات پروتکل جهت تشخیص آن) باشد. (این فهرست سریع‌تر از این صفحه راهنما تغییر می‌کند).
اگر \fIFILENAME\fP یک فایل موجود باشد، URI مناسب برای آن تولید خواهد شد. در صورتی که تجزیه با خطا مواجه شود، کد خروجی غیر صفر خواهد بود.

.IP "\fBparse-stream \fIURI|FILENAME\fP [\fISYNTAX\fP [\fIBASE URI\fP [\fICONTEXT\fP]]\fR"
تجزیه جریانی نحو در URI به درون گراف با استفاده از \fISYNTAX\fP که می‌تواند یکی از موارد \fIrdfxml\fP (پیش‌فرض، RDF/XML) یا \fIntriples\fP باشد.
اگر \fIFILENAME\fP یک فایل موجود باشد، URI مناسب برای آن تولید خواهد شد. اگر URI اختیاری \fICONTEXT\fI داده شده باشد، سه‌تایی‌ها به آن بافتار اضافه می‌شوند.
در صورتی که تجزیه با خطا مواجه شود، کد خروجی غیر صفر خواهد بود.

.IP "\fBprint\fR"
چاپ سه‌تایی‌های گراف در قالبی ساده با نمایش گره‌های بافتار در صورت وجود.

.IP "\fBquery \fINAME\fP|- \fIURI\fP|- \fIQUERY-STRING\fP\fR"
اجرای پرس‌وجوی \fIQUERY-STRING\fI در زبان \fINAME\fR که بسته به پرس‌وجو مقادیر متغیرها، یک مقدار بولی یا یک گراف RDF را برمی‌گرداند.
زبان پرس‌وجو می‌تواند \(aqsparql\(aq یا \(aqrdql\(aq باشد.

.IP "\fBremove \fISUBJECT\fP \fIPREDICATE\fP \fIOBJECT\fP \fI[CONTEXT]\fP\fR"
حذف سه‌تایی داده‌شده از گراف، در بافتار اختیاری Redland در صورتی که \fICONTEXT\fR مشخص شده باشد.

.IP "\fBremove-context \fICONTEXT\fP\fR"
حذف تمام سه‌تایی‌های موجود در گراف با بافتار Redland به نام \fICONTEXT\fR.

.IP "\fBserialize [\fISYNTAX\fP [\fIURI\fP [\fIMIME-TYPE\fP]]]\fR"
سریال‌سازی گراف به یک نحو با \fISYNTAX\fR، \fIURI\fR یا نوع رسانه اینترنتی/نوع MIME مشخص. در صورتی که هیچ‌یک از موارد فوق داده نشود، پیش‌فرض RDF/XML (\fINAME\fR با مقدار "rdfxml"، و نوع MIME با مقدار "application/rdf/xml") است. گزینه دیگر "ntriples" (بدون نوع MIME) است.

.IP "\fBsource \fIPREDICATE\fP \fIOBJECT\fP\fR"
.IP "\fBsources \fIPREDICATE\fP \fIOBJECT\fP\fR"
نمایش یک گره/تمام گره‌هایی که با سه‌تایی‌های (?, \fIPREDICATE\fP, \fIOBJECT\fP) مطابقت دارند.

.IP "\fBtarget \fISUBJECT\fP \fIPREDICATE\fP\fR"
.IP "\fBtargets \fISUBJECT\fP \fIPREDICATE\fP\fR"
نمایش یک گره/تمام گره‌هایی که با سه‌تایی‌های (\fISUBJECT\fP, \fIPREDICATE\fP, ?) مطابقت دارند.

.SH "محیط (ENVIRONMENT)"
می‌توان متغیر RDFPROC_STORAGE_OPTIONS را به جای استفاده از گزینه \-t, \-\-storage-options \fIOPTIONS\fR برای تعیین گزینه‌های ذخیره‌سازی تنظیم کرد.
هنگامی که هر دو مشخص شوند، گزینه‌های خط فرمان در آخر اعمال می‌شوند و تقدم دارند.
.LP
می‌توان متغیر RDFPROC_STORAGE_TYPE را به جای استفاده از گزینه \-s, \-\-storage \fITYPE\fR برای تعیین نوع ذخیره‌سازی تنظیم کرد.
هنگامی که هر دو مشخص شوند، نوع ذخیره‌سازی ارائه‌شده از طریق خط فرمان استفاده خواهد شد.
.SH "سازگاری با استانداردها (CONFORMING TO)"
\fIRDF/XML Syntax (Revised)\fR,
توصیه‌نامه W3C،
.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،
.UR http://www.w3.org/TR/rdf-testcases/#ntriples
http://www.w3.org/TR/rdf-testcases/#ntriples
.UE
.SH "همچنین ببینید (SEE ALSO)"
redland(3), libraptor(3), rapper(1)
.SH "نویسندگان (AUTHORS)"
Dave Beckett - 
.UR http://www.dajobe.org
http://www.dajobe.org
.UE