&Anders.Lund; &Anders.Lund.mail;
Андрей
Балагута

    uj2@mail.ru

Перевод на русский
Николай
Шафоростов

    shafff@ukr.net

Перевод на русский

# Дополнительные возможности редактирования

## Комментирование

Команды "Комментировать" и "Раскомментировать", которые доступны из меню Сервис, позволяют добавить или убрать маркеры комментариев для выделенного блока текста (или для текущей строки, если текст не выделен), при условии, что комментарии поддерживаются форматом редактируемого текста.

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

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

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

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

Чтобы закомментировать выделенный текст (или активную строку), выберите пункт менюСервис Закомментировать или нажмите соответствующее сочетание клавиш (по умолчанию &Ctrl;D).

Чтобы удалить маркеры комментариев, выберите пункт меню Сервис Раскомментировать или нажмите соответствующее сочетание клавиш ( по умолчанию &Ctrl;&Shift;D).

## Командная строка компонента редактора

Модуль Kate имеет встроенную командную строку, позволяющую производить различные действия, оставляя интерфейс минималистским. Она представляет из себя поле ввода внизу области редактора. Для получения к ней доступа, выберите пункт меню Вид Переключиться в командную строку или нажмите F7 (по умолчанию). Команды, доступные из неё, описаны ниже, кроме того, модули могут предоставлять свои дополнительные команды.

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

Вы всегда можете получить справку с помощью команды `help`. Для получение списка всех доступных команд, введите `help list`, для просмотра справки по определённой команде - `help команда`.

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

### Стандартные команды

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

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

##### Типы аргументов

BOOLEAN

  Используется для команд включения/выключения. Допустимые значения - `on`, `off`, `true`, `false`, `1` или `0`

INTEGER

  Целое число

STRING

  Строка

    set-tab-widthINTEGER width

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

    set-indent-widthINTEGER width

  Устанавливает ширину отступа. Только при создании отступов пробелами.

    set-word-wrap-columnINTEGER width

  Устанавливает максимальную длину строк в случае, если включён автоматический перенос.

    set-icon-borderenable

  Устанавливать видимость рамок пиктограмм

    set-folding-markersBOOLEAN enable

  Устанавливать видимость маркеров сворачивания блоков кода.

    set-line-numbersBOOLEAN enable

  Устанавливать видимость нумерации строк

    set-replace-tabsBOOLEAN enable

  Заменять при вводе символы табуляции на пробелы.

    set-remove-trailing-spaceBOOLEAN enable

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

    set-show-tabsBOOLEAN enable

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

    set-indent-spacesBOOLEAN enable

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

    set-mixed-indentBOOLEAN enable

  Использовать для отступов как символы табуляции, так и пробелы. Это реализуется путём замены пробелов в количестве, кратном ширине символа табуляциями, на последние.

  Эта команда также включить расстановку отступов пробелами, и установит ширину отступов, если она не указана, в половину значения `tab-width` (для текущего документа на время выполнения).

    set-word-wrapBOOLEAN enable

  Динамический перенос слов

    set-replace-tabs-saveBOOLEAN enable

  Заменять символы табуляции на пробелы при сохранении.

    set-remove-trailing-space-saveBOOLEAN enable

  Удалить пробелы в конце строк при сохранении.

    set-indent-modename

  Выбрать режим расстановки отступов. Параметр `name` может иметь следующие значения: 'cstyle', 'csands', 'xml', 'python', 'varindent' и 'none'. При других значениях используется 'none'.

    set-highlighthighlight

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

#### Команды редактирования

