.\" $Id: recollq.1,v 1.1 2007-11-13 10:07:35 dockes Exp $ (C) 2005 J.F.Dockes\$
.TH RECOLLQ 1 "13 November 2007"
.SH "نام (NAME)"
recollq \- ابزار خط فرمانی و خروجی استاندارد برای پرس‌وجو در Recoll
.SH "خلاصه دستور (SYNOPSIS)"
.B recollq
[
.B \-c
<configdir>
]
[
.B \-o
|
.B \-f
|
.B \-a
]
[
.B \-b
]
[
.B \-C
]
[
.B \-d
]
[
.B \-A
]
[
.B \-p
|
.B \-q
]
[
.B \-e
]
[
.B \-m
]
[
.B \-n
<[first-]cnt>
]
[
.B \-Q
]
[
.B \-s
<stemming language>
]
[
.B \-S
<fldname>
]
[
.B \-D
]
[
.B \-i
<additional index directory>
]
[
.B \-F
<quoted space separated field name list>
]
[
.B \--extract-to
<file path>
]
<query string>

.B recollq \-P

.SH "توضیحات (DESCRIPTION)"
دستور
.B recollq
پرس‌وجوی Recoll مشخص‌شده در خط فرمان را اجرا کرده و نتایج را در خروجی استاندارد چاپ می‌کند. این ابزار در اصل برای عیب‌یابی یا هدایت داده‌ها از طریق لوله‌کشی (piping) به برنامه‌ای دیگر طراحی شده است. قالب پایه و گونه‌های مختلف آن می‌توانند برای پرس‌وجو از طریق خط فرمان مفید باشند. گزینهٔ \-F باید منحصراً برای استفاده از داده‌های خروجی در برنامه‌ای دیگر به کار رود، زیرا تنها گزینه‌ای است که خروجی آن تضمین می‌شود کاملاً قابل تجزیه (parseable) باشد.
.PP
گزینهٔ
.B \-c 
نام دایرکتوری پیکربندی را مشخص می‌کند و مقدار پیش‌فرض یا $RECOLL_CONFDIR را بازنویسی می‌نماید.
.PP
رشتهٔ پرس‌وجو با اتصال تمام آرگومان‌های موجود در انتهای خط فرمان (پس از گزینه‌ها) ساخته می‌شود. این رشته به‌طور پیش‌فرض به‌عنوان یک رشته در زبان پرس‌وجو تفسیر خواهد شد. در صورت نیاز باید از نقل‌قول برای گریز (escape) دادن نویسه‌هایی که ممکن است توسط شل تفسیر شوند (مانند نویسه‌های عام / wildcards) استفاده کرد. اگر
.B \-a 
مشخص شود، رشتهٔ پرس‌وجو به‌صورت یک جست‌وجوی ساده برای
.I همهٔ واژه‌ها
تفسیر می‌شود. اگر 
.B \-o 
مشخص شود، رشتهٔ پرس‌وجو به‌صورت یک جست‌وجوی ساده برای
.I هر یک از واژه‌ها
تفسیر خواهد شد. اگر 
.B \-f
مشخص شود، رشتهٔ پرس‌وجو به‌صورت یک جست‌وجوی ساده برای
.I نام فایل
تفسیر می‌گردد.
.PP
گزینهٔ
.B \-b
(ساده/basic) می‌تواند برای چاپِ تنها urlهای نتایج در جریان خروجی مشخص شود.
.PP
اگر 
.B \-d
تنظیم شود، متن محتوای فایل‌های نتیجه در stdout تخلیه خواهد شد.
.PP
با 
.B \-C
برنامه برای چندین سند یکسان (هش داده‌های یکسان)، تنها یک نتیجه نمایش خواهد داد.
.PP
اگر 
.B \-m
تنظیم شود، کل آرایهٔ فراداده‌ها (metadata) برای هر سند تخلیه خواهد شد.
.PP
اگر 
.B \-A
تنظیم شود، چکیدهٔ اسناد چاپ خواهد شد. با افزودن گزینهٔ اضافی
.B \-p
(یا
.B \-q
)، قطعه‌متن‌ها (snippets) به همراه شمارهٔ صفحه (یا شمارهٔ خط)، در صورت موجود بودن، به‌جای آن نمایش داده می‌شوند.
.PP
.B \-S
<fieldname>
نتایج را بر اساس فیلد مشخص‌شده مرتب می‌کند. از 
.B \-D 
برای مرتب‌سازی نزولی استفاده کنید.
.PP
.B \-n
<[first-]cnt>
می‌تواند برای تعیین حداکثر تعداد نتایجی که باید چاپ شوند استفاده شود. مقدار پیش‌فرض ۲۰۰۰ است. برای بدون محدودیت، از مقدار ۰ استفاده کنید. اگر آرگومان به‌شکل first-cnt باشد، اولین نتیجه برای خروجی را نیز مشخص می‌کند (از ۰).
.PP
.B \-s
<language>
زبان ریشه‌یابی واژگان (stemming) را انتخاب می‌کند. این مقدار باید با یک پایگاه‌دادهٔ ریشه‌یابی موجود مطابقت داشته باشد (همان‌طور که در پیکربندی تنظیم شده یا با recollindex \-s اضافه شده است).
.PP
.B \-i
<extra dbdir>
نمایهٔ (index) مشخص‌شدهٔ Xapian را به مجموعهٔ مورد استفاده برای پرس‌وجو اضافه می‌کند. این گزینه می‌تواند چندین بار مشخص شود.
.PP 
.B \-F
<space separated field list> (یک آرگومان، مثلاً "author title")
باید برای هدایت داده‌ها از طریق لوله‌کشی به برنامه‌ای دیگر استفاده شود. پس از ۲ خط اولیه که پرس‌وجوی واقعی و تعداد تخمینی نتایج را نشان می‌دهند، برای هر سند نتیجه یک خط چاپ خواهد شد. هر خط دقیقاً فیلدهای درخواست‌شده در خط فرمان را خواهد داشت. فیلدها در قالب base64 کدگذاری شده و با یک نویسهٔ فاصله از هم جدا می‌شوند. فیلدهای خالی با نویسه‌های فاصلهٔ متوالی مشخص می‌شوند. یک نویسهٔ فاصلهٔ اضافی نیز در انتهای هر خط وجود دارد.
.PP
.B \--extract-to
<file path>
اولین سند نتیجهٔ پرس‌وجو را در مسیر مشخص‌شده استخراج می‌کند که این مسیر نباید از قبل وجود داشته باشد. برای انتخاب سند، از
-n first-cnt
استفاده کنید.
.PP
.B recollq \-P
(دوره زمانی/Period) کمترین و بیشترین سال‌های تغییر اسناد در نمایه را چاپ خواهد کرد.

.SH "همچنین ببینید (SEE ALSO)"
.PP 
recollindex(1) recollq(1) recoll.conf(5)