# Посібник з pluma

## Вступ

Програма pluma дозволяє створювати та редагувати текстові файли.

pluma — має бути простим та легким у використанні текстовим редактором. Багато можливостей можуть бути включені модулями, що вирішують ряд завдань з редагування тексту.

## Початок роботи

### Запуск pluma

pluma можна запустити наступними способами:

Меню Програми

- Виберіть Стандартні Текстовий редактор.

Командний рядок

- Виконайте команду: `pluma`

Якщо ви відкриваєте текстовий документ у файловому менеджері, pluma запускається автоматично та відображає файл, що відкривається.

### Вікно pluma

Після запуску програми pluma відкривається наступне вікно:

#### Вікно pluma

Shows pluma main window.

Вікно pluma містить наступні елементи:

Панель меню

- Меню містить усі необхідні команди для роботи з файлами у pluma.

Панель інструментів

- Панель меню містить деякі команди, доступні у меню.

Область відображення

- У області перегляду відображається текст, що редагується.

Рядок стану

- Рядок стану показує поточний стан pluma, а також контекстну інформацію про пункти меню. Інформація про стан може бути такою:

  - Позиція курсору: номер рядка та номер стовпчика, де знаходиться курсор.

  - Режим редагування: Якщо редактор знаходиться у режимі вставки, у рядку статусу відображається ВСТ. Якщо редактор у режимі заміни, рядок відображає ЗАМ. Натискання клавіші Insert змінює режим редагування.

Бічна панель

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

  Типово бічна панель не відображається. Щоб її побачити, виберіть Вигляд Бічна панель.

Нижня панель

- The bottom pane is used by programming tools such as the Python Console plugin to display output.

  By default the bottom pane is not shown. To show it, choose View Bottom Pane.

При клацанні правою кнопкою миші у вікні pluma, з'являється контекстне меню. Воно містить загальні команди редагування тексту.

Like other MATE applications, actions in pluma can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the User Guide.

### Запуск pluma з командного рядка

Можна запустить pluma з командного рядка з одним або кількома файлами. Для відкривання кількох файлів введіть наступну команду та натисніть клавішу Enter:

`pluma `file1.txt file2.txt file3.txt``

Або ж замість назви файлу можна вказати URI.

Додаткову інформацію про запуск pluma з командного рядка дивіться man-сторінці для pluma,

pluma

1.

## Робота с файлами

### Створення нового документу

Щоб створити новий документ виберіть Файл Створити. У вікні pluma з'явиться новий порожній документ.

### Відкриття файлу

Щоб відкрити файл виберіть Файл Відкрити. У діалозі вибору файлів знайдіть потрібний файл та натисніть кнопку Відкрити. Файл відобразиться у вікні pluma.

The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the File menu. You can also click on the Shows Recent Files menu icon. icon on the toolbar to display the list of recent files.

У pluma можна відкривати декілька файлів. Програма додає вкладку для кожного відкритого файлу у вікно. Також дивіться pluma-tabs.

### Збереження файлу

Зберігати файли можна кількома способами:

- Щоб зберегти зміни у існуючому файлі, виберіть Файл Зберегти.

- To save a new file or to save an existing file under a new filename, choose File Save As . Enter a name for the file in the Save As dialog, then click Save.

- To save all of the files that are currently open in pluma, choose Documents Save All .

To close all of the files that are currently open in pluma, choose Documents Close All .

### Відкриття файлу через URI

Щоб відкрити файл через Uniform Resource Identifier (URI), виконайте наступне:

1. Choose File Open Location to display the Open Location dialog.

2. Введіть URI файлу, який хочете відкрити.

3. Виберіть відповідне кодування у розкривному списку Кодування символів.

4. Натисніть кнопку Відкрити.

Інший спосіб - ввести у командному рядку: `pluma `URI``, де `URI` — URI файлу, що відкривається, а потім натиснути клавішу Enter. `URI` може містити `http:`, `ftp:`, `file:` та усі протоколи, що підтримуються `mate-vfs`.

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

Збереження файлів на сервер FTP можна увімкнути у Редакторі конфігурації, встановивши ключ `/apps/pluma/preferences/editor/save/writable_vfs_schemes`. Але подібний режим використання може призводити до помилок.

### Робота з вкладками

Коли відкрито більше одного файлу, pluma відображає у верхній частині області перегляду вкладки для кожного документу. Перейти до іншого документу можна натиснувши на відповідній вкладці.

Для переміщення документу в інше вікно pluma, перетягніть відповідну вкладку.

To move a document to a new pluma window, either drag its tab to the desktop, or choose Documents Move to New Window .

## Робота с текстом

### Редагування тексту

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

- Ввести новий текст з клавіатури. Курсор показує місце вводу тексту, змінити яке можна за допомогою клавіш керування курсором або клацання мишею.

