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

2015-2021
MATE Documentation Project
2007
GNOME Documentation Project
2002
2003
2004
Sun Microsystems
2000
Eric Baudais
Проект документирования MATE
Проект документирования GNOME
Проект документирования MATE
Рабочий стол MATE
Joachim
Noreiko
Проект документирования GNOME
GNOME
Hal
Canary
Добавлена таблица комбинаций клавиш
Команда Документации по Sun Java Desktop System
Sun Microsystems
gdocteam@sun.com
Eric
Baudais
Проект документирования GNOME
baudais@okstate.edu
Baris
Cicek
Предоставлена информация из более ранних версий приложения Pluma.
George
Ajit
Предоставлена информация о модулях.
1.0
2000

Eric Baudais baudais@okstate.edu

Проект документирования GNOME

2.0
Март 2002

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.1
Июнь 2002

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.2
Август 2002

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.3
Сентябрь 2002

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.4
Январь 2003

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.5
Март 2003

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.6
Сентябрь 2003

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.7
Март 2004

Команда документирования GNOME компании Sun

Проект документирования GNOME

2.8
Июль 2015

Команда Документации по Sun Java Desktop System

Проект документирования GNOME

2.9
Июль 2006

Команда документирования GNOME

Проект документирования GNOME

3.0
Июль 2015

Команда документирования MATE

Проект документирования MATE

Это руководство описывает версию pluma 1.10.

## Введение

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

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

## Начало работы

### Запуск Pluma

Вы можете запустить Pluma следующими способами:

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

  Выберите аксессуары для текстового редактора Pluma.

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

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

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

### Окно Pluma

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

#### Окно Pluma

Показывается главное окно Pluma.

Окно pluma содержит следующие элементы:

Строка меню

  Меню на соответствующей панели содержат все команды , требующиеся для работы с файлами в Pluma.

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

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

Область отображения

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

Строка состояния

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

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

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

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

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

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

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

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

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

Когда вы щёлкаете правой кнопкой мыши в окне приложения pluma, появляется контекстное меню. Оно содержит наиболее распространенные команды редактирования текста.

Как и в других приложениях среды MATE, действия в pluma можно выполнить несколькими способами: с помощью меню, с помощью панели инструментов, или используя комбинации клавиш. Комбинации клавиш, общие для всех приложений, перечислены в Руководстве пользователя.

### Запуск «Pluma» из командной строки

Вы можете запустить pluma из командной строки и открыть один или несколько файлов. Чтобы открыть несколько файлов из командной строки, наберите приведённую ниже команду, затем нажмите Return:

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

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

Обратитесь к странице руководства по pluma 1 для получения дополнительной информации о запуске pluma из командной строки.

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

### Создание нового документа

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

### Открытие файла

Для открытия файла выберите Файл Открыть , чтобы появится диалоговое окно Открыть файл. Выберите необходимый файл и нажмите Открыть. Выбранный файл откроется в окне pluma.

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

В pluma вы можете одновременно открыть несколько файлов. При этом, каждый файл будет открыт в отдельной вкладке. Подробнее смотрите в разделе .

Вы можете напечатать местоположение файла в диалоговом окне Открыть файл. Чтобы переключиться между ручным вводом местоположения и навигационным режимом, нажмите Ctrl l, ., ~ или /.

### Сохранение файла

Вы можете сохранять файлы следующими способами:

- Чтобы сохранить изменения в имеющемся файле, выберите Файл Сохранить .

- Чтобы сохранить новый файл или существующий файл с новым названием, выберите Файл Сохранить как . Введите название файла в диалоговом окне Сохранить как и нажмите Сохранить.

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

Чтобы закрыть все файлы, открытые на данный момент в pluma, выберите Документы Закрыть все .

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

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

Чтобы переместить документ в другое окно pluma, перетащите соответствующую вкладку в окно, в которое вы хотите его переместить.

Чтобы переместить документ в новое окно pluma, вы можете перетащить соответствующую вкладку на рабочий стол или воспользоваться меню: Документы Переместить в новое окно .

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

