nanorc

У файлах nanorc містяться типові параметри nano, малого і дружнього до користувача редактора. Під час запуску, якщо не задано --rcfile, nano виконуватиме читання двох файлів: спочатку загальносистемних параметрів з /etc/nanorc (точний шлях може бути іншим у вашій системі), а потім специфічних для користувача параметрів, або з ~/.nanorc, або з $XDG_CONFIG_HOME/nano/nanorc, або з ~/.config/nano/nanorc, з того, який буде виявлено першим. Якщо використано параметр --rcfile, nano виконає читання лише з вказаного файла параметрів.

ПАРАМЕТРИ

У файлі налаштувань можна вказати послідовність команд set і unset, якими можна скористатися для налаштовування запуску nano без використання параметрів командного рядка. Крім того, передбачено декілька команд для визначення підсвічування синтаксичних конструкцій та зміни прив'язки клавіш -- ці команди описано у двох окремих розділах. nano читатиме по одній команді на рядок. Усі команди і ключові слова слід вказувати малими літерами.

Параметри у файлах nanorc мають вищий пріоритет за типові параметри nano, а параметри рядка команди мають вищий пріоритет за параметри у nanorc. Крім того, параметри, які не приймають аргументів, типово вважаються невизначеними. Отже, використання команди unset потрібне лише для перевизначення параметра у загальносистемному файлі nanorc у вашому власному файлі nanorc. Визначення параметрів, які приймають аргументи, не можна скасувати.

Лапки у параметрах символи, які описано нижче, не потрібно екранувати. Останні подвійні лапки у рядку вважатимуться завершальними лапками.

Підтримувані команди і аргументи:

set afterends: Зробити так, щоб комбінації Ctrl+Стрілка праворуч і Ctrl+Delete зупиняли курсор на кінцях слів, а не на початках.

set allow_insecure_backup: При резервному копіюванні файлів дозволити успішне завершення резервного копіювання, навіть якщо права доступу не може бути встановлено або скинуто через обмеження операційної системи. НЕ варто користуватися цим параметром, якщо ви не певні щодо того, чи він вам потрібен.

set atblanks: Якщо увімкнено м'яке перенесення рядків, переносити рядки на пробільних символах (пробілах або табуляціях), а не точно на краю екрана.

set autoindent: Автоматично встановлювати відступ у новоствореному рядку, з тієї самої кількості символів табуляції і/або пробілів, що і у попередньому рядку (або у наступному рядку, якщо попередній рядок був початком абзацу).

set backup: При збереженні файла створювати резервну копію, назва якої утворюється шляхом додавання тильди ( ~) до назви файла.

set backupdir каталог: Створювати і зберігати не лише одну резервну копію файла, але цілу послідовність нумерованих резервних копій, коли ви зберігаєте файл -- якщо увімкнено резервне копіювання за допомогою set backup, --backup або -B. Пронумеровані файли буде збережено у вказаному каталозі каталог.

set boldtext: Використовувати напівжирний шрифт замість інверсії кольорів на смужці заголовка, смужці стану, записах комбінацій клавіш, міток функцій, номерах рядків та позначеному тексті. Може бути скасовано встановленням значень параметрів titlecolor, statuscolor, keycolor, functioncolor, numbercolor, and selectedcolor.

set bookstyle: Якщо текст вирівняно за шириною, вважати будь-який рядок, який починається з пробілу, початковим рядком абзацу (якщо не увімкнено автоматичне встановлення відступів).

set brackets "символи ": Встановити символи, які вважатимуться завершальними дужками при вирівнюванні абзаців. Сюди не можна включати символи-пробіли. Можна використовувати лише завершальну пунктуацію (див. set punct), після якої можуть перебувати вказані завершальні дужки. Може завершувати речення. Типовим значенням є « "')>]}».

set breaklonglines: Автоматично жорстко переносити поточний рядок, якщо він є надто довгим.

set casesensitive: Типово, виконувати пошук із врахуванням регістру символів.

set constantshow: Неперервно показувати позицію курсора на смужці стану. Зауважте, що це призведе до перевизначення параметра ( quickblank).

set cutfromcursor: Використовувати типово вирізання від курсора до кінця рядка, замість вирізання усього рядка.

set emptyline: Не використовувати рядок одразу під смужкою заголовка, лишаючи його повністю порожнім.

set errorcolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати вказану комбінацію кольорів для смужки стану при показі повідомлення про помилку. Типовим значенням є bold,white,red. Див. set titlecolor, щоб ознайомитися із коректними назвами кольорів.

set fill число: Встановити ширину для вирівнювання за шириною та автоматичного жорсткого перенесення рядків на вказаній позиції число. Якщо число дорівнюватиме нулеві або буде меншим за нуль, перенесення буде виконано на позиції, яка дорівнює різниці між шириною екрана і числом, що надає змогу варіювати позицію перенесення із шириною екрана, якщо ширину екрана буде змінено. Типовим значенням є -8.

set functioncolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати цю комбінацію кольорів для короткого опису функціональних можливостей у двох рядках довідки у нижній частині екрана. Див. set titlecolor, щоб дізнатися більше.

set guidestripe число: Малювати вертикальну смужку на заданій позиції у рядку, щоб простіше було визначати ширину тексту. (Колір смужки можна змінити за допомогою параметра set stripecolor.)