- To copy the selected text to the clipboard, choose Edit Copy .

- To delete the selected text from the file and move the selected text to the clipboard, choose Edit Cut .

- To permanently delete the selected text from the file, choose Edit Delete .

- To insert the contents of the clipboard at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file, either from pluma or another application.

- To select all of the text in a file, choose Edit Select All .

### Повернення та повтор змін

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## Пошук та заміна

У pluma є два способи пошуку тексту. Для пошуку текстового блоку можна використовувати діалог Знайти, або блока скористатись Інтерактивним пошуком для виділення кольором тексту під час вводу.

### Пошук тексту

Щоб знайти у файлі рядок тексту, виконайте наступні дії:

1. Choose Search Find to display the Find dialog.

2. У полі Знайти введіть рядок, що шукається. Можна використовувати спеціальні символи, такі як, символ нового рядка чи табуляції: дивіться pluma-find-escapes.

3. Для пошуку першого збігу після поточної позиції курсору натисніть Знайти. Якщо рядок знайдений, програма виділяє перший збіг. Інші рядки, що збігаються, будуть виділені кольором.

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### Інтерактивний пошук

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

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

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

Щоб подовжити виділення до наступного збігу не закриваючи вікно інтерактивного пошуку, натисніть Ctrl G. Щоб перетйти до попереднього збігу натисніть Ctrl Shift G.

Також для переходу між місцями збігу можна використовувати клавіші зі стрілками вгору та вниз, або колесо миші.

### Заміна тексту

Для пошуку та заміни рядка у файлі іншим рядком, виконайте наступні дії:

1. Choose Search Replace to display the Replace dialog.

2. Введіть рядок, що замінюється у полі Знайти. Можна використовувати та спеціальні символи, як наприклад, символ нового рядка чи символ табуляції: дивіться pluma-find-escapes.

3. У полі Замінити на введіть рядок на який треба замінити.

Для перегляду кожного збігу рядка перед його заміною, натисніть Знайти. Якщо збіг є, pluma виділить його. Для заміни натисніть Замінити. Щоб перейти до наступного збігу, ще раз натисніть Знайти.

Для негайної заміни збігів, натисніть Замінити все.

### Параметри пошуку та заміни

Діалог Знайти, як і діалог Замінити, мають наступні параметри:

- Виберіть Збігається регістр, щоб шукати текст у тому регістрі, у якому ви його ввели. Наприклад, у цьому випадку «ТЕКСТ» не те ж саме, що й «текст».

- Виберіть Збігається ціле слово, щоб ввести пошук лише за повними словами. Так, наприклад, «текст» не те ж саме що й «текстура».

- Виберіть Шукати назад, для пошуку у зворотному напрямку, до початку документу.

- При увімкненому Досягнувши кінця, починати спочатку, пошук йде від поточної позиції курсору до кінця, потім, від початку документу до поточної позиції.

### Спеціальні символи

У текст для пошуку можна включати наступні escape-послідовності, що замінюють спеціальні символи:

`\n`

- Символ нового рядка.

`\t`

- Символ табуляції.

`\r`

- Символ переведення каретки.

`\\`

- The backslash character itself must be escaped if it is being searched for. For example, if you are looking for the "`\n`" literal, you will have to type "\\n" in the Search for field. Or if you are looking for a sequence of backslashes, you will have to double the number of searched backslashes.

### Встановлення курсору на певний рядок

To position the cursor on a specific line in the current file, choose Search Go to Line . The line number box appears at the top of the display area.

Begin typing the number of the line that you want to move the cursor to and the document will scroll to the specified line.

To dismiss the box and move the cursor to the specified line, press Return.

## Друк

### Встановлення параметрів сторінки

To set the page options, choose File Page Setup to display the Page Setup dialog.

Це діалогове вікно дозволяє налаштувати наступні параметри друку:

#### Вкладка «Загальне»

Print syntax highlighting

- Відмітьте цей параметр, для друку з виділенням синтаксису кольором. Також дивіться pluma-set-highlightmode.

Print page headers

- Параметр вмикає заголовок для кожної сторінки. Заголовок не налаштовується.

Line Numbers

- Параметр Друкувати номери рядків вмикає друк номерів рядків.

  Використовуючи поле Нумерувати кожен ... рядок, можна вказати як часто будуть друкуватись номери. Наприклад, кожні 5 чи кожні 10 рядків.

Text Wrapping

- Параметр Увімкнути перенос тексту дозволяє переносити довгі рядки на інший рядок. Не впливає на нумерацію рядків.

  Параметр Не розривати слово між рядками дозволяє переносити текст цілими словами.

#### Шрифти

Body

- Натискаючи цю кнопку можна обрати шрифт для друку тексту.

