نام (NAME)

vimpager - جایگزینی برای less.sh با پشتیبانی از برجسته‌سازی نحو

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

vimpager 'پرونده'

یا (در این حالت همیشه هایلایت نحو به همان خوبی انجام نمی‌شود):

cat 'پرونده' | vimpager

وابستگی‌های زمان اجرا (RUN-TIME DEPENDENCIES)

•

vim

•

sharutils یا هر ابزار uudecode دیگر (اختیاری)

وابستگی‌های زمان ساخت (BUILD DEPENDENCIES)

•

sharutils یا هر ابزار uuencode دیگر

•

pandoc

نصب (INSTALL)

git clone git://github.com/rkitover/vimpager
cd vimpager
sudo make install

اگر vimpager را از بخش اسکریپت‌های vim.org دریافت کرده‌اید، فقط کافی است آن را در یکی از مسیرهای PATH خود قرار دهید، مثلاً:

cp vimpager ~/bin
chmod +x ~/bin/vimpager

در فایل ~/.bashrc خود خطوط زیر را اضافه کنید:

export PAGER=/usr/local/bin/vimpager
alias less=$PAGER
alias zless=$PAGER

توضیحات (DESCRIPTION)

یک PAGER بر پایه less.vim با پشتیبانی از هایلایت کردن صفحات راهنما (man pages) و قابلیت‌های متعدد دیگر. روی اکثر سیستم‌های شبه‌یونیکس و همچنین Cygwin و MSYS کار می‌کند.

در گیت‌هاب: http://github.com/rkitover/vimpager

برای استفاده از یک vimrc متفاوت با vimpager، تنظیمات خود را در ~/.vimpagerrc یا ~/.vim/vimpagerrc یا فایلی که متغیر محیطی VIMPAGER_RC به آن اشاره می‌کند قرار دهید.

شما همچنین می‌توانید یک فایل پیکربندی سراسری برای تمام کاربران در /etc/vimpagerrc داشته باشید، که کاربران می‌توانند با ایجاد ~/.vimpagerrc یا ~/.vim/vimpagerrc آن را بازنویسی (override) کنند.

کلیدهای زیر برای پیمایش صفحات در vimpager به کار می‌روند که در بیشتر موارد مشابه less هستند:

برای غیرفعال کردن بارگذاری افزونه‌ها، عبارت "set noloadplugins" را در فایل vimpagerrc قرار دهید.

همچنین می‌توانید متغیر "vimpager" را در vimrc خود فعال کنید تا تنظیمات جایگزین را برای vimpager اعمال نمایید.

اگر می‌خواهید از gvim یا MacVim برای پنجره پیجر خود استفاده کنید، خط زیر را در .vimrc/.vimpagerrc قرار دهید:

let vimpager_use_gvim = 1

برای خاموش کردن قابلیت عبور مستقیم (passthrough) متن‌هایی که از ارتفاع ترمینال کوچک‌ترند، از این دستور استفاده کنید:

let vimpager_passthrough = 0

بخش "حالت عبور مستقیم (PASSTHROUGH MODE)" را در ادامه مشاهده کنید.

برای شروع ویم با گزینه -X (عدم اتصال به x11، شروع کمی سریع‌تر) خط زیر را در .vimrc/.vimpagerrc خود بگذارید:

let vimpager_disable_x11 = 1

میزان فاصله اسکرول (:help scrolloff) را می‌توان با قرار دادن خط زیر در .vimrc/.vimpagerrc مشخص کرد (پیش‌فرض = 5، غیرفعال = 0):

let vimpager_scrolloff = 5

درخت فرآیندهای vimpager در متغیر "vimpager_ptree" در دسترس است؛ نمونه‌ای از کاربرد آن به شکل زیر است:

if exists("vimpager")
  if exists("vimpager_ptree") && vimpager_ptree[-2] == 'wman'
    set ft=man
  endif
endif

برای غیرفعال کردن استفاده از AnsiEsc.vim جهت نمایش رنگ‌های ANSI در سورس، این متغیر را تنظیم کنید:

let vimpager_disable_ansiesc = 1

برای جزئیات بیشتر بخش "دنباله‌های اسکیپ ANSI و چاپ مجدد" را ببینید.

گزینه‌های خط فرمان (COMMAND LINE OPTIONS)

دنباله‌های اسکیپ ANSI و چاپ مجدد (ANSI ESCAPE SEQUENCES AND OVERSTRIKES)

اگر منبع شما از کدهای اسکیپ ANSI استفاده می‌کند، افزونه AnsiEsc برای نمایش آن‌ها به جای هایلایت معمولی ویم استفاده خواهد شد، هرچند نکات زیر را در نظر داشته باشید. اگر این کار ممکن نباشد، کدها حذف شده و به جای آن هایلایت معمولی ویم به کار می‌رود.

چاپ‌های مجدد (Overstrikes) مانند آنچه در صفحات مان دیده می‌شود، همیشه حذف خواهند شد.

برنامه vimpager افزونه AnsiEsc (http://www.vim.org/scripts/script.php?script_id=4979) را به همراه دارد (در زمان اجرا باز می‌شود و نیازی به فعال‌سازی دستی نیست).

با این حال، ویم شما باید با ویژگی 'conceal' کامپایل شده باشد. برای بررسی، دستور زیر را امتحان کنید:

:echo has("conceal")

اگر نتیجه '1' باشد قابلیت conceal را دارید، و اگر '0' باشد آن را ندارید و افزونه AnsiEsc فعال نخواهد شد.

اگر روی سیستم‌عامل مک هستید، نسخه ویم پیش‌فرض سیستم این ویژگی را ندارد؛ ویم را از طریق Homebrew نصب کنید.

برای غیرفعال کردن استفاده از AnsiEsc.vim، خط زیر را تنظیم کنید:

let vimpager_disable_ansiesc = 1

در فایل .vimrc خود.

حالت عبور مستقیم (PASSTHROUGH MODE)

اگر متن ارسالی به پیجر کوچک‌تر از اندازه پنجره ترمینال باشد، بدون ویم و به صورت متن عادی نمایش داده می‌شود. اگر دارای کدهای ansi باشد حفظ می‌شوند، در غیر این صورت با vimcat هایلایت می‌گردد.

می‌توانید این قابلیت را با قرار دادن خط زیر غیرفعال کنید:

let vimpager_passthrough = 0

حالت عبور مستقیم نیازمند یک پوسته استاندارد POSIX با پشتیبانی از بسط محاسباتی است.

نکات CYGWIN/MSYS/MSYS2

برنامه vimpager با نسخه بومی Windows gvim به درستی کار می‌کند؛ کافی است آن را در PATH خود قرار داده و گزینه vimpager_use_gvim را همان‌طور که در بالا توضیح داده شد تنظیم کنید.

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

Rafael Kitover <rkitover@gmail.com>.