# Руководство по Pluma

## Введение

Приложение pluma позволяет вам создавать и редактировать текстовые файлы.

Цель pluma — быть простым и лёгким в использовании текстовым редактором. Многие возможности могут быть включены модулями, решающими множество задач по редактированию текста.

## Начало

### Запуск pluma

Можно запустить pluma следующими способами:

Меню Приложения

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

Командная строка

- Выполните команду: `pluma`

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

### Окно pluma

Когда запускается pluma, отображается следующее окно:

#### Окно pluma

Shows pluma main window.

Окно pluma состоит из следующих элементов:

Строка меню

- Меню включает в себя все команды необходимые для работы с файлами в pluma.

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

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

Область просмотра

- В области просмотра отображается редактируемый текст.

Строка статуса

- Строка статуса показывает текущее состояние pluma, а также контекстную информацию о пунктах меню. Информация о состоянии может быть следующей:

  - Позиция курсора: номер строки и номер столбца, где находится курсор.

  - Режим редактирования: если редактор находится в режиме вставки, в строке статуса отобразится ВСТ. Если редактор в режиме замены, строка статуса покажет ЗАМ. Нажатие клавиши Insert меняет режим редактирования.

Боковая панель

- В боковой панели отображается список открытых документов и другая информация, зависящая от загруженных модулей.

  По умолчанию боковая панель скрыта. Чтобы увидеть её, выберите Вид Боковая панель.

Нижняя панель

- Нижняя панель используется инструментами программирования, такими как модуль Консоль Python, для отображения результатов работы.

  По умолчанию нижняя панель скрыта. Чтобы увидеть её, выберите Вид Нижняя панель.

При щелчке правой кнопкой мыши в окне 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 из командной строки с одним или несколькими файлами. Для открытия нескольких файлов введите следующую команду и нажмите клавишу Ввод:

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

Также, вместо имени файла можно указать URI.

Для дополнительной информации о запуске pluma из командной строки смотрите страницы руководства unix для 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. Нажмите кнопку Открыть.

`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`

- Символ возврата каретки.

`\\`

- При поиске необходимо экранировать символы обратного слеша. Например, если вы ищете "`\n`", в поле Найти нужно напечатать "\\n". Иными словами, если вы хотите найти последовательность обратных слэшей, вам необходимо увеличить число вводимых обратных слэшей вдвое.

### Установка курсора на определённую строку

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.

Начните вводить номер строки, на которую хотите переместить курсор, и документ прокрутится до указанной строки.

Чтобы покинуть окно и перейти к указанной строке, нажмите клавишу Ввод.

## Печать

### Установка параметров страницы

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 (PDF) являются общими предпечатными форматами.

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.

  С помощью кнопки Сохранить как, можно указать имя и местоположение файла.

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 | Открыть адрес (URI).
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 | Удалить текущую строку.
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

- Выберите параметр Подсвечивать текущую строку для подсветки строки, где находится курсор.

Right Margin

- Выберите Отображать правую границу, чтобы отображалась вертикальная линия — правая граница.

  Используя поле Правая граница у столбца, можно указать положение этой вертикальной линии.

Bracket Matching

- Выберите параметр Подсвечивать соответствующую скобку для подсветки соответствующих скобок, когда курсор установлен на одной из них.

### Настройки редактирования

Tabs

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

  Параметр Вставлять пробелы вместо табуляций укажет pluma по нажатию клавиши Tab вставлять вместо символа табуляции определённое число пробелов.

Auto Indentation

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

File Saving

- При включённой настройке Создавать резервную копию файла перед сохранением каждый раз при сохранении файла, создается его резервная копия. Резервная копия содержит символ ~ в конце имени файла.

  Параметр Автоматически сохранять каждые ... минут позволяет автоматически сохранять текущий файл через определённые промежутки времени.

### Шрифты и цвета

Font

- Выберите Использовать исходный шрифт темы, чтобы текст в окне pluma отображался шрифтом определённым по умолчанию.

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

Color Scheme

- Вы можете выбрать цветовую схему из списка схем. По умолчанию, представлены следующие цветовые схемы:

  Classic

- Классическая цветовая схема. Основана на цветовой схеме gvim.

Cobalt

- Синеватая цветовая схема.

Kate

- Цветовая схема, используемая в текстовом редакторе Kate.

Oblivion

- Темная цветовая схема, использующая цветовую палитру Танго.

Tango

- Цветовая схема Танго.

Чтобы добавить новые цветовые схемы, щёлкните Добавить...и выберите файл с цветовой схемой

Чтобы удалить выбранную цветовую схему, щёлкните на кнопке Удалить

### Настройка модулей

Модули расширяют возможности 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.

- Обозреватель файлов позволяет просмотреть папки и файлы в боковой панели.

- Отступ вставляет или убирает отступ в выделенных строках.

- Вставка даты и времени вставляет текущую дату и время в позиции курсора.

- Modelines Поддержка 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 в каталоге текущего документа.

Список файлов в каталоге

- Вставляет содержание каталога текущего документа в новый документ.

Переменные окружения

- Отображает список переменных окружения в нижней панели.

Поиск по файлам

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

Удалить конечные пробелы

- Удаляет все начинающие и завершающие пробелы в строках.