Line numbers

- Ця кнопка дозволяє обрати шрифт для друку номерів рядків.

Headers and footers

- Цією кнопкою обирається шрифт для друку верхніх та нижніх колонтитулів.

Кнопкою Відновити початкові шрифти можна відновити типові шрифти.

### Друк документу

Pluma може виконувати наступні завдання друку:

- Друк документу на принтері.

- Друк у файл.

При друкуванні у файл, pluma створює файл в одному з друкованих форматів. Загальними форматами друку є PostScript та Portable Document Format.

To preview the pages that you want to print, choose File Print Preview .

To print the current file to a printer or a file, choose File Print to display the Print dialog.

Вікно Друк дозволяє встановлювати наступні параметри друку:

#### Вкладка «Завдання»

Print range

- Для визначення кількості сторінок для друку виберіть один з наступних параметрів:

  - All

    Відмітьте цей параметр для друкування усіх сторінок документа.

  - Lines

    При виборі цього параметра друкуються лише певний діапазон рядків. Діапазон визначається полями Від та До.

  - Selection

    Буде надрукований лише виділений текст. Якщо текст не виділений, параметр недоступний.

Copies

- У полі Кількість копій можна вказати скільки екземплярів документу треба надрукувати.

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

#### Вкладка «Принтер»

Printer

- Використовуючи цей список можна вибрати принтер для друку.

Settings

- У цьому списку обираються параметри принтера.

  Для налаштовування принтера натисніть Налаштувати. Наприклад, можна увімкнути або вимкнути друк з двох сторін, або відкласти друк до певного часу, якщо ця функціональність підтримується принтером.

Location

- У цьому списку можна вибрати:

  CUPS

- Друк документу на принтер CUPS.

  Якщо виділений принтер є принтером CUPS, тоді у цьому розкривному списку є єдиний елемент - CUPS.

lpr

- Друк документу на принтер lpr.

File

- Друк документу у файл PostScript.

  Натисніть Зберегти як щоб відкрити діалогове вікно,у якому вказується назва та розташування файлу PostScript.

Custom

- Дозволяє використовувати вказану команду для друку документу.

  Введіть у текстовому полі назву команди та її аргументи.

State

- Функціональність не підтримується у цій версії pluma.

Type

- Функціональність не підтримується у цій версії pluma.

Comment

- Функціональність не підтримується у цій версії pluma.

#### Вкладка «Папір»

Paper size

- У цьому розкривному списку можна вибрати розмір аркушів, на які буде друкуватись документ.

Width

- У цьому полі визначається ширина аркуша. Одиниця виміру обирається у сусідньому розкривному списку.

Height

- У цьому полі визначається висота сторінки.

Feed orientation

- У цьому списку вибирається орієнтація паперу у принтері.

Page orientation

- У цьому списку вибирається орієнтація сторінки.

Layout

- У цьому списку вказується схема розташування сторінки. Попередній вигляд компонування сторінки відображається у полі Попередній перегляд.

Paper tray

- У цьому списку можна вибрати джерело паперу.

## Програмування

Деякі з можливостей програмування у pluma підтримуються модулями. Наприклад, «Список тегів» — модуль, що відображає теги різних мов розмітки: дивіться pluma-tag-list-plugin.

### Виділення синтаксису

Виділення синтаксису кольором робить полегшує читання коду людиною. Різні смислові елементи тексту виділяються різними кольорами.

pluma chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

- Без виділення кольором.

Sources

- Виділення програмних текстів. З підменю виберіть потрібний тип.

Markup

- Виділяє мови розмітки. З підменю можна обрати потрібну.

Scripts

- Виділення кольором синтаксису сценаріїв. У підменю містяться деякі мови «сценаріїв».

Others

- Інші режими виділення кольором.

### Вставка результатів виконання команд у файл

Можна використовувати pluma для вставки результатів виконання певної команди у текстовий файл. Наприклад, `ls | pluma`.

Вивід команди `ls` буде занесений у новий текстовий файл у вікні pluma.

Інший спосіб — використовувати модуль Зовнішні інструменти для вставки результатів виконання команди у поточний файл.

## Комбінації клавіш

Для прискорення виконання поширених операцій замість миші та меню використовуйте комбінації клавіш. У наступній таблиці перелічені усі комбінації клавіш pluma.

For more on shortcut keys, see the Desktop User Guide.

Вкладки

Комбінації клавіш для роботи з вкладкам

Комбінація клавіш | Команда
Ctrl + Alt + PageUp | Перейти до сусідньої вкладки, що розташована ліворуч
Ctrl + Alt + PageDown | Перейти до сусідньої вкладки, що розташована праворуч
Ctrl + W | Закрити вкладку.
Ctrl + Shift + L | Зберегти усі вкладки.
Ctrl + Shift + W | Закрити усі вкладки.
Alt + n | Перейти до n-ої вкладки