set historylog: Зберігати останні сто рядків пошуку і заміни, а також виконаних команд, щоб можна було без проблеми користуватися ними у наступних сеансах.

set indicator: Показувати «смужку гортання» у правій частині вікна редагування. На смужці буде показано позицію поля перегляду у буфері і частку буфера, яку зайнято полем перегляду.

set jumpyscrolling: Гортати вміст буфера порціями у пів екрана, замість гортання по одному рядку.

set keycolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати цю комбінацію кольорів для комбінацій клавіш скорочень у двох рядках довідки у нижній частині екрана. Див. set titlecolor, щоб дізнатися більше.

set linenumbers: Показувати номери рядків у лівій частині області тексту. (Будь-який рядок з прив'язкою додатково матиме позначку на полях.)

set locking: Увімкнути файли блокування у стилі vim при редагуванні файлів.

set magic: Якщо ні назва файла, ні його перший рядок не дають це визначити, спробувати скористатися libmagic для визначення відповідного синтаксису. (Виклик libmagic може бути відносно витратним щодо часу. Через це, його виклик типово не виконується.)

set matchbrackets "символи ": Вказати початкову і завершальну дужки, які може бути знайдено засобом пошуку дужок. У списку не повинно бути пробільних символів. Набір початкових дужок має передувати набору завершальних. Набори має бути вказано в одному порядку. Типовим значенням є « (<[{)>]}».

set minibar: Придушити виведення смужки заголовка і, замість неї, показати відомості щодо поточного буфера у нижній частині екрана, за рахунок місця для смужки стану. На цій «мініпанелі» назву файла буде показано ліворуч, після неї буде показано зірочку, якщо до буфера було внесено зміни. Праворуч буде показано номери поточного рядка і позиції у ньому, код символу під курсором (у форматі Unicode: U+xxxx), ті самі прапорці, що і показані за допомогою set stateflags, та частку вмісту файла, яка відповідає поточній позиції курсора у ньому (за рядками). При завантаженні або збереженні файла, а також при перемиканні між буферами, після назви файла буде показано кількість рядків у буфері. Цю кількість буде витерто після натискання будь-якої клавіш або замінено на лічильник [i/n], якщо відкрито декілька буферів. Дані щодо позицій у рядку та коду символів, буде показано, лише якщо використано параметр set constantshow. Їхній показ можна увімкнути чи вимкнути за допомогою комбінації M-C. Прапорці стану буде показано, лише якщо використано параметр set stateflags.

set minicolor [bold,][italic,]колір_тексту ,колір_тла: Використати вказану комбінацію кольорів для мініпанелі. (Якщо цей параметр не вказано, буде використано кольори смужки заголовка.) Див. set titlecolor, щоб дізнатися більше.

set mouse: Увімкнути підтримку миші, якщо таку передбачено у вашій системі. Якщо увімкнено, за допомогою клацання кнопками миші можна буде змінювати розташування курсора, встановлювати позначку (подвійним клацанням) та користуватися комбінаціями-скороченнями з клавішами клавіатури. Миша працюватиме під керуванням X Window System та у консолі, якщо запущено gpm. Фрагмент тексту можна буде позначати перетягуванням із одночасним утриманням натиснутою клавіші Shift.

set multibuffer: При читанні файла за допомогою ^R типово вставляти його до нового буфера.

set noconvert: Не перетворювати файли з формату DOS/Mac.

set nohelp: Не показувати два рядки довідки у нижній частині екрана.

set nonewlines: Не додавати символ нового рядка автоматично, якщо текст не завершується ним. (Це надасть вам змогу зберігати текстові файли, у яких порушено стандарт POSIX.)

set nowrap: Застарілий параметр, оскільки його використання стало типовою поведінкою. Якщо потрібно, скористайтеся замість нього unset breaklonglines.

set numbercolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати цю комбінацію кольорів для номерів рядків. Див. set titlecolor, щоб дізнатися більше.

set operatingdir каталог: nano читатиме і записуватиме файли лише у вказаному каталозі каталог та його підкаталогах. Крім того, буде змінено поточний каталог на вказаний, тому файли вставлятимуться з цього каталогу. Типово, можливість визначення робочого каталогу вимкнено.

set positionlog: Зберігати позицію курсора у файлах між сеансами редагування. Програма пам'ятатиме позицію курсора для 200 останніх редагованих файлів.

set preserve: Зберігати послідовності XON і XOFF ( ^Q і ^S).

set promptcolor [bold,][italic,]колір_тексту ,колір_тла: Використати вказану комбінацію кольорів для панелі запитів. (Якщо цей параметр не вказано, буде використано кольори смужки заголовка.) Див. set titlecolor, щоб дізнатися більше.

set punct "символи ": Встановити символи, які вважатимуться завершальною пунктуацією при вирівнюванні абзаців. Сюди не можна включати символи-пробіли. Можна використовувати лише вказані завершальні символи пунктуації, за якими може бути вказано завершальні дужки (див. brackets). Може завершувати речення. Типовим значенням є « !.?».

set quickblank: Зробити так, щоб повідомлення на смужці стану зникали після 1 натискання клавіші, а не після 20. Зауважте, що параметр ( constantshow) має пріоритет над цим параметром. Якщо задіяно параметр minibar або zero, quickblank призводить до зникнення повідомлення за 0,8 секунд замість типових 1,5 секунди.

set quotestr "формальний_вираз ": Встановити формальний вираз для визначення частини рядка у лапках. Типовим значенням є " ^([ \t]*([!#%:;>|}]|//))+". (Зауважте, що \t є замінником символу табуляції.) Це уможливлює перебудову блоків цитованого тексту при створенні повідомлень електронної пошти і повторного перенесення у блоках рядкових коментарів при написанні програмного коду.

set rawsequences: Обробляти керівні послідовності безпосередньо, а не використовувати ncurses для їхньої обробки. (Якщо вам потрібен цей параметр для того, щоб нормально працювали деякі клавіші, це означає, що опис термінала у terminfo, який використано, не повністю відповідає поведінці вашого термінала. Таке може трапитися, наприклад, якщо ви використовуєте ssh на комп'ютері з BSD.) Використання цього параметра вимикає підтримку роботи з мишею у nano.

set rebinddelete: Обробляти Delete і Backspace в інший спосіб, щоб і Backspace, і Delete працювали належним чином. Цим параметром варто користуватися, лише якщо або Backspace працює як Delete, або Delete працює як Backspace.

set regexp: Типово, виконувати пошук за формальними виразами. Формальні виразу у nano належать до розширеного типу (ERE).

set saveonexit: Зберегти змінений буфер автоматично при виході ( ^X); без запиту щодо дії.

set scrollercolor колір_тексту ,колір_тла: Використовувати вказану комбінацію кольорів індикаторного варіанта «смужки гортання». (У емуляторах термінала, які скомпоновано з libvte версії, старішої за 0.55, використання тут кольору тла не працюватиме належним чином.) Див. set titlecolor, щоб дізнатися більше.

set selectedcolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати цю комбінацію кольорів для позначеного тексту. Див. set titlecolor, щоб дізнатися більше.

set showcursor: Зробити курсор видимим у навігаторі файлами (розташувати його на підсвіченому пункті) та у засобі перегляду довідки. Корисно для користувачів азбуки Брайля та тих, хто недобачає.

set smarthome: Зробити поведінку у відповідь на натискання клавіші Home кмітливішою. Якщо Home натиснуто десь, окрім на самому початку непробільних символів у рядку, курсор перестрибне на цей початок (вперед або назад). Якщо курсор вже перебуває на цій позиції, він перестрибне на справжній початок рядка.

set softwrap: Показувати рядки, довжина яких перевищує ширину екрана, у декількох рядках. (Ви можете наказати програмі виконувати це завдання м'яким перенесенням, а не грубим розриванням на краю екрана, за допомогою додаткового параметра set atblanks.)

set speller "програма [ аргумент ...] ": Скористатися вказаною програмою для виконання перевірки і виправлення правопису, замість використання вбудованого засобу виправлення, який викликає hunspell(1) або spell(1).

set spotlightcolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати вказану комбінацію кольорів для підсвічування відповідника пошуку. Типовим значенням є black,lightyellow. Див. set titlecolor, щоб ознайомитися із коректними назвами кольорів.

set stateflags: Використати верхній правий кут екрана для показу деяких прапорців стану: I, якщо увімкнено автовідступ, M, якщо увімкнено позначку, L, якщо увімкнено жорстке перенесення (розбиття довгих рядків), R, якщо ведеться запис макроса, та S, якщо увімкнено режим м'якого перенесення рядків. Якщо до буфера внесено зміни, після назви файла у центрі смужки заголовка буде показано зірочку ( *).

set statuscolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати цю комбінацію кольорів для смужки стану. Див. set titlecolor, щоб дізнатися більше.

set stripecolor [bold,][italic,]колір_тексту ,колір_тла: Використовувати цю комбінацію кольорів для вертикальної напрямної смужки. Див. set titlecolor, щоб дізнатися більше.

set tabsize число: Встановити розмір (ширину) табуляції у число позицій. Значення число має бути додатним. Типовим значенням є 8.

set tabstospaces: Перетворювати усі введенні символи табуляції на пробіли. Число вказує кількість пробілів, на які слід замінити одну табуляцію.

set titlecolor [bold,][italic,]колір_тексту ,колір_тла: Використати вказану комбінацію кольорів для смужки заголовка. Коректними назвами для кольорів тексту і тла є такі: red, green, blue, magenta, yellow, cyan, white і black. До кожної з цих восьми назв можна дописати слово-префікс light, щоб отримати яскравішу версію відповідного кольору. Словом grey або gray можна скористатися як синонімом lightblack. У емуляторах термінала, де передбачено принаймні 256 кольорів, іншими коректними (але без префіксів) назвами кольорів є такі: pink, purple, mauve, lagoon, mint, lime, peach, orange, latte, rosy, beet, plum, sea, sky, slate, teal, sage, brown, ocher, sand, tawny, brick, crimson та normal -- де normal означає типовий колір тексту або тла. У таких емуляторах термінала колір також можна вказати у форматі трицифрового шістнадцяткового числа із префіксом #. Цифри також числа відповідають величинам червоного, зеленого та синього компонентів, відповідно. Визначення таких кольорів наказує nano вибрати з доступної палітри колір, який є найближчим до вказаних значень. Можна не вказувати або « колір_тексту», або « ,колір_тла», а перед парою значень може бути вказано bold і/або italic (відокремлені комами) для отримання напівжирного і/або курсивного тексту, якщо у вашому терміналі передбачено такі можливості.

set trimblanks: Вилучити кінцеві пробіли з перенесеного рядка, якщо відбулося автоматичне жорстке перенесення рядка або якщо текст вирівняно за шириною.

set unix: Типово зберігати файл у форматі Unix. Це перевизначає типову поведінку nano, яка полягає у зберіганні файла у форматі, який він мав до редагування. (Цей параметр ні на що не впливає, якщо ви також скористаєтеся set noconvert.)

set whitespace "символи ": Встановити два символи, які вказуватимуть на наявність табуляцій і пробілів. Це мають бути однопозиційні символи. Типовою парою для локалі UTF-8 є « »⋅», а для інших локалей — « >.».

set wordbounds: Визначати межі слова в інший спосіб, вважаючи символи пунктуації частиною слова.

set wordchars "символи ": Вказати, які інші символи (окрім звичайних літер і цифр) слід вважати частиною слова. Якщо використано цей параметр, варто вимкнути wordbounds.

set zap: Вилучати позначений фрагмент (а не один символ, без впливу на буфер вирізання) у відповідь на натискання немодифікованих Backspace або Delete.

set zero: Приховати усі елементи інтерфейсу (смужку заголовка, смужку стану та рядки довідки) і використати усі рядки термінала для показу вмісту буфера. Смужку стану буде показано, лише якщо там є змістовне повідомлення, яке зникне за 1,5 секунди або після натискання будь-якої клавіші. За допомогою натискання комбінації клавіш M-Z можна увімкнути або вимкнути показ смужки заголовка і смужки стану. За допомогою M-X можна увімкнути або вимкнути показ рядків довідки.

ПРИМІТКИ

Вилучено параметр set suspendable. Призупинення типово увімкнено. Доступ до нього можна отримати за допомогою ^T^Z. (Якщо ви хочете, щоб роботу nano призупиняло звичайне ^Z, додайте bind ^Z suspend main до вашого nanorc.)

ПІДСВІЧУВАННЯ СИНТАКСИЧНИХ КОНСТРУКЦІЙ

Розфарбовування різних синтаксичних елементів файла виконується за допомогою формальних виразів (див. команду color нижче). Наслідком цього є певна недосконалість, оскільки формальні вирази є недостатньо потужними для повної обробки файла. Тим не менше, формальні вирази можуть бути досить корисними і простими у написанні, тому вони досить добре пасують до невеличкого редактора, яким є nano.

Усі формальні вирази у nano є розширеними формальними виразами POSIX. Це означає, що символи ., ?, *, +, ^, $ та деякі інші символи вважаються особливими. Крапка, ., відповідає будь-якому одинарному символу, ? означає, що попередній запис є необов'язковим, * означає, що попередній запис може зустрічатися нуль або більше разів, + означає, що попередній запис може зустрічатися один або декілька разів, ^ відповідає початку рядка, а $ — кінець, \< означає початок слова, а \> — його кінець, а \s відповідає пробілу. Це також означає, що пошук вперед і пошук назад є неможливими. Повний опис можна знайти на сторінці підручника GNU grep: man grep.

Кожний формальний вираз у файлі nanorc має бути взято у подвійні лапки ( ""). В одному рядку може бути вказано декілька формальних виразів, які слід відокремлювати пробілами. Це означає, що у формальному виразі не може міститися подвійних лапок з наступним пробілом. Якщо вам потрібна така комбінація у формальному виразі, або подвійні лапки, або пробіл слід взяти у квадратні дужки ( []).

Для кожного типу файлів можна визначити окремий синтаксис за допомогою таких команд:

syntax назва [ "формальний_вираз_файла " ...]: Визначення синтаксису слід розпочинати із цієї назви. Усі наступні записи color та інші такі команди буде додано до цього синтаксису, аж доки під час обробки не буде зустрінуто нову команду syntax. Після запуску nano цей синтаксис буде автоматично активовано, якщо назва поточного файла відповідає розширеному формальному виразу формальний_вираз_файла. Крім того, синтаксис може бути явно активовано використанням параметра командного рядка -Y або --syntax з наступним визначенням назви. Синтаксис default є особливим: у ньому не використовується формальний_вираз_файла, і він застосовується до файлів, назва яких не відповідає жодному формальному виразу синтаксису. Синтаксис none зарезервовано; його використання у рядку команди має ті самі наслідки, що і вимикання використання будь-якого синтаксису.

header "формальний_вираз " ...: Якщо виразу формальний_вираз_файла не відповідатиме жоден з визначених синтаксисів, виконати порівняння цього формального_виразу (або формальних виразів) із першим рядком поточного файла для визначення того, чи слід використовувати цей синтаксис для нього.

magic "формальний_вираз " ...: якщо не буде встановлено відповідності виразу формальний_вираз_файла і жодному формальному виразу header, виконати порівняння з цим формальним виразом (або формальними виразами) результатів запиту до бази даних magic щодо поточного файла для визначення того, чи слід використовувати для нього такий синтаксис. (Ця можливість працює, лише якщо у системі встановлено libmagic. Її буде проігноровано без повідомлень, якщо це не так.)

formatter програма [ аргумент ...]: Запустити вказану програму для повного набору даних поточного буфера.

linter програма [ аргумент ...]: Скористатися вказаною програмою для виконання перевірки синтаксису у поточному буфері.

comment "рядок ": Скористатися вказаним рядком для коментування або зняття позначки коментаря у рядках. Якщо у рядку міститься вертикальна смужка або символ каналу ( |), це означає коментарі у стилі дужок, наприклад, « /*|*/» для файлів CSS. Символи перед символом каналу буде додано на початку, а символи після символу каналу буде дописано наприкінці рядка. Якщо символу каналу немає, на початку рядка буде дописано увесь рядок; наприклад, для файлів мовою Python буде дописано « #». Якщо буде вказано порожній рядок між подвійними лапками, можливість коментування або зняття позначки коментаря буде вимкнено; наприклад, "" для JSON. Типовим значенням є « #».

tabgives "рядок ": Зробити так, щоб натискання клавіші <Tab> призводило до введення вказаного рядка. Корисно для мов, подібних до Python, де для формування відступів використовують лише пробіли. Цей параметр має пріоритет над встановленим параметром tabstospaces.

color [bold,][italic,]колір_тексту ,колір_тла " формальний_вираз " ...: Розфарбувати усі фрагменти тексту, які відповідають розширеному формальному виразу формальний_вираз, із використанням вказаних кольорів тексту і тла. Має бути вказано принаймні один з кольорів. Коректними назвами кольорів є: red, green, blue, magenta, yellow, cyan, white, and black. До кожної з цих восьми назв можна дописати слово-префікс light, щоб отримати яскравішу версію відповідного кольору. Словом grey або gray можна скористатися як синонімом lightblack. У емуляторах термінала, де передбачено принаймні 256 кольорів, іншими коректними (але без префіксів) назвами кольорів є такі: pink, purple, mauve, lagoon, mint, lime, peach, orange, latte, rosy, beet, plum, sea, sky, slate, teal, sage, brown, ocher, sand, tawny, brick, crimson та normal -- де normal означає типовий колір тексту або тла. У таких емуляторах термінала колір також можна вказати у форматі трицифрового шістнадцяткового числа із префіксом #. Цифри також числа відповідають величинам червоного, зеленого та синього компонентів, відповідно. Визначення таких кольорів наказує nano вибрати з доступної палітри колір, який є найближчим до вказаних значень. Перед парою значень може бути вказано bold і/або italic (відокремлені комами) для отримання напівжирного і/або курсивного тексту, якщо у вашому терміналі передбачено такі можливості. Усі команди розфарбовування буде застосовано у порядку, у якому їх вказано. Це означає, що пізніші команди можуть змінити кольори, які визначено попередніми командами.

icolor [bold,][italic,]колір_тексту ,колір_тла " формальний_вираз " ...: Те саме, що і вище, але із встановленням відповідності без врахування регістру символів.

color [bold,][italic,]колір_тексту ,колір_тла start=" форм_вираз_початку " end="форм_вираз_кінця ": Розфарбувати усі фрагменти тексту, початок яких відповідає розширеному формальному виразу форм_вираз_початку, а кінець яких відповідає формальному виразу форм_вираз_кінця, використанням вказаних кольорів тексту і тла. Має бути вказано принаймні один з цих кольорів. Це означає, що після початкового відповідника форм_вираз_початку, буде розфарбовано увесь текст до першого відповідника форм_вираз_початку. Це уможливлює поширення підсвічування синтаксису на декілька рядків.

icolor [bold,][italic,]колір_тексту ,колір_тла start=" форм_вираз_початку " end="форм_вираз_кінця ": Те саме, що і вище, але із встановленням відповідності без врахування регістру символів.

include "файл_синтаксису ": Прочитати самодостатні синтаксиси кольорів з файла_синтаксису. Зауважте, що файл_синтаксису може містити лише вказані вище команди, від syntax до icolor.

extendsyntax назва команда аргумент ...: Розширити раніше визначений як назву синтаксис ще однією командою. Це надає змогу додати нову команду color, icolor, header, magic, formatter, linter, comment або tabgives до вже визначеного синтаксису -- корисно, якщо ви хочете дещо удосконалити синтаксис, який вже визначено у одному з встановлених на рівні системи файлів (доступ до запису до яких, зазвичай, закрито).

ЗМІНА ПРИВ'ЯЗКИ КЛАВІШ

Прив'язку клавіш може бути змінено за допомогою таких трьох команд:

bind клавіша функція меню: Перепризначити вказану клавішу до вказаної функції у вказаному меню (або в усіх меню, де використано пункт функції, якщо вказано all).

bind клавіша "рядок" меню: Робить так, щоб вказана клавіша давала вказаний рядок у вказаному меню (або в усіх меню, де використано клавішу, якщо вказано all). Окрім буквального тексту і/або кодів керування, рядок може містити назви функцій у фігурних дужках. Ці функції буде викликано, коли буде натиснуто клавішу. Щоб включити сам символ фігурної дужки, скористайтеся конструкцією {{}.

unbind клавіша меню: Скасувати прив'язку вказаної клавіші до вказаного меню (або усіх меню, де використано клавішу, якщо вказано all).

Зауважте, що bind клавіша "{ функція}" меню є еквівалентом bind клавіша функція меню, окрім того, що для останньої форми nano перевірятиме доступність функції у вказаному меню під час запуску програми (і повідомити про помилку, якщо її там не існує), оскільки для першої форми nano перевірятиме під час виконання, що функція існує, але не те, чи має вона сенс у поточному меню. Користувачеві слід подбати, щоб функція із назвою у фігурних дужках (або будь-яка їхня послідовність) була належною. Якщо цю умову не буде виконано, результат може бути несподіваним.

Формат запису клавіші має бути одним з таких:

^X: де X є латинською літерою або одним з декількох символів ASCII (@, ], \, ^, _) або словом "Space". Приклад: ^C.

M-X: де X є будь-яким символом ASCII, окрім [, або словом "Space". Приклад: M-8.

Sh-M-X: де X — латинська літера. Приклад: Sh-M-U. Типово, усі комбінації Meta+літера активують ті самі дії, що і відповідні комбінації Shift+Meta+літера. Але якщо виконано якусь прив'язку Shift+Meta, це правило не виконуватиметься для усіх літер.

FN: де N є числовим значенням від 1 до 24. Приклад: F10. (Часто клавішам від F13 до F24 відповідають комбінації клавіш від F1 до F12 з Shift.)

Ins або Del.

Не варто виконувати повторну прив'язку ^M (Enter) або ^I (Tab). Зміна прив'язки ^[ (Esc) неможлива, оскільки відповідний код клавіші є початковим байтом комбінацій клавіш Meta та екранованих послідовностей. Повторна прив'язка будь-якої з клавіш, які пов'язано із рухом курсора (стрілок, Home, End, PageUp і PageDown) неможлива. У деяких терміналах неможливо виконати повторну прив'язку ^H (якщо не використано --raw), оскільки код цієї клавіші є тотожним до клавіші Backspace.

Коректними назвами функції для прив'язки можуть бути такі:

help: Викликає засіб перегляду довідки.

cancel: Скасовує поточну команду.

exit: Завершує роботу програми (або засобу перегляду довідки чи засобу навігації файлової системи).

writeout: Записує поточний буфер на диск із надсиланням запиту щодо назви.

savefile: Записує поточний файл на диск без запиту.

insert: Вставляє вміст файла до поточного буфера (у поточній позиції курсора) або до нового буфера, якщо встановлено параметр multibuffer.

whereis: Починає пошук фрагмента тексту вперед у поточному буфері -- або назв файлів, які відповідають введеному рядку у поточному списку панелі навігації файловою системою.

wherewas: Починає пошук фрагмента тексту назад у поточному буфері -- або назв файлів, які відповідають введеному рядку у поточному списку панелі навігації файловою системою.

findprevious: Шукає наступний відповідник у зворотному напрямку.

findnext: Шукає наступний відповідник у прямому напрямку.

replace: Інтерактивно замінює текст у поточному буфері.

cut: Вирізає і зберігає поточний рядок (або позначену ділянку тексту).

copy: Копіює поточний рядок (або позначену ділянку тексту) без його вилучення з буфера.

paste: Вставляє поточний збережений текст до поточного буфера у поточній позиції курсора.

zap: Викидає з буфера поточний рядок (або позначену ділянку). (Цю функцію типово прив'язано із комбінацією клавіш <Meta+Delete>.)

chopwordleft: Вилучає фрагмент тексту від позиції курсора до початку попереднього слова. (Цю функцію типово пов'язано із комбінацією клавіш <Shift+Ctrl+Delete>. Якщо ваш термінал видає ^H для <Ctrl+Backspace>, ви можете наказати програмі після натискання <Ctrl+Backspace> вилучати слово ліворуч від курсора повторною прив'язкою ^H до цієї функції.)

chopwordright: Вилучає фрагмент тексту від позиції курсора до початку наступного слова. (Цю функцію типово пов'язано із комбінацією клавіш <Ctrl+Delete>.)

cutrestoffile: Вирізає увесь текст від позиції курсора до кінця буфера.

mark: Встановлює позначку у поточну позицію для початку позначеного фрагмента тексту або, якщо таку позначку таму уже встановлено, скасовує її встановлення.

location: Повідомляє про поточну позицію курсора у буфері: рядок, стовпчик і позицію у символах.

wordcount: Обчислює і виводить до смужки стану кількість рядків, слів та символів у поточному буфері (або у позначеній ділянці тексту).

execute: Надсилає запит щодо програми, яку слід виконати. Виведені програмою дані буде вставлено до поточного буфера (або до нового буфера, якщо натиснуто перемикач M-F).

speller: Викликає програму для перевірки правопису, або типову hunspell(1), або GNU spell(1), або програму, яку визначено за допомогою --speller або set speller.

formatter: Викликає програму для обробки усього буфера (якщо активний синтаксис таку визначає). (Поточний буфер буде записано до тимчасового файла, для цього файла буде запущено програму, а потім тимчасовий файл буде знову прочитано для заміни його вмістом вмісту буфера.)

linter: Викликає програму перевірки синтаксису (якщо активний синтаксис таку визначає). Якщо ця програма виводить рядки у формі «назва_файла:номер_рядка:номер_символу: якесь повідомлення», курсор буде переведено у вказану позицію у згаданому файлі, а «якесь повідомлення» буде показано на смужці стану. Ви можете пересуватися від повідомлення до повідомлення за допомогою натискання клавіш <PgUp> і <PgDn>, і полишити режим перевірки за допомогою натискання комбінації клавіш ^C або клавіші <Enter>.

justify: Вирівнює поточний абзац (або позначену ділянку тексту). Абзац є групою неперервних рядків, які, окрім, можливо, першого рядка, мають однакові відступи. Початок абзацу виявляється або за окремим рядком із іншим відступом або за попереднім порожнім рядком.

fulljustify: Вирівнює увесь поточний буфер (або позначену ділянку тексту).

indent: Встановлює відступ (зсуває текст праворуч) у поточному рядку або у позначених рядках.

unindent: Скасовує відступ (зсуває текст ліворуч) у поточному рядку або у позначених рядках.

comment: Коментує поточний рядок або позначені рядки чи знімає з них коментування. Буде використано стиль коментування, який вказано в активному синтаксисі.

complete: Завершує (якщо це можливо) фрагмент до курсора до повного слова, яке виявлено в іншому місці поточного буфера.

left: Перехід на одну позицію ліворуч (у редакторі або засобі навігації).

right: Перехід на одну позицію праворуч (у редакторі або засобі навігації).

up: Перехід на один рядок вгору (у редакторі або засобі навігації).

down: Перехід на один рядок униз (у редакторі або засобі навігації).

scrollup: Гортає вміст поля перегляду на один рядок вгору (тобто текст ковзатиме вниз), лишаючи курсор у тій самій позиції у рядку, якщо це можливо. (Цю функцію типово пов'язано із комбінацією клавіш <Alt+стрілка вгору>. Якщо у вашій консолі Linux комбінація <Alt+стрілка вгору> не працює, див. поширені питання та відповіді на них:

https://nano-editor.org/dist/latest/faq.html#4.1

scrolldown: Гортає вміст поля перегляду на один рядок униз (тобто текст ковзатиме вгору), лишаючи курсор у тій самій позиції у рядку, якщо це можливо (Цю функцію типово пов'язано із комбінацією клавіш <Alt+стрілка униз>.)

center: Виконує гортання рядка з курсором у центр екрана.

prevword: Пересуває курсор на початок попереднього слова.

nextword: Пересуває курсор на початок наступного слова.

home: Пересуває курсор на початок поточного рядка.

end: Пересуває курсор на кінець поточного рядка.

beginpara: Пересуває курсор на початок поточного абзацу.

endpara: Пересуває курсор на кінець поточного абзацу.

prevblock: Пересуває курсор на початок поточного або попереднього блоку тексту. (Блоки відокремлюються одним або декількома порожніми рядками.)

nextblock: Пересуває курсор на початок наступного блоку тексту.

pageup: Перейти на один екран вище.

pagedown: Перейти на один екран нижче.

firstline: Перейти до першого рядка файла.

lastline: Перейти до останнього рядка файла.

gotoline: Переводить курсора на вказаний рядок (і позицію, якщо її вказано). Від'ємні значення буде відлічено від кінця файла (і кінця рядка).

findbracket: Пересуває курсор до дужки (фігурної або круглої тощо), яка відповідає (у парі) тій, яка перебуває під курсором. Див. set matchbrackets.

anchor: Розташовує прив'язку у поточному рядку або вилучає прив'язку, якщо вона там була. (Прив'язку буде видно, якщо активувати показ номерів рядків.)

prevanchor: Виконує перехід до першої прив'язки до поточного рядка.

nextanchor: Виконує перехід до першої прив'язки після поточного рядка.

prevbuf: Перемикає програму на редагування або перегляд попереднього буфера, якщо відкрито декілька буферів.

nextbuf: Перемикає програму на редагування або перегляд наступного буфера, якщо відкрито декілька буферів.

verbatim: Вставляє наступну комбінацію клавіш до файла як є або починає введення символу Unicode, якщо введено шістнадцяткову цифру.

табуляція: Вставити табуляцію у поточну позицію курсора.

enter: Вставити новий рядок під поточним.

delete: Вилучити символ під курсором.

backspace: Вилучити символ до курсора.

recordmacro: Розпочинає записування комбінації клавіш -- комбінації буде збережено як макрос. Якщо вже виконується запис, записування буде припинено.

runmacro: Відтворює комбінації клавіш останнього записаного макроса.

undo: Скасовує останню виконану з текстом дію (додавання тексту, вилучення тексту тощо).

redo: Повторює останню скасовану дію (тобто скасовує скасовування).

refresh: Освіжити вміст екрана.

suspend: Призупиняє редактор і повертає керування командній оболонці (аж доки ви не накажете процесу поновити виконання за допомогою fg).

casesens: Перемикає пошук та заміну між режимом ігнорування та режимом врахування регістру символів.

regexp: Перемикає пошук та заміну між буквальним режимом та режимом формальних виразів.

backwards: Перемикає пошук та заміну між режимом пошуку вперед і режимом пошуку у зворотному напрямку.

older: Отримати попередню (ранішу) відповідь на запит.

newer: Отримати наступну (пізнішу) відповідь на запит.

flipreplace: Перемикає програму між режимом пошуку і режимом заміни.

flipgoto: Перемикає програму між режимом пошуку тексту та переходу до рядка із вказаним номером.

flipexecute: Перемикає програму між режимом вставлення файла та режимом виконання команди.

flippipe: При виконанні команди вмикає або вимикає передавання каналом вмісту поточного буфера (або позначеної ділянки тексту).

flipnewbuffer: Перемикає програму між режимом вставлення до поточного буфера і вставлення до порожнього буфера.

flipconvert: При читанні файла вмикає або вимикає перетворення даних з формату DOS/Mac. Типовим є перетворення.

dosformat: При записуванні до файла перемикає програму у режим запису даних у форматі DOS (CR/LF).

macformat: При записуванні до файла перемикає програму у режим запису даних у форматі Mac.

append: При записуванні файла вмикає режим дописування наприкінці, замість перезаписування файла.

prepend: При записуванні файла вмикає режим записування даних на початку файла, замість перезаписування вмісту файла.

backup: При записуванні файла вмикає режим створення резервної копії поточного файла.

discardbuffer: При спробі запису до файла відкинути поточний буфер без збереження. (Ця функція, типово, є обов'язковою, лише якщо задіяно параметр --saveonexit.)

browser: Запускає панель файловою системою (у меню читання та запису файлів), надаючи змогу вибрати файл зі списку.

gotodir: Переводить програму до вказаного каталогу, надаючи змогу навігації будь-яким каталогом файлової системи.

firstfile: Перейти до першого файла у списку при використанні засобу навігації файлової системи.

lastfile: Перейти до останнього файла у списку при використанні засобу навігації файлової системи.

nohelp: Вмикає або вимикає показ дворядкового списку клавіатурних прив'язок у нижній частині екрана. (Цей перемикач є особливим: він доступний в усіх меню, окрім засобу перегляду довідки та перевірки. Усі подальші перемикачі доступі лише у основному меню.)

zero: Вмикає або вимикає показ смужки заголовка та смужки стану.

constantshow: Вмикає або вимикає постійний показ поточного рядка, позиції у рядку та позиції у буфері.

softwrap: Вмикає або вимикає показ надто довгих рядків у декількох рядках на екрані.

linenumbers: Вмикає або вимикає показ номерів рядків перед текстом.

whitespacedisplay: Увімкнути або вимкнути показ пробілів.

nosyntax: Увімкнути або вимкнути підсвічування синтаксичних конструкцій.

smarthome: Вмикає або вимикає режим «кмітливої» клавіші Home.

autoindent: Вмикає або вимикає режим, коли новостворені рядки міститимуть ту саму кількість початкових пробілів, що і попередній рядок або наступний рядок, якщо попередній рядок був початком абзацу.

cutfromcursor: Перемикає режим вирізання тексту: вирізання усього рядка, чи лише частини від поточної позиції курсора до кінця рядка.

breaklonglines: Вмикає або вимикає режим жорсткого перенесення довгих рядків. (Стара назва цієї функції, «nowrap», вважається застарілою.)

tabstospaces: Вмикає або вимикає перетворення введених табуляцій на пробіли.

mouse: Увімкнути або вимкнути підтримку миші.

Коректними розділами меню є такі:

main: Головне вікно редактора, де вводять і редагують текст.

help: Меню засобу перегляду довідки.

search: Меню пошуку (або визначення місця).

replace: Меню «шукати, щоб замінити».

replacewith: Меню «замінити на», яке з'являється після вибору «шукати, щоб замінити».

yesno: Меню «yesno», де буде задано питання із відповідями «так/ні/усі/скасувати».

gotoline: Меню «перейти до рядка (і позиції)».

writeout: Меню «записати файл».

insert: Меню «вставити файл».

browser: Меню «навігатора файлами» для вибору файла, який слід відкрити, вставити або записати.

whereisfile: Меню «шукати файл» у навігаторі файловою системою.

gotodir: Меню «перейти до каталогу» у засобі навігації файловою системою.

execute: Меню для вставлення виведених зовнішньою командою даних або фільтрування буфера (або позначеної ділянки тексту) за допомогою зовнішньої команди чи виконання одного із зовнішніх інструментів.

spell: Меню інтегрованого засобу перевірки правопису, де користувач може редагувати слово із помилкою.

linter: Меню засобу перевірки, за допомогою якого можна переходити між повідомленнями засобу перевірки.

all: Спеціальна назва, яка охоплює усі меню. Для bind вона означає, що усі меню, де існує вказана функція; для unbind вона означає усі меню, де існує вказана клавіша.

ФАЙЛИ

/etc/nanorc: Загальносистемний файл налаштувань.

~/.nanorc, $XDG_CONFIG_HOME/nano/nanorc або ~/.config/nano/nanorc: Файл налаштувань користувача.

/usr/share/nano/*: Визначення синтаксису для розфарбування синтаксичних конструкцій для стандартних типів файлів (і для менш поширених типів файлів у підкаталозі extra/).

ДИВ. ТАКОЖ

nano(1)

https://nano-editor.org/cheatsheet.html: Огляд типових прив'язок клавіш.

ПЕРЕКЛАД

Український переклад цієї сторінки посібника виконано Yuri Chornoivan <[email protected]>

Цей переклад є безкоштовною документацією; будь ласка, ознайомтеся з умовами GNU General Public License Version 3 НЕ НАДАЄТЬСЯ ЖОДНИХ ГАРАНТІЙ.

Якщо ви знайшли помилки у перекладі цієї сторінки підручника, будь ласка, надішліть електронний лист до списку листування перекладачів: [email protected]

версія 7.2

nanorc

НАЗВА

ОПИС