Команды, которые непосредственно изменяют текущий документ.

    indent

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

    unindent

  Снять отступы с выделенных строк или с текущей.

    cleanindent

  Очистить отступы в выделенных строках или в текущей в соответствии с параметрами расстановки отступов для текущего документа.

    comment

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

    uncomment

  Удалить маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла.

    kill-line

  Удалить текущую строку.

    replacepatternreplacement

  Заменить текст, совпадающий с `pattern` на `replacement`. Для включения пробелов в `pattern`, нужно заключить в кавычки и `pattern` и `replacement`, в двойные или одинарные. Если аргументы не заключены в кавычки, первое слово будет принято за `pattern`, а остальное - за `replacement`. Если `replacement` не задать, вхождения текста будут удалены.

  Для настройки параметров поиска, нужно указать соответствующие флаги после двоеточия (`replace:options pattern replacement`):

  `b`

    Производить поиск в обратном направлении.

  `c`

    Искать с позиции курсора.

  `e`

    Производить поиск только по выделенному тексту.

  `r`

    Аргумент `pattern` - регулярное выражение. Вы можете использовать `\N` в `replacement` для получения N-ной подстроки найденного текста.

  `s`

    С учётом регистра.

  `p`

    Подтверждать каждую замену.

  `w`

    Только целые слова.

    dateformat

  Вставить строку с датой/временем в указанном формате (задаётся параметром `format`), или в yyyy-MM-dd hh:mm:ss, если параметр упущен. Доступны следующие подстановки:

  `d` | Номер дня в месяце без ведущего нуля (1-31).
  `dd` | Номер дня в месяце с ведущим нулём (01-31).
  `ddd` | Сокращённое название дня недели ('Пн'..''Вс, 'Mon'..'Sun').
  `dddd` | Полное названия дня недели ('Понедельник'..'Воскресенье', 'Monday'..'Sunday').
  `M` | Номер месяца без ведущего нуля (1-12).
  `MM` | Номер месяца с ведущим нулём (01-12).
  `MMM` | Сокращённое название месяца ('Янв'..'Дек', 'Jan'..'Dec').
  `yy` | Год двумя цифрами (00-99).
  `yyyy` | Год четырьмя цифрами (1752-8000).
  `h` | Номер часа без ведущего нуля (0..23 или 1..12, в зависимости от настроек).
  `hh` | Номер часа с ведущим нулём (00..23 or 01..12, в зависимости от настроек).
  `m` | Номер минуты без ведущего нуля (0..59).
  `mm` | Номер минуты с ведущим нулём (00..59).
  `s` | Секунда без ведущего нуля (0..59).
  `ss` | Секунда с ведущим нулём (00..59).
  `z` | Миллисекунда без ведущих нулей (0..999).
  `zzz` | Миллисекунда с ведущими нулями (000..999).
  `AP` | Использовать 12-часовый формат часов. AP будет заменено на "AM" или "PM".
  `ap` | Использовать 12-часовый формат часов. ap будет заменено на "am" или "pm".

    charidentifier

  Эта команда позволяет вставить символ по его числовому идентификатору в десятичной, восьмеричной или шестнадцатеричной системах счисления. Чтобы использовать её, откройте диалоговое окно "Команда правки" и наберите `char: [number]` в строке ввода, после чего нажмите кнопку OK.

  ##### Примеры использования команды `char`

  Введите: `char:234`

  Получите: `ê`

  Введите: `char:0x1234`

  Получите: `ሴ`