Файли

Комбінації клавіш для роботи з файлами:

Комбінація клавіш | Команда
Ctrl + N | Створити новий документ.
Ctrl + O | Відкрити документ.
Ctrl + L | Відкрити адресу.
Ctrl + S | Зберегти поточний документ на диск.
Ctrl + Shift + S | Зберегти поточний документ з новою назвою.
Ctrl + P | Надрукувати поточний документ.
Ctrl + Shift + P | Попередній перегляд документу.
Ctrl + W | Закрити поточний документ.
Ctrl + Q | Вихід з pluma.

Правка

Комбінації клавіш для правки документу:

Комбінація клавіш | Команда
Ctrl + Z | Скасувати останню операцію
Ctrl + Shift + Z | Повторити скасовану дію
Ctrl + X | Вирізати виділену текстову область та перемістити у буфер обміну.
Ctrl + C | Копіювати виділений текст або регіон у буфер обміну.
Ctrl + V | Вставити текст з буферу обміну.
Ctrl + A | Виділити все.
Ctrl + D | Delete current line.
Alt + Up | Move the selected line up one line.
Alt + Down | Move the selected line down one line.

Панелі

Комбінації клавіш для роботи з панелями:

Комбінація клавіш | Команда
F9 | Показати чи сховати бічну панель.
Ctrl + F9 | Відобразити/приховати нижню панель.

Пошук

Комбінації клавіш для виконання пошуку

Комбінація клавіш | Команда
Ctrl + F | Знайти рядок
Ctrl + G | Пошук місця наступного збігу з вказаним рядком.
Ctrl + Shift + G | Знайти попереднє місце збігу з рядком
Ctrl + K | Інтерактивний пошук.
Ctrl + H | Пошук та заміна.
Ctrl + Shift + K | Очистити виділення кольором
Ctrl + I | Перейти на рядок.

Сервіс

Комбінації клавіш для сервісних функцій:

Комбінація клавіш | Команда
Shift + F7 | Перевірка орфографії
Alt + F12 | Видалення завершальних пробілів (модуль).
Ctrl + T | Модуль «Відступи рядків»
Ctrl + Shift + T | Забрати відступ у рядку (модуль).
F8 | Запустити "make" у поточному каталозі (модуль).
Ctrl + Shift + D | Список файлів каталогу (модуль).

Довідка

Комбінації клавіш для отримання довідки

Комбінація клавіш | Команда
F1 | Відкривання посібника користувача pluma:

## Параметри

To configure pluma, choose Edit Preferences . The Preferences dialog contains the following categories:

- pluma-prefs-view

- pluma-prefs-editor

- pluma-prefs-fontsandcolors

- pluma-prefs-plugins

### Зовнішній вигляд

Text Wrapping

- Відмітьте Увімкнути перенос тексту, щоб довгі рядки відображались як абзаци, а не забігли за край вікна. Горизонтальне прокручування стане зайвим.

  Параметр Не розривати слово між рядками включає перенос по словам тексту між рядками. Такий текст легше читати.

Line Numbers

- При відміченому параметрі Показувати номери рядків коло лівої межі вікна pluma відображаються номери рядків.

Current Line

- Select the Highlight current line option to highlight the line where the cursor is placed.

Right Margin

- Відмітьте Відображати праву межу, щоб відображалась вертикальна лінія праворуч - права межа.

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

Bracket Matching

- Select the Highlight matching bracket option to highlight the corresponding bracket when the cursor is positioned on a bracket character.

### Параметри редактора

Tabs

- У полі Ширина табуляції можна вказати ширину вільного простору, що додається pluma при натисканні клавіші Tab.

  Параметр Вставляти пробіли замість табуляції вказує pluma при натисканні клавіші Tab замість символу табуляції вставляти певну кількість пробілів.

Auto Indentation

- Параметр Увімкнути автоматичний відступ визначає чи буде наступний рядок починатись з такого ж відступу як і попередній.

File Saving

- При увімкненому параметрі Створювати резервну копію файлу перед збереженням кожен раз при збереженні файлу створюється його резервна копія. Резервна копія містить символ ~ наприкінці імені файлу.

  Параметр Автоматично зберігати поточний файл кожні ... хв дозволяє періодично автоматично зберігати поточний файл.

### Параметри шрифтів та кольорів

Font

- Виберіть Шрифт типової теми, щоб текст у вікні pluma відображався типовим шрифтом.

  В полі Шрифт редактора відображається поточний шрифт, що використовується для виводу тексту. Натискання на кнопку дозволяє встановити сам шрифт, гарнітуру та розмір.

