vimpersian.github.io

KO | EN

gitlite — search

#python #hacktoberfest #ai #rust #linux #java #windows #awesome #cli #awesome-list #security #mcp #openai #open-source

vimpersian.github.io

(★ 17)

راهتمای ادیتور ویم برای پارسی زبانان

vimpersian.github.io Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center"><h1> Hello Vim World!</h1></div>

<div dir="rtl">
ویم‌، یک ادیتور مودال است. به این معنی که در ویم، ما مود‌های مختلف جهت انجام کارهای مختلف داریم. مد عادی ویم، یا همان نرمال مود، حالتی است که در آن ما درون فایل حرکت می‌کنیم، متن را جستجو می‌کنیم یا ویرایش‌های جزئی انجام می‌دهیم. 
<br><br>

برای وارد کردن متن از مود وردی یا اینسرت مود استفاده می‌کنیم و برای انتخاب و ویرایش‌های بزرگ‌تر از مود ویژوآل، و برای اجرای دستورات خط فرمان ویم یا خط فرمان پوسته، از مود دستوری یا کامند مود استفاده می‌کنیم.

دانستن اینکه ویم فراتر از یک ادیتور است و درواقع یک زبان برای ویرایش متن و کد است در ابتدای کار حیاتی است. 
در ویم هر کلید کیبورد در مود نرمال به یک کنش یا اکشن اختصاص دارد. مدل ویرایش در ویم این صورت است که ما مدام در بین مودهای مختلف در حال حرکت هستیم و این سرعتی باور نکردنی در پیمایش متن و ویرایش آن به ما می‌دهد.
<br><br>

ویم دارای گرامر بخصوصی است که آن‌را می‌توان به COM خلاصه کرد.
</div>

- count (شمارش)
- operation (عملیات)
- motion (جهت)

<div dir="rtl">
تمام دستورات ویم می‌توانند با یک عدد پیش از آن‌ها، به تعداد آن عدد انجام شوند. همچنین تمام دستورات ویم نیز می‌توانند در جهت خاصی مانند ،چپ، راست، تا آخر خط، تا آخر کلمه، تا آخر پاراگراف ، تا اولین خط خالی و ... انجام شوند.
<br><br>
در ویم یا وی‌آی، ما می‌توانیم با تنها یک کلید ، در متن حرکت کنیم. این حرکت‌ها به کلمات، گروهی از حروف ، اعداد، تک حرف ، توکن‌ها یا خط ‌ها باشند.
در منطق ویم، یک کلمه می‌تواند گروهی از حروف ، اعداد و  سمبل‌ها باشد. از طرفی دیگر یک توکن، هر آنچه که با فضای سفید، (اسپیس)  جدا شده باشد تلقی می‌شود.
<br><br>
<strong style="color:red">
این راهنما باید بعد از انجام کامل vimtutor خوانده شود.
</strong>
<br>
<small> در ترمینال عبارت <code>vimtutor</code> را وارد کنید و درس‌ها را انجام دهید.
اگر با زبان انگلیسی آن راحت نیستید، این پلی‌لیست را در یوتوب ببینید.
</small>
</div>
<br>

<div align="center">
<iframe width="560" height="315" src="https://www.youtube.com/embed/1MQuSZzjvMA?si=hfl-ZmyHKMjRm7FE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
</div>
<br>
<div dir="rtl">در این پلی‌لیست تمامی درس‌های <code>vimtutor</code>
به‌علاوه‌ی درس‌هایی در باره نصب پلاگین و شخصی سازی ویم، قرار
گرفته است.<br>  اگرچه بیشتر اطلاعات داخل <code>vimtutor</code> در این سایت پوشش داده
می‌شود، فرض بر آن است که مخاطب <code>vimtutor</code> را گذرانده است. مرحله اول یادگیری
ویم، همیشه و همه‌جا <code>vimtutor</code> است.</div>
<br>
<hr>

<div dir="rtl" style="margin-right: 5px;">
<ol style="list-style-type: persian;">
<li><a href="#moving">حرکت در فایل</a></li>
<li><a href="#moving2">حرکت با حروف، کلمه یا توکن</a></li>
<li><a href="#moving3">حرکت با خطوط</a></li>
<li><a href="#moving4">حرکت  به وسیله صفحه</a></li>
<li><a href="#ins">وارد کردن متن</a></li>
<li><a href="#edt"> ویرایش متن</a></li>
<li><a href="#xyp">کات کپی و جایگذاری</a></li>
<li><a href="#vis">حالت ویژوال</a></li>
<li><a href="#ind"> ایندنت</a></li>
<li><a href="#srch"> جستجو در متن</a></li>
<li><a href="#wq"> ذخیره کردن و خروج از فایل</a></li>
<li><a href="#multi">  کار کردن با بیش از یک فایل</a></li>
<li><a href="#mark"> مارک‌ها و پرش‌ها</a></li>
<li><a href="#macro">ماکرو</a></li>
<li><a href="#colo"> فعال کردن تم‌ها در ویم</a></li>
<li><a href="#s">دستورات جایگزینی متن </a></li>
<li><a href="#sflags">فلگ های مرسوم برای دستورات جایگزینی</a></li>
<li><a href="#larg">آرگومان های خط فرمان</a></li>
<li><a href="#parsi-1">کارکردن با نوشتار پارسی در ویم</a></li>
<li><a href="#parsi-2">نکاتی درمورد ترمینال</a></li>
<li><a href="#parsi-3">فونت‌های مناسب برای هر دو نوشتار پارسی و انگلیسی </a></li>
<li><a href="#zwnj">نیم فاصله</a></li>
<li><a href="#vimrc">ذخیره‌سازی تنظیمات در فایل ویم‌آرسی</a></li>
<li><a href="#vimplug">نصب پلاگین با استفاده از ویم‌پلاگ</a></li>
<li><a href="#pluginlist"> چند پلاگین مفید برای ویم</a></li>
<li><a href="#spellcheck">چک کردن املای کلمات</a></li>
</ol>
</div>
<ul>
<li><a href="#update">آخرین آپدیت</a></li>
</ul>
 
<hr>
<div dir="rtl"><h1 id="moving">حرکت در فایل</h1></div>
<div dir="rtl"><h2 id="moving2">حرکت با حروف، کلمه یا توکن</h2></div>

<div dir="rtl">کلید‌های اساسی حرکت در ویم این‌ها هستند:</div>

-   **`h`** -- حرکت نشانگر به چپ
-   **`j`** -- حرکت نشانگر به پایین
-   **`k`** -- حرکت نشانگر به بالا
-   **`l`** -- حرکت نشانگر به راست
<br>

<div dir="rtl">
این کلید‌ها را می‌توان با یک شمارش همراه کرد تا به توان همان عدد انجام شوند
</div>

-  **`5j`**  پنج خط به پایین می‌رود
<br>

-   **`b`** -- حرکت به اول یک کلمه
-   **`B`** -- حرکت به اول یک توکن
-   **`w`** -- حرکت به اول کلمه‌ی بعد
-   **`W`** -- حرکت به اول توکن بعد
-   **`e`** -- حرکت به آخر کلمه
-   **`E`** -- حرکت به آخر توکن

