VIMIVRC(5) پیکربندی vimiv VIMIVRC(5)

vimivrc - فایل‌های پیکربندی برای نمایش‌دهنده تصویر vimiv

/etc/vimiv/vimivrc, $XDG_CONFIG_HOME/vimiv/vimivrc, ~/.vimiv/vimivrc

/etc/vimiv/keys.conf, $XDG_CONFIG_HOME/vimiv/keys.conf, ~/.vimiv/keys.conf

برنامه vimiv از طریق دو فایل پیکربندی می‌شود:

  • فایل vimivrc برای پیکربندی‌های پایه
  • فایل keys.conf برای کلیدهای میانبر

به‌طور پیش‌فرض این فایل‌ها در مسیر /etc/vimiv/ نصب می‌شوند. بهترین روش این است که آن‌ها را در مسیر $XDG_CONFIG_HOME/vimiv/ کپی کرده و فایل‌های رونوشت‌شده را پیکربندی کنید.

اطلاعات بیشتر با قالبی خواناتر در نشانی زیر در دسترس است:

⟨http://karlch.github.io/vimiv/documentation/configuration⟩

تنظیمات در فایل vimivrc پیکربندی می‌شوند. این فایل به چهار بخش تقسیم شده است:

  • GENERAL (عمومی)
  • LIBRARY (کتابخانه)
  • EDIT (ویرایش)
  • ALIASES (نام‌های مستعار)

سه بخش اول تنظیمات را گروه‌بندی می‌کنند و بخش چهارم برای تعریف نام‌های مستعار استفاده می‌شود. معنای هر تنظیم و مقادیر مجاز در ادامه توضیح داده شده است:

start_fullscreen, Bool
در صورت انتخاب yes، برنامه در حالت تمام‌صفحه آغاز می‌شود.
start_slideshow, Bool
در صورت انتخاب yes، نمایش اسلاید در هنگام راه‌اندازی آغاز می‌گردد.
slideshow_delay, Float
تعیین میزان تاخیر برای نمایش اسلاید (به ثانیه).
shuffle, Bool
در صورت انتخاب yes، تصاویر در فهرست پرونده‌ها به‌صورت تصادفی بر هم ریخته می‌شوند.
display_bar, Bool
در صورت انتخاب yes، نوار وضعیت در پایین صفحه نمایش داده می‌شود؛ در غیر این صورت پنهان می‌گردد. توجه داشته باشید که پیام‌های خطا حتی در صورت پنهان بودن نوار وضعیت نیز نمایش داده می‌شوند.
default_thumbsize, Tuple
اندازه تصاویر بندانگشتی به‌صورت (x, y).
geometry, String
رشته‌ای در قالب "WIDTHxHEIGHT" که اندازه پیش‌فرض پنجره را مشخص می‌کند. توجه داشته باشید که ممکن است همه مدیران پنجره این تنظیم را اعمال نکنند.
recursive, Bool
در صورت انتخاب yes، دایرکتوری داده‌شده در هنگام راه‌اندازی به‌صورت بازگشتی برای یافتن تصاویر جستجو می‌شود.
rescale_svg, Bool
در صورت انتخاب yes، گرافیک‌های برداری با بارگذاری مجدد تصویر به‌صورت خودکار تغییر اندازه می‌ابند. در غیر این صورت، همانند یک تصویر معمولی بزرگنمایی می‌شوند.
overzoom, Float
عددی اعشاری که حداکثر میزان بزرگنمایی تصویر را برای تطبیق با پنجره در اولین بارگذاری تعیین می‌کند.
search_case_sensitive, Bool
در صورت انتخاب yes، جستجو به بزرگی و کوچکی حروف حساس خواهد بود؛ در غیر این صورت حروف نادیده گرفته می‌شوند.
incsearch, Bool
در صورت انتخاب yes، جستجو همزمان با تایپ کردن به‌صورت تدریجی انجام می‌شود.
copy_to_primary, Bool
در صورت انتخاب yes، کپی در گزینش اولیه (Primary Selection) به جای کلیپ‌بورد انجام می‌شود.
commandline_padding, Int
فاصله حاشیه داخلی (Padding) مورد استفاده در خط فرمان و نوار وضعیت.
thumb_padding, Int
فاصله حاشیه بین تصاویر بندانگشتی. نکته: علاوه بر پدینگ، فاصله ستون‌ها نیز به‌صورت پویا به‌روزرسانی می‌شود تا به بهترین شکل با عرض فعلی پنجره تطبیق یابد.
completion_height, Int
ارتفاع منوی تکمیل خودکار هنگام نمایش پیشنهادهای خط فرمان.
play_animations, Bool
در صورت انتخاب yes، تصاویر متحرک گیف پخش می‌شوند؛ در غیر این صورت روی فریم اول یا فریم جاری باقی می‌مانند.

