.TH micro 1 "2025-09-03"
.SH "نام (NAME)"
micro \- ویرایشگر متنی مدرن، بصری و مبتنی بر ترمینال
.SH "خلاصه دستور (SYNOPSIS)"
.B micro
.RI [ OPTION ]...\&
.RI [ FILE ]...\&
.RI [+ LINE [: COL ]]\&
.RI [+/ REGEX ]
.br
.B micro
.RI [ OPTION ]...\&
.RI [ FILE [: LINE [: COL ]]]...\&
\& (تنها در صورتی که گزینه `parsecursor` فعال باشد)
.SH "توضیحات (DESCRIPTION)"
نرم‌افزار Micro یک ویرایشگر متنی مبتنی بر ترمینال است که هدف آن ارائه رابط کاربری آسان و بصری است، در حالی که از تمامی قابلیت‌های ترمینال‌های مدرن بهره می‌برد. این برنامه به صورت یک فایل باینری ایستا (static binary)، با تمام امکانات اولیه و بدون هیچ وابستگی عرضه می‌شود.

همان‌طور که از نامش پیداست، micro به دنبال آن است که تا حدی جانشین ویرایشگر nano باشد؛ با نصب آسان و کاربرد سریع در شرایط اضطراری، اما هم‌زمان کار تمام‌وقت با آن نیز لذت‌بخش است؛ چه ترمینال محیط کاری دلخواه شما باشد و چه از سر ضرورت (از طریق ssh) در آن کار کنید.

برای خروج از Ctrl-q، برای ذخیره از Ctrl-s و برای باز کردن منوی راهنمای داخلی ویرایشگر از Ctrl-g استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.PP
.B \-clean
.RS 4
پاک‌سازی دایرکتوری پیکربندی و خروج
.RE
.PP
.B \-config-dir
.I dir
.RS 4
مشخص کردن مسیر سفارشی برای دایرکتوری پیکربندی
.RE
.PP
.IR FILE : LINE [: COL ]
(تنها در صورتی که گزینه `parsecursor` فعال باشد)
.br
.IR FILE \ + LINE [: COL ]
.RS 4
مشخص کردن سطر و ستون شروع مکان‌نما هنگام باز کردن یک بافر
.RE
.PP
.RI +/ REGEX
.RS 4
مشخص کردن عبارت باقاعده (regex) برای جستجو هنگام باز کردن یک بافر
.RE
.PP
.B \-options
.RS 4
نمایش راهنمای همه گزینه‌ها و خروج
.RE
.PP
.B \-debug
.RS 4
فعال‌سازی حالت اشکال‌زدایی (ثبت لاگ‌ها در ./log.txt)
.RE
.PP
.B \-profile
.RS 4
فعال‌سازی پروفایل‌بندی پردازنده (نوشتن اطلاعات پروفایل در ./micro.prof تا بعداً با "go tool pprof micro.prof" تحلیل شود)
.RE
.PP
.B \-version
.RS 4
نمایش شماره نسخه و اطلاعات آن و خروج
.RE

پلاگین‌های Micro را می‌توان از طریق خط فرمان با دستورات زیر مدیریت کرد.
.RS 4
.PP
.B \-plugin install
.RI [ PLUGIN ]...
.RS 4
نصب پلاگین(ها)
.RE
.PP
.B \-plugin remove
.RI [ PLUGIN ]...
.RS 4
حذف پلاگین(ها)
.RE
.PP
.B \-plugin update
.RI [ PLUGIN ]...
.RS 4
به‌روزرسانی پلاگین(ها) (در صورت عدم ارائه آرگومان، همه پلاگین‌ها به‌روزرسانی می‌شوند)
.RE
.PP
.B \-plugin search
.RI [ PLUGIN ]...
.RS 4
جستجو برای یک پلاگین
.RE
.PP
.B \-plugin list
.RS 4
فهرست کردن پلاگین‌های نصب‌شده
.RE
.PP
.B \-plugin available
.RS 4
فهرست کردن پلاگین‌های موجود
.RE
.RE

گزینه‌های Micro را می‌توان برای اعمال سریع تنظیمات، از طریق آرگومان‌های خط فرمان نیز تعیین کرد. برای پیکربندی اساسی و دائمی، لطفاً از فایل settings.json استفاده کنید (دستور 'help options' را ببینید).
.RS 4
.PP
.BI \-< option >
.I value
.RS 4
تنظیم `option` به `value` برای این نشست.
.br
به عنوان مثال: `micro -syntax off file.c`
.RE
.RE
.PP
برای مشاهده فهرست کامل گزینه‌های پیکربندی، از دستور `micro -options` استفاده کنید.
.SH "پیکربندی (CONFIGURATION)"
برنامه Micro از متغیر $MICRO_CONFIG_HOME به عنوان دایرکتوری پیکربندی استفاده می‌کند.
اگر این متغیر محیطی تنظیم نشده باشد، از $XDG_CONFIG_HOME/micro استفاده خواهد شد.
در صورتی که آن متغیر نیز مقداردهی نشده باشد، از ~/.config/micro به عنوان دایرکتوری پیکربندی استفاده می‌شود.
در مستندات، از ~/.config/micro برای اشاره به دایرکتوری پیکربندی استفاده می‌کنیم
(حتی اگر به دلیل تنظیم هر یک از متغیرهای محیطی یادشده، در عمل مسیر دیگری باشد).
.SH "توجه (NOTICE)"
این صفحه راهنما صرفاً به عنوان یک راهنمای سریع برای نحوه فراخوانی micro در نظر گرفته شده است و جایگزین مستندات کامل موجود درون خود micro که از داخل برنامه قابل دسترسی است نمی‌باشد. برنامه Micro در گوشه پایین سمت راست به شما نشان می‌دهد که چه کلیدهای ترکیبی را برای دریافت راهنما بفشارید.
.SH "اشکالات (BUGS)"
فهرست جامعی از باگ‌ها در این صفحه راهنما آورده نشده است. برای مشاهده فهرست باگ‌های شناخته‌شده و گزارش باگ‌های جدیدی که ممکن است با آن‌ها مواجه شوید، به صفحه گیت‌هاب در \fBhttps://github.com/zyedidia/micro/issues\fP مراجعه کنید. ما تلاش می‌کنیم اشکالات را در سریع‌ترین زمان ممکن رفع کنیم.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2020 متعلق به Zachary Yedidia و همکاران. مجوز MIT.
برای جزئیات بیشتر به \fBhttps://github.com/zyedidia/micro\fP مراجعه کنید.