.TH VIMIVRC 5 "مه 2017" "لینوکس پارچ" "پیکربندی vimiv"
.SH "نام (NAME)"
vimivrc \- فایل‌های پیکربندی برای نمایش‌دهنده تصویر vimiv
.SH "خلاصه دستور (SYNOPSIS)"
.PP
/etc/vimiv/vimivrc, $XDG_CONFIG_HOME/vimiv/vimivrc, ~/.vimiv/vimivrc
.PP
/etc/vimiv/keys.conf, $XDG_CONFIG_HOME/vimiv/keys.conf, ~/.vimiv/keys.conf
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه vimiv از طریق دو فایل پیکربندی می‌شود:
.RS
.IP \(bu 2
فایل vimivrc برای پیکربندی‌های پایه
.IP \(bu 2
فایل keys.conf برای کلیدهای میانبر
.RE
.PP
به‌طور پیش‌فرض این فایل‌ها در مسیر /etc/vimiv/ نصب می‌شوند. بهترین روش این است که آن‌ها را در مسیر $XDG_CONFIG_HOME/vimiv/ کپی کرده و فایل‌های رونوشت‌شده را پیکربندی کنید.
.PP
اطلاعات بیشتر با قالبی خواناتر در نشانی زیر در دسترس است:
.PP
\[la]http://karlch.github.io/vimiv/documentation/configuration\[ra]
.SH "تنظیمات (SETTINGS)"
.PP
تنظیمات در فایل vimivrc پیکربندی می‌شوند. این فایل به چهار بخش تقسیم شده است:
.RS
.IP \(bu 2
GENERAL (عمومی)
.IP \(bu 2
LIBRARY (کتابخانه)
.IP \(bu 2
EDIT (ویرایش)
.IP \(bu 2
ALIASES (نام‌های مستعار)
.RE
.PP
سه بخش اول تنظیمات را گروه‌بندی می‌کنند و بخش چهارم برای تعریف نام‌های مستعار استفاده می‌شود. معنای هر تنظیم و مقادیر مجاز در ادامه توضیح داده شده است:
.SS "عمومی (GENERAL)"
.TP
\fB\fCstart_fullscreen\fR, \fB\fCBool\fR
در صورت انتخاب yes، برنامه در حالت تمام‌صفحه آغاز می‌شود.
.TP
\fB\fCstart_slideshow\fR, \fB\fCBool\fR
در صورت انتخاب yes، نمایش اسلاید در هنگام راه‌اندازی آغاز می‌گردد.
.TP
\fB\fCslideshow_delay\fR, \fB\fCFloat\fR
تعیین میزان تاخیر برای نمایش اسلاید (به ثانیه).
.TP
\fB\fCshuffle\fR, \fB\fCBool\fR
در صورت انتخاب yes، تصاویر در فهرست پرونده‌ها به‌صورت تصادفی بر هم ریخته می‌شوند.
.TP
\fB\fCdisplay_bar\fR, \fB\fCBool\fR
در صورت انتخاب yes، نوار وضعیت در پایین صفحه نمایش داده می‌شود؛ در غیر این صورت پنهان می‌گردد. توجه داشته باشید که پیام‌های خطا حتی در صورت پنهان بودن نوار وضعیت نیز نمایش داده می‌شوند.
.TP
\fB\fCdefault_thumbsize\fR, \fB\fCTuple\fR
اندازه تصاویر بندانگشتی به‌صورت (x, y).
.TP
\fB\fCgeometry\fR, \fB\fCString\fR
رشته‌ای در قالب "WIDTHxHEIGHT" که اندازه پیش‌فرض پنجره را مشخص می‌کند. توجه داشته باشید که ممکن است همه مدیران پنجره این تنظیم را اعمال نکنند.
.TP
\fB\fCrecursive\fR, \fB\fCBool\fR
در صورت انتخاب yes، دایرکتوری داده‌شده در هنگام راه‌اندازی به‌صورت بازگشتی برای یافتن تصاویر جستجو می‌شود.
.TP
\fB\fCrescale_svg\fR, \fB\fCBool\fR
در صورت انتخاب yes، گرافیک‌های برداری با بارگذاری مجدد تصویر به‌صورت خودکار تغییر اندازه می‌ابند. در غیر این صورت، همانند یک تصویر معمولی بزرگنمایی می‌شوند.
.TP
\fB\fCoverzoom\fR, \fB\fCFloat\fR
عددی اعشاری که حداکثر میزان بزرگنمایی تصویر را برای تطبیق با پنجره در اولین بارگذاری تعیین می‌کند.
.TP
\fB\fCsearch_case_sensitive\fR, \fB\fCBool\fR
در صورت انتخاب yes، جستجو به بزرگی و کوچکی حروف حساس خواهد بود؛ در غیر این صورت حروف نادیده گرفته می‌شوند.
.TP
\fB\fCincsearch\fR, \fB\fCBool\fR
در صورت انتخاب yes، جستجو همزمان با تایپ کردن به‌صورت تدریجی انجام می‌شود.
.TP
\fB\fCcopy_to_primary\fR, \fB\fCBool\fR
در صورت انتخاب yes، کپی در گزینش اولیه (Primary Selection) به جای کلیپ‌بورد انجام می‌شود.
.TP
\fB\fCcommandline_padding\fR, \fB\fCInt\fR
فاصله حاشیه داخلی (Padding) مورد استفاده در خط فرمان و نوار وضعیت.
.TP
\fB\fCthumb_padding\fR, \fB\fCInt\fR
فاصله حاشیه بین تصاویر بندانگشتی. نکته: علاوه بر پدینگ، فاصله ستون‌ها نیز به‌صورت پویا به‌روزرسانی می‌شود تا به بهترین شکل با عرض فعلی پنجره تطبیق یابد.
.TP
\fB\fCcompletion_height\fR, \fB\fCInt\fR
ارتفاع منوی تکمیل خودکار هنگام نمایش پیشنهادهای خط فرمان.
.TP
\fB\fCplay_animations\fR, \fB\fCBool\fR
در صورت انتخاب yes، تصاویر متحرک گیف پخش می‌شوند؛ در غیر این صورت روی فریم اول یا فریم جاری باقی می‌مانند.
.SS "کتابخانه (LIBRARY)"
.TP
\fB\fCstart_show_library\fR, \fB\fCBool\fR
در صورت انتخاب yes، کتابخانه همیشه در هنگام شروع نمایش داده می‌شود.
.TP
\fB\fClibrary_width\fR, \fB\fCInt\fR
عرض پیش‌فرض کتابخانه زمانی که تصویری باز است.
.TP
\fB\fCexpand_lib\fR, \fB\fCBool\fR
در صورت انتخاب yes، اگر هیچ تصویری باز نباشد، کتابخانه به‌طور خودکار به اندازه کل پنجره گسترش می‌یابد.
.TP
\fB\fCborder_width\fR, \fB\fCInt\fR
عرض حاشیه جداکننده کتابخانه و تصویر.
.TP
\fB\fCmarkup\fR, \fB\fCString\fR
قالب نشانه‌گذاری مورد استفاده برای برجسته‌سازی نتایج جستجو. این مورد باید یک تگ بازکننده صحیح مانند <span ...> باشد زیرا با </span> بسته خواهد شد.
.TP
\fB\fCshow_hidden\fR, \fB\fCBool\fR
در صورت انتخاب yes، فایل‌های مخفی در کتابخانه نمایش داده شده و تصاویر مخفی باز می‌شوند.
.TP
\fB\fCdesktop_start_dir\fR, \fB\fCString\fR
دایرکتوری که vimiv باید در صورت باز شدن از طریق فایل .desktop در آن شروع به کار کند.
.TP
\fB\fCfile_check_amount\fR, \fB\fCInt\fR
تعداد فایل‌هایی که vimiv در یک دایرکتوری بررسی می‌کند تا مشخص شود تصویر هستند یا خیر. این مورد بر ستون اندازه دایرکتوری‌ها در کتابخانه اثر می‌گذارد. به محض رسیدن به این عدد، بررسی متوقف شده و یک علامت + افزوده می‌شود (مانند +30). عدد بزرگتر دقت و اطلاعات را به بهای کاهش سرعت افزایش می‌دهد.
.TP
\fB\fCtilde_in_statusbar\fR, \fB\fCBool\fR
در صورت انتخاب yes، مسیر $HOME در نوار وضعیت بخش کتابخانه به علامت ~ خلاصه می‌شود.
.SS "ویرایش (EDIT)"
.TP
\fB\fCautosave_images\fR, \fB\fCBool\fR
در صورت انتخاب yes، تصاویر چرخانده‌شده یا قرینه‌شده به‌صورت خودکار بر روی دیسک ذخیره می‌شوند؛ در غیر این صورت برای حفظ تغییرات باید دستور :w به صراحت فراخوانی شود.
.SS "نام‌های مستعار (ALIASES)"
.PP
امکان پیکربندی نام‌های مستعار (Aliases) برای خط فرمان در این بخش فراهم شده است. یک نام مستعار در قالب زیر تعریف می‌شود:
.PP
aliasname: command
.PP
همچنین ببینید: دستور alias.
.SH "کلیدهای میانبر (KEYBINDINGS)"
.PP
کلیدهای میانبر در فایل keys.conf تعریف می‌شوند. مشابه با vimivrc، این فایل نیز به بخش‌های مختلف تفکیک شده است:
.RS
.IP \(bu 2
IMAGE: کلیدهای تعریف‌شده در اینجا برای حالت مشاهده تصویر اعمال می‌شوند.
.IP \(bu 2
THUMBNAIL: کلیدهای تعریف‌شده در اینجا برای حالت تصاویر بندانگشتی اعمال می‌شوند.
.IP \(bu 2
LIBRARY: کلیدهای تعریف‌شده در اینجا برای حالت کتابخانه اعمال می‌شوند.
.IP \(bu 2
MANIPULATE: کلیدهای تعریف‌شده در اینجا برای حالت ویرایش و دستکاری تصویر اعمال می‌شوند.
.IP \(bu 2
COMMAND: کلیدهای تعریف‌شده در اینجا برای خط فرمان اعمال می‌شوند.
.RE
.PP
کلیدهای میانبر در قالب زیر تعریف می‌شوند:
.PP
keyname: command [arguments]
.PP
نام کلید (keyname) باید یک نماد کلید معتبر مانند "a" یا "b" یا مثلاً "colon" برای کاراکتر ":" باشد. یک ابزار کاربردی در X برای بررسی تعاملی این نام‌ها ابزار
.B xev
است.
.PP
کلیدهای تبدیل‌کننده (Modifiers) پشتیبانی‌شده عبارتند از:
.RS
.IP \(bu 2
Shift از طریق Shift+keyname
.IP \(bu 2
Control از طریق ^keyname
.IP \(bu 2
Alt از طریق Alt+keyname
.RE
.PP
بخش command [arguments] باید یک دستور معتبر vimiv به همراه آرگومان‌های صحیح باشد. برای مشاهده فهرست کامل دستورات به همراه توضیحات، مستندات دستورات را بررسی کنید.
.PP
کلیدهای ماوس نیز در همان قالب تعریف می‌شوند. کافی است از واژه "Button" و شماره متناظر با آن مانند "Button1" به عنوان keyname استفاده کنید.
.SH "دستورات (COMMANDS)"
.TP
\fB\fCaccept_changes\fR
پذیرش و تایید تغییرات اعمال‌شده در حالت دستکاری (manipulate).
.TP
\fB\fCalias\fR
افزودن نام مستعار برای یک دستور.
.TP
\fB\fCautorotate\fR
چرخش خودکار تمامی تصاویر در فهرست پرونده‌های جاری بر اساس داده‌های exif.
.TP
\fB\fCcenter\fR
پیمایش به مرکز تصویر.
.TP
\fB\fCcopy_abspath\fR
کپی کردن مسیر مطلق فایل انتخاب‌شده جاری در کلیپ‌بورد.
.TP
\fB\fCcopy_basename\fR
کپی کردن نام پایه فایل انتخاب‌شده جاری در کلیپ‌بورد.
.TP
\fB\fCdelete\fR
حذف تصویر جاری.
.TP
\fB\fCdiscard_changes\fR
نادیده گرفتن و لغو هرگونه تغییرات اعمال‌شده در حالت manipulate و خروج از آن.
.TP
\fB\fCedit\fR
ویرایش روشنایی، کنتراست یا اشباع رنگ تصویر جاری.
.TP
\fB\fCfirst\fR
انتقال به اولین تصویر فهرست پرونده‌ها در حالت تصویر یا بندانگشتی.
.TP
\fB\fCfirst_lib\fR
انتقال به اولین فایل فهرست پرونده‌ها در کتابخانه.
.TP
\fB\fCfit\fR
تطبیق اندازه تصویر با ابعاد پنجره جاری.
.TP
\fB\fCfit_horiz\fR
تطبیق افقی اندازه تصویر با عرض پنجره جاری.
.TP
\fB\fCfit_vert\fR
تطبیق عمودی اندازه تصویر با ارتفاع پنجره جاری.
.TP
\fB\fCflip\fR
قرینه‌سازی و وارونه کردن تصویر جاری.
.TP
\fB\fCfocus_library\fR
فوکوس کردن روی کتابخانه.
.TP
\fB\fCformat\fR
قالب‌بندی مجدد تمامی نام‌های فایل‌های باز شده فعلی.
.TP
\fB\fCfullscreen\fR
تغییر وضعیت حالت تمام‌صفحه.
.TP
\fB\fClast\fR
انتقال به آخرین تصویر در فهرست پرونده‌ها در حالت تصویر یا بندانگشتی.
.TP
\fB\fClast_lib\fR
انتقال به آخرین فایل فهرست پرونده‌ها در کتابخانه.
.TP
\fB\fClibrary\fR
تغییر وضعیت نمایش کتابخانه (روشن/خاموش).
.TP
\fB\fCmanipulate\fR
ورود به حالت دستکاری و تنظیمات تصویر (manipulate).
.TP
\fB\fCmark\fR
علامت‌گذاری تصویر انتخاب‌شده جاری.
.TP
\fB\fCmark_all\fR
علامت‌گذاری تمامی تصاویر موجود در فهرست جاری.
.TP
\fB\fCmark_between\fR
علامت‌گذاری تمامی تصاویر میان دو تصویر علامت‌گذاری‌شده اخیر.
.TP
\fB\fCmark_toggle\fR
تغییر وضعیت علامت‌گذاری تصویر جاری.
.TP
\fB\fCmove_up\fR
انتقال یک شاخه به بالا در کتابخانه.
.TP
\fB\fCnext\fR
انتقال به تصویر بعدی در فهرست حالت تصویر.
.TP
\fB\fCnext!\fR
انتقال اجباری به تصویر بعدی در فهرست حالت تصویر.
.TP
\fB\fCprev\fR
انتقال به تصویر قبلی در فهرست حالت تصویر.
.TP
\fB\fCprev!\fR
انتقال اجباری به تصویر قبلی در فهرست حالت تصویر.
.TP
\fB\fCq\fR
خروج از vimiv.
.TP
\fB\fCq!\fR
خروج اجباری از vimiv.
.TP
\fB\fCreload_lib\fR
بارگذاری مجدد کتابخانه.
.TP
\fB\fCrotate\fR
چرخش پادساعت‌گرد تصویر.
.TP
\fB\fCset\fR
تغییر مقدار یک تنظیم.
.TP
\fB\fCslideshow\fR
روشن یا خاموش کردن حالت نمایش اسلاید.
.TP
\fB\fCtag_write\fR
نوشتن نام تمامی تصاویر علامت‌گذاری‌شده جاری در یک فایل برچسب (tagfile).
.TP
\fB\fCtag_load\fR
بارگذاری تمامی تصاویر موجود در فایل برچسب به حالت تصویر.
.TP
\fB\fCtag_remove\fR
حذف یک فایل برچسب.
.TP
\fB\fCthumbnail\fR
روشن یا خاموش کردن حالت تصاویر بندانگشتی.
.TP
\fB\fCundelete\fR
بازگردانی یک تصویر حذف‌شده.
.TP
\fB\fCunfocus_library\fR
فوکوس روی ابزارکی که قبل از کتابخانه دارای فوکوس بود.
.TP
\fB\fCversion\fR
نمایش پنجره بالاپرده با اطلاعات نسخه برنامه.
.TP
\fB\fCw\fR
ذخیره صریح تصاویر تغییریافته بر روی دیسک.
.TP
\fB\fCwq\fR
مشابه دستور :w به همراه خروج از برنامه vimiv.
.TP
\fB\fCzoom_in\fR
بزرگنمایی (Zoom in).
.TP
\fB\fCzoom_out\fR
کوچک‌نمایی (Zoom out).
.TP
\fB\fCzoom_to\fR
تنظیم بزرگنمایی تصویر روی یک درصد مشخص.
.SH "دستورات پنهان (HIDDEN COMMANDS)"
.PP
دستورات زیر تنها می‌توانند به کلیدها اختصاص یابند و از طریق خط فرمان در دسترس نیستند:
.TP
\fB\fCclear_status\fR
پاک کردن تمامی ارقام یا پیام‌ها از نوار وضعیت و بازنشانی جستجو.
.TP
\fB\fCcommand\fR
ورود به حالت خط فرمان.
.TP
\fB\fCscroll\fR
پیمایش تصویر یا نمای بندانگشتی.
.TP
\fB\fCscroll_lib\fR
پیمایش کتابخانه.
.TP
\fB\fCsearch\fR
جستجو برای متن در فهرست پرونده‌های جاری.
.TP
\fB\fCsearch_next\fR
پیمایش به نتیجه بعدی جستجو.
.TP
\fB\fCsearch_prev\fR
پیمایش به نتیجه قبلی جستجو.
.TP
\fB\fChistory_down\fR
حرکت به پایین در تاریخچه خط فرمان.
.TP
\fB\fChistory_up\fR
حرکت به بالا در تاریخچه خط فرمان.
.TP
\fB\fCdiscard_command\fR
خروج از خط فرمان و نادیده گرفتن متن واردشده فعلی.
.TP
\fB\fCcomplete\fR
شروع تکمیل خودکار خط فرمان.
.TP
\fB\fCcomplete_inverse\fR
شروع تکمیل خودکار خط فرمان با گزینش معکوس آیتم‌ها.
.TP
\fB\fCslider\fR
تغییر مقدار لغزنده (Slider) جاری که فوکوس دارد.
.TP
\fB\fCfocus_slider\fR
فوکوس روی یکی از لغزنده‌های دستکاری تصویر.
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR vimiv (1),
.BR date (1)