`s///[ig]` `%s///[ig]`

  "Типичный пользователь" при виде этих команд обязательно вздрогнет и начнёт искать на клавиатуре кнопку "Windows". В самом деле, кому придёт в голову искать текст подобным образом? Но вы же не "типичный", не так ли? Поэтому попробуем разобраться в этих двух sed-подобных командах. Первая выполняет поиск/замену в текущей строке, вторая -- во всём файле (`%s///`).

  Вкратце, команды производят поиск текста, заданного маской поиска -- регулярным выражением (regexp) между первой и второй наклонной чертой, и, при нахождении, выполняет замену выражением, которое задано между второй и третьей чертой. Круглые скобки в маске поиска позволяют задать подстроки в найденном тексте, на которые можно потом ссылаться в выражении замены. Обратная ссылка -- это регулярное выражение, которое при совпадении заменяется на фактический текст и может быть использовано в шаблоне замены. Для этого, в нужном месте поставьте обратную черту, а за ней номер подстроки по порядку (`\1` -- для первой пары скобок, `\2` -- для второй, и т. д.).

  Чтобы искать сами скобки `(` или `)`, нужно предварить их обратной чертой: `\(\)`.

  Если в самом конце указать `i`, поиск будет проводиться с учётом регистра, а если `g` - будут заменены все вхождения текста, совпадающего с регулярным выражением, иначе - только первое.

  ##### Замена текста в текущей строке

  Будучи противником принципа "разделяй и властвуй", вы решили откомпилировать свою программу. Но компилятор начал на вас ругаться: класс `myClass`, упомянутый в строке 3902, не определён.

  "Чёрт!", - думаете вы, -- "да это же мой класс `MyClass`". Вы добираетесь до строки 3902 и, вместо того, чтобы пытаться искать слово в этой длинной строке (а кто сейчас укладывает каждую строчку кода в 60 символов?), вы запускаете диалоговое окно "Команда правки", вводите `s/myclass/MyClass/i`, жмёте OK, сохраняете и компилируйте -- успешно и без ошибок.

  ##### Замена текста во всём файле

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

  Вызовите командную строку и введите следующий текст: `%s/госпожа Иванова/госпожа Петрова/` -- и ваша работа сделана.

  ##### Более сложный пример

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

  Допустим, у вас набрана такая строка:

      void MyClass::DoStringOps( String      &foo, String &bar String *p, int  &a, int &b )

  Теперь вы думаете, что это недостаточно "красивый" код, и решаете, что вам нужно использовать ключевое слово `const` с параметрами, передаваемыми по ссылке (теми, перед которыми стоит амперсанд). Вы также хотите свернуть все пробелы, чтобы между каждым словом был всего один пробел.

  Запустите диалоговое окно "Команда правки" и наберите: `s/\s+(\w+)\s+(&)/ const \1 \2/g`, и не забудьте нажать кнопку OK -- иначе ничего не выйдет. Символ `g` в конце команды указывает компилятору "пересчитывать" регулярное выражение обратной ссылки каждый раз, когда встречаются совпадения.

  Вывод: `void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )`

  Миссия завершена! Ну, и что же произошло? Мы искали некоторое количество пробелов (`\s+`), за которыми идут несколько латинских символов (`\w+`), следом за ними опять несколько пробелов (`\s+`), после которых стоит амперсанд, и по ходу дела сохраняли эти алфавитные символы и амперсанд для использования их в операции замены. После этого мы заменили совпадающие части строки следующей последовательностью: один пробел, за которым идёт спецификатор const, за ним ещё один пробел, после которого наши сохранённые символы (`\1`), ещё один пробел и сохранённый амперсанд (`\2`).

  В одном случае латинские символы составили слово String, в другом -- слово int, т.е. символьный класс `\w` с последующим знаком `+` определяет символьный набор произвольной длины.

#### Команды навигации

    gotoINT line

  Перейти к указанной строке.

    findpattern

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

  Параметры поиска можно задавать добавлением двоеточия и "флагов" после её имени (`find:options pattern`). Флаги - набор из следующих букв:

  `b`

    Производить поиск в обратном направлении.

  `c`

    Искать с позиции курсора.

  `e`

    Производить поиск только по выделенному тексту.

  `r`

    Аргумент `pattern` - регулярное выражение. Вы можете использовать `\N` в `replacement` для получения N-ной подстроки найденного текста.

  `s`

    С учётом регистра.

  `w`

    Только целые слова.

    ifindpattern

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

  `b`

    Производить поиск в обратном направлении.

  `r`

    Поиск по регулярному выражению.

  `s`

    С учётом регистра.

  `c`

    Искать с позиции курсора.