نام (NAME)

micro - ویرایشگر متنی مدرن، بصری و مبتنی بر ترمینال

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

micro [OPTION]... [FILE]... [+LINE[:COL]] [+/REGEX]
micro [OPTION]... [FILE[:LINE[:COL]]]... (تنها در صورتی که گزینه `parsecursor` فعال باشد)

توضیحات (DESCRIPTION)

نرم‌افزار Micro یک ویرایشگر متنی مبتنی بر ترمینال است که هدف آن ارائه رابط کاربری آسان و بصری است، در حالی که از تمامی قابلیت‌های ترمینال‌های مدرن بهره می‌برد. این برنامه به صورت یک فایل باینری ایستا (static binary)، با تمام امکانات اولیه و بدون هیچ وابستگی عرضه می‌شود.

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

برای خروج از Ctrl-q، برای ذخیره از Ctrl-s و برای باز کردن منوی راهنمای داخلی ویرایشگر از Ctrl-g استفاده کنید.

گزینه‌ها (OPTIONS)

-clean

پاک‌سازی دایرکتوری پیکربندی و خروج

-config-dir dir

مشخص کردن مسیر سفارشی برای دایرکتوری پیکربندی

FILE:LINE[:COL] (تنها در صورتی که گزینه `parsecursor` فعال باشد)
FILE +LINE[:COL]

مشخص کردن سطر و ستون شروع مکان‌نما هنگام باز کردن یک بافر

+/REGEX

مشخص کردن عبارت باقاعده (regex) برای جستجو هنگام باز کردن یک بافر

-options

نمایش راهنمای همه گزینه‌ها و خروج

-debug

فعال‌سازی حالت اشکال‌زدایی (ثبت لاگ‌ها در ./log.txt)

-profile

فعال‌سازی پروفایل‌بندی پردازنده (نوشتن اطلاعات پروفایل در ./micro.prof تا بعداً با "go tool pprof micro.prof" تحلیل شود)

-version

نمایش شماره نسخه و اطلاعات آن و خروج

پلاگین‌های Micro را می‌توان از طریق خط فرمان با دستورات زیر مدیریت کرد.

-plugin install [PLUGIN]...

نصب پلاگین(ها)

-plugin remove [PLUGIN]...

حذف پلاگین(ها)

-plugin update [PLUGIN]...

به‌روزرسانی پلاگین(ها) (در صورت عدم ارائه آرگومان، همه پلاگین‌ها به‌روزرسانی می‌شوند)

-plugin search [PLUGIN]...

جستجو برای یک پلاگین

-plugin list

فهرست کردن پلاگین‌های نصب‌شده

-plugin available

فهرست کردن پلاگین‌های موجود

گزینه‌های Micro را می‌توان برای اعمال سریع تنظیمات، از طریق آرگومان‌های خط فرمان نیز تعیین کرد. برای پیکربندی اساسی و دائمی، لطفاً از فایل settings.json استفاده کنید (دستور 'help options' را ببینید).

-<option> value

تنظیم `option` به `value` برای این نشست.
به عنوان مثال: `micro -syntax off file.c`

برای مشاهده فهرست کامل گزینه‌های پیکربندی، از دستور `micro -options` استفاده کنید.

پیکربندی (CONFIGURATION)

برنامه Micro از متغیر $MICRO_CONFIG_HOME به عنوان دایرکتوری پیکربندی استفاده می‌کند. اگر این متغیر محیطی تنظیم نشده باشد، از $XDG_CONFIG_HOME/micro استفاده خواهد شد. در صورتی که آن متغیر نیز مقداردهی نشده باشد، از ~/.config/micro به عنوان دایرکتوری پیکربندی استفاده می‌شود. در مستندات، از ~/.config/micro برای اشاره به دایرکتوری پیکربندی استفاده می‌کنیم (حتی اگر به دلیل تنظیم هر یک از متغیرهای محیطی یادشده، در عمل مسیر دیگری باشد).

توجه (NOTICE)

این صفحه راهنما صرفاً به عنوان یک راهنمای سریع برای نحوه فراخوانی micro در نظر گرفته شده است و جایگزین مستندات کامل موجود درون خود micro که از داخل برنامه قابل دسترسی است نمی‌باشد. برنامه Micro در گوشه پایین سمت راست به شما نشان می‌دهد که چه کلیدهای ترکیبی را برای دریافت راهنما بفشارید.

اشکالات (BUGS)

فهرست جامعی از باگ‌ها در این صفحه راهنما آورده نشده است. برای مشاهده فهرست باگ‌های شناخته‌شده و گزارش باگ‌های جدیدی که ممکن است با آن‌ها مواجه شوید، به صفحه گیت‌هاب در https://github.com/zyedidia/micro/issues مراجعه کنید. ما تلاش می‌کنیم اشکالات را در سریع‌ترین زمان ممکن رفع کنیم.