نام (NAME)

nvim — ویرایش متن - ویرایشگر نئو‌ویم، نسل جدید ویم

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

nvim [options] [file ...] nvim [options] - nvim [options] -t tag nvim [options] -q [errorfile]

توضیحات (DESCRIPTION)

nvim یک ویرایشگر متن بر پایه ویم (Vim) است. برای اجرای nvim می‌توانید آن را همراه با هر تعداد گزینه و/یا فایل اجرا کنید:

دستورات در nvim با دونقطه (‘:’) آغاز می‌شوند. عبارت “:help موضوع” را تایپ کنید تا راهنمای موضوع مورد نظر نمایش داده شود. از کلید <Tab> و CTRL-D برای تکمیل خودکار موضوعات راهنما استفاده کنید (“:help cmdline-completion”).

بخش راهنمای “quickref” یک مرجع فشرده و سریع از امکانات ویرایشگر است:

اگر در کار با ویم یا نئو‌ویم تازه‌کار هستید، آموزش ۳۰ دقیقه‌ای تعاملی را آغاز کنید:

پس از نصب یا به‌روزرسانی نئو‌ویم، اجرای بررسی خودکار سلامت سیستم پیشنهاد می‌شود:

file ...

فایل یا فایل‌ها برای ویرایش. برای هر فایل یک بافر باز می‌شود. برای جابه‌جایی میان بافرها، از دستورات :next و :previous استفاده کنید.

-

متن را از ورودی استاندارد (stdin) تا رسیدن به EOF می‌خواند، سپس یک بافر با آن متن باز می‌کند. ورودی کاربر از خروجی خطای استاندارد (stderr) که باید یک ترمینال باشد خوانده می‌شود.

گزینه‌ها (OPTIONS)

-t tag

برچسب tag را در فایل tags می‌یابد، فایل مربوطه به عنوان فایل جاری باز شده و دستور مرتبط اجرا می‌شود. مکان‌نما در موقعیت برچسب در فایل قرار می‌گیرد. :help tag-commands

-q [errorfile]

حالت رفع سریع خطا (QuickFix). اولین خطا را در errorfile نمایش می‌دهد. اگر errorfile مشخص نشود، از مقدار گزینه 'errorfile' استفاده می‌شود (پیش‌فرض errors.err است). خطاهای بعدی با دستور :cnext قابل پیمایش هستند. :help quickfix

--

پایان گزینه‌ها. آرگومان‌های بعدی به عنوان نام فایل حقیقی در نظر گرفته می‌شوند، حتی اگر با خط تیره (‘-’) شروع شوند.

-e

حالت Ex، خواندن ورودی استاندارد به عنوان دستورات Ex. :help Ex-mode

-E

حالت Ex، خواندن ورودی استاندارد به عنوان متن ساده. :help Ex-mode

-es

حالت غیرتعاملی و خاموش Ex، خواندن stdin به عنوان دستورات Ex. برای اسکریپت‌نویسی بسیار مفید است زیرا برعکس -e هیچ رابط کاربری (UI) را راه‌اندازی نمی‌کند. :help silent-mode

-Es

حالت غیرتعاملی و خاموش Ex، خواندن stdin به عنوان متن ساده. برای اسکریپت‌نویسی مناسب است زیرا برعکس -E هیچ رابط کاربری را راه‌اندازی نمی‌کند. :help silent-mode

-d

حالت مقایسه تفاوت‌ها (Diff mode). تفاوت میان دو تا هشت فایل را نمایش می‌دهد، مشابه با sdiff(1). :help diff

-R

حالت فقط‌خواندنی (Read-only). گزینه 'readonly' را فعال می‌کند. به معنای اعمال -n نیز هست. بافرها قابل ویرایش هستند، اما در صورتی که به فایلی متصل باشند نمی‌توان آن‌ها را روی دیسک نوشت مگر با افزودن علامت تعجب به دستورات Ex، مانند :w!. :help 'readonly'

-m

غیرفعال کردن ذخیره تغییرات روی فایل‌ها با بازنشانی گزینه 'write'. نوشتن روی فایل غیرفعال می‌شود اما ویرایش بافرها همچنان ممکن است.

-M

غیرفعال کردن هرگونه تغییر. گزینه‌های 'write' و 'modifiable' را غیرفعال می‌کند تا امکان تغییر فایل و بافر سلب شود.

-b

حالت باینری برای ویرایش فایل‌های باینری و اجرایی. :help edit-binary

-A

حالت عربی. گزینه 'arabic' را فعال می‌کند.

-H

حالت عبری. گزینه‌های 'hkmap' و 'rightleft' را فعال می‌کند.

-V[N][file]

حالت پرگویی (Verbose). پیام‌های اشکال‌زدایی را چاپ می‌کند. N سطح پرگویی است که پیش‌فرض آن 10 است. در صورت مشخص شدن file ، پیام‌ها به جای چاپ روی صفحه در فایل file ذخیره می‌شوند. :help 'verbose'

-D

حالت اشکال‌زدایی اسکریپت‌های ویم (Vimscript debug mode). هنگام اجرای اولین دستور از یک اسکریپت فعال می‌شود. :help debug-mode

-n

غیرفعال کردن استفاده از فایل‌های مبادله (Swap files). مقدار گزینه 'updatecount' را روی 0 تنظیم می‌کند. برای ویرایش فایل‌ها روی رسانه‌های ذخیره‌سازی کند مفید است.