### Редактирование текста

Вы можете редактировать текстовый файл следующими способами:

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

- Чтобы скопировать выделенный текст в буфер обмена, выберите Правка Копировать .

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

- Чтобы навсегда удалить выделенный текст из файла, выберите Правка Удалить .

- Чтобы вставить содержимое буфера обмена в позиции курсора, выберите Правка Вставить . Прежде чем вставить текст в файл, вы должны вырезать или скопировать его в текстовом редакторе «Pluma» либо в другом приложения.

- Чтобы выделить весь текст в файле, выберите Правка Выделить всё .

### Отмена и возврат изменений

Чтобы отменить внесённое изменение, выберите Правка Отменить . Чтобы отменить это действие, выберите Правка Вернуть .

## Поиск и замена

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

### Поиск текста

Чтобы найти в файле строку с текстом, выполните следующие действия:

1. Выберите пункт меню Поиск Поиск... для показа диалога Поиск.

2. Введите строку, которую требуется найти, в поле Искать. Можно включить специальные символы (например, символ новой строки или табуляцию): смотрите .

3. Нажмите кнопку Найти, чтобы найти в файле первое вхождение указанной строки после текущей позиции курсора. Если pluma найдёт строку, будет выбрано её первое вхождение. Остальные вхождения строки будут подсвечены.

4. Чтобы найти следующее вхождение строки, нажмите кнопку Найти или выберите пункт меню Поиск Найти следующее . Чтобы найти предыдущее вхождение текста, выберите пункт меню Поиск Найти предыдущее .

После закрытия диалога Поиск всё ещё будет можно перемещать выбор на другие вхождения текста с помощью пунктов меню Поиск Найти следующее и Поиск Найти предыдущее .

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

Обратитесь к странице руководства по pcrepattern 3 для получения дополнительной информации о синтаксисе и семантике регулярных выражений, поддерживаемых в диалоге Поиск.

### Пошаговый поиск

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

Чтобы начать пошаговый поиск, выберите Поиск Пошаговый поиск . В верхней части области отображения появится поле для ввода поискового запроса.

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

Чтобы перейти к следующему совпадению, оставив окно пошагового поиска открытым, нажмите Ctrl G . Чтобы перейти к предыдущему совпадению, нажмите Ctrl Shift G .

Вы также можете использовать клавиши со стрелками «вверх» и «вниз» или колёсико мыши для перемещения между найденными совпадениями.

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

Чтобы найти в файле строчку и заменить её альтернативной, выполните следующие действия:

1. Выберите пункт меню Поиск Заменить... для показа диалога Заменить.

2. Введите строку, которую требуется найти, в поле Искать. Можно включить специальные символы (например, символ новой строки или табуляцию): смотрите .

3. Введите строку, которую следует использовать для замены найденной строки, в поле Заменить на.

Нажимайте кнопку Найти, чтобы просмотреть каждое вхождение строки перед заменой. Если pluma найдёт строку, она будет выбрана. Нажмите кнопку Заменить, чтобы заменить выбранное вхождение строки. Снова нажмите кнопку Найти, чтобы найти следующее вхождение строки.

Для замены всех вхождений строки в документе нажмите кнопку Заменить всё.

### Параметры поиска и замены

Как в диалоге Поиск, так и в диалоге Заменить доступны следующие параметры:

- Выберите параметр Учитывать регистр для поиска только тех вхождений строки, которые соответствуют регистру вводимого текста. Если параметр Учитывать регистр включён, то, например, «TEXT» не будет соответствовать «text».

- Выберите параметр Только полные слова для поиска только тех вхождений строки, которые соответствуют полным словам вводимого текста. Если параметр Только полные слова включён, то, например, «text» не будет соответствовать «texture».

- Выберите параметр Обратный поиск для поиска в обратном направлении (к началу документа).

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

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

Можно включить в текст следующие управляющие последовательности для обозначения специальных символов:

`\n`

  Указывает новую строку.