#### Определение команд

Чтобы добавить внешнюю команду, выберите Сервис External Tools.

В окне External Tools Manager щёлкните кнопку Создать. Для новой команды можно указать следующие детали:

Описание

- Когда меню команды выбрано, описание отображается в строке статуса.

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

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

Команды

- Запускаемые команды. Можно использовать также и переменные окружения, подробнее смотрите 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

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

Модуль File Browser отображает папки и файлы в боковой панели, позволяя быстро открывать файлы.

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. Щёлкните OK для закрытия диалога.

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

### Модуль «Строки режимов»

Модуль Строки режимов позволяет установить индивидуальные настройки документа. Строки режимов представляют собой строки текста в начале или конце документа с параметрами для pluma.

Значения параметров установленных с помощью строк режимов имеют преимущество перед значениями тех же параметров установленных через диалог установки параметров.

Можно установить следующие параметры с помощью строк режимов:

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

- Ширина отступа

- Пробелы вместо табуляций

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

- Положение правой границы

Модуль Строки режимов поддерживает некоторые возможности настроек других текстовых редакторов: Emacs, Kate и Vim по заголовку текстового файла.

#### «Строки режимов» Emacs

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

Из настроек Emacs поддерживаются ширина табуляции, отступ выравнивания, режим отступа с помощью табуляции и авто-перенос. Для дополнительной информации смотрите Руководство по GNU Emacs.

#### «Строки режимов» Kate

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

Из настроек Kate поддерживаются ширина табуляции, ширина отступа, отступ пробелами, перенос слов и номер столбца для переноса. Для дополнительной информации смотрите Kate website.

#### «Строки режимов» Vim

Сканируются первые и последние три строки документа.

Из настроек Vim поддерживаются expandtab, ts, tabstop, shiftwidth, wrap и textwidth. Подробнее смотрите Vim website.

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

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

Вводимые команды исполняются безо всякой проверки. Возможны зависания pluma, например, при входе в бесконечный цикл.

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

Модуль Фрагменты текста позволяет сохранять часто используемые куски текста и, затем быстро вставлять эти куски в любое место в редактируемом документе.

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

Некоторое количество фрагментов поставляется в составе pluma. Их можно менять.

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

Для вставки фрагмента напечатайте его tab trigger и нажмите клавишу Tab. Tab trigger фрагмента текста — это обычно первые несколько символов нужного фрагмента, либо какая-нибудь еще короткая и легко запоминающаяся последовательность.

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

#### Добавление фрагментов

Чтобы создать новый фрагмент текста:

1. Выберите Сервис Управление фрагментами. Откроется окно Менеджер фрагментов.

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

3. Щёлкните Создать, и новый фрагмент добавится в список.

4. Введите следующую информацию о фрагменте:

   Имя

5. Введите имя фрагмента в текстовое поле в списке. Имя служит только для отражения сути фрагмента. Можно изменить имя текстового фрагмента, щелкнув по нему мышкой.

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

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

  Можно переключаться в окно документа без закрытия окна Менеджер фрагментов.

Tab Trigger

- Введите tab trigger для фрагмента. Этот текст нужно напечатать до нажатия клавиши Tab при вставке фрагмента.

  Tab trigger Может быть либо одним символом, либо словом, состоящим только из букв. Если введенный tab trigger невозможен, он будет подсвечен красным цветом.

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

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

#### Редактирование и удаление фрагментов

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

Для переименования фрагмента, щёлкните его в списке.

Чтобы восстановить измененные встроенные фрагменты, нажмите Revert.

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

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

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

Можно использовать следующие символы-заменители:

Закладки

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

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

  Закладка маркирует место во фрагменте, куда можно добавить текст после вставки фрагмента.

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

  Нажав комбинацию клавиш Shift Tab, можно перейти к предыдущей закладке. Если закладок больше нет, клавиша Tab перемещает курсор в конец фрагмента, или к концевому символу-заменителю, если таковой имеется.

Зеркала

- Несколько закладок будут отображать один и тот же текст. Зеркала позволяют ввести текст лишь однажды и этот текст будет отображен в нескольких местах во фрагменте.

Концевой символ-заменитель

- `$0` определяет концевой символ-заменитель. Позволяет завершить работу с фрагментом, оставив курсор в нужной позиции.

Переменные окружения

- Переменные окружения, такие как `$PATH` и `$HOME` могут быть использованы во фрагментах. Вот полный список переменных окружения, что могут использоваться:

  $PLUMA_SELECTED_TEXT

- Текущий выделенный текст.

$PLUMA_FILENAME

- Полное имя текущего документа. Если документ еще не был сохранен, возвращается пустая строка.

$PLUMA_BASENAME

- Имя файла без пути, или пустая строка если файл не сохранен.

$PLUMA_CURRENT_WORD

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

Команды shell

- `$(`cmd`)` во фрагменте текста заменяется результатом выполнения `cmd` в shell.

  `$(`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. Чтобы вставить тег в позицию курсора в текущем файле, дважды щёлкните по нужному тегу в списке. Другие способы вставки тегов:

   - Для того, чтобы вставить тэг и переместить фокус ввода с боковой панели к окну редактирования текущего документа, нажмите клавишу Ввод.

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