Color Scheme

- You can choose a color scheme from the list of color schemes. By default, the following color schemes are installed:

  Classic

- Classic color scheme based on the gvim color scheme.

Cobalt

- Blue based color scheme.

Kate

- Color scheme used in the Kate text editor.

Oblivion

- Dark color scheme using the Tango color palette.

Tango

- Color scheme using the Tango color scheme.

You can add a new color scheme by clicking on Add..., and selecting a color scheme file

You can remove the selected color scheme by clicking on Remove

### Параметри модулів

Модулі розширюють можливості pluma. Для інформації про вбудовані модулі дивіться pluma-plugins-overview.

#### Підключення модулів

Щоб підключити модуль у pluma, виконайте інструкції:

1. Choose Edit Preferences .

2. Перейдіть до вкладки Модулі.

3. Відмітьте модуль, який хочете увімкнути.

4. Натисніть на кнопку Закрити для закриття діалогу Параметри.

#### Вимикання модулів

Модулі залишаються увімкненими після виходу з pluma.

Щоб вимкнути модуль виконайте наступне:

1. Choose Edit Preferences .

2. Перейдіть до вкладки Модулі.

3. Просто зніміть позначку з модуля, що вимикається.

4. Натисніть на кнопку Закрити для закриття діалогу Параметри.

## Модулі

### Робота з модулями

Підключенням модулів, можна розширити функціональність pluma. Модулі — це додаткові програми. Вони можуть додавати нові пункти меню для доступу до своєї функціональності.

Деякі модулі постачаються разом з pluma, але можна встановити й інші. На веб-сайті pluma є список додаткових модулів.

Для вмикання та вимикання модулів дивіться розділ Налаштовування модулів.

Наступні модулі постачаються разом з pluma:

- Заміна регістру дозволяє змінити регістр символів виділеного тексту.

- Статистика документа показує кількість рядків, слів та символів у документі.

- Зовнішні інструменти дозволяє виконати зовнішні команди з pluma.

- Перегляд файлів дозволяє переглядати теки та файли у бічній панелі.

- Відступ у рядках вставляє або прибирає відступ у виділених рядках.

- Вставка дати й часу вставляє поточну дату й час у позиції курсору.

- Стилі редагування підтримка стилів редагування рядків Emacs, Kate та Vim для pluma.

- Консоль Python дозволяє запускати команди на мові програмування Python.

- Фрагменти тексту дозволяє швидко вставляти фрагменти тексту, що часто використовуються.

- Сортування сортує документ або виділений текст.

- Перевірка орфографії перевіряє орфографію у поточному документі.

- Список тегів надає простий спосіб вставки у документ теги або рядки, не вводячи їх вручну.

For more information on creating plugins, see the pluma website.

### Модуль зміни регістру символів

Модуль Заміна регістру змінює регістр символів виділеного тексту.

Якщо модуль увімкнений, у меню Правка будуть доступні наступні пункти меню:

Пункт меню | Дія | Приклад
Edit Change Case All Upper Case | Змінює регістр кожного символу у верхній регістр. | `Цей текст` перетворюється у `ЦЕЙ ТЕКСТ`
Edit Change Case All Lower Case | Змінює регістр кожного символу на нижній регістр. | `Цей текст` перетворюється на `цей текст`
Edit Change Case Invert Case | Змінює регістр кожного символу, нижній на верхній, а верхній на нижній. | `Цей Текст` перетвориться на `цЕЙ тЕКСТ`
Edit Change Case Title Case | Змінює регістр першого символу кожного слова у верхньому регістрі. | `цей текст` перетвориться на `Цей Текст`

### Модуль «Статистика документа»

Модуль Статистика документа підраховує кількість рядків, слів, символів з пробілами, символів без пробілів, а також байтів у поточному файлі. Результати виводяться у діалоговому вікні Статистика документа. Щоб скористатись цим модулем виконайте наступні дії:

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - Кількість рядків у поточному документі.

   - Кількість слів.

   - Кількість символів разом з пробілами.

   - Кількість символів без урахування пробілів.

   - Кількість байт.

2. Можна продовжувати редагування файлів та при відкритому вікну Статистика документа. Кнопка Оновити оновлює зміст діалогового вікна.

### Модуль «Зовнішні інструменти»

Модуль Зовнішні інструменти дозволяє виконувати зовнішні команди та сценарії оболонки. Команді можна передавати деякі дані, а потім використовувати виведену нею інформацію (наприклад, sed), або запускати запускати певну команду (наприклад, make)

Використовуючи Менеджер зовнішніх інструментів можна створювати та редагувати команди. Для запуску зовнішніх команд використовуйте меню Сервіс.

#### Вбудовані команди

З модулем постачаються наступні команди:

Build