`\t`

  Определяет символ табуляции.

`\r`

  Определяет возврат каретки.

`\\`

  Сам символ обратной косой черты необходимо экранировать, если выполняется его поиск. Например, чтобы найти литерал «`\n`», потребуется ввести «\\n» в поле Искать. А если выполняется поиск последовательности обратных косых черт, то придётся удвоить количество косых черт в поле поиска.

### Позиционирование курсора на определённой строке

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

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

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

## Печать

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

Для настройки параметров страницы выберите пункт меню Файл Параметры страницы ; будет показан диалог Параметры страницы.

В диалоге Параметры страницы можно указать следующие параметры печати:

#### Вкладка «Общие»

Печатать подсветку синтаксиса

  Выберите этот параметр, чтобы напечатать подсветку синтаксиса. Дополнительные сведения о подсветке синтаксиса смотрите в .

Печатать заголовки страниц

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

Номера строк

  Выберите параметр Печатать номера строк, чтобы включать номера строк при печати файла.

  Используйте поле Печатать номера каждые , чтобы счётчиком указать периодичность печати номеров строк, например, каждые 5 строк, каждые 10 строк и т. д.

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

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

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

#### Шрифты

Тело

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

Номера строк

  Щёлкните на эту кнопку, чтобы выбрать шрифт, используемый для печати номеров строк.

Верхние и нижние колонтитулы

  Щёлкните на эту кнопку, чтобы выбрать шрифт для печати верхних и нижних колонтитулов.

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

### Печать документа

Вы можете использовать pluma для выполнения следующих операций печати:

- Напечатать документ на принтере.

- Напечатать вывод команды печати в файл.

Если вы печатаете в файл, pluma отправляет выходные данные файла в файл формата допечатной подготовки. Наиболее распространенными форматами допечатной подготовки являются PostScript и Portable Document Format (PDF).

Для предварительного просмотра страниц, которые вы хотите напечатать, выберите Файл Просмотр печати .

Чтобы напечатать текущий документ на принтере или в файл, выберите Файл Напечатать , откроется диалоговое окно Печать.

В диалоговом окне Печать можно указать следующие параметры печати:

#### Вкладка «Задание»

Диапазон

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

  - Все страницы

    Выберите этот параметр, чтобы напечатать все страницы файла.

  - Строки

    Выберите этот параметр, чтобы напечатать только указанные строки. Используйте поля От и До, чтобы указать необходимый диапазон.

  - Выделение

    Выберите этот параметр, чтобы напечатать только выделенный текст. Этот параметр становится доступен только при выделении текста.

Копии

  Используйте счётчик Копий, чтобы указать необходимое количество копий файла для печати.

  Если вы печатаете несколько копий файла, выберите параметр Упорядочить, чтобы отсортировать распечатанные копии.

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

Принтер

  Используйте этот раскрывающийся список, чтобы выбрать принтер, на котором вы хотите распечатать файл.

Параметры

  Выберите параметры принтера в этом раскрывающемся списке.

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

Расположение

  Выберите одно из следующих расположений печати в этом раскрывающемся списке:

  CUPS

    Напечатать файл на принтере CUPS.

    Если выбранный принтер поддерживает CUPS, в раскрывающемся списке будет только один вариант — CUPS.

  lpr

    Напечатать файл на принтере.

  Файл

    Напечатать в файл PostScript.

    Нажмите кнопку Сохранить как, чтобы открыть диалог, в котором можно указать название и расположение файла PostScript.

  Другое

    Используйте указанную команду для печати файла.

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

Состояние

  В этой версии pluma не поддерживается данная функциональная возможность.

Тип

  В этой версии pluma не поддерживается данная функциональная возможность.

Комментарий

  В этой версии pluma не поддерживается данная функциональная возможность.

#### Вкладка «Бумага»

Размер бумаги

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

Ширина

  Используйте этот счётчик для указания ширины бумаги. В расположенном рядом раскрывающемся списке можно изменить единицы измерения.

