.\" Copyright (C) 1999-2011, 2013-2026 Free Software Foundation, Inc. .\" .\" This document is dual-licensed. You may distribute and/or modify it .\" under the terms of either of the following licenses: .\" .\" * The GNU General Public License, as published by the Free Software .\" Foundation, version 3 or (at your option) any later version. You .\" should have received a copy of the GNU General Public License .\" along with this program. If not, see .\" . .\" .\" * The GNU Free Documentation License, as published by the Free .\" Software Foundation, version 1.2 or (at your option) any later .\" version, with no Invariant Sections, no Front-Cover Texts, and no .\" Back-Cover Texts. You should have received a copy of the GNU Free .\" Documentation License along with this program. If not, see .\" . .\" .TH NANO 1 "July 2026" "GNU nano 9.2" .SH "نام (NAME)" nano \- ویرایشگر متن دیگر نانو، با الهام از Pico .SH "خلاصه دستور (SYNOPSIS)" .B nano .RI [ options "] [[\fB+" line [\fB, column "]] " file ]... .sp .BR nano " [" \fIoptions "] [[" + [ crCR ]{ / | ? } \fIstring "] " \fIfile ]... .SH "توضیحات (DESCRIPTION)" ویرایشگر \fBnano\fR یک ویرایشگر متن کوچک و کاربرپسند است. این برنامه ظاهر و رفتار Pico را بازسازی کرده، اما نرم‌افزاری آزاد است و برخی قابلیت‌ها را که Pico فاقد آن است پیاده‌سازی می‌کند؛ از جمله: باز کردن چندین فایل، پیمایش خط‌به‌خط، واگرد/ازنو (undo/redo)، رنگ‌آمیزی ساختار نحوی (syntax coloring)، شماره‌گذاری خطوط و شکست نرم خطوط طولانی (soft-wrapping). .sp هنگام مشخص کردن نام فایل در خط فرمان، می‌توان با افزودن شماره خط همراه با علامت جمع (\fB+\fR) قبل از نام فایل، مکان‌نما را روی یک خط مشخص قرار داد، و حتی با افزودن یک ویرگول، آن را در یک ستون مشخص مستقر ساخت. اعداد منفی از انتهای فایل یا سطر شمارش می‌شوند. .sp مکان‌نما می‌تواند با مشخص کردن یک رشته پس از \fB+/\fR یا \fB+?\fR قبل از نام فایل، روی اولین یا آخرین رخداد آن رشته قرار گیرد. این رشته می‌تواند با درج \fBc\fR و/یا \fBr\fR پس از علامت \fB+\fR، به حروف بزرگ و کوچک حساس شده و/یا به عنوان یک عبارت باقاعده تفسیر شود. این حالت‌های جستجو را می‌توان با استفاده از نوع بزرگ این حروف به‌طور صریح غیرفعال کرد: \fBC\fR و/یا \fBR\fR. زمانی که رشته حاوی فاصله باشد، باید درون علامت نقل‌قول قرار گیرد. برای ارائه یک مثال: برای باز کردن یک فایل در اولین رخداد کلمه "Foo"، دستور زیر را اجرا می‌کنید: .sp .RS 4 .BI "nano +c/Foo " file .RE .sp به عنوان یک حالت خاص: اگر به جای نام فایل یک خط تیره (\fB\-\fR) داده شود، \fBnano\fR داده‌ها را از ورودی استاندارد خواهد خواند. .SH "اعلان‌ها (NOTICES)" از نسخه 9.0 به بعد، تمام خطوط به صورت افقی با یکدیگر پیمایش می‌شوند (هنگامی که مکان‌نما به لبه صفحه نزدیک می‌شود)، دقیقاً به میزانی که لازم است، به جای آنکه تنها خط جاری با یک گام بزرگ پیمایش شود. اگر رفتار قدیمی را ترجیح می‌دهید، می‌توانید از \fB\-\-\%solo\fR در خط فرمان یا \fBset \%solosidescroll\fR در فایل \fInanorc\fR خود استفاده کنید. .sp همچنین از نسخه 9.0، کلیدهای میانبر \fBM\-<\fR و \fBM\->\fR به توابع \fB\%scrollleft\fR و \fB\%scrollright\fR اختصاص یافته‌اند. اگر می‌خواهید این کلیدها همان کاری را که پیش از نسخه 9.0 انجام می‌دادند انجام دهند، این دو خط را به انتهای فایل \fInanorc\fR خود اضافه کنید: .sp .RS 4 .B bind M\-< prevbuf main .br .B bind M\-> nextbuf main .RE .sp از نسخه 8.0، برای راحتی کاربران تازه‌کار، کلید \fB^F\fR جستجو به جلو، \fB^B\fR جستجو به عقب، \fBM\-F\fR جستجوی رخداد بعدی به جلو، و \fBM\-B\fR جستجوی رخداد بعدی به عقب را آغاز می‌کند. اگر می‌خواهید این کلیدها همان کاری را که پیش از نسخه 8.0 انجام می‌دادند انجام دهند، چهار خط زیر را به انتهای فایل \fInanorc\fR خود اضافه کنید: .sp .RS 4 .B bind ^F forward main .br .B bind ^B back main .br .B bind M\-F formatter main .br .B bind M\-B linter main .RE .sp .SH "ویرایش (EDITING)" ورود متن و جابجایی در فایل ساده و سرراست است: تایپ کردن حروف و استفاده از کلیدهای معمولی حرکت مکان‌نما. دستورها با استفاده از کلیدهای Control (^) و Alt یا Meta (M\-) وارد می‌شوند. تایپ کردن \fB^K\fR خط جاری را حذف کرده و آن را در cutbuffer قرار می‌دهد. استفاده متوالی از \fB^K\fR تمام خطوط حذف‌شده را در کنار هم در cutbuffer قرار می‌دهد. هرگونه حرکت مکان‌نما یا اجرای هر دستور دیگری باعث می‌شود که \fB^K\fR بعدی محتوای cutbuffer را بازنویسی کند. فشردن \fB^U\fR محتویات جاری cutbuffer را در موقعیت فعلی مکان‌نما جای‌گذاری (paste) می‌کند. .sp هنگامی که نیاز است بخش دقیق‌تری از متن برش داده یا کپی شود، می‌توانید ابتدای آن را با \fB^6\fR علامت‌گذاری کنید، مکان‌نما را به انتهای آن ببرید (متن علامت‌گذاری‌شده برجسته می‌شود)، و سپس از \fB^K\fR برای برش دادن، یا از \fBM\-6\fR برای کپی کردن آن در cutbuffer استفاده کنید. همچنین می‌توانید متن علامت‌گذاری‌شده را با \fB^O\fR در یک فایل ذخیره کنید، یا با \fB^T^T\fR املای آن را بررسی نمایید. .sp در برخی پایانه‌ها، متن را می‌توان با نگه‌داشتن کلید Shift هنگام استفاده از کلیدهای جهت‌نما نیز انتخاب کرد. نگه‌داشتن کلید Ctrl یا Alt نیز گام حرکت را افزایش می‌دهد. هرگونه حرکت مکان‌نما بدون نگه‌داشتن Shift، چنین انتخابی را لغو می‌کند. .sp هر نقطه کد معتبر یونیکد (Unicode code point) را می‌توان با فشردن \fBM\-V\fR و به دنبال آن ارقام هگزادسیمال نقطه کد (که در صورت کمتر از شش رقم بودن، با \fB\fR یا \fB\fR پایان می‌یابد) در بافر درج کرد. یک کد کنترلی عینی (به‌جز \fB^J\fR) را می‌توان با فشردن \fBM\-V\fR و به دنبال آن فشردن کلید مربوطه درج نمود. .sp دو خط پایینی صفحه، برخی از دستورهای مهم را نشان می‌دهند؛ راهنمای توکار (\fB^G\fR) تمامی دستورهای موجود را فهرست می‌کند. ترکیب کلیدهای پیش‌فرض را می‌توان از طریق فایل \fInanorc\fR تغییر داد \[em] مراجعه کنید به: .BR nanorc (5). .sp با \fB^S^X\fR می‌توانید بافر را ذخیره کرده و از \fBnano\fR خارج شوید. .SH "گزینه‌ها (OPTIONS)" .TP .BR \-A ", " \-\-smarthome کلید Home را هوشمندتر می‌کند. هنگامی که در هر جایی به جز ابتدای نویسه‌های غیرفاصله در یک خط کلید Home فشرده شود، مکان‌نما به آن ابتدا می‌پرد (به جلو یا عقب). اگر مکان‌نما از قبل در آن موقعیت باشد، به ابتدای واقعی خط می‌پرد. .TP .BR \-B ", " \-\-backup هنگام ذخیره فایل، از نسخه قبلی آن با افزودن یک مدک (\fB\[ti]\fR) به انتهای نام فایل جاری، نسخه پشتیبان تهیه می‌کند. .TP .BI \-C " directory\fR, " \-\-backupdir= directory به جای ایجاد و نگهداری تنها یک فایل پشتیبان، هر بار که فایلی ذخیره می‌شود یک فایل با شماره منحصر‌به‌فرد ایجاد و نگهداری می‌کند \[em] زمانی که پشتیبان‌گیری فعال باشد (\fB\-B\fR). فایل‌های با شماره منحصر‌به‌فرد در \fI\%directory\fR مشخص‌شده ذخیره می‌شوند. .TP .BR \-D ", " \-\-boldtext برای رابط کاربری، به جای ویدئوی معکوس از قلم پررنگ (bold) استفاده می‌کند. این مورد را می‌توان برای عناصر خاص با تنظیم گزینه‌های \fB\%titlecolor\fR، \fB\%statuscolor\fR، \fB\%promptcolor\fR، \fB\%minicolor\fR، \fB\%keycolor\fR، \fB\%numbercolor\fR، و/یا \fB\%selectedcolor\fR در فایل \fInanorc\fR بازنویسی کرد. به \fBnanorc\fR(5) مراجعه کنید. .TP .BR \-E ", " \-\-tabstospaces هر تب تایپ‌شده را به فاصله تبدیل می‌کند \[em] به تعداد فاصله‌هایی که یک تب در آن موقعیت اشغال می‌کرد. (توجه: تب‌های جای‌گذاری‌شده تبدیل نمی‌شوند.) .TP .BR \-F ", " \-\-newbuffer فایل را به طور پیش‌فرض در یک بافر جدید می‌خواند. (شکل قدیمی این گزینه، یعنی \fB\-\-\%multibuffer\fR، منسوخ شده است.) .TP .BR \-G ", " \-\-locking هنگام ویرایش فایل‌ها، از قفل‌گذاری فایل به سبک vim استفاده می‌کند. .TP .BR \-H ", " \-\-historylog صد رشته جستجوی آخر، رشته‌های جایگزینی و دستورهای اجرا شده را ذخیره می‌کند تا در نشست‌های بعدی به آسانی قابل استفاده مجدد باشند. .TP .BR \-I ", " \-\-ignorercfiles نه فایل \fInanorc\fR سیستم و نه فایل \fInanorc\fR کاربر را بررسی نمی‌کند (هر دو را نادیده می‌گیرد). .TP .BI \-J " number\fR, " \-\-guidestripe= number یک نوار عمودی در ستون داده‌شده ترسیم می‌کند تا به تخمین عرض متن کمک کند. (رنگ نوار را می‌توان با \fBset \%stripecolor\fR در فایل \fInanorc\fR تغییر داد.) .TP .BR \-K ", " \-\-rawsequences توالی‌های گریز (escape sequences) را مستقیماً تفسیر می‌کند، به جای این‌که از \fI\%ncurses\fR بخواهد آن‌ها را ترجمه کند. (اگر برای عملکرد درست برخی کلیدها به این گزینه نیاز دارید، به این معنی است که شرح پایانه \fI\%terminfo\fR استفاده‌شده با رفتار واقعی پایانه شما کاملاً مطابقت ندارد. برای مثال، این موضوع ممکن است هنگام برقراری ارتباط ssh با یک ماشین BSD رخ دهد.) استفاده از این گزینه، پشتیبانی از ماوس در \fBnano\fR را غیرفعال می‌کند. .TP .BR \-L ", " \-\-nonewlines وقتی متنی به خط جدید (newline) ختم نمی‌شود، به‌طور خودکار یک خط جدید اضافه نمی‌کند. (این می‌تواند باعث شود که فایل‌های متنی ناسازگار با استاندارد POSIX ذخیره کنید.) .TP .BR \-M ", " \-\-trimblanks هنگامی که شکست سخت خودکار خطوط رخ می‌دهد یا متن تراز می‌شود، فاصله‌های خالی انتهای خط پیچیده‌شده را حذف می‌کند. .TP .BR \-N ", " \-\-noconvert تبدیل خودکار فایل‌ها از قالب DOS را غیرفعال می‌کند. .TP .BR \-O ", " \-\-bookstyle هنگام تراز کردن متن (justifying)، هر خطی را که با فاصله خالی شروع می‌شود به عنوان شروع یک پاراگراف در نظر می‌گیرد (مگر اینکه تورفتگی خودکار فعال باشد). .TP .BR \-P ", " \-\-positionlog برای ۲۰۰ فایل اخیر، آخرین موقعیت مکان‌نما را ثبت می‌کند و هنگام باز کردن مجدد چنین فایلی، آن را دوباره در همان موقعیت قرار می‌دهد. همچنین موقعیت هر لنگرگاهی را ذخیره و بازیابی می‌کند. .TP .BI "\-Q """ regex\fB"\fR, " \-\-quotestr=""" regex """" عبارت باقاعده را برای مطابقت با بخش نقل‌قول در یک سطر تنظیم می‌کند. مقدار پیش‌فرض "\fB^([\ \\t]*([!#%:;>|}]|//))+\fR" است. (توجه داشته باشید که \fB\\t\fR نشان‌دهنده یک Tab واقعی است.) این امکان مرتب‌سازی مجدد بلوک‌های متن نقل‌قول‌شده هنگام نگارش رایانامه، و شکست مجدد بلوک‌های یادداشت‌های خطی هنگام نوشتن کد مبدأ را فراهم می‌سازد. .TP .BR \-R ", " \-\-restricted تنها \fIfile\fR (یا فایل‌های) مشخص‌شده در خط فرمان را می‌خواند و می‌نویسد. این بدان معنی است: عدم خواندن یا نوشتن فایل‌های تاریخچه؛ عدم اجازه به تعلیق برنامه؛ عدم اجازه به بررسی املا؛ عدم اجازه به اجرای هرگونه دستور در شل؛ عدم اجازه به ذخیره بافر جاری با نامی دیگر؛ عدم اجازه به الحاق به ابتدا یا انتهای هر فایل؛ و عدم ایجاد فایل‌های پشتیبان. .sp به عنوان یک استثناء، پیش از فایل یا فایل‌های مشخص‌شده، فایل‌های \fInanorc\fR خوانده می‌شوند تا امکان سفارشی‌سازی فراهم باشد. اگر سفارشی‌سازی نیز نباید مجاز باشد، از گزینه \fB\-I\fR (\fB\-\-\%ignorercfiles\fR) نیز استفاده کنید. .sp هنگامی که هیچ \fIfile\fR در خط فرمان مشخص نشده باشد، حالت محدود به شما اجازه می‌دهد محتوایی را که در بافر جدید تایپ می‌کنید با هر نامی ذخیره کنید، مشروط بر اینکه فایل‌های موجود بازنویسی نشوند. اگر مکان‌هایی که این فایل جدید می‌تواند در آنجا ایجاد شود باید محدود گردد، از گزینه \fB\-o\fR (\fB\-\-\%operatingdir\fR) نیز استفاده کنید. .sp حالت محدود را می‌توان با فراخوانی \fBnano\fR با نامی که با 'r' آغاز می‌شود (مانند \fBrnano\fR) نیز فعال کرد. .TP .BR \-S ", " \-\-softwrap خطوطی را که طول آن‌ها از عرض صفحه بیشتر است، در چندین ردیف صفحه نمایش می‌دهد. (با استفاده از \fB\-\-\%atblanks\fR می‌توانید کاری کنید که این شکست نرم به جای شکستن ناگهانی در لبه صفحه، روی فاصله‌ها رخ دهد.) .TP .BI \-T " number\fR, " \-\-tabsize= number اندازه (عرض) تب را روی \fI\%number\fR ستون تنظیم می‌کند. مقدار \fI\%number\fR باید بزرگتر از 0 باشد. مقدار پیش‌فرض \fB8\fR است. .TP .BR \-U ", " \-\-quickblank باعث می‌شود پیام‌های نوار وضعیت به جای ۲۰ فشردن کلید، پس از ۱ فشردن کلید ناپدید شوند. توجه داشته باشید که گزینه \fB\-c\fR (\fB\-\-\%constantshow\fR) بر این گزینه اولویت دارد. هنگامی که گزینه \fB\-\-\%minibar\fR یا \fB\-\-\%zero\fR در حال اجرا باشد، \fB\-\-\%quickblank\fR باعث می‌شود پیام به جای ۱.۵ ثانیه پیش‌فرض، پس از ۰.۸ ثانیه ناپدید شود. . .TP .BR \-V ", " \-\-version شماره نسخه فعلی را نمایش داده و خارج می‌شود. .TP .BR \-W ", " \-\-wordbounds مرزهای کلمات را به شیوه‌ای متفاوت تشخیص می‌دهد و نویسه‌های نشانه‌گذاری را بخشی از یک کلمه به شمار می‌آورد. .TP .BI "\-X """ characters\fB"\fR, " \-\-wordchars=""" characters """" مشخص می‌کند چه نویسه‌های دیگری (علاوه بر نویسه‌های الفبایی‌عددی معمول) باید بخشی از یک کلمه در نظر گرفته شوند. هنگام استفاده از این گزینه، احتمالاً ترجیح می‌دهید \fB\-W\fR (\fB\-\-\%wordbounds\fR) را نادیده بگیرید. .TP .BI \-Y " name\fR, " \-\-syntax= name نام رنگ‌آمیزی نحوی مورد استفاده را از میان موارد تعریف‌شده در فایل‌های \fInanorc\fR مشخص می‌کند. .TP .BR \-Z ", " \-\-zap اجازه می‌دهد که فشردن عادی کلید Backspace یا Delete، ناحیه علامت‌گذاری‌شده را پاک کند (به جای یک نویسه تکی، و بدون تأثیر روی cutbuffer). .TP .BR \-a ", " \-\-atblanks هنگام انجام شکست نرم خطوط، خطوط را در فاصله‌ها می‌پیچد به جای آنکه همواره در لبه صفحه شکسته شوند. .TP .BR \-b ", " \-\-breaklonglines خط جاری را هنگامی که بیش از حد طولانی شود به‌طور خودکار به صورت سخت می‌شکند؛ یعنی هنگامی که عریض‌تر از مقدار داده‌شده با \fB\-r\fR (\fB\-\-fill\fR) شود. مقدار پیش‌فرض برای \fB\-r\fR عرض پایانه منهای هشت است. (این گزینه نقطه مقابل گزینه \fB\-w\fR (\fB\-\-\%nowrap\fR) است \[em] آخرین گزینه واردشده اعمال می‌شود.) .TP .BR \-c ", " \-\-constantshow موقعیت مکان‌نما را به‌طور مداوم در نوار وضعیت گزارش می‌دهد. توجه داشته باشید که این گزینه بر گزینه \fB\-U\fR (\fB\-\-\%quickblank\fR) اولویت دارد. .TP .BR \-d ", " \-\-rebinddelete کلیدهای Delete و Backspace را به‌طور متفاوتی تفسیر می‌کند تا هر دو کلید به درستی کار کنند. تنها زمانی باید از این گزینه استفاده کنید که در سیستم شما Backspace مانند Delete عمل کند یا Delete مانند Backspace رفتار نماید. .TP .BR \-e ", " \-\-emptyline از خط زیرین نوار عنوان استفاده نمی‌کند و آن را کاملاً خالی رها می‌کند. .TP .BI \-f " file\fR, " \-\-rcfile= file به جای خواندن فایل‌های \fInanorc\fR سراسری سیستم و کاربر، تنها این \fIfile\fR را برای تنظیم گزینه‌های \fBnano\fR می‌خواند. .TP .BR \-g ", " \-\-showcursor مکان‌نما را در مرورگر فایل (با قرار دادن آن روی مورد برجسته‌شده) و در نمایش‌دهنده راهنما مرئی می‌کند. برای کاربران خط بریل و افرادی با بینایی ضعیف مفید است. .TP .BR \-h ", " \-\-help خلاصه‌ای از گزینه‌های موجود خط فرمان را نمایش داده و خارج می‌شود. .TP .BR \-i ", " \-\-autoindent یک خط تازه ایجادشده را به‌طور خودکار با همان تعداد تب و/یا فاصله‌های خط قبلی تورفتگی می‌دهد (یا خط بعدی اگر خط قبلی ابتدای یک پاراگراف باشد). .TP .BR \-j ", " \-\-jumpyscrolling محتویات بافر را به جای خط‌به‌خط، به اندازه نیم‌صفحه پیمایش می‌کند. .TP .BR \-k ", " \-\-cutfromcursor دستور 'Cut Text' (معمولاً \fB^K\fR) را طوری تنظیم می‌کند که از موقعیت فعلی مکان‌نما تا انتهای خط را برش دهد، به جای این‌که کل خط را برش دهد. .TP .BR \-l ", " \-\-linenumbers شماره خطوط را در سمت چپ ناحیه متن نمایش می‌دهد. (هر خطی که دارای یک لنگرگاه باشد، نشانه‌ای اضافی در حاشیه دریافت می‌کند.) .TP .BR \-m ", " \-\-mouse پشتیبانی از ماوس را (در صورت در دسترس بودن در سیستم شما) فعال می‌کند. در صورت فعال بودن، کلیک‌های ماوس را می‌توان برای قرار دادن مکان‌نما، تنظیم علامت (با دوبار کلیک) و اجرای میانبرها استفاده کرد. ماوس در سامانه پنجره X و در کنسول هنگام اجرای gpm کار می‌کند. متن را همچنان می‌توان با نگه‌داشتن کلید Shift و کشیدن ماوس انتخاب کرد. .TP .BR \-n ", " \-\-noread با هر نام داده‌شده در خط فرمان به عنوان یک فایل جدید برخورد می‌کند. این به \fBnano\fR اجازه می‌دهد در لوله‌های نام‌گذاری‌شده بنویسد: با یک بافر خالی شروع می‌شود و زمانی که کاربر «فایل» را ذخیره می‌کند در پایپ می‌نویسد. بدین ترتیب \fBnano\fR می‌تواند به عنوان یک ویرایشگر در ترکیب با مثلاً \fBgpg\fR بدون نیاز به نوشتن اولیه داده‌های حساس روی دیسک به کار رود. .TP .BI \-o " directory\fR, " \-\-operatingdir= directory به \fI\%directory\fR داده‌شده تغییر مسیر می‌دهد و خواندن و نوشتن فایل‌ها را تنها در این شاخه و زیرشاخه‌های آن مجاز می‌شمارد. .TP .BR \-p ", " \-\-preserve توالی‌های XOFF و XON (\fB^S\fR و \fB^Q\fR) را حفظ می‌کند تا توسط پایانه دریافت شوند (متوقف کردن و از سر گرفتن خروجی). توجه داشته باشید که گزینه \fB\-/\fR (\fB\-\-\%modernbindings\fR) این رفتار را لغو می‌کند. .TP .BR \-q ", " \-\-indicator یک «نوار پیمایش» در سمت راست پنجره ویرایش نمایش می‌دهد. این نوار موقعیت دیدگاه را در بافر و میزان پوشش بافر توسط دیدگاه را نشان می‌دهد. .TP .BI \-r " number\fR, " \-\-fill= number عرض هدف را برای مرتب‌سازی و شکست سخت خودکار روی این \fI\%number\fR از ستون‌ها تنظیم می‌کند. اگر مقدار ۰ یا کمتر باشد، شکست خط در عرض صفحه منهای \fI\%number\fR ستون رخ می‌دهد، که اجازه می‌دهد در صورت تغییر اندازه صفحه، نقطه شکست نیز متناسب با عرض صفحه تغییر کند. مقدار پیش‌فرض \fB\-8\fR است. .TP .B "\-s ""\fIprogram\fR [\fIargument \fR...]\fB""\fR, \fB\-\-speller=""\fIprogram\fR [\fIargument \fR...]\fB""" از این دستور برای انجام بررسی و تصحیح املا استفاده می‌کند، به جای استفاده از تصحیح‌کننده توکار که \fB\%hunspell\fR(1) یا \fBspell\fR(1) را فراخوانی می‌کند. .TP .BR \-t ", " \-\-saveonexit بافر تغییریافته را بدون درخواست تأیید ذخیره می‌کند (هنگام خروج با \fB^X\fR). .TP .BR \-u ", " \-\-unix فایل را به طور پیش‌فرض در قالب یونیکس ذخیره می‌کند. این گزینه رفتار پیش‌فرض \fBnano\fR مبنی بر ذخیره فایل در قالبی که قبلاً داشت را لغو می‌کند. (این گزینه هنگامی که از \fB\-\-\%noconvert\fR نیز استفاده کنید اثری ندارد.) .TP .BR \-v ", " \-\-view تنها مشاهده فایل و عدم اجازه به ویرایش: حالت فقط‌خواندنی. این حالت به کاربر اجازه می‌دهد فایل‌های دیگری را نیز برای مشاهده باز کند، مگر اینکه \fB\-\-\%restricted\fR نیز داده شده باشد. .TP .BR \-w ", " \-\-nowrap خط جاری را در صورت طولانی شدن به‌طور خودکار به صورت سخت نمی‌شکند. این رفتار پیش‌فرض است. (این گزینه نقطه مقابل گزینه \fB\-b\fR (\fB\-\-\%breaklonglines\fR) است \[em] آخرین گزینه واردشده اعمال می‌شود.) .TP .BR \-x ", " \-\-nohelp دو خط راهنما در پایین صفحه را نشان نمی‌دهد. .TP .BR \-y ", " \-\-afterends کاری می‌کند که Ctrl+Right و Ctrl+Delete به جای ابتدای کلمات، در انتهای کلمات متوقف شوند. .TP .BR \-z ", " \-\-listsyntaxes نام ساختارهای نحوی در دسترس را فهرست کرده و خارج می‌شود. .TP .BR \-! ", " \-\-magic هنگامی که نه نام فایل و نه خط اول آن سرنخی به دست نمی‌دهند، تلاش می‌کند با استفاده از \fI\%libmagic\fR ساختار نحوی مربوطه را تشخیص دهد. .TP .BR \-@ ", " \-\-colonparsing هنگامی که نام فایل داده‌شده در خط فرمان به دونقطه به همراه ارقام ختم شود و این نام فایل وجود نداشته باشد، دونقطه و ارقام را حذف کرده و آن ارقام را به عنوان شماره خط در نظر می‌گیرد. اگر نام فایل برش‌خورده نیز وجود نداشته باشد، فرایند تکرار شده و دو عدد به‌دست‌آمده به عنوان شماره خط و شماره ستون در نظر گرفته می‌شوند. اما اگر نام فایل دو بار برش‌خورده نیز وجود نداشته باشد، برش‌ها نادیده گرفته شده و نام فایل اصلی همان‌طور که هست پذیرفته می‌شود. برای غیرفعال کردن این تجزیه با دونقطه برای فایلی خاص، از \fB+1\fR یا موارد مشابه قبل از نام فایل مربوطه استفاده کنید. .TP .BR \-% ", " \-\-stateflags از گوشه بالا سمت راست صفحه برای نمایش برخی پرچم‌های وضعیت استفاده می‌کند: \fBI\fR هنگام تورفتگی خودکار، \fBM\fR هنگام روشن بودن علامت‌گذاری، \fBL\fR هنگام شکست سخت خطوط (شکستن خطوط طولانی)، \fBR\fR هنگام ضبط ماکرو، و \fBS\fR هنگام شکست نرم خطوط. هنگامی که بافر اصلاح شود، یک ستاره (\fB*\fR) بعد از نام فایل در مرکز نوار عنوان نمایش داده می‌شود. .TP .BR \-_ ", " \-\-minibar نوار عنوان را پنهان کرده و در عوض اطلاعات مربوط به بافر جاری را در پایین صفحه، در فضای نوار وضعیت نشان می‌دهد. در این «نوار کوچک» (mini bar)، نام فایل در سمت چپ نمایش داده می‌شود که در صورت اصلاح شدن بافر، یک ستاره به دنبال آن می‌آید. در سمت راست، شماره خط و ستون فعلی، کد نویسه زیر مکان‌نما (در قالب یونیکد: U+xxxx)، همان پرچم‌هایی که توسط \fB\-\-\%stateflags\fR نشان داده می‌شوند، و درصدی که نشان‌دهنده موقعیت مکان‌نما در طول فایل است (بر حسب خطوط) نمایش داده می‌شوند. هنگامی که فایلی بارگذاری یا ذخیره می‌شود، و همچنین هنگام جابجایی بین بافرها، تعداد خطوط بافر بعد از نام فایل نمایش داده می‌شود. این عدد با فشردن کلید بعدی پاک شده، یا در صورت باز بودن چندین بافر، با یک شمارنده [i/n] جایگزین می‌شود. شماره خط و ستون و کد نویسه تنها زمانی که از \fB\-\-\%constantshow\fR استفاده شده باشد نمایش داده می‌شوند و می‌توان آن‌ها را با \fBM\-C\fR فعال یا غیرفعال کرد. پرچم‌های وضعیت تنها زمانی نمایش داده می‌شوند که از \fB\-\-\%stateflags\fR استفاده شده باشد. .TP .BR \-0 ", " \-\-zero تمام عناصر رابط کاربری (نوار عنوان، نوار وضعیت و خطوط راهنما) را پنهان کرده و از تمامی ردیف‌های پایانه برای نمایش محتویات بافر استفاده می‌کند. نوار وضعیت تنها زمانی ظاهر می‌شود که پیام مهمی وجود داشته باشد و پس از ۱.۵ ثانیه یا با فشردن کلید بعدی ناپدید می‌شود. با \fBM\-Z\fR نوار عنوان به همراه نوار وضعیت را می‌توان پنهان/آشکار کرد. با \fBM\-X\fR خطوط راهنما را. .TP .BR \-1 ", " \-\-solosidescroll هنگامی که مکان‌نما به لبه راست پنجره ویرایش نزدیک می‌شود، تنها خط جاری را به مقدار زیادی به طرفین پیمایش می‌کند، به جای این‌که تمام خطوط مرئی را دقیقاً به میزان لازم برای دیده‌شدن مکان‌نما به طرفین پیمایش کند. این پیمایش جانبی روان برای کل پنجره، رفتار پیش‌فرض جدید است. پیمایش جانبی پرشی و تک‌خطی فعال‌شده با این گزینه، رفتار قدیمی بود \[em] تنها رفتاری که \fBnano\fR پیش‌تر می‌شناخت. .TP .BR \-/ ", " \-\-modernbindings از کلیدهای میانبر مشابه برنامه‌های امروزی استفاده می‌کند: \fB^X\fR برش (cut)، \fB^C\fR کپی (copy)، \fB^V\fR جای‌گذاری (paste)، \fB^Z\fR واگرد (undo)، \fB^Y\fR ازنو (redo)، \fB^F\fR جستجو به جلو، \fB^G\fR جستجوی بعدی، \fB^S\fR ذخیره، \fB^O\fR باز کردن فایل، \fB^Q\fR خروج، و (در صورت امکان‌پذیر بودن در پایانه) \fB^H\fR نمایش راهنما. همچنین، \fB^A\fR علامت‌گذاری، \fB^B\fR جستجو به عقب، \fB^D\fR جستجوی قبلی، \fB^R\fR جایگزینی، \fB^P\fR نمایش موقعیت، \fB^T\fR رفتن به خط، \fB^W\fR نوشتن و ذخیره فایل، و \fB^E\fR اجرای دستور. توجه داشته باشید که این گزینه بر گزینه \fB\-p\fR (\fB\-\-\%preserve\fR) اولویت دارد. .SH "کلیدهای تغییر وضعیت (TOGGLES)" تعدادی از گزینه‌های بالا را می‌توان در حین اجرای \fBnano\fR نیز روشن و خاموش کرد. برای مثال، \fBM\-L\fR شکست سخت خطوط طولانی، \fBM\-S\fR شکست نرم، \fBM\-N\fR شماره‌گذاری خطوط، \fBM\-M\fR ماوس، \fBM\-I\fR تورفتگی خودکار، و \fBM\-X\fR خطوط راهنما را تغییر وضعیت می‌دهد. برای مشاهده فهرست کامل، به انتهای متن راهنمای \fB^G\fR مراجعه فرمایید. .sp کلید تغییر وضعیت \fBM\-X\fR ویژه است: در تمامی منوها به جز نمایش‌دهنده راهنما و linter کار می‌کند. تمام کلیدهای تغییر وضعیت دیگر تنها در منوی اصلی عمل می‌کنند. .SH "فایل‌ها (FILES)" هنگامی که \fB\-\-\%rcfile\fR مشخص شده باشد، \fBnano\fR تنها فایل مشخص‌شده را برای تنظیم گزینه‌ها، ساختار نحوی و کلیدهای میانبر می‌خواند. بدون این گزینه، \fBnano\fR دو فایل پیکربندی را می‌خواند: ابتدا \fInanorc\fR سیستم (در صورت وجود) و سپس \fInanorc\fR کاربر (در صورت وجود)، یعنی \fI\%\[ti]/.nanorc\fR یا \fI\%$XDG_CONFIG_HOME/\:nano/\:nanorc\fR یا \fI\%\[ti]/.config/\:nano/\:nanorc\fR (هر کدام که زودتر یافت شود). برای اطلاعات بیشتر در مورد محتویات احتمالی این فایل‌ها به: .BR nanorc (5) مراجعه کنید. .sp برای تعاریف موجود رنگ‌آمیزی نحوی، به \fI/usr/\:share/\:nano/\fR و \fI/usr/\:share/\:nano/\:extra/\fR مراجعه فرمایید. .SH "وضعیت خروج (EXIT STATUS)" .TP .B 0 ویرایشگر به صورت عادی به پایان رسید. .TP .B 1 گزینه نامعتبر یا آرگومان نامعتبر برای گزینه مشخص شده است. .TP .B 2 آخرین بافر باز نادیده گرفته و رها شد (با \fB^O^Q\fR یا \fB^X^Q\fR). .SH "نکات (NOTES)" قابلیت تعلیق برنامه به‌طور پیش‌فرض فعال است و از طریق \fB^T^Z\fR در دسترس قرار دارد. (اگر می‌خواهید فشردن یک \fB^Z\fR ساده نانو را معلق کند، عبارت \fBbind ^Z suspend main\fR را به فایل \fInanorc\fR خود اضافه کنید.) .sp در اعلان‌های دوگزینه‌ای بله/خیر، \fB^Y\fR می‌تواند برای "بله" (Yes)، \fB^N\fR برای "خیر" (No)، و \fB^A\fR برای "همه" (All) به کار رود. (و هنگام خروج، \fB^Q\fR می‌تواند برای "خروج همراه با خطا" استفاده شود.) این کلیدهای فهرست‌نشده در هر محلی‌سازی زبانی (locale) کار می‌کنند. .sp هنگامی که می‌خواهید متن علامت‌گذاری‌شده را از \fBnano\fR در کلیپ‌بورد سیستم کپی کنید، به یکی از مثال‌های موجود در صفحه راهنمای \fBnanorc\fR(5) مراجعه فرمایید. .sp اگر هیچ دستور بررسی املای جایگزینی نه در خط فرمان و نه در یکی از فایل‌های \fInanorc\fR مشخص نشده باشد، \fBnano\fR متغیر محیطی \fBSPELL\fR را برای یافتن آن بررسی می‌کند. .sp در برخی موارد \fBnano\fR تلاش می‌کند بافر را درون یک فایل اضطراری ذخیره کند. این اتفاق بیشتر زمانی رخ می‌دهد که \fBnano\fR سیگنال SIGHUP یا SIGTERM دریافت کند یا حافظه کافی در دسترس نداشته باشد. اگر بافر نامی نداشته باشد، آن را در فایلی با نام \fI\%nano.save\fR ذخیره می‌کند، یا پسوند ".save" را به نام فایل جاری می‌افزاید. اگر یک فایل اضطراری با آن نام از قبل در شاخه جاری وجود داشته باشد، برای منحصر‌به‌فرد ساختن آن، پسوند ".save" به همراه یک شماره (برای مثال: ".save.1") را به نام فایل فعلی اضافه می‌کند. هنگامی که چند بافر باز باشد، \fBnano\fR هر بافر تغییریافته را در فایل اضطراری متناظر با خود می‌نویسد. .sp راهنمای کامل این برنامه در قالب Texinfo نگهداری می‌شود. می‌توانید آن را با دستور \fBinfo nano\fR یا در نشانی زیر مطالعه کنید: .IR https://nano\-editor.org/dist/latest/nano.html . .sp اگر پرسشی درباره نحوه استفاده از \fBnano\fR در وضعیتی خاص دارید، می‌توانید آن را در \fIhelp\-nano@gnu.org\fR مطرح کنید. .SH "اشکالات (BUGS)" ضبط و پخش ماکروهای صفحه‌کلید تنها در یک شبیه‌ساز پایانه به درستی عمل می‌کند، نه در کنسول لینوکس (VT)؛ زیرا کنسول لینوکس به‌طور پیش‌فرض کلیدهای جهت‌نمای اصلاح‌شده را از کلیدهای بدون کلید تغییردهنده تمیز نمی‌دهد. .sp لطفاً هرگونه اشکال دیگری را که با آن مواجه می‌شوید، از طریق نشانی زیر گزارش دهید: .br .IR https://savannah.gnu.org/bugs/?group=nano . .sp هنگامی که \fBnano\fR دچار فروپاشی (crash) می‌شود، هر بافر تغییریافته را در فایل‌های اضطراری \fI.save\fR ذخیره می‌کند. اگر قادر به بازتولید فروپاشی هستید و می‌خواهید یک ردگیری پشته (backtrace) به دست آورید، متغیر محیطی \fBNANO_NOCATCH\fR را تعریف کنید. .SH "صفحه خانگی (HOMEPAGE)" .I https://nano\-editor.org .SH "همچنین ببینید (SEE ALSO)" .BR nanorc (5) .sp \fI/usr/share/doc/nano/\fR (یا معادل آن در سیستم شما)