- Запускає make у каталозі поточного документу.

Directory Listing

- Вставляє зміст каталогу поточного документу у новий документ.

Environment Variables

- Відображає список змінних оточення у нижній панелі.

Grep

- Шукає вираз в усіх файлах у каталозі поточного документу, використовуючи шаблони. Результати відображаються у нижній панелі.

Remove Trailing Spaces

- Видаляє всі початкові та завершальні пробіли у рядках.

#### Визначення команд

Щоб додати зовнішню команду, виберіть Сервіс Зовнішні інструменти.

У вікні Менеджер зовнішніх інструментів натисніть кнопку Створити. Для нової команди можна вказати наступні подробиці:

Опис

- Коли меню команди обрано, опис відображається у рядку статусу.

Комбінація клавіш

- Комбінація клавіш для виклику команди.

Команди

- Команди, що запускаються. Можна використовувати також і змінні оточення, докладніше дивіться pluma-external-tools-plugin-variables.

Ввід

- Дані, що отримуються командами (як `stdin`): текст всього поточного документу, виділена область, рядок або слово.

Вікно виводу

- Що робити з виводом команди: відобразити у нижній панелі, вставити у новий документ або у поточний; у кінець, у позицію курсора, замінити виділений текст у документі або ж замінити весь документ.

Застосовність:

- Визначає тип документу, до якого типу застосовуються команди, наприклад, локальні документи або документи у мережі.

#### Редагування та видалення фрагментів

Для редагування фрагменту виберіть його зі списку та відредагуйте.

Для перейменування фрагменту, клацніть на ньому у списку.

Щоб відновити змінені вбудовані фрагменти, натисніть Відновити.

Для видалення фрагменту, виберіть його у списку та натисніть кнопку Видалити. Вбудовані фрагменти видалити неможливо.

#### Змінні

У полі Команда(и) можна використовувати наступні змінні:

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### Модуль перегляду файлової системи

Модуль Перегляд файлів відображає теки та файли у бічній панелі, дозволяючи швидко відкривати файли.

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### Перегляд ваших файлів

Вкладка Перегляд файлів початково відображає закладки. Для перегляду змісту будь-якого елементу двічі клацніть на ньому.

Щоб піднятись рівнем вище, скористайтесь розкривним списком або натисніть клавішу зі стрілкою вгору (фокус вводу повинен бути на панелі).

Щоб переглянути теку документу, з яким ви працюєте зараз, клацніть правою кнопкою на списку файлів та виберіть Встановити корінь на активний документ.

#### Відкриття файлу

Подвійне клацання на файлі відкриває його у pluma.

#### Створення файлів та тек

Щоб створити файл у поточній теці, клацніть на списку файлів правою кнопкою миші та виберіть Створити файл.

Щоб створити нову теку у поточній теці, у контекстному меню виберіть Створити теку.

### Модуль «Відступи в рядках»

Модуль Відступ у рядках вставляє або прибирає відступ на початку рядків.

Щоб вставити чи прибрати відступ, зробіть наступне:

1. Виділіть рядки. Якщо це один рядок, просто залиште курсор десь у його межах.

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

Кількість пробілів, а також чи будуть ці пробіли або символ табуляції залежать від параметрів Знаки табуляції у параметрах редактора, дивіться pluma-prefs-editor.

### Модуль вставки дати та часу

Модуль Вставка дати й часу вставляє поточну дату й час у поточний документ. Щоб використати його:

1. Choose Edit Insert Date and Time .

   Якщо ви не налаштовували цей модуль на вставку дати та часу без запиту формату, тоді pluma відобразить діалог Вставити дату й час. Виберіть зі списку потрібний формат та натисніть Вставити. У позицію курсору будуть вставлені нова дата та час. Діалог закриється автоматично.

   Якщо pluma вже налаштований для вставки дати та часу визначеного формату, діалог Вставити дату й час показаний не буде.

#### Настройка модуль вставляння дати й часу

Для налаштовування модуля вставки дати й часу, виконайте наступне:

1. Choose Edit Preferences .

2. Перейдіть до вкладки Модулі.

3. Виберіть модуль Вставка дати й часу.

4. Натисніть кнопку Налаштувати модуль. Відкриється діалог Налаштовування модуля вставляння дати й часу.

5. Виберіть один з параметрів:

   - Для запиту формату вставки кожен раз, відмітьте Запитувати формат.

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see

     strftime

     3. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

6. Натисніть Гаразд для закриття діалогу.

7. Закрийте діалог Параметри натисніть на кнопку Закрити.

### Модуль «Стилі редагування»

Модуль Стилі редагування дозволяє встановити індивідуальні параметри документа. Стилі редагування є рядками тексту на початку або наприкінці документу з параметрами для pluma.