<br>

برای  پرش به  پرانتز بسته،  گیومه بسته  و غیره از  **`%`** استفاده کنید
</div>

**`:h matchpairs`**
<br>

-   **`0 \ zero`**  -- حرکت به اول خط فعلی
-   **`$ \ dollar sign`** -- حرکت به آخر خط فعلی
-   **`^ \ caret sign`** -- حرکت به اولین  کاراکتر موجود در خط
-   **`#G`** / **`#gg`** / **`:#`** حرکت به شماره خط مشخص، (شماره خط جایگزین هشتگ شود)

<br>
<div dir="rtl">برای استفاده از این قابلیت، شماره خطوط را فعال کنید.</div>

```
:set number
```
<br>

<div dir="rtl"><h1 id="moving4">  حرکت  به وسیله صفحه</h1></div>
دستورهای زیر برای اسکرول کردن سریع در فایل کاربرد دارند.

-   **`Ctrl + b`** -- یک صفحه کامل به عقب رفتن
-   **`Ctrl + f`** -- یک صفحه کامل به جلو رفتن
-   **`Ctrl + d`** -- نصف صفحه جلو‌ رفتن
-   **`Ctrl + u`** -- نصف صفحه عقب رفتن
-   **`Ctrl + e`** -- صفحه را بدون حرکت دادن نشانگر یک خط پایین‌تر بردن
-   **`Ctrl + y`** --  صفحه را بدون حرکت دادن نشانگر یک خط بالاتر بردن
-   **`Ctrl + o`** -- به عقب رفتن در تاریخچه‌ی پرش ها. برای حرکت بین فایل‌ها و بافرها هم کاربرد دار
-   **`Ctrl + i`** -- برعکس دستور بالا

<br>

-   **`H`** -- حرکت به بالای صفحه
-   **`M`** -- حرکت به وسط صفحه
-   **`L`** -- حرکت به پایین صفحه

-   **`i`** -- وارد شدن به حالت ورود متن
-   **`I`** -- وارد کردن متن در اول خط
-   **`a`** -- سوییچ کردن به حالت ورود متن بعد از نشانگر
-   **`A`** -- وارد کردن متن در آخر خط
-   **`o`** -- باز کردن یک خط جدید زیر خط فعلی
-   **`O`** -- باز کردن خط جدید بالای خط فعلی
-   **`ea`** -- وارد کردن متن در آخر کلمه
-   **`Esc`** -- خارج شدن از حالت ورود متن و برگشنن به حالت نرمال
<br>

<div dir="rtl"><h1 id="edt">  ویرایش متن</h1></div>

-   **`r`** -- جایگزین کردن یک کاراکتر و بازگشت به حالت نرمال
-   **`cc`** -- جایگزین کردن کل خط (خط را پاک می‌کند و به خالت ورود متن می‌رود)
-   **`C`** / **`c$`** -- جایگزین کردن متن از مکان نشانگر تا آخر خط
-   **`cw`** -- جایگزین کردن تا آخر کلمه
-   **`s`** -- جایگزین کردن یک کاراکتر و رفتن به حالت ورود متن
-   **`J`** -- ادغام خط فعلی و خط زیر آن با یک اسپیس فاصله
-   **`gJ`** -- ادغام خط فعلی با خط زیر آن بدون اسپیس
-   **`u`** -- undo 
-   **`Ctrl`** + **`r`** -- redo
-   **`.`** -- تکرار آخرین دستور
<br>

<div dir="rtl"><h1 id="xyp">   کات کپی و جایگذاری</h1></div>

-   **`yy`** -- کپی کردن کامل خط فعلی
-   **`#yy`** -- کپی کردن تعداد مشخصی از خطوط
-   **`dd`** -- کات کردن کل خط
-   **`#dd`** -- کات کردن تعداد مشخصی از خطوط
-   **`p`** -- جایگذاری بعد از نشانگر
-   **`P`** -- جایگذاری قبل از نشانگر

<br>

<div dir="rtl">
<h1 id="ind"> ایندنت</h1>
برای ایندنت کردن در حالت نرمال از کلید های زیر استفاده می کنیم:
</div>

- `>>`
- `<<`

<div dir="rtl">برای ایندنت کردن در حالت اینسرت از کلید های زیر استفاده می کنیم:</div>

- `Ctrl+t` 
- `Ctrl+d`

<div dir="rtl">کنترل و تی، متن را رو به جلو ایندنت می کند و کنترل و دی رو به عقب</div>

<div dir="rtl"><h1 id="vis">  حالت ویژوال</h1>

به غیر از حالت ورود متن (insert mode) و حالت نرمال (normal mode) و حالت دستوری (command mode)، حالت دیگری نیز به نام حالت ویژوال (visual mode) وجود دارد. از این مود برای انتخاب و ویرایش و انجام عملیات‌های مختلف بر روی بخش‌های بزرگ‌تری از متن استفاده می‌شود

ویژوال مود سه حالت کلی دارد.

- حالت کاراکتری
- حالت خطی
- حالت بلاک

</div>

```
character mode, line mode, and block mode
```
<br>

-   **`v`** -- انتخاب متن در حالت کاراکتری
-   **`V`** -- انتخاب متن در حالت خطی
-   **`Ctrl`**+**`v`** -- انتخاب متن در حالت بلاک

پس از فعال‌سازی یکی از حالت‌ها، با استفاده از کلید‌های جهت متن را انتخاب کنید.
<br>

-   **`o`** -- حرکت از ابتدای متن انتخاب شده به آخر آن
-   **`aw`** -- انتخاب یک کلمه
-   **`ab`** -- انتخاب یک بلاک کد که در بین پرانتز است
-   **`aB`** -- انتخاب یک بلاک کد که در بین آکولاد است {}
-   **`at`** -- انتخاب یک بلاک کد که در بین تگ است \<\>
-   **`ib`** -- انتخاب قسمت داخلی یک بلاک کد که بین پرانتز است
-   **`iB`** - انتخاب قسمت داخلی یک بلاک کد که بین آکولاد است {}
-   **`it`** -- انتخاب قسمت داخلی یک بلاک کد که بین یک تگ است \<\>

<div dir="rtl">پس از انتخاب متن مورد نظر می‌توانید عملیات‌های مختلف را به وسیله‌ی کلید‌های زیر انجام دهید.</div>

-   **`y`** -- کپی
-   **`d`** -- کات
-   **`p`** -- جایگذازی
    <br>
<div dir="rtl"><h1 id="srch"> جستجو در متن</h1></div>

-   **`* \ asterisk`** -- رفتن به وقوع بعدی از کلمه‌ی زیر نشانگر
-   **`# \ pound sign`** -- رفتن به وقوع قبلی از کلمه‌ی زیر نشانگر
-   **`/pattern`** --جستجوی یک الگوی مشخص در فایل 
-   **`?pattern`** -- جستجوی یک الگوی مشخص از مکان فعلی تا اول متن
-   **`n`** -- پرش به وقوع بعدی الگوی یافت شده
-   **`N`** -- پرش به وقوع قبلی الگوی یافت شده

<br>

<div dir="rtl"><h1 id="wq"> ذخیره کردن و خروج از فایل</h1></div>