Высота

  Используйте этот счётчик для указания высоты бумаги.

Ориентация бумаги

  Используйте этот раскрывающийся список для задания ориентации бумаги в принтере.

Ориентация страницы

  Используйте этот раскрывающийся список для задания ориентации страниц.

Расположение

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

Выходной лоток

  Выберите лоток для бумаги в этом раскрывающемся списке.

## Возможности программирования

Ряд возможностей программирования pluma предоставляется модулями. Например, модуль «Список тегов» предоставляет список часто используемых тегов для различных языков разметки: смотрите .

### Подсветка синтаксиса

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

Приложение pluma выбирает подходящий режим подсветки синтаксиса на основе типа документа. Чтобы переопределить режим подсветки синтаксиса, выберите пункт меню Вид Режим подсветки синтаксиса , затем выберите один из следующих пунктов меню:

Текст

  Не показывать подсветку синтаксиса.

Исходный текст

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

Разметка

  Показывать подсветку синтаксиса для редактирования кода разметки. Используйте подменю Разметка для выбора типа кода разметки.

Сценарий

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

Другое

  Показывать подсветку синтаксиса для редактирования других типов кода. Используйте подменю Другие для выбора типа кода.

### Передача выходных данных команды в файл

Программа pluma позволяет передавать выходные данные команды в текстовый файл. Например, чтобы передать выходные данные команды `ls` в текстовый файл, введите `ls | pluma`, а затем нажмите клавишу Return.

Выходные данные команды `ls` отображаются в новом текстовом файле в окне pluma.

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

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

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

Дополнительная информация о комбинациях клавиш доступна в руководстве пользователя по рабочей среде.

Вкладки

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

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

файлы

Комбинации клавиш для работы с файлами:

Комбинация клавиш | Команда
--- | ---
Ctrl + N | Создать новый документ.
Ctrl + O | Открыть документ.
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 | Удалить текущую строку.
Ctrl + U | Изменить регистр на верхний.
Ctrl + L | Изменить регистр на нижний.
Alt + U | Изменить регистр каждого символа.
Alt + L | Написать каждое слово с заглавной буквы.
Alt + Up | Переместить выбранную строку вверх на одну.
Alt + Стрелка вниз | Переместить выбранную строку вниз на одну.
Tab | Увеличить отступ выделенных строк.
Shift + Tab | Уменьшить отступ выделенных строк.

Вид

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

Комбинация клавиш | Команда
--- | ---
Ctrl + Y | Показать/Скрыть номера строк.

Панели

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

Комбинация клавиш | Команда
--- | ---
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.

## Параметры

Чтобы настроить приложение pluma, выберите пункт меню Правка Параметры . Диалог Параметры содержит следующие категории:

### Вид

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

  Выберите параметр Включить режим переноса текста для формирования абзацев из длинных строк текста (так текст не будет выходить за пределы текстового окна). В этом случае не потребуется горизонтальная прокрутка.

  Выберите параметр Не _разрывать слово между двумя строками для сохранения целостности слов при переносе текста на следующую строку. В этом случае читать текст будет легче.

Номера строк

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

Текущая строка

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

Правое поле

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

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

Соответствие скобок

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

### Редактор

Метки табуляции

  Используйте счётчик Ширина табуляции для указания ширины пространства, которое pluma вставляет при нажатии клавиши Tab.

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

Автоматический отступ

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

Сохранение файлов

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

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

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

Шрифт

  Выберите параметр Использовать системный моноширинный шрифт (%s), чтобы использовать системный шрифт по умолчанию для текста в текстовом окне pluma.

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

Цветовая схема

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

  Классическая

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

  Cobalt

    Цветовая схема, основанная на синем цвете.

  Kate

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

  Oblivion

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

  Tango

    Цветовая схема, использующая цветовую схему Tango.

  Можно добавить новую цветовую схему, нажав Добавить... и выбрав файл цветовой схемы

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

### Модули