Preferences set using modelines take precedence over the ones specified in the preference dialog.

You can set the following preferences with modelines:

- Ширина табуляції

- Indent width

- Пробіли замість табуляції

- Перенос тексту

- Пробіли замість табуляцій

Модуль Стилі редагування підтримує набори параметрів інших текстових редакторів: Emacs, Kate та Vim.

#### «Стиль редагування» Emacs

Скануються перші два рядки документу.

The Emacs options for tab-width, indent-offset, indent-tabs-mode and autowrap are supported. For more information, see the GNU Emacs Manual.

#### «Стиль редагування» Kate

Скануються перші та останні десять рядків документу.

З параметрів Kate підтримуються ширина табуляції, ширина відступу, відступ пробілами, перенос слів та word-wrap-column. Додаткову інформації дивіться веб-сайт Kate.

#### «Стиль редагування» Vim

Скануються перші та останні три рядки документа.

The Vim options for et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth are supported. For more information, see the Vim website.

### Модуль «Консоль Python»

Модуль Консоль Python дозволяє запускати команди на мові програмування python. У нижню панель буде додана вкладка, у якій можна ввести команду та переглянути її вивід.

Команди, що вводяться, виконуються без будь-якої перевірки. Можливі зависання pluma, наприклад, при вході у нескінченний цикл.

### Модуль «Фрагменти тексту»

Модуль Фрагменти тексту дозволяє зберігати фрагменти тексту, що часто використовуються, потім швидко вставляти ці фрагменти у будь-яке місце документу.

Фрагменти тексту специфічні для мови поточного документу. Наприклад, працюючи з HTML-документом, можна обрати фрагменти для HTML. Деякі текстові фрагменти глобальні, вони доступні для усіх видів документів.

Декілька фрагментів постачається у складі pluma. Їх можна змінювати.

#### Вставка фрагментів

Для вставки фрагменту введіть його tab-тригер та натисніть клавішу Tab. Tab-тригер фрагменту тексту — це зазвичай перші декілька символів потрібного фрагменту, або будь-яка послідовність, що легко запам'ятовується.

Інший спосіб: натискання Ctrl Пробіл дозволяє обрати зі списку потрібний фрагмент для вставки.

#### Додавання фрагментів

Для створення нового фрагменту тексту:

1. Виберіть Сервіс Керування фрагментами. Відкриється вікно Менеджер фрагментів.

2. У списку фрагменти тексту згруповані за мовою. Оберіть мову, для якого хочете додати фрагмент. Для додавання фрагменту, що стосується усіх мов, виберіть «Глобальний».

3. Натисніть Створити, та новий фрагмент додається у список.

4. Введіть наступну інформацію про фрагмент:

   Назва

5. Введіть назву фрагменту у текстове полі у списку. Назва служить лише для відображення суті фрагменту. Можна змінити назва текстового фрагмента, клацнув по ньому мишкою.

Текст фрагменту

- Введіть текст самого фрагменту у текстовому полі Редагувати фрагмент. Дивіться також pluma-snippets-plugin-syntax.

  Можна перемикнутися у вікно документу без закриття вікна Менеджер фрагментів.

Tab-тригер

- Введіть tab-тригер для фрагменту це - текст, який треба ввести до натискання клавіші Tab при вставлянні фрагменту.

  Tab-тригер Може бути або одним символом, або словом, що складається лише із літер. Якщо введений неправильний tab-тригер, він буде виділений червоним кольором.

Комбінація клавіш

- Введіть комбінацію клавіш, для вставки фрагменту.

#### Редагування та видалення фрагментів

Для редагування фрагменту виберіть його з списку та відредагуйте.

Для зміни назви фрагменту, клацніть на ньому у списку.

Щоб відновити змінені вбудовані фрагменти, натисніть Відновити.

Для видалення фрагменту, виберіть його зі списку та натисніть кнопку Видалити. Вбудовані фрагменти видаляти не можна.

#### Підстановка у фрагментах

Окрім статичного тексту у фрагменти можна включати і змінюваний текст, або символи пробілів, куди можна буде додати текст після вставки фрагменту у документ.

Можна використати наступні символи-замінники:

Закладки

- `$`n`` встановлює закладку, де `n` — число більше 1.

  `${`n`:`default`}` встановлює закладку з типовим значенням.

  Закладка позначає місце у фрагменті, куди можна додати текст після вставки фрагменту.

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

  При натисканні комбінації клавіш Shift Tab, можна перейти до попередньої закладки. Якщо закладок більше немає, клавіша Tab переміщує курсор у кінець фрагменту, або до кінцевого символу-заміннику, якщо такий є.

Дзеркала

- Декілька закладок будуть відображати один і той самий текст. Дзеркала дозволяють ввести текст один раз, і він відображатиметься у кількох місцях у фрагменті.