-   **`:w`** -- ذخیره کردن
-   **`:wq`** / **`:x`** / **`ZZ`** -- ذخیر کردن و خروج از ویم
-   **`:q`** -- خروج
-   **`:q!`**/ **`ZQ`** -- خروج بدون ذخیره کردن تغییرات
-   **`:w new_file_name `**-- ذخیره کردن تحت نامی جدید و ادامه دادن به ویرایش فایل اصلی
-   **`:sav`** -- ذخیره کردن تحت نامی جدید و ادامه‌ دادن به ویرایش فایل کپی شده
-   **`:w !sudo tee %`** -- ذخیره کردن فایل به‌وسیله‌ی سودو و تی، مناسب وقتی که فایلی را بدون دسترسی سودو باز کرده‌ایم [tee](https://wiki.archlinux.org/title/Tee)
    <br>

-   **`:e file_name `** -- باز کردن فایل در یک بافر جدید
-   **`:bn `** -- رقتن به بافر بعدی
-   **`:bp`** -- بازگشت به بافر قبلی
-   **`:bd `** -- بستن بافر
-   **`:b# `** -- رفتن به بافر با عدد شناسایی مشخص
-   **`:b file_name`** -- رفتن به بافر با نام مشخص
-   **`:ls`** -- لیست کردن تمام بافر باز ( شناسه‌ی عددی هر بافر کنار نام آن ظاهر خواهد شد)

<br>

-   **`:sp file_name `** -- باز کردن یک فایل در یک اسپلیت افقی
-   **`:vs file_name `** --باز کردن یک فایل در یک اسپلیت عمودی
-   **`:vert ba `** -- باز کردن همه‌ی بافر های فعلی در اسپلیت‌های عمودی
-   **`:tab ba `** -- ویرایش تمام بافر‌ها به‌وسیله تب‌
-   **`gt`** -- رفتن به تب بعدی
-   **`gT`** -- رفتن به تب قبلی

-   **`Ctrl+w s`** -- اسپلیت کردن صفحه به صورت افقی
-   **`Ctrl+w v`** -- اسپلیت کردن صفحه به صورت عمودی
-   **`Ctrl+w w`** -- سوییچ کردن بین اسپلیت ها (مشابه alt + tab)
-   **`Ctrl+w q`** -- بستن اسپلیت ها
-   **`Ctrl+w x`** -- جابجا کردن اسپلیت ‌ها با یگدیگر
-   **`Ctrl+w +/-`** -- تغییر اندازه‌ی اسپلیت عمودی
-   **`Ctrl+w >/<`** -- تغییر اندازه‌ی اسپلیت  افقی
-   **`Ctrl+w =`** -- برابر کردن طول و عرض تمام اسپلیت‌ها

<br>

-   **`m[a-z]`** -- مارک کردن موقعیت فعلی به‌وسیله‌ی حروف الفبا 
-   **`M[a-z]`** -- مارک کردن خط فعلی به‌وسیله‌ی خطوط الفبا 
-   **`` `a ``** - پرش به موقعیتی که با حرف آ مارک شده **`a`**
-   **`` `. ``** -- پرش به آخرین تغییر در فایل 
-   **`` `0 ``** -- پرش به آخرین موقعیت فایل قبل از بسته شدن ویم
-   **``` `` ```** -- پرش به آخرین پرش
-   **`:marks`** -- لیست کردن همه‌ی مارک ها
-   **`:jumps`** -- لیست کردن همه‌ی پرش ‌ها
-   **`:changes`** لیست کردن همه‌ی‌ تغییرات
-   **`Ctrl+o`** -- رفتن به پرش قبلی
-   **`Ctrl+i`** -- رفتن به پرش بعدی
-   **`g;`** -- رفتن به تغییر قبلی در لیست تغییرات
-   **`g,`** -- رفتن به نغییر بعدی در لیست تغییرات

<div dir="rtl"><h1 id="macro">  ماکرو</h1></div>
<div dir="rtl">برای دستور ها یا ویرایش های تکرار شونده در ویم میتوان از ماکروها استفاده کرد.
برای ضبط یک ماکرو ابتدا کلید q و سپس نام رجیستری که می‌خواهیم ماکرو در آن ضبط شود را وارد می‌کنیم، بدین ترتیب می‌توانیم چندین ماکرو بصورت همزمان داشته باشیم. در این مثال از رجیستر a استفاده شده است.
</div>

-   **`qa `** -- ضبط کردن یک ماکرو **`a`**
-   **`q `** -- توقف ضبط یک ماکرو 
-   **`@a `** -- اجرا کردن ماکرو **`a`**
-   **`@@ `** -- اجرای دوباره‌ی ماکرو

<div dir="rtl">برای مثال اگر محتوای زیر را داشته باشیم:</div>

```
aaa
bbb
ccc
ddd
```
<div dir="rtl">و بخواهیم در آخر هر خط یک کاراکتر وارد کنیم، برای مثال  حرف x، می توانیم ماکرو زیر را ضبط کنیم.</div>

```
Ax<ESC>j

با در نظر گرفتن کلید ضبط و پایان ضبط ماکرو

qAx<ESC>jq
```
<div dir="rtl">در اینجا با استفاده از اپراتور A، به آخر خط رفته و وارد مود ورود متن یا همان اینسرت مود می شویم. حرف x را تایپ کرده و با زدن کلید اسکیپ به مود نرمال بر می گردیم و در آخر با زدن کلید j به خط پایین می رویم تا ماکرو بتواند ادامه پیدا کند.
همان‌طور که پیش‌تر گفتیم، همه‌چیز در ویم شمارش پذیر یا توان پذیر هستند. بنابراین برای اجرای یک ماکرو به توان عدد خاصی، آن عدد را قبل از فراخوانی ماکرو وارد می‌کنیم.
</div>
<br>

```
10@a 
ماکروی ضبط شده در رجیستر را به تعداد ده بار اجرا می‌کند
```

-   **`:colorscheme [colorscheme_name] `** -- تغییر تم رنگی
-   **`:colorscheme [space]+Ctrl+d`** -- لیست کردن تمام تم های رنگی موجود

- retrobox
- lunaperche
- elflord
- slate

<div dir="rtl">با استفاده از دستور زیر نیز می‌توان رنگ زمینه پیش‌فرض ویم را به روشن یا تاریک تغییر داد:</div>
<br>

```
:set background=dark
:set background=light
```
<div dir="rtl">برای استفاده بهتر  از رنگ ها و همچنین فعال سازی سینتکس، از دستور زیر استفاده می کنیم:</div>
<br>

```
:syntax on
```
<div dir="rtl">بعدها شیوه ذخیره کردن این تنظیمات در ویم را خواهیم آموخت.</div>

<div dir="rtl"><h1 id="s">دستورات جایگزینی متن </h1>
یکی از قابلیت‌های قدرتمند ویم، دارا بودن یک نوع فرمان SED داخلی است. این فرمان که در ویم معمولاً substitute خوانده می‌شود، ابزار بسیار پیشرفته‌ای برای یافتن و ویرایش متن به وسیله‌ی الگو‌های رجکس است.
با استفاده از این دستور، کاربر ویم می‌تواند ویرایش‌های عظیم و پیچیده‌ای را روی فایل‌ها اعمال کند. عملیات‌های طولانی و طاقت فرسای اصلاح متنی طولانی با استفاده صحیح از این دستور به آسانی صحبت کردن با بهترین دوستتان می‌شوند.

برای مثال, یک فایل html با محتوای زیر داریم.
</div>

<div align="center">
<h1> Quote of the day</h1>
<h2> Shopenhauer</h2>

"The majority of men... are not capable of thinking, but only of believing, and... are not accessible to reason, but only to authority." <br>

(Arthur Shopenhauer)
</div>

<div dir="rtl">
فرض می‌کنیم که این بخشی از یک مقاله دانشگاهی یا پستی برای یک وبلاگ است. همچنین فرض می‌کنیم که ما نام آرتور شوپنهاور را از اول این فایل اشتباه تایپ کرده‌ایم. به‌جای Sch برای صدای ش در آلمانی از Sh در انگلیسی استفاده کرده‌ایم. حالا ساعت‌ها کار ما بخاطر این اشتباه غیرقابل ارائه است.

برای حل این مشکل از یک دستور جایگزینی ساده استفاده می‌کنیم.
</div>

```
:%s/Shopenhauer/Schopenhauer/g
```

<div dir="rtl">اجازه بدهید دستور را خرد کنیم.</div>
<br>

- % همیشه اشاره به فایل فعلی در ویم دارد، اینجا یعنی در این فایل بگرد
- s شروع دستور جستجو و جایگزینی همیشه با این حرف است. به معنی substitute 
- /الگوی هدف/
- /الگوی مقصد/
- g انجام عملیات برای تمامی مچ‌ها

<div dir="rtl"><h5>نکته </h5></div>
<div dir="rtl"><div style="color:yellow;"><strong>در ویم نقطه . اشاره به خط زیر نشانگر دارد</strong></div></div>
<br>

<div dir="rtl">سینتکس ساده ی دستورات جایگزینی به شکل زیر است:</div>

```
:s/search/replace/flags
```

<div dir="rtl"><h2 id="sflags">فلگ های مرسوم برای دستورات جایگزینی</h2></div>

- *`c`* تایید کردن هر جایگزینی بصورت دستی 
- *`e`* ساکت کردن ارورها در صورتی که الگو پیدا نشود
- *`i`*  نادیده گیری حروف بزرگ و کوچک ignorecase
- *`I`*  حساسیت به حروف بزرگ و کوچک 
- *`g`* انجام جایگزینی در تمام مچ‌ها، در غیر این صورت جایگزینی پس از اولین مچ متوقف می‌شود
- *`n`* نمایش تعداد مچ‌ها و عدم جایگزینی

<div dir="rtl"><h1 id="larg">آرگومان های خط فرمان</h1></div>

<div dir="rtl">آرگومان های خط فرمان ویم، آپشن هایی هستند که برای تغییر عمل کرد ویم در هنگام باز کردن آن از ترمینال، می توانید مقابل نام دستور ویم قرار دهید. در جدول زیر تعداد زیادی از این آرگومان ها برای شما با توضیحات فارسی قرار داده شده است.</div>
<br>
<div dir="rtl">پر کاربردترین این آرگومان  ها از نظر نگارنده در جدول اول و باقی آن ها در جدول دوم آمده اند.</div>
<hr>

| Option           | Description                                                                                                       |
|------------------|-------------------------------------------------------------------------------------------------------------------|
| `-o`           | باز کردن تعدادی فایل در اسپلیت های افقی
| `-O`           | باز کردن تعدادی فایل در اسپلیت های افقی عمودی|
| `-p`           | باز کردن تعدادی فایل در تب های مجزا درون ویم
| `+/{pat}`         | تعیین جایگاه نشانگر براساس اولین وقوع رجکس                                      |
| `-u {vimrc}`      | خواندن فایل پیکره بندی غیر از فایل پیش فرض 
| `--clean`         |  باز کردن ویم بدون تنظیمات شخصی - بدون ویم آرسی                                              |
| `--version`       | چاپ اطلاعات مربوط به ورژن و ویژگی ها                                                                         |

<hr>

| Option           | Description                                                                                                       |
|------------------|-------------------------------------------------------------------------------------------------------------------|
| `vim`            | باز کردن ویم و یک بافر خالی در حالت نرمال                                                                  |
| `vim filename`   | باز کردن ویم با یک فایل مشخص                                                          |
| `vim -`          |stdin خواندن متن از ورودی استاندارد                                                                                   |
| `-n` or `--normal` | باز کردن ویم در حالت نرمال، پیش‌فرض                                                                                 |
| `-i` or `--insert` | باز کردن ویم در مود اینسرت                                                                                  |
| `-R` or `--readonly` | باز کردن فایل در حالت غیرقابل ویرایش                         |
| `-N` or `--noplugin` | باز کردن ویم بدون لود کردن هیچ پلاگینی               |
| `+[num]`          |               تعیین جایگاه نشانگر براساس شماره خط            |
| `+{command}` or `-c {command}` | اجرای یک دستور پس از بازکردن فایل                           |
| `-S {file}`       | سورس کردن یک فایل ویم اسکریپت                  |
| `-g` or `--gui`   |  باز کردن جی ویم یا همان ویم در پنجره گرافیکی
| `-A`              | باز کردن ویم در حالت عربی، راست به چپ آینه شده، درصورتی که با گزینه مربوط کامپایل شده باشد                               |
| `-b`              | حالت ویرایش فایل‌های باینری           |
| `-C`              |vi حالت هماهنگی با ادیتور  
| `-d`              | diff باز کردن ویم در حالت دیف , برای مقایسه فایل‌ها                 |
| `-E`              | باز کردن ویم در مود ارتقا یافته ی اکس
| `-F`              | باز کردن ویم با تنظیمات فارسی، این گزینه دیگر وجود ندارد
| `-h`              | نمایش پیام کمکی
| `-m`              | غیر فعال کردن امکان ایجاد تغییر 
| `-N`              |vi  خاموش کردن تطابق با 
| `-R`              |read only حالت                                                                                     |
| `-r`              | لیست کردن فایل های سواپ ویم جهت ریکاوری 
| `-x`              | فعال سازی رمزگذاری فایل                                                                          |
| `-y`              | باز کردن ویم در حالت ایزی-ویم / در این حالت ویم نت پد ویندوز را شبیه سازی می کند
| `-Z`              | باز کردن ویم در حالت محدود، جلوگیری از اجرای دستورات پوسته و غیره
| `--`              | اعلام پایان آرگومان های ویم، پس از این تمام آرگومان ها به عنوان نام فایل خوانده می شوند

<div dir="rtl">
   <h1 id="parsi-1"> 
   کارکردن با نوشتار پارسی در ویم
   </h1>
</div>

<div dir="rtl">
برخلاف آنچه تصور می‌کنید، ویم قابلیت رندر کردن و تایپ متون فارسی را دارد. با اینکه ویژگی +farsi در نسخه ۷ از ویم حذف شد، اکثر توزیع‌های ویم‌ با ویژگی +arabic کامپایل شده‌اند و در نتیجه قابلیت پردازش متون راست به چپ را نیز دارا می‌باشند.

طبیعتا شما می‌توانید با تغییر زبان کیبورد خود به هر زبانی که می‌خواهید در ویم تایپ کنید، اما قابلیت استفاده از دستورات ویم را از دست می‌دهید و برای مثال چنانچه از اینسرت مود خارج شوید دیگر با زدن کلید <code>i</code> به آن باز نمی‌گردید.

راه حل این مسئله استفاده از کیبورد فارسی داخلی ویم است.

دستور زیر را در مود خط فرمان ویم وارد کنید:
</div>

```
:echo $VIMRUNTIME
```

<div dir="rtl">
بسته یه اینکه ویم را چگونه کامپایل کرده‌اید، یا در کدام توزیع آن‌را از مخارن باینری نصب کرده‌اید، مسیر خروجی می‌تواند متفاوت باشد. معمولا مسیر زیر در نتیجه دستور بالا به شما نمایش داده خواهد شد:
</div>

```
/usr/share/vim/vim90/
```

<div dir="rtl">
این مسیر ران‌تایم ویم و فایل‌های آن است.
از طریق شل (پوسته) وارد مسیر بالا شوید:
</div>

```
cd /usr/share/vim/vim90
```
<div dir="rtl">
سپس با استفاده از  <code>ls</code> پوشه‌ها و فایل‌های موجود را بررسی کنید‌.
باید یک پوشه به نام keymaps ببینید. 
با دستور زیر از وجود فایل کیبورد فارسی برای ویم اطمینان حاصل کنید:

</div>

```
find keymaps -type f -name '*persian*'
```
 <div dir="rtl">
این فرایند را می‌توانستیم به صورت زیر نیز خلاصه کنیم:
</div>

```
find /usr/share/vim/vim90 -type f -name '*persian*'
```
<div dir="rtl">
چنانچه به هر علتی، فایل persian.vim و persian-iranian_utf-8.vim در مسیر ویم قرار ندارد، از مخزن ویم آن‌‌ها را دانلود کنید و در مسیر مذکور قرار دهید. 
</div>
<a href="https://github.com/vim/vim/tree/master/runtime/keymap"> Vim GitHub </a>

<div dir="rtl">
حالا می‌توانیم وارد ویم شویم و با دستور زیر زبان ورودی را به فارسی تغییر دهیم.
</div>

```
:set keymap=persian
```
<div dir="rtl">
بدین‌ترتیب، تمام مود‌های ویم، و شورتکات‌های ویم در عین فارسی بودن کیبورد به درستی کار می‌کنند.

برای تغییر کیبورد به انگلیسی از دستور زیر استفاده می‌کنیم:
</div>

```
:set keymap=
```
<div dir="rtl">
جهت راحتی بیشتر، می‌توانیم برای این دستور‌ها، شورتکات تعریف کنیم.
برای مثال:
</div>

```
inoremap <C-f> <C-o>:set keymap=persian<cr>
inoremap <C-e> <C-o>:set keymap= <cr>
```

<div dir="rtl">بدین ترتیب با کلید‌های Ctrl+f به پارسی، و با Ctrl+e به انگلیسی می‌رویم.
اما بهتر است از مپ کردن کلید‌هایی که در ویم کاربرد پیش‌فرضی دارند، مانند دو ترکیب بالا خودداری کنیم و به جای آن از کلید لیدر استفاده کنیم.
</div>

```
inoremap <leader>f <C-o>:set keymap=persian<cr>
inoremap <leader>e <C-o>:set keymap= <cr>
```

<div dir="rtl">کلید لیدر، یک مودیفایر مخصوص در ویم است که با ترکیب آن با دیگر کلیدها می‌توانیم مپینگ‌های شخصی‌ بسازیم، بدون اینکه مپینگ‌های داخلی ویم را تغییر داده باشیم. کلید لیدر پیش‌فرض ویم <code>\</code> است.
اکثر کاربران این کلید لیدر را به اسپیس تغییر می‌دهتد.
</div>

```
let mapleader =" "
```
<div dir="rtl">بنابراین با زدن space-e و space-f کیبورد را عوض می‌کنیم.
 این تنظیمات باید در فایل ~/.vimrc قرار بگیرند.
</div>
<br>
<div dir="rtl">
   <h2 id="parsi-2"> 
نکاتی درمورد ترمینال
   </h2>
اگر به‌صورت مداوم با متون پارسی سروکار دارید، حتما از یک ترمینال مناسب استفاده کنید. ترمینال‌های VTE و ترمینال‌های شناخنه شده، ساپورت مناسبی برای نوشتار راست به چپ دارند.
لیستی از  ترمینال‌های خوب در پایین آورده شده است.
</div>

1. Xterm
2. Xfce4-terminal 
3. Konsole 
4. Roxterm
5. Blackbox
6. Gnome-terminal
7. Terminator
8. Lxterminal
9. Qterminal
10. Sakura

<div dir="rtl">
   <h2 id="parsi-3"> 
   فونت‌های مناسب برای هر دو نوشتار پارسی و انگلیسی 
   </h2>
   فونت‌های زیر عملکرد‌ مناسبی در هردو نوشتار راست به چپ و چپ به راست دارند.
   در اکثر مواقع فونت پیش‌فرض monospace سیستم برای بیشتر سناریو ها مناسب است.  با استفاده از دستور زیر می‌توانید ببینید که فونت پیش‌فرض مونو سیستم شما کدام فونت است.
</div>

```
fc-match monospace
```

خروجی این دستور در سیستم نگارنده به شکل زیر است:
</div>

`NotoSansMono-Regular.ttf`

پکیج `noto-fonts` در اکثر سیستم‌ها بصورت پیش‌فرض نصب است. چنانچه این پکیج را نصب ندارید یا سیستم شما به فونت دیگری برای مونو فالبک می‌کند (برای مثال فونت روبوتو)، می‌توانید فونت مونو سیستمی را تغییر دهید. برای این کار به دستورالعمل توزیع خود مراجعه کنید.
</div>
<div dir="rtl">

برای مواردی که در tty نیاز به فونت مناسب فارسی دارید، فونت terminus ساپورت مناسبی از گلیف‌های فارسی دارد.
</div>

<div dir="rtl"><h2 id="zwnj">نیم فاصله </h2></div>

<div dir="rtl">برای نمایش درست نیم فاصله ها در ویم، خصوصا در ترمینال، می بایست دو خط زیر را به ویم آرسی خود اضافه کنیم. اینجا از قابلیت  conceal  ویم برای پنهان کردن و جایگزینی ZWNJ استفاده می‌کنیم.</div>
<br>

```
call matchadd('Conceal', '\%u200c', 10, -1, {'conceal':'|'})
set conceallevel=2 concealcursor=nv
```

<div dir="rtl">من اینجا از کاراکتر | برای نشان دادن نیم فاصله استفاده  می کنم.
برای وارد کردن نیم‌فاصله با استفاده از کیبورد فارسی داخلی ویم از کلید‌های شیفت-بی Shift-B  استفاده می‌کنیم.

</div>
<br>

<div dir="rtl">
   <h1 id="vimrc"> 
    ذخیره‌سازی تنظیمات در فایل ویم‌آرسی 
   </h1>
</div>

برای ذخیره‌سازی تنظیمات ویم از فایل ویم‌آرسی استفاده می‌کنیم. این فایل بصورت پیش‌فرض وجود ندارد مگر آن‌که توزیع شما یا خودتان آن‌را ساخته باشید. در این فایل می‌توانیم تمامی تنظیمات داخلی ویمو تنظیمات پلاگین‌ها را تغییر دهیم، ویم‌اسکریپت‌‌های خودمان را اضافه کنیم و ویم را کاملا از آن خود کنیم.

در ابتدا آپشن‌های مورد نظر خود را set  می‌کنیم. تعدادی از این آپشن‌ها ضروری و تعداد زیادی از آن‌ها کاملا سلیقه‌ای هستند.
</div>

```
vim ~/.vimrc
```
<br>

<div dir="rtl">
در جدول زیر تعدادی از آپشن‌های ضروی از نظر نگارنده آورده ‌شده‌اند.
</div>
<br>

| option | Description |
|-------|------|
| set shiftwidth=4 | تعداد فاصله در هر سطح از ایندت  |
| set tabstop=4 | تغداد فاصله در هر تب  |
| set noswapfile | خاموش کردن فایل های سواپ که برای بازیابی اطلاعات استفاده می شوند |
| set autoindent |ایندنت خودکار |
| set ignorecase | عدم توجه به بزرگی و کوچکی حروف هنگام جستجو |
| set incsearch | هایلاییت الگوی جستجو همزمان با تایپ آن  |
| set smartcase | عملکرد هوشمند در رابطه با حروف بزرگ و کوچک  |
| set relativenumber | شماره گذاری خطوط به صورت نسبی / به نسبت خط زیر نشانگر  |
| set number | شماره گذاری عادی  |
| set hlsearch | هایلایت کردن الگوی جستجو   |
| set autowriteall | ذخیره ی فایل به صورت خودکار|
| set laststatus=2 | نمایش نوار اطلاعات|
| set noshowmode | عدم نمایش تغییر مودها |
| set autochdir  | تغییر خودکار مسیر پوسته به مکان فایل باز شده در ویم

<div dir="rtl">برای اطلاعات بیشتر فایل کمکی زیر را مطالعه کنید.</div>

<code>:h options</code >

<div dir="rtl">دو گزینه‌ی زیر از مهم‌ترین تنظیماتی هستند که باید در ویم انجام دهیم. این دو گزینه باعث هایلایت شدن کد بر اساس سینتکس و اینجام ایندنتیشن بر اساس نوع فایل می‌شوند.</div>

```
syntax on
filetype plugin indent on
```
<div dir="rtl">بنابراین یک ویم‌آرسی مختصر و مفید به شکل زیر خواهد بود:</div>

```
syntax on
filetype plugin indent on

set shiftwidth=4
set tabstop=4
set noswapfile
set autoindent
set ignorecase
set incsearch
set smartcase
set relativenumber
set number
set hlsearch
set autowriteall
set laststatus=2
```
<div dir="rtl">طبعا گزینه های بی‌شماری برای تنظیمات و شخصی‌سازی ویم وجود دارند. برخی از آن‌ها شامل: چشمک زدن نشانگر، رفتار فولد‌ها،  چک‌کردن املا،  انکودینگ و بسیاری دیگر می‌شوند. توضیح همه‌ی آن‌ها از حوصله‌ی این فصل خارج است، بنابراین گزینه‌های دیگر در فصل‌های مربوط به خودشان مطرح خواهند شد.</div>

<br>

<div dir="rtl">
   <h1 id="vimplug"> 
   نصب پلاگین با استفاده از ویم‌پلاگ
   </h1>
</div>

<div dir="rtl">
راحت‌ترین راه نصب پلاگین در ویم، استفاده از یک پلاگین منیجر مانند ویم‌پلاگ است.

ویم از نسخه ۸ به بعد دارای سیستم مدیریت پلاگین است، اما این روش خیلی مناسب کاربران تازه کار نیست.

در روش داخلی ویم، پلاگین‌ها باید در ساختار مشخصی از پوشه‌ها و به ترتیب خاصی قرار بگیرند و وظیفه آپدیت نگه‌داشتن آن‌ها نیز با خود کاربر است. پلاگین‌ها بصورت مخازن گیت کلون شده و به کلی با استفاده از دستورات گیت مدیریت می‌شوند.
<br> 
<br> 
 برای مثال ساختار زیر را ببینید. هر پلاگینی که در مسیر زیر قرار بگیرد توسط ویم لود خواهد شد.
<pre dir="ltr">
.vim/pack
└── plugins
   └── start
      ├── cheat40
      ├── corrections
      ├── mdhelper
      └── vim-polyglot

</pre>

این روش برای کسانی که چند پلاگین کوچک نیاز دارند روش مناسب و قابل مدیریتی است. اما برای کسانی که می‌خواهند با راحتی بیشتری پلاگین‌ها را نصب، غیرفعال، آپدیت یا پاک کنند، ویم‌پلاگ گزینه‌ی بسیار بهتری است.
<br> 
شایان ذکر است که ویم دارای هیچگونه پلاگین یا قابلیتی برای سرچ کردن پلاگین‌ها از داخل خود ویم نیست و هیچ‌ برنامه‌ای جهت ساخت این‌چنین چیزی وجود ندارد. 
<br> 
برای نصب ویم‌پلاگ، به <a href="https://github.com/junegunn/vim-plug">مخزن</a> آن در گیت‌هاب رفته و دستور curl مربوط به سیستم خود را انتخاب می‌کنیم.
<br> 
برای نصب ویم پلاگ در سیستم‌های یونیکس و لینوکس‌، دستور کرل زیر را اجرا می‌کنیم:

</div>

<code>
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
</code>

<div dir="rtl">
دقت کنید که دستور مناسب سیستم عامل خود را انتخاب کنید. همچنین دقت کنید که دستور ویم با نئوویم فرق دارد.
( در این سایت به نئوویم پرداخته نمی‌شود. )
<br> 
پس از اجرای دستور بالا، کافی‌ست که آدرس پلاگین‌های خود را بین دو عبارت 
</div>

```
call plug#begin()
```

``` 
call plug#end()
```

<div dir="rtl">
قرار دهید.  هر پلاگین موجهی که درون این دو عبارت باشند نصب و هنگام باز شدن ویم لود می‌شوند. برای موقتا غیرفعال کردن یک پلاگین کافی‌ست آن‌را در ویم‌آرسی کامنت کنیم و یرای پاک کردن آن کافی‌ست خط مربوط به آن را پاک کنیم و دستور پاک‌سازی‌ پلاگین‌ها را اجرا کنیم.

آدرس پلاگین‌ها می‌توانند آدرس http مخزن گیت یا آدرس کوتاه شده باشند. تقریبا همه‌ی پلاگین‌های ویم از ویم‌پلاگ پشتیبانی می‌کنند. اکثر پلاگین‌ها در دستورات نصب خود آدرس کوتاه شده‌ی پلاگین را برای استفاده با ویم‌پلاگ قرار داده‌اند.
<br>
برای مثال چند پلاگین مفید و کاربردی نصب می‌کنیم.
</div>

```
call plug#begin()

Plug 'SirVer/ultisnips' 
Plug 'honza/vim-snippets'
Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }
Plug 'https://github.com/wolandark/vim-live-server.git', { 'do': 'sudo npm install -g browser-sync' }