-r [file]

حالت بازیابی (Recovery mode). اگر file مشخص نشود، فهرستی از فایل‌های سواپ همراه با اطلاعات بازیابی ارائه می‌دهد. در غیر این صورت فایل سواپ file برای بازیابی یک نشست کاری متوقف‌شده استفاده می‌شود. :help recovery

-L [file]

نام مستعار برای -r.

-u vimrc

استفاده از فایل vimrc به جای مسیر پیش‌فرض ~/.config/nvim/init.vim. اگر مقدار vimrc برابر NORC باشد، هیچ فایل پیکربندی اولیه‌ای (به جز افزونه‌ها) بارگذاری نمی‌شود. اگر مقدار برابر NONE باشد، بارگذاری افزونه‌ها نیز لغو می‌گردد. :help initialization

-i shada

استفاده از shada به جای مسیر پیش‌فرض ~/.local/state/nvim/shada/main.shada. اگر مقدار برابر NONE باشد، خواندن و نوشتن فایل ShaDa انجام نمی‌شود. :help shada

--noplugin

جلوگیری از بارگذاری افزونه‌ها. توسط -u NONE نیز اعمال می‌شود.

--clean

اجرای نئو‌ویم با تنظیمات اولیه کارخانه (تنها افزونه‌های داخلی، بدون کانفیگ کاربر و بدون shada). :help --clean

-o[N]

باز کردن N پنجره افقی روی هم. در صورت حذف N ، برای هر فایل یک پنجره باز می‌شود.

-O[N]

مشابه با -o -، اما پنجره‌ها را به صورت عمودی در کنار هم می‌چیند.

-p[N]

مشابه با -o -، اما برای برگه‌ها (Tabs).

+[linenum]

برای اولین فایل، مکان‌نما را روی شماره خط linenum قرار می‌دهد. در صورت عدم تعیین شماره خط، مکان‌نما روی آخرین خط قرار می‌گیرد.

+/[pattern]

برای اولین فایل، مکان‌نما را روی اولین تطابق الگوی pattern قرار می‌دهد.

+command, -c command

اجرای command پس از خواندن اولین فایل. تا ۱۰ دستور مجاز است.

--cmd command

مشابه با -c -، اما دستور را پیش از پردازش هر فایل vimrc اجرا می‌کند.

-l script [args]

اجرای اسکریپت لوآ script همراه با آرگومان‌های اختیاری [args].

-S [session]

اجرای فایل نشست session پس از خواندن اولین فایل.

-s scriptin

خواندن دستورات حالت عادی از فایل scriptin.

-w scriptout

ثبت تمام کلیدهای فشرده‌شده در فایل scriptout.

-W scriptout

مشابه -w -، اما فایل موجود را رونویسی (truncate) می‌کند.

--startuptime file

ثبت زمان‌بندی پیام‌های آغاز به کار در file برای ریشه‌یابی کندی اجرای اولیه.

--api-info

چاپ متادیتای API به صورت سریال‌شده با msgpack و خروج.

--embed

استفاده از stdin و stdout به عنوان کانال ارتباطی msgpack-rpc.

--headless

اجرا بدون محیط کاربری تصویری (Headless).

--listen address

راه‌اندازی سرور RPC روی این سوکت TCP یا پایپ.

-h, --help

چاپ اطلاعات راهنما و خروج.

-v, --version

چاپ اطلاعات نسخه و خروج.

محیط (ENVIRONMENT)

NVIM_APPNAME

نام زیرپوشه‌های استفاده‌شده در هر دایرکتوری کاربری XDG (پیش‌فرض nvim است).

NVIM_LOG_FILE

مسیر فایل لاگ سطح پایین، معمولاً در ~/.local/state/nvim/nvim.log.

VIM

جهت تعیین مسیر فایل‌های کاربر مانند init.vim.

VIMRUNTIME

جهت تعیین مسیر فایل‌های زمان اجرا (مستندات، هایلایت نحو و...).

XDG_CONFIG_HOME

مسیر دایرکتوری محلی پیکربندی کاربر (پیش‌فرض ~/.config است).

XDG_STATE_HOME

مسیر نگهداری داده‌های وضعیتی نئو‌ویم مانند swap، پشتیبان و فایلهای ShaDa (پیش‌فرض ~/.local/state است).

XDG_DATA_HOME

مسیر ذخیره‌سازی فایل‌های زمان اجرای نئو‌ویم (پیش‌فرض ~/.local/share است).

VIMINIT

دستورات Ex که باید هنگام راه‌اندازی اولیه اجرا شوند.

SHELL

پوسته پیش‌فرضی که برای ویژگی‌هایی مانند :terminal و :! استفاده می‌شود.

فایل‌ها (FILES)

~/.config/nvim/init.lua

فایل پیکربندی کاربر نئو‌ویم با زبان Lua.

~/.config/nvim

دایرکتوری پیکربندی کاربر نئو‌ویم.

$VIM/sysinit.vim

فایل پیکربندی سراسری سیستم نئو‌ویم.

$VIM

دایرکتوری زمان اجرای سراسری نئو‌ویم.

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

نئو‌ویم توسط Thiago de Arruda پایه‌گذاری شد. بخش عمده ویم توسط Bram Moolenaar نوشته شده است. ویم بر اساس Stevie توسعه یافته که توسط Tim Thompson و Tony Andrews و G.R. (Fred) Walter طراحی شده بود. به ":help credits" مراجعه نمایید.