start_show_library, Bool
در صورت انتخاب yes، کتابخانه همیشه در هنگام شروع نمایش داده می‌شود.
library_width, Int
عرض پیش‌فرض کتابخانه زمانی که تصویری باز است.
expand_lib, Bool
در صورت انتخاب yes، اگر هیچ تصویری باز نباشد، کتابخانه به‌طور خودکار به اندازه کل پنجره گسترش می‌یابد.
border_width, Int
عرض حاشیه جداکننده کتابخانه و تصویر.
markup, String
قالب نشانه‌گذاری مورد استفاده برای برجسته‌سازی نتایج جستجو. این مورد باید یک تگ بازکننده صحیح مانند <span ...> باشد زیرا با </span> بسته خواهد شد.
show_hidden, Bool
در صورت انتخاب yes، فایل‌های مخفی در کتابخانه نمایش داده شده و تصاویر مخفی باز می‌شوند.
desktop_start_dir, String
دایرکتوری که vimiv باید در صورت باز شدن از طریق فایل .desktop در آن شروع به کار کند.
file_check_amount, Int
تعداد فایل‌هایی که vimiv در یک دایرکتوری بررسی می‌کند تا مشخص شود تصویر هستند یا خیر. این مورد بر ستون اندازه دایرکتوری‌ها در کتابخانه اثر می‌گذارد. به محض رسیدن به این عدد، بررسی متوقف شده و یک علامت + افزوده می‌شود (مانند +30). عدد بزرگتر دقت و اطلاعات را به بهای کاهش سرعت افزایش می‌دهد.
tilde_in_statusbar, Bool
در صورت انتخاب yes، مسیر $HOME در نوار وضعیت بخش کتابخانه به علامت ~ خلاصه می‌شود.

autosave_images, Bool
در صورت انتخاب yes، تصاویر چرخانده‌شده یا قرینه‌شده به‌صورت خودکار بر روی دیسک ذخیره می‌شوند؛ در غیر این صورت برای حفظ تغییرات باید دستور :w به صراحت فراخوانی شود.

امکان پیکربندی نام‌های مستعار (Aliases) برای خط فرمان در این بخش فراهم شده است. یک نام مستعار در قالب زیر تعریف می‌شود:

aliasname: command

همچنین ببینید: دستور alias.

کلیدهای میانبر در فایل keys.conf تعریف می‌شوند. مشابه با vimivrc، این فایل نیز به بخش‌های مختلف تفکیک شده است:

  • IMAGE: کلیدهای تعریف‌شده در اینجا برای حالت مشاهده تصویر اعمال می‌شوند.
  • THUMBNAIL: کلیدهای تعریف‌شده در اینجا برای حالت تصاویر بندانگشتی اعمال می‌شوند.
  • LIBRARY: کلیدهای تعریف‌شده در اینجا برای حالت کتابخانه اعمال می‌شوند.
  • MANIPULATE: کلیدهای تعریف‌شده در اینجا برای حالت ویرایش و دستکاری تصویر اعمال می‌شوند.
  • COMMAND: کلیدهای تعریف‌شده در اینجا برای خط فرمان اعمال می‌شوند.

کلیدهای میانبر در قالب زیر تعریف می‌شوند:

keyname: command [arguments]

نام کلید (keyname) باید یک نماد کلید معتبر مانند "a" یا "b" یا مثلاً "colon" برای کاراکتر ":" باشد. یک ابزار کاربردی در X برای بررسی تعاملی این نام‌ها ابزار xev است.

کلیدهای تبدیل‌کننده (Modifiers) پشتیبانی‌شده عبارتند از:

  • Shift از طریق Shift+keyname
  • Control از طریق ^keyname
  • Alt از طریق Alt+keyname

بخش command [arguments] باید یک دستور معتبر vimiv به همراه آرگومان‌های صحیح باشد. برای مشاهده فهرست کامل دستورات به همراه توضیحات، مستندات دستورات را بررسی کنید.

کلیدهای ماوس نیز در همان قالب تعریف می‌شوند. کافی است از واژه "Button" و شماره متناظر با آن مانند "Button1" به عنوان keyname استفاده کنید.

