.TH SDCV 1 "2006-04-24" "sdcv-0.4.2"
.SH "نام (NAME)"
sdcv \- نسخهٔ کنسولی برنامهٔ StarDict
.SH "خلاصه دستور (SYNOPSIS)"
.B sdcv 
[ 
.BI options 
] 
[list of words]
.SH "توضیحات (DESCRIPTION)"
.I sdcv 
یک ابزار متنی ساده و چندسکویی برای کار با فرهنگ‌های لغت در قالب StarDict است.
هر واژه از «list of words» (فهرست واژه‌ها) می‌تواند رشته‌ای باشد
با یک «/» در ابتدا برای استفاده از الگوریتم جستجوی فازی (Fuzzy)،
با یک «|» در ابتدا برای استفاده از جستجوی تمام‌متن (full-text)،
و این رشته می‌تواند شامل «?» و «*» برای جستجو با عبارات باقاعده (regexp) باشد.
این برنامه در هر دو حالت تعاملی و غیرتعاملی کار می‌کند.
برای خروج از حالت تعاملی کلیدهای Ctrl+D را فشار دهید.
در حالت تعاملی، اگر sdcv با پشتیبانی از کتابخانهٔ readline کامپایل شده باشد،
می‌توانید از کلیدهای UP و DOWN برای پیمایش در تاریخچه استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B "\-h  \-\-help"
نمایش پیام راهنما و خروج
.TP 8
.B "\-v \-\-version"
نمایش نسخه و خروج
.TP 8
.B "\-l \-\-list\-dicts" 
نمایش فهرست فرهنگ‌های لغت موجود و خروج
.TP 8
.B "\-u \-\-use\-dict filename"
برای جستجو فقط از فرهنگ لغت با این bookname استفاده شود
.TP 8
.B "\-n \-\-non\-interactive"
برای استفاده در اسکریپت‌ها
.TP 8
.B "\-x \-\-only\-data\-dir"
برای استفاده در اسکریپت‌ها: فقط از فرهنگ‌های لغت موجود در data-dir استفاده شود، و در دایرکتوری‌های کاربر و سیستم جستجو نشود
.TP 8
.B "\-e \-\-exact\-search" 
عدم انجام جستجوی فازی برای واژه‌های مشابه، فقط تطابق‌های دقیق بازگردانده شوند
.TP 8
.B "\-j \-\-json"
چاپ نتایج list-dicts و جستجوها در قالب json، نه به عنوان متن ساده.
برای استفاده در پردازش خودکار نتایج حاصل از جستجوی فرهنگ لغت.
.TP 8
.B "\-\-utf8\-output"
مجبور کردن sdcv به عدم تبدیل به مجموعه نویسه‌های محلی (locale)، خروجی در قالب utf8
.TP 8
.B "\-\-utf8\-input"
مجبور کردن sdcv به عدم تبدیل از مجموعه نویسه‌های محلی (locale)، با این فرض که ورودی در قالب utf8 است
.TP 8
.B "\-\-data\-dir path/to/directory" 
استفاده از این دایرکتوری به عنوان مسیر دایرکتوری داده‌های stardict. بدین معنی که sdcv فرهنگ‌های لغت را در دایرکتوری data-dir/dic جستجو می‌کند.
.TP 8
.B "\-\-color" 
استفاده از کدهای فرار ANSI برای رنگی کردن خروجی sdcv (روی خروجی json کار نمی‌کند).
.SH "فایل‌ها (FILES)"
.TP 
/usr/share/stardict/dic
.TP
$(XDG_DATA_HOME)/stardict/dic

مکانی که sdcv انتظار دارد فرهنگ‌های لغت را در آن بیابد.
به جای /usr/share/stardict/dic می‌توانید از هر دایرکتوری دلخواهی
استفاده کنید، کافی است متغیر محیطی STARDICT_DATA_DIR را تنظیم کنید.
برای نمونه، اگر فرهنگ‌های لغت شما در /mnt/data/stardict-dicts/dic قرار دارند،
متغیر STARDICT_DATA_DIR را برابر با /mnt/data/stardict-dicts قرار دهید.
.TP
$(XDG_DATA_HOME)/sdcv_history

این فایل شامل $(SDCV_HISTSIZE) واژهٔ آخری است که با sdcv جستجو کرده‌اید.
SDCV تنها در صورتی از این فایل استفاده می‌کند که با پشتیبانی از کتابخانهٔ readline کامپایل شده باشد.
.TP
$(XDG_CONFIG_HOME)/sdcv_ordering

این یک فایل متنی شامل یک bookname از فرهنگ لغت در هر خط است.
این فایل مشخص می‌کند که نتایج جستجو باید با چه ترتیبی نمایش داده شوند.
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی مورد استفاده توسط \fIsdcv\fR:
.TP 20
.B STARDICT_DATA_DIR
در صورت تنظیم، sdcv از این متغیر به عنوان دایرکتوری داده استفاده می‌کند؛ بدین معنی که sdcv فرهنگ‌های لغت را در $\fBSTARDICT_DATA_DIR\fR/dic جستجو می‌کند.
.TP 20
.B SDCV_HISTSIZE
در صورت تنظیم، sdcv آخرین $(SDCV_HISTSIZE) واژه‌ای را که با sdcv جستجو می‌کنید در $(XDG_DATA_HOME)/sdcv_history (یا $(SDCV_HISTFILE)) می‌نویسد. اگر تنظیم نشده باشد، آخرین ۲۰۰۰ واژه در $(XDG_DATA_HOME)/sdcv_history ذخیره می‌شوند.
.TP 20
.B SDCV_HISTFILE
در صورت تنظیم، sdcv تاریخچهٔ خود را در $(SDCV_HISTFILE) می‌نویسد. اگر تنظیم نشده باشد، مسیر پیش‌فرض $(XDG_DATA_HOME)/sdcv_history استفاده خواهد شد.
.TP 20
.B SDCV_PAGER
در صورت تنظیم SDCV_PAGER، مقدار آن به عنوان نام برنامه‌ای که برای نمایش مدخل فرهنگ لغت به کار می‌رود، استفاده خواهد شد.
.SH "گزارش باگ‌ها (BUGS)"
گزارش‌های باگ را به dushistov at mail dot ru ایمیل کنید. حتماً واژهٔ «sdcv» را در جایی از فیلد «Subject:» بگنجانید.
.SH "نویسندگان (AUTHORS)"
Evgeniy A. Dushistov, Hu Zheng
.SH "همچنین ببینید (SEE ALSO)"
stardict(1), http://sdcv.sourceforge.net, http://stardict.sourceforge.net