call plug#end()
```

<div dir="rtl">
در کد بالا که جایی در ویم‌آرسی خود قرار می‌دهیم، نمونه‌ی استفاده از آدرس کامل مخرن و آدرس کوتاه شده قابل مشاهده است. هم‌چنین قابلیت هوک‌های بعد‌از نصب و آپدیت در سینتکس ویم‌پلاگ نیز در دو پلاگین آخر استفاده شده است. <br>
پلاگین fzf از سازنده‌ی ویم‌پلاگ برنامه بسیاری خوبی است که در خط فرمان و در ویم بسیار مفید است. پلاگین  vim-live-server که توسط نگارنده این مطلب ساخته شده، یک پلاگین لایو سرور برای ویم است که از پکیج browser-sync استفاده می‌کند.
<br>
<br>

سینتکس دستورات ساده‌ی ویم‌پلاگ به شکل زیر است.
</div>

<code>
Plug 'address in single quotes'
</code> 
<br>
<br>

<div dir="rtl">
ویم‌پلاگ قابلیت‌های زیادی دارد که بهتر است برای یادگیری آن‌ها به گیت‌هاب پروژه مراجعه کنید.

دستورات ضروری ویم‌پلاگ اینجا مطرح خواهند شد.
</div>

<div dir="rtl">
پس از قراردادن آدرس پلاگین‌ها در ویم‌آرسی، فایل را ذخیره و سورس می‌کنیم  
</div>
<code>
:w
<br>
:source %
<br>
(یا خارج و وارد می‌شویم)
</code>

<div dir="rtl">
سپس با دستور PlugInstall پلاگین‌های خود را نصب می‌کنیم.

</div> <br>

| Command | Descriptionb|
 | --------- | -------- |
 | :PlugInstall   |  نصب پلاگین‌ها  | 
 | :PlugUpdate | آپدیت پلاگین‌ها |
 | :PlugUpgrade | آپگرید ویم‌پلاگ |
 | :PlugClean | پاک کردن پلاگین‌ها |

<br>
<div dir="rtl"><h1 id="pluginlist"> چند پلاگین مفید برای ویم </h1>
لیستی از پلاگین‌های مفید و کارآمد در زیر آورده شده است. بر اساس نیاز خود و با در نظرگیری کارکرد و تطابق پلاگین‌ها با همدیگر  از بین آن‌ها انتخاب کنید. 
لیست کامل‌تری از پلاگین‌های ویم در سایت 
<a href="https://vimawesome.com/">vimawesome</a> 
قرار دارد.
<br>
<br>
</div>
<div>
    <ul>
        <li>
            <a href="https://github.com/tpope/vim-surround">vim-surround</a>
            <p dir="rtl">پلاگینی برای محاصره کردن توکن ها با  الگو های دیگر</p>
            <code>Plug 'tpope/vim-surround'</code>
        </li>
        <li>
            <a href="https://github.com/neoclide/coc.nvim">coc.nvim</a>
            <p dir="rtl">اکستنشن Nodejs برای ویم - لود کردن اکستنشن مانند وی اس کد </p>
            <code> curl -sL install-node.vercel.app/lts | bash
            <br>
            Plug 'neoclide/coc.nvim', {'branch': 'release'}</code>
        </li>
        <li>
            <a href="https://github.com/ap/vim-css-color">vim-css-color</a>
            <br>
            <p dir="rtl">هایلات کردن رنگ‌های CSS در ویم</p>
            <code>Plug 'ap/vim-css-color'</code>
        </li>
        <li>
            <a href="https://github.com/itchyny/lightline.vim">lightline.vim</a>
            <br>
            <p dir="rtl">استاتوس لاین زیبا و کارآمد</p>
            <code>Plug 'itchyny/lightline.vim'</code>
        </li>
        <li>
            <a href="https://github.com/junegunn/fzf.vim">fzf.vim</a>
            <br>
            <p dir="rtl">فازی فایندر </p>
            <code>Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }<br>
Plug 'junegunn/fzf.vim'</code>
        </li>
        <li>
            <a href="https://github.com/tpope/vim-repeat">vim-repeat</a>
            <br>
            <p dir="rtl">تکرار همه‌چیز به آسانی </p>
            <code>Plug 'tpope/vim-repeat'</code>
        </li>
        <li>
            <a href="https://vimawesome.com/plugin/tagbar">tagbar</a>
            <br>
            <p dir="rtl">پلاگین مرور کردن تگ‌ها</p>
            <code>Plug 'majutsushi/tagbar'</code>
        </li>
        <li>
            <a href="https://github.com/dense-analysis/ale">ale</a>
            <br>
            <p dir="rtl">پلاگین LSP برای ویم</p>
            <code>Plug 'w0rp/ale'</code>
        </li>
        <li>
            <a href="https://github.com/godlygeek/tabular">tabular</a>
            <br>
            <p dir="rtl">منظم‌سازی متن بر اساس الگو یا کاراکتر، مناسب جدول و غیره ...</p>
            <code>Plug 'godlygeek/tabular'</code>
        </li>
        <li>
            <a href="https://github.com/sirver/ultisnips">ultisnips</a>
            <br>
            <p dir="rtl">موتور مدیریت اسنیپت‌ها برای ویم</p>
            <code>Plug 'sirver/ultisnips'</code>
        </li>
        <li>
            <a href="https://github.com/honza/vim-snippets">vim-snippets</a>
            <br>
            <p dir="rtl">اسنیپت‌های ه هونزا برای استفاده با ultisnips</p>
            <code>Plug 'honza/vim-snippets'</code>
        </li>
        <li>
            <a href="https://github.com/rstacruz/sparkup">sparkup</a>
            <br>
            <p dir="rtl">خلاصه‌نویسی HTML مانند Emmet</p>
            <code>Plug 'rstacruz/sparkup'</code>
        </li>
        <li>
            <a href="https://github.com/chriskempson/base16-vim">base16-vim</a>
            <br>
            <p dir="rtl">صدها تم رنگی باکیفیت بر اساس پالت بیس۱۶</p>
            <code>Plug 'chriskempson/base16-vim'</code>
        </li>
        <li>
            <a href="https://github.com/ctrlpvim/ctrlp.vim">ctrlp.vim</a>
            <br>
            <p dir="rtl">یک فازی فایندر دیگر برای ویم</p>
            <code>Plug 'https://github.com/ctrlpvim/ctrlp.vim.git'</code>
        </li>
        <li>
            <a href="https://github.com/rking/ag.vim">ag.vim</a>
            <br>
            <p dir="rtl">ابزار فوق‌العاده‌ی ag برای ویم </p>
            <code>Plug 'rking/ag.vim'</code>
        </li>
        <li>
            <a href="https://github.com/sheerun/vim-polyglot">پکیج زبان برای ویم</a>
            <br>
            <p dir="rtl"></p>
            <code>Plug 'sheerun/vim-polyglot'</code>
        </li>
        <li>
            <a href="https://github.com/tpope/vim-eunuch">vim-eunuch</a>
            <br>
            <p dir="rtl">دستورات پوسته با راحتی بیشتر از داخل ویم</p>
            <code>Plug 'tpope/vim-eunuch'</code>
        </li>
        <li>
            <a href="https://github.com/mg979/vim-visual-multi">vim-visual-multi</a>
            <br>
            <p dir="rtl">چندین نشانگر برای ویم مشابه سابلایم</p>
            <code>Plug 'mg979/vim-visual-multi', {'branch': 'master'}</code>
        </li>
        <li>
            <a href="https://github.com/mhinz/vim-startify">vim-startify</a>
            <br>
            <p dir="rtl">داشبرد شروع کار برای ویم</p>
            <code>Plug 'mhinz/vim-startify'</code>
        </li>
        <li>
            <a href="https://github.com/junegunn/goyo.vim">goyo.vim</a>
            <br>
            <p dir="rtl">وسط‌چین کردن متن در ویم و نگارش بدون حواس‌پرتی</p>
            <code>Plug 'junegunn/goyo.vim'</code>
        </li>
    </ul>

</div>
<br>
<br>

<div dir="rtl"><h1 id="spellcheck"> چک کردن املای کلمات</h1></div>
<div dir="rtl"><strong>آپشن های لازم:</strong></div>

```
set spell spelllang=en_us
set wildmode=longest,list,full
hi SpellBad ctermfg=red guifg=red
```

<div dir="rtl">پس از قراردادن این آپشن در ویم‌آرسی، ویم بصورت خودکار واژگانی که غلط نوشته‌شده باشند را قرمز می‌کند.
سپس برای پریدن به واژگان مشخص‌ شده از کلیدهای زیر استفاده می‌کنیم.
</div>

- `]s` 
- `[s`

<div dir="rtl"> پس از آن‌که نشانگر ما روی واژه‌ی مشخص شده قرار‌گرفت، با استفاده از عملیات زیر آن را اصلاح می‌کنیم:</div>

`z=`

<div dir="rtl">
<code>=z</code>ما را وارد منوی انتخاب واژه با املای درست می‌کند. معمولا اولین پیشنهاد درست‌ترین پیشنهاد است. سپس با زدن کلید <code>1</code> اولین پیشنهاد را انتخاب می‌کنیم و واژه جایگزین می‌شود.
چنانچه انتخاب دوم، سوم الی آخر درست بودند، عدد مربوط به آن را وارد می‌کنیم.
</div>

<div dir="rtl">
پس به‌طور‌ خلاصه <code>z=1</code> سریع‌ترین راه اصلاح املای واژگان است.
</div>

<div dir="rtl">اگر از قرمز شدن واژگان هنگام کد زدن خسته شدید، می‌توانید با استفاده از یک keybinding ساده در ویم، فقط هنگام نیاز آن را فعال کنید</div>

```
noremap <F6> :setlocal spell! spelllang=en_us<CR>
```

<div dir="rtl">با قراردادن خط بالا در ویم‌آرسی، فشردن کلید <code>F6</code> حالت بررسی غلط‌های املایی را فعال می‌کند. اگر بخواهید که <code>F6</code> در حالت اینسرت هم این کار را انجام دهد باید یک مپینگ جدا برای آن تعریف کنید. keybinding ها در ویم،‌ اختصاصا برای مدهای مختلف تعریف می‌شوند.</div>

```
nnoremap <F6> :setlocal spell! spelllang=en_us<CR>
inoremap <F6> <C-o>:setlocal spell! spelllang=en_us<CR>
```

<div dir="rtl">همچنین با استفاده از یک تابع بسیار ساده در ویم‌اسکریپت و اختصاص یک keybinding به آن می‌توانیم فرایند ‍‍<code>z=1</code> را تسریع دهیم.</div>

```
function! FixSpell()
  normal! 1z=<CR>
endfunction

map gs :call FixSpell()<CR>
```
<div dir="rtl">از این پس با زدن کلید‌های <code>gs</code>روی واژگان قرمز شده، می‌توانیم اولین پیشنهاد اصلاح را اعمال کنیم.</div>
<br> 
<br>

<div id="update" align="center" dir="rtl" style="color:orange;">
آخرین آپدیت:

۲۳ بهمن ۱۴۰۲

Dos Bah 23 02:14:34 +0330 1402
</div>
<hr>

<footer>
       <div dir="rtl">
              <p> مطالب این سایت بصورت مداوم به‌روز‌رسانی می‌شوند.  برای دنبال کردن مطالب این سایت را بوکمارک کنید.</p>
              <p>جهت کمک به این پروژه و اضافه کردن مطالب و نکات خود در باره ویم، فایل <a href="https://github.com/wolandark/vim-cheatsheet-farsi/blob/master/RAHNAMA.md">راهنمای</a>
 داخل مخزن را ببینید.</p>
              <p>جهت حمایت مالی از پروژه، در صورتی که در ایران هستید، روی دکمه‌ی <a href="https://www.coffeete.ir/wolandark">برام قهوه بخر</a>
 کلیک کنید.</p>
              <p>جهت ارتباط با نگارنده از طریق تلگرام یا ایمیل اقدام کنید.</p>
              <p>این سایت از یک اسکریپت web analytics کاملا اوپن سورس، ضمن احترام به حریم خصوصی کاربر استفاده می‌کند.</p>
       </div>
</footer>

# Contact me
[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/wolandarkside)
[![Protonmail](https://img.shields.io/badge/ProtonMail-8B89CC?style=for-the-badge&logo=protonmail&logoColor=white)](mailto:contact-woland@proton.me)
<br>
<br>
<hr>

# Chapters to write

- [x] vim plugins - default and vimplug way
    - vimplug covered - pack/start briefly covered 
- [x] list of useful plugins
- [ ] Insert mode keybindings
- [ ] custom mappings 
- [ ] spell check
- [ ] NETRW
- [ ] Compiling Vim
<br>
<br>
<hr>

<div dir="rtl">
<h1>راهنمای کمک به این پروژه</h1>

دوستداران ویم که قصد دارند در این پروژه سهیم باشند، قبل از ثبت هر نوع درخواست موارد زیر را بررسی نمایند

یک : فرمت مطالب می‌بایست مارکداون یا ویکی باشد

دو: نسخه ویم و تنظیمات آرسی یا پلاگین ها قید شوند

سه: نکاتی که وابسته به پلاگین هستند تحت عنوان همان پلاگین ثبت شوند

چهار: نکات مربوط به زبان برنامه نویسی خاصی، تحت نام همان زبان ثبت شوند

پنج: هیچ ضمانتی از طرف مالک این مخزن من‌باب ثبت و مرج شدن مطالب شما وجود ندارد

شش: مطالب تکراری نادیده گرقته خواهند شد

هفت: اگر قصد دارید مطلبی را به فصلی اضافه کنید، در فایل محتص آن فصل در پوشه ی فایل های مارکدان مخزن این کار را انجام دهید.

</div>

vimpersian.github.io

vimpersian.github.io Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

vimpersian.github.io

vimpersian.github.io Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README