accept_changes
پذیرش و تایید تغییرات اعمال‌شده در حالت دستکاری (manipulate).
alias
افزودن نام مستعار برای یک دستور.
autorotate
چرخش خودکار تمامی تصاویر در فهرست پرونده‌های جاری بر اساس داده‌های exif.
center
پیمایش به مرکز تصویر.
copy_abspath
کپی کردن مسیر مطلق فایل انتخاب‌شده جاری در کلیپ‌بورد.
copy_basename
کپی کردن نام پایه فایل انتخاب‌شده جاری در کلیپ‌بورد.
delete
حذف تصویر جاری.
discard_changes
نادیده گرفتن و لغو هرگونه تغییرات اعمال‌شده در حالت manipulate و خروج از آن.
edit
ویرایش روشنایی، کنتراست یا اشباع رنگ تصویر جاری.
first
انتقال به اولین تصویر فهرست پرونده‌ها در حالت تصویر یا بندانگشتی.
first_lib
انتقال به اولین فایل فهرست پرونده‌ها در کتابخانه.
fit
تطبیق اندازه تصویر با ابعاد پنجره جاری.
fit_horiz
تطبیق افقی اندازه تصویر با عرض پنجره جاری.
fit_vert
تطبیق عمودی اندازه تصویر با ارتفاع پنجره جاری.
flip
قرینه‌سازی و وارونه کردن تصویر جاری.
focus_library
فوکوس کردن روی کتابخانه.
format
قالب‌بندی مجدد تمامی نام‌های فایل‌های باز شده فعلی.
fullscreen
تغییر وضعیت حالت تمام‌صفحه.
last
انتقال به آخرین تصویر در فهرست پرونده‌ها در حالت تصویر یا بندانگشتی.
last_lib
انتقال به آخرین فایل فهرست پرونده‌ها در کتابخانه.
library
تغییر وضعیت نمایش کتابخانه (روشن/خاموش).
manipulate
ورود به حالت دستکاری و تنظیمات تصویر (manipulate).
mark
علامت‌گذاری تصویر انتخاب‌شده جاری.
mark_all
علامت‌گذاری تمامی تصاویر موجود در فهرست جاری.
mark_between
علامت‌گذاری تمامی تصاویر میان دو تصویر علامت‌گذاری‌شده اخیر.
mark_toggle
تغییر وضعیت علامت‌گذاری تصویر جاری.
move_up
انتقال یک شاخه به بالا در کتابخانه.
next
انتقال به تصویر بعدی در فهرست حالت تصویر.
next!
انتقال اجباری به تصویر بعدی در فهرست حالت تصویر.
prev
انتقال به تصویر قبلی در فهرست حالت تصویر.
prev!
انتقال اجباری به تصویر قبلی در فهرست حالت تصویر.
q
خروج از vimiv.
q!
خروج اجباری از vimiv.
reload_lib
بارگذاری مجدد کتابخانه.
rotate
چرخش پادساعت‌گرد تصویر.
set
تغییر مقدار یک تنظیم.
slideshow
روشن یا خاموش کردن حالت نمایش اسلاید.
tag_write
نوشتن نام تمامی تصاویر علامت‌گذاری‌شده جاری در یک فایل برچسب (tagfile).
tag_load
بارگذاری تمامی تصاویر موجود در فایل برچسب به حالت تصویر.
tag_remove
حذف یک فایل برچسب.
thumbnail
روشن یا خاموش کردن حالت تصاویر بندانگشتی.
undelete
بازگردانی یک تصویر حذف‌شده.
unfocus_library
فوکوس روی ابزارکی که قبل از کتابخانه دارای فوکوس بود.
version
نمایش پنجره بالاپرده با اطلاعات نسخه برنامه.
w
ذخیره صریح تصاویر تغییریافته بر روی دیسک.
wq
مشابه دستور :w به همراه خروج از برنامه vimiv.
zoom_in
بزرگنمایی (Zoom in).
zoom_out
کوچک‌نمایی (Zoom out).
zoom_to
تنظیم بزرگنمایی تصویر روی یک درصد مشخص.

دستورات زیر تنها می‌توانند به کلیدها اختصاص یابند و از طریق خط فرمان در دسترس نیستند:

clear_status
پاک کردن تمامی ارقام یا پیام‌ها از نوار وضعیت و بازنشانی جستجو.
command
ورود به حالت خط فرمان.
scroll
پیمایش تصویر یا نمای بندانگشتی.
scroll_lib
پیمایش کتابخانه.
search
جستجو برای متن در فهرست پرونده‌های جاری.
search_next
پیمایش به نتیجه بعدی جستجو.
search_prev
پیمایش به نتیجه قبلی جستجو.
history_down
حرکت به پایین در تاریخچه خط فرمان.
history_up
حرکت به بالا در تاریخچه خط فرمان.
discard_command
خروج از خط فرمان و نادیده گرفتن متن واردشده فعلی.
complete
شروع تکمیل خودکار خط فرمان.
complete_inverse
شروع تکمیل خودکار خط فرمان با گزینش معکوس آیتم‌ها.
slider
تغییر مقدار لغزنده (Slider) جاری که فوکوس دارد.
focus_slider
فوکوس روی یکی از لغزنده‌های دستکاری تصویر.

vimiv(1), date(1)

مه 2017 لینوکس پارچ