Модули предоставляют pluma дополнительные возможности. Дополнительная информация о модулях и использовании встроенных модулей: .

#### Включение модуля

Чтобы включить модуль pluma, выполните следующие действия:

1. Выберите пункт меню Правка Параметры .

2. Выберите вкладку Модули.

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

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

#### Отключение модуля

При выходе из pluma модуль остаётся включённым.

Чтобы отключить модуль pluma, выполните следующие действия:

1. Выберите пункт меню Правка Параметры .

2. Выберите вкладку Модули.

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

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

## Модули

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

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

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

Чтобы включить или отключить модули или просто просмотреть текущие включённые модули, используйте .

С pluma поставляются следующие встроенные модули:

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

- позволяет выполнять внешние команды из pluma.

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

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

- добавляет в документ текущие дату и время.

- позволяет задать параметры редактирования для отдельных документов и поддерживает строки режимов Emacs, Kate и Vim.

- позволяет выполнять команды на языке программирования Python.

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

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

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

- исправляет орфографические ошибки в выбранном тексте или автоматически отмечает ошибки в документе.

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

Дополнительная информация о создании модулей: .

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

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

1. Выберите пункт меню Сервис Показать статистику документа для отображения диалога Статистика документа. В диалоге Статистика документа показана следующая информация о файле:

   - Количество строк в текущем документе.

   - Количество слов в текущем документе.

   - Количество символов (с пробелами) в текущем документе.

   - Количество символов (без пробелов) в текущем документе.

   - Количество байтов в текущем документе.

2. С файлом pluma можно продолжать работу, когда открыт диалог Статистика документа. Чтобы обновить содержимое диалога Статистика документа, нажмите кнопку Обновить.

### Модуль «Внешние инструменты»

Модуль Внешние инструменты позволяет выполнять внешние команды из pluma. В команду можно передать некое содержимое и использовать её выходные данные (например, sed) или запустить предустановленную команду (например, make).

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

#### Встроенные команды

С модулем Внешние инструменты поставляются следующие команды:

Сборка

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

Перечень файлов каталога

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

Переменные среды

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

Фильтр

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

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

  Удаляет все пробелы в конце строк документа.

#### Создание команды

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

В окне Управление внешними средствами нажмите кнопку Создать. Для новой команды можно задать следующие параметры:

Описание

  Это описание отображается в строке состояния при выборе команды в меню.

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

  Введите комбинацию клавиш для команды.

Команды

  Сами команды, которые будут выполнены. Для передачи содержимого этим командам можно использовать несколько переменных среды pluma: смотрите .