Кінцевий символ-замінник

- `$0` визначає кінцевий символ-замінник. Дозволяє завершити роботу з фрагментом, залишаючи курсор у потрібній позиції.

Змінні оточення

- У фрагментах можуть використовуватись змінні оточення, такі як `$PATH` та `$HOME` . Ось повний список змінних оточення, що можуть використовуватись:

  $PLUMA_SELECTED_TEXT

- Виділений текст.

$PLUMA_FILENAME

- Повна назва поточного документу. Якщо документ ще не був збережений, повертається порожній рядок.

$PLUMA_BASENAME

- Назва файлу без шляху, або порожній рядок, якщо файл не збережений.

$PLUMA_CURRENT_WORD

- Слово у позиції курсору. Слово буде замінене фрагментом тексту.

Команди оболонки

- `$(`cmd`)` у фрагменті тексту замінюється результатом виконання `cmd` у оболонці.

  `$(`n`:`cmd`)` дозволяє призначити посиланню цьому елементу, де `n` — число більше 1. За допомогою `$`n`` можна вивід однієї команди подати на вхід іншої.

Команди Python

- `$<`cmd`>` замінюється результатами обчислення `cmd` у інтерпретаторі мови python.

  `$<`a`:`cmd`>` визначає зв'язок з іншими командами python, де `a` — їх порядок у фрагменті. Це дозволяє використовувати функції python, визначення у інших фрагментах. Для вказування кількох залежностей, розділіть їх комами: `$<`a`,`b`:`cmd`>`

  Для використання змінних у python-фрагментах, декларуйте їх як `global`.

### Модуль сортування

Модуль Сортування впорядковує виділені рядки за алфавітом.

You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose File Revert .

Щоб скористатись сортуванням виконайте наступні дії:

1. Виділіть рядки для сортування

2. Choose Edit Sort . The Sort dialog opens.

3. Відмітьте потрібні параметри сортування:

   - Щоб сортувати у зворотному порядку, виберіть Зворотний порядок.

   - Для видалення дублікатів рядків, відмітьте Видаляти повтори.

   - Щоб не звертати увагу на регістр символів, виберіть Ігнорувати регістр.

   - Також можна виконувати сортування ігноруючи перші декілька символів рядків. Для цього скористайтесь полем Починати з стовпчика.

4. При натисканні кнопки Сортувати виконується сортування.

### Модуль перевірки орфографії

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

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   Невідомі слова відображаються іншим кольором та підкреслюються. Клацніть правою кнопкою на такому слові та виберіть підменю Можливі варіанти дозволяє:

   - Замінити слово на інше, що пропонується зі списку, просто клацнувши на ньому.

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   Якщо ніяких помилок не знайдено, буде виведене повідомлення: немає помилкових слів.

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

   - Слово з помилкою буде показано у верхній частині вікна.

   - Поле Замінити на буде містити пропонований варіант напису слова. Можна ввести у це поле власний варіант для заміни, або обрати альтернативу зі списку Варіанти.

   - Можна перевірити напис введеного на заміну слова, натискаючи кнопку Перевірити слово. Якщо слово правильне, у списку Варіанти буде надпис `(правильний напис)`. Якщо ж слово невідоме, у списку Варіанти будуть відображені уже варіанти його написання.

   - Для ігнорування невідомого слова, натисніть Ігнорувати. Щоб ігнорувати всі подібні слова, натисніть Ігнорувати все. Дійсно лише у межах поточної сеансу pluma.

   - Для заміни невідомого слова на слово у текстовому полі Замінити на, натисніть на кнопку Замінити. Щоб замінити всі подібні невідомі слова у тексті всього документу, натисніть Замінити все.

   - Додати невідоме слово у особистий словник можна натиснути на кнопку Додати слово.

   - Щоб закрити діалог Перевірка орфографії натисніть Закрити.

### Модуль списку тегів

Модуль Список тегів дозволяє вставити у документ теги зі списку у бічній панелі.

Для використання модуля:

1. Choose View Side Pane .

2. Типово, у бічній панелі відображається вкладка зі списком відкритих документів. Натисніть вкладку із зображенням «+» внизу панелі.

3. Виберіть відповідну категорію тегів у розкривному списку, наприклад, HTML - теги.

4. Можна прокрутити список тегів для пошуку потрібного.

5. Щоб вставити тег у позицію курсору у поточному файлі, двічі клацніть на потрібному тегу у списку. Інші способи вставки тегів:

   - Для вставки тегу та зміни фокусу вводу з бічної панелі до редагування поточного документу, натисніть клавішу Enter.

   - Для вставки тегу та збереження фокусу вводу за списком тегів, натисніть комбінацію клавіш Shift Enter.