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

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

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

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

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

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

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

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

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

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

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

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

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

    Имя

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

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

    Введите текст самого фрагмента в текстовое поле Редактировать фрагмент. Смотрите также Раздел 10.10.4 ― Подстановка во фрагментах.

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

    Tab Trigger

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

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

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

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

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

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

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

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

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

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

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

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

Закладки

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

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

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

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

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

Зеркала

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

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

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

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

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

$GEDIT_SELECTED_TEXT

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

$GEDIT_FILENAME

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

$GEDIT_BASENAME

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

$GEDIT_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.