نام (NAME)

sdcv - نسخهٔ کنسولی برنامهٔ StarDict

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

sdcv [ options ] [list of words]

توضیحات (DESCRIPTION)

sdcv یک ابزار متنی ساده و چندسکویی برای کار با فرهنگ‌های لغت در قالب StarDict است. هر واژه از «list of words» (فهرست واژه‌ها) می‌تواند رشته‌ای باشد با یک «/» در ابتدا برای استفاده از الگوریتم جستجوی فازی (Fuzzy)، با یک «|» در ابتدا برای استفاده از جستجوی تمام‌متن (full-text)، و این رشته می‌تواند شامل «?» و «*» برای جستجو با عبارات باقاعده (regexp) باشد. این برنامه در هر دو حالت تعاملی و غیرتعاملی کار می‌کند. برای خروج از حالت تعاملی کلیدهای Ctrl+D را فشار دهید. در حالت تعاملی، اگر sdcv با پشتیبانی از کتابخانهٔ readline کامپایل شده باشد، می‌توانید از کلیدهای UP و DOWN برای پیمایش در تاریخچه استفاده کنید.

گزینه‌ها (OPTIONS)

-h --help: نمایش پیام راهنما و خروج
-v --version: نمایش نسخه و خروج
-l --list-dicts: نمایش فهرست فرهنگ‌های لغت موجود و خروج
-u --use-dict filename: برای جستجو فقط از فرهنگ لغت با این bookname استفاده شود
-n --non-interactive: برای استفاده در اسکریپت‌ها
-x --only-data-dir: برای استفاده در اسکریپت‌ها: فقط از فرهنگ‌های لغت موجود در data-dir استفاده شود، و در دایرکتوری‌های کاربر و سیستم جستجو نشود
-e --exact-search: عدم انجام جستجوی فازی برای واژه‌های مشابه، فقط تطابق‌های دقیق بازگردانده شوند
-j --json: چاپ نتایج list-dicts و جستجوها در قالب json، نه به عنوان متن ساده. برای استفاده در پردازش خودکار نتایج حاصل از جستجوی فرهنگ لغت.
--utf8-output: مجبور کردن sdcv به عدم تبدیل به مجموعه نویسه‌های محلی (locale)، خروجی در قالب utf8
--utf8-input: مجبور کردن sdcv به عدم تبدیل از مجموعه نویسه‌های محلی (locale)، با این فرض که ورودی در قالب utf8 است
--data-dir path/to/directory: استفاده از این دایرکتوری به عنوان مسیر دایرکتوری داده‌های stardict. بدین معنی که sdcv فرهنگ‌های لغت را در دایرکتوری data-dir/dic جستجو می‌کند.
--color: استفاده از کدهای فرار ANSI برای رنگی کردن خروجی sdcv (روی خروجی json کار نمی‌کند).

فایل‌ها (FILES)

/usr/share/stardict/dic
$(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 قرار دهید.
$(XDG_DATA_HOME)/sdcv_history: این فایل شامل $(SDCV_HISTSIZE) واژهٔ آخری است که با sdcv جستجو کرده‌اید. SDCV تنها در صورتی از این فایل استفاده می‌کند که با پشتیبانی از کتابخانهٔ readline کامپایل شده باشد.
$(XDG_CONFIG_HOME)/sdcv_ordering: این یک فایل متنی شامل یک bookname از فرهنگ لغت در هر خط است. این فایل مشخص می‌کند که نتایج جستجو باید با چه ترتیبی نمایش داده شوند.

محیط (ENVIRONMENT)

متغیرهای محیطی مورد استفاده توسط sdcv:

STARDICT_DATA_DIR: در صورت تنظیم، sdcv از این متغیر به عنوان دایرکتوری داده استفاده می‌کند؛ بدین معنی که sdcv فرهنگ‌های لغت را در $STARDICT_DATA_DIR/dic جستجو می‌کند.
SDCV_HISTSIZE: در صورت تنظیم، sdcv آخرین $(SDCV_HISTSIZE) واژه‌ای را که با sdcv جستجو می‌کنید در $(XDG_DATA_HOME)/sdcv_history (یا $(SDCV_HISTFILE)) می‌نویسد. اگر تنظیم نشده باشد، آخرین ۲۰۰۰ واژه در $(XDG_DATA_HOME)/sdcv_history ذخیره می‌شوند.
SDCV_HISTFILE: در صورت تنظیم، sdcv تاریخچهٔ خود را در $(SDCV_HISTFILE) می‌نویسد. اگر تنظیم نشده باشد، مسیر پیش‌فرض $(XDG_DATA_HOME)/sdcv_history استفاده خواهد شد.
SDCV_PAGER: در صورت تنظیم SDCV_PAGER، مقدار آن به عنوان نام برنامه‌ای که برای نمایش مدخل فرهنگ لغت به کار می‌رود، استفاده خواهد شد.

گزارش باگ‌ها (BUGS)

گزارش‌های باگ را به dushistov at mail dot ru ایمیل کنید. حتماً واژهٔ «sdcv» را در جایی از فیلد «Subject:» بگنجانید.

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

Evgeniy A. Dushistov, Hu Zheng

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

stardict(1), http://sdcv.sourceforge.net, http://stardict.sourceforge.net