Ввод

  Содержимое для передачи командам (как 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

### Модуль «Панель обозревателя файлов»

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

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

#### Просмотр файлов

На вкладке «Обозреватель файлов» изначально показаны закладки диспетчера файлов. Для просмотра содержимого элемента сделайте по нему двойной щелчок.

Чтобы просмотреть родительскую папку, выберите её в раскрывающемся списке или нажмите стрелку вверх на панели инструментов «Обозревателя файлов».

Чтобы просмотреть папку, содержащую тот документ, над которым сейчас ведётся работа, щёлкните в списке файлов правой кнопкой мыши и выберите в контекстном меню пункт Установить корень на активный документ.

#### Открытие файла

Чтобы открыть файл в pluma, сделайте по нему двойной щелчок в списке файлов.

#### Создание файлов и папок

Чтобы создать новый пустой текстовый файл в текущей показанной в обозревателе папке, щёлкните в списке файлов правой кнопкой мыши и выберите в контекстном меню пункт Создать файл.

Чтобы создать новую папку в текущей показанной в обозревателе папке, щёлкните в списке файлов правой кнопкой мыши и выберите в контекстном меню пункт Создать папку.

### Модуль «Отступ строк»

Модуль Отступ строк добавляет или удаляет пустое пространство в начале строк текста.

Чтобы добавить или убрать отступ текста, выполните следующие действия:

1. Выберите строки, для которых требуется добавить или убрать отступ. Чтобы добавить или убрать отступ отдельной строки, поместите курсор в любое место на ней.

2. - Чтобы добавить отступ текста, выберите пункт меню Правка Добавить отступ .

   - Чтобы убрать отступ, выберите пункт меню Правка Отменить отступ .

Количество используемого пространства, а также использование табуляций или пробелов определяются параметрами в разделе настройки Метки табуляции: смотрите .

### Модуль «Вставка даты и времени»

Модуль Вставка даты и времени вставляет текущие дату и время в документ. Чтобы использовать этот модуль, выполните следующие действия:

1. Выберите пункт меню Правка Вставить дату и время... .

   Если модуль «Вставка даты и времени» не настроен на автоматическую вставку даты и времени без запроса формата у пользователя, pluma отобразит диалог Вставить дату и время. Выберите подходящий формат даты и времени в списке. Нажмите кнопку Вставить для закрытия диалога Вставить дату и время. pluma вставит дату и время в позиции курсора в текущем файле.

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

#### Настройка модуля «Вставка даты и времени»

Чтобы настроить модуль «Вставка даты и времени», выполните следующие действия:

1. Выберите пункт меню Правка Параметры .

2. Выберите вкладку Модули.

3. Выберите модуль Вставка даты и времени.

4. Нажмите кнопку Настроить модуль для отображения диалога Настройка модуля вставки даты и времени.

5. Выберите один из следующих вариантов:

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

   - Чтобы использовать один и тот же предоставленный pluma формат даты и времени при каждой их вставке, выберите вариант Использовать указанный формат, затем выберите подходящий формат в списке. Если выбран этот вариант, pluma не предлагает указать формат даты и времени при выборе пункта меню Правка Вставить дату и время .

   - Чтобы всегда использовать тот же пользовательский формат даты и времени при каждой их вставке, выберите вариант Использовать другой формат, а затем введите подходящий формат в текстовом поле. Обратитесь к странице руководства по strftime 3 для получения дополнительной информации об указании пользовательского формата. Если выбран этот вариант, pluma не предлагает указать формат даты и времени при выборе пункта меню Правка Вставить дату и время .

6. Нажмите кнопку OK для закрытия диалога Настройка модуля вставки даты и времени.

7. Чтобы закрыть диалог Параметры, нажмите кнопку Закрыть.

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

Модуль Строки режимов позволяет устанавливать параметры для отдельных документов. Строка режима (моделайн) — это расположенная в начале или конце документа строка текста с параметрами, которые распознаёт pluma.

Параметры, заданные с помощью строк режимов, имеют приоритет над параметрами, указанными в диалоге настройки параметров.

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

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

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

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

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

- Ширина правого поля

Модуль Режимы строк поддерживает подмножество параметров, используемых другими текстовыми редакторами (Emacs, Kate и Vim).

#### Строки режима Emacs

Поиск строк режима Emacs выполняется в первых двух строках документа.

Поддерживаются следующие параметры Emacs: tab-width, indent-offset, indent-tabs-mode и autowrap. Дополнительная информация доступна в руководстве пользователя GNU Emacs.

#### Строки режима Kate

Поиск строк режима Kate выполняется в первых и последних десяти строках документа.

Поддерживаются следующие параметры Kate: tab-width, indent-width, space-indent, word-wrap и word-wrap-column. Дополнительная информация доступна на веб-сайте Kate.

#### Строки режима Vim

Поиск строк режима Kate выполняется в первых и последних трёх строках документа.

Поддерживаются следующие параметры Vim: et, expandtab, ts, tabstop, sw, shiftwidth, wrap и textwidth. Дополнительная информация доступна на веб-сайте Vim.

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

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

Команды, введённые в консоли Python, не проверяются перед выполнением. Поэтому возможно, например, вызвать зависание программы pluma при вводе бесконечного цикла.

### Модуль «Сохранить без лишних пробелов»

Модуль Сохранить без лишних пробелов удаляет символы пустого пространства, такие как пробел (`˽`), табуляция (`\t`), возврат каретки (`\r`) и т.д. в конце строки. Чтобы использовать модуль «Сохранить без лишних пробелов», выполните следующие действия:

1. Включите модуль, как описано в .

2. Когда документ будет готов, сохраните его.

3. После сохранения документа будут удалены все лишние пробелы.

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

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

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

С программой pluma устанавливается ряд встроенных фрагментов, которые можно изменять.

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

Чтобы вставить фрагмент в документ, введите его переключатель и нажмите клавишу Tab. Обычно переключателем фрагмента являются его первые несколько букв или какая-либо другая короткая и простая для запоминания последовательность символов.

Кроме того, можно просмотреть список доступных для вставки фрагментов: нажмите Ctrl Пробел .

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

Чтобы создать новый фрагмент, сделайте следующее:

1. Выберите пункт меню Сервис Управление фрагментами... . Будет открыто окно Обозреватель фрагментов.

2. Фрагменты сгруппированы по языкам. Выберите язык, для которого требуется добавить фрагмент, или фрагмент в группе этого языка. Чтобы добавить фрагмент для всех языков, выберите пункт «Глобальные» (верхний в списке). По умолчанию показан синтаксис документа, над которым в настоящее время ведётся работа.

3. Нажмите кнопку Создать. В списке появится новый фрагмент.

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

   Имя

     Введите имя фрагмента в текстовом поле внутри списка фрагментов. Имя фрагмента предназначено исключительно для того, чтобы напоминать пользователю о предназначении этого фрагмента. Чтобы изменить имя создаваемого фрагмента, щёлкните по нему в списке.

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

     Введите текст фрагмента в текстовом поле Правка. Информация о специальных кодах, которые можно использовать: .

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

   Переключатель

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

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

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

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

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

Чтобы отредактировать фрагмент, выберите его в списке и внесите изменения в его текст и свойства активации.

Чтобы переименовать фрагмент, снова щёлкните по нему в списке.

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

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

#### Замены фрагментов

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

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

Tab-заполнители

  `$n` задаёт tab-заполнитель, где `n` — любое число не меньше 1.

  `${n:default}` задаёт tab-заполнитель со значением по умолчанию.

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

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

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

Mirror-заполнители

  Повторённый tab-заполнитель будет отражать уже заданный. Благодаря этому можно только один раз ввести тот текст, который должен появиться во фрагменте несколько раз.

End-заполнитель

  `$0` задаёт end-заполнитель. Это позволяет закончить работу с фрагментом, когда курсор находится в точке, отличной от конца текста фрагмента.

Переменные среды

  В тексте фрагмента заменяются такие переменные среды, как `$PATH` и `$HOME`. Также можно использовать следующие переменные, относящиеся к pluma:

  $PLUMA_SELECTED_TEXT

    Текущий выбранный текст.

  $PLUMA_FILENAME

    Полное имя файла документа (или пустая строка, если документ ещё не сохранён).

  $PLUMA_BASENAME

    Базовое имя файла документа (или пустая строка, если документ ещё не сохранён).

  $PLUMA_CURRENT_WORD

    Слово в позиции курсора в документе. Когда используется эта переменная, текущее слово заменяется текстом фрагмента.

Shell-заполнители

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

  `$(n:cmd)` позволяет дать ссылку на этот заполнитель, где n — любое число не меньше 1. Используйте `$n` для использования выходных данных одного shell-заполнителя в качестве входных данных другого.

Python-заполнители

  `$<cmd>` заменяется результатом вычисления cmd в интерпретаторе Python.

  `$<a:cmd>` указывает в качестве зависимости другой python-заполнитель, где a задаёт его порядок во фрагменте. Это позволяет использовать функции Python, определённые в другом фрагменте. Чтобы указать несколько зависимостей, разделяйте числа запятыми: `$<a,b:cmd>`

  Чтобы использовать переменную во всех других фрагментах Python, объявите её как `global`.

### Модуль «Сортировка»

Модуль Сортировка упорядочивает выбранные строки текста по алфавиту.

Чтобы использовать модуль «Сортировка», выполните следующие действия:

1. Выберите те строки текста, которые требуется упорядочить.

2. Выберите пункт меню Правка Сортировать... . Будет открыт диалог Сортировка.

3. Выберите нужные параметры сортировки:

   - Чтобы упорядочить текст в обратном порядке, выберите В обратном порядке.

   - Чтобы удалить дубликаты строк, выберите Убирать повторения.

   - Чтобы не учитывать регистр, выберите Игнорировать регистр.

   - Чтобы игнорировать символы в начале строк при сортировке, укажите первый символ, который следует использовать для сортировки, с помощью счётчика Начинать со столбца.

4. Чтобы выполнить операцию сортировки, нажмите кнопку Упорядочить.

### Модуль «Проверка орфографии»

Модуль Проверка орфографии проверяет орфографию в выбранном тексте. Программу pluma можно настроить на автоматическую проверку орфографии для выбранного языка (либо можно выполнять проверку вручную). Параметр языка и свойства автоматической проверки орфографии применяются для каждого отдельного документа. Чтобы использовать модуль «Проверка орфографии», выполните следующие действия:

1. Выберите пункт меню Сервис Установить язык... для показа диалога Установить язык. Выберите подходящий язык в списке. Нажмите кнопку OK для закрытия диалога Установить язык.

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

   Неизвестные слова показаны другим цветом и подчёркнуты. Щёлкните по такому слову правой кнопкой мыши и выберите в контекстном меню пункт Возможные варианты...:

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

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

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

3. Чтобы проверить орфографию вручную, выберите пункт меню Сервис Проверить орфографию .

   Если орфографических ошибок нет, в диалоге Информация будет показано сообщение об отсутствии слов с ошибками в документе. Нажмите кнопку OK для закрытия диалога Информация.

   Если орфографические ошибки найдены, будет показан диалог Проверка орфографии:

   - Ошибочное слово отображается в верхней части диалога.

   - В текстовом поле Заменить на показано предлагаемое известное слово. Его можно заменить другим известным словом из списка Варианты. Также можно ввести текст непосредственно в текстовое поле Заменить на.

   - Чтобы проверить орфографию текста в текстовом поле Заменить на, нажмите кнопку Проверить слово. Если это известное слово, содержимое списка Варианты будет заменено на текст `(правильное написание)`. Если же слово неизвестно, в списке Варианты появятся новые записи.

   - Чтобы проигнорировать текущее вхождение неизвестного слова, нажмите кнопку Игнорировать. Чтобы проигнорировать все вхождения неизвестного слова, нажмите кнопку Игнорировать все. Неизвестное слово игнорируется только в текущем сеансе pluma.

   - Чтобы заменить текущее вхождение неизвестного слова на текст в текстовом поле Заменить на, нажмите кнопку Изменить. Чтобы заменить все вхождения неизвестного слова на текст в текстовом поле Заменить на, нажмите кнопку Изменить все.

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

   - Чтобы закрыть диалог Проверка орфографии, нажмите кнопку Закрыть.

### Модуль «Список тегов»

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

Чтобы использовать модуль «Список тегов», выполните следующие действия:

1. Выберите пункт меню Вид Боковая панель .

2. По умолчанию на боковой панели показана вкладка со списком открытых документов. Щёлкните по вкладке со значком + в нижней части боковой панели для просмотра вкладки со списком тегов.

3. Выберите подходящую категорию тегов в раскрывающемся списке. Например, HTML — теги.

4. Прокручивайте список для поиска нужного тега.

5. Чтобы вставить тег в позиции курсора в текущем файле, сделайте двойной щелчок по этому тегу в списке. Также можно вставить тег следующим образом:

   - Чтобы вставить тег в текущий файл и переключить фокус с боковой панели на область просмотра, нажмите клавишу Return.

   - Чтобы вставить тег в текущий файл и оставить фокус на окне Модуль «Список тегов», нажмите Shift Return .