.\" $Id: recoll.1,v 1.3 2007-11-13 18:42:18 dockes Exp $ (C) 2005 J.F.Dockes\$
.TH RECOLL 1 "8 January 2006"
.SH "نام (NAME)"
recoll \- رابط کاربری سامانه جستجوی تمام‌متن Recoll
.SH "خلاصه دستور (SYNOPSIS)"
.B recoll
[
.B \-h
]
[
.B \-c
<configdir>
]
[
.B \-L
<lang>
]
[
.B \-w
]
[
.B \-W
]
[
.B \-o
|
.B \-l
|
.B \-f
|
.B \-a
]
[
.B \-q
<query>
]

.B recoll -t
[
.B \-h
]
[
.B \-c
<configdir>
]
[
.B \-o
|
.B \-l
|
.B \-f
|
.B \-a
]
[
.B \-q
<query>
]

.B recoll
[
.B \-c
<configdir>
]
<url>
.SH "توضیحات (DESCRIPTION)"
در حالت اول، دستور
.B recoll
رابط گرافیکی کاربر را برای پرس‌وجوی نمایه آغاز خواهد کرد. در نخستین اجرا، این دستور پیکربندی کاربر را ایجاد می‌کند که پیش از آغاز ایجاد نمایه می‌توان آن را سفارشی‌سازی کرد.
.PP
در حالت دوم (همراه با گزینهٔ
.BR \-t )،
دستور
.B recoll
مانند دستور
.B recollq
رفتار خواهد کرد. در این حالت رابط گرافیکی اجرا نمی‌شود، بلکه پرس‌وجو را انجام داده و نتایج را در ترمینال (خروجی استاندارد) نمایش می‌دهد. همچنین اگر
.B recoll
از طریق یک پیوند به‌صورت
.B recollq
فراخوانی شود نیز عملکرد مشابهی خواهد داشت. در این حالت می‌توان گزینه‌های اضافی قابل فهم توسط دستور
.B recollq
را نیز تعیین کرد. این گزینه‌ها می‌توانند قالب خروجی و بیشترین تعداد نتایج نمایش‌یافته را کنترل کنند. لطفاً برای توضیحات کامل به راهنمای دستور دریافت‌شده از طریق گزینه‌های
.B \-t \-h
یا صفحهٔ راهنمای
.B recollq
مراجعه کنید. گزینهٔ
.B \-t
باید به‌صورت جداگانه تعیین شود و نمی‌توان آن را با گزینه‌های تک‌حرفی دیگر ادغام کرد.
.PP
گزینهٔ
.B \-c 
نام دایرکتوری پیکربندی را تعیین می‌کند و بر مقدار پیش‌فرض یا RECOLL_CONFDIR$ اولویت دارد.
.PP
با گزینهٔ
.BR \-w ،
رابط گرافیکی به‌صورت کمینه‌شده (minimized) اجرا می‌شود که برای شروع خودکار همگام با محیط میزکار مناسب است. گزینهٔ
.B \-W
مشابه است، اما تنها یک آیکون در سینی سیستم (system tray) نمایش می‌دهد. از این گزینه تنها در صورتی می‌توان استفاده کرد که قابلیت سینی سیستم در تنظیمات ترجیحات فعال شده باشد.
.PP
گزینهٔ
.B \-q 
می‌تواند برای مشخص کردن یک پرس‌وجوی اولیه در خط فرمان به کار رود. این پرس‌وجو به‌طور پیش‌فرض به‌عنوان یک رشته به زبان پرس‌وجو تفسیر می‌شود.
اگر
.B \-a 
مشخص شود، رشتهٔ پرس‌وجو به‌صورت یک جستجوی سادهٔ
.I all words
(تمامی کلمات) تفسیر خواهد شد. اگر
.B \-o 
مشخص شود، رشتهٔ پرس‌وجو به‌صورت یک جستجوی سادهٔ
.I any word
(هر کلمه‌ای) تفسیر خواهد شد. اگر
.B \-f
مشخص شود، رشتهٔ پرس‌وجو به‌صورت یک جستجوی سادهٔ
.I file name
(نام فایل) تفسیر خواهد شد. اگر
.B \-l
مشخص شود (یا به‌طور پیش‌فرض، بدون هیچ گزینه‌ای)، رشتهٔ پرس‌وجو به‌صورت یک جستجوی سادهٔ
.I query language
(زبان پرس‌وجو) تفسیر خواهد شد.
.PP
در حالت سوم، دستور
.B recoll
می‌تواند برای راه‌اندازی یک نمایش‌دهندهٔ بومی جهت مشاهدهٔ سندی که توسط Recoll نمایه شده است استفاده شود. این دستور بخش انتهایی نشانی اینترنتی (که با نویسهٔ '#' جدا می‌شود) را برای مشخص کردن یک
.I ipath
درک خواهد کرد؛ مشخص‌کننده‌ای برای بخشی از مسیر دسترسی سند در Recoll که درون یک ظرف مانند یک پوشهٔ mbox یا یک آرشیو zip قرار دارد. همچنین در صورت نیاز یک فایل موقت می‌سازد تا ابزار عادی سیستم بتواند سند را نمایش دهد. این حالت بیشتر برای باز کردن اسناد درون‌سازی‌شده (embedded) از طریق یک رابط جستجوی رومیزی خارجی کاربرد دارد.
.SH "همچنین ببینید (SEE ALSO)"
.PP 
recollindex(1) recollq(1) recoll.conf(5)