Андрей
Балагута

    uj2@mail.ru

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

# Настройка &kate;

## Обзор

&kate; предоставляет несколько возможностей настройки. Наиболее важные из них:

Диалоговое окно настройки

  Главный инструмент, позволяющий настроить &kate;, редактор и дополнительные модули.

Меню Настройка

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

Меню Вид

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

Встроенный эмулятор терминала &konsole; использует общие настройки, заданные в Центре управления. Параметры отображения можно настроить, используя контекстное меню консоли (вызывается щелчком правой кнопки мыши в окне терминала), подменю Настройка.

## Диалоговое окно настройки

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

### Группа &kate;

Эта группа содержит страницы, позволяющие настроить приложение &kate;.

#### Страница Общие

Общие настройки &kate;

Режимы приложения

  Здесь можно выбрать тип интерфейса &kate;: многооконный редактор или редактор в одном окне.

  Многооконный редактор: режим, который установлен по умолчанию; для всех открытых файлов используется одно окно. Чтобы открыть нужный документ, выберите его в списке файлов (который пристыкован слева к главному окну &kate;) или из меню Документ.

  Редактор в одном окне: каждый документ открывается в отдельном окне. Список файлов и селектор файлов расположены в отдельном окне.

  Изменение этого параметра вступит в силу только после перезапуска &kate;.

При запуске

  Эти опции позволяют настроить восстановление сеанса редактирования после нормального завершения &kate; (если приложение восстанавливается менеджером сеанса &kde;, эти опции не играют никакой роли - &kate; попытается восстановить самый недавний сеанс редактирования).

  Открыть последние файлы

    Позволяет восстановить в редакторе файлы, которые были открыты при последнем завершении &kate;. Будут восстановлены закладки и настройки последнего активного редактора: позиция курсора, граница пиктограмм и панель номеров строк.

  Восстанавливать вид окон

    Эта опция позволяет при следующем запуске &kate; восстановить структуру фреймов точно в таком виде, в каком вы ее оставили.

Запускать только один экземпляр приложения

  Если опция включена, вы не сможете запустить более одного экземпляра приложения &kate;. При попытке повторно запустить &kate; уже запущенный экземпляр активизируется и откроет нужный файл (если последний был указан в командной строке). Например, если в Konqueror вы используете &kate; в качестве приложения для просмотра исходного текста веб-страниц и этот флажок включен, все страницы будут открыты в запущенном экземпляре &kate;

Показывать содержимое при изменении размеров окна

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

Синхронизировать Konsole с активным документом

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

Количество файлов в списке недавно редактировавшихся

  Здесь можно указать максимальное число файлов в меню Открыть недавние.

#### Страница Список документов

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

#### Внешние инструменты

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

Внешний инструмент - это фактически команда оболочки с подстановками данных документа.

##### Свойства внешних инструментов

Название

  Текст пункта меню "Внешние инструменты".

Команда

  Команда, которая будет выполнена при выборе пункта меню. Доступны следующие подстановки:

  %URL

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

  %URLS

    Список полных адресов всех открытых файлов (кроме несохранённых) через пробел.

  %directory

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

  %filename

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

  %line

    Номер текущей строки.

  %column

    Позиция курсора в текущей строке.

  %selection

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

  %text

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

Программа

  The main executable i the script. This is mandatory, and is used to test if the command can be run at all. A fully qualified path is allowed in case the executable is not in your `PATH` variable.

Mime-типы

  Разделённый запятыми список mime-типов, для которых команда должна быть доступна.

Сохранить

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

Команда правки

  Вы сможете вызвать этот внешний инструмент из строки команд правки введя `exttool-команда_правки` (т.е. её имя дополняется exttool-).

### Группа Редактирование

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

#### Страница Цвета

Эта страница позволяет изменить цвета фона и выделения. Первоначально &kate; использует цвета, определенные в &kcontrolcenter; на странице Внешний вид и интерфейс Цвета .

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

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

Иначе вам, возможно, придется изменить Стили по умолчанию.

#### Страница Шрифты

Здесь вы можете изменить шрифты. Эти настройки будут также использоваться в &kwrite; и при просмотре текстовых файлов в &konqueror;.

На этой странице расположены две вкладки: одна позволяет выбрать шрифт редактора, вторая - шрифт печати. Щелкните на нужной вкладке и выберите шрифт. По умолчанию используется моноширинный шрифт, определенный в настройках &kde;.

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

#### Страница Отступ

На этой странице можно настроить параметры отступа.

##### Параметры отступа

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

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

Заполнять отступ пробелами

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

Отступы клавишей Backspace

  Если эта опция включена, то при нажатии на клавишу Backspace в пустой (заполненной только пробелами) строке курсор установится в позицию отступа ближайшей непустой строки.

Отступы клавишей Tab

  Позволяет использовать для отступа клавишу Tab. Это будет работать, если в текущей строке до позиции курсора все символы пробельные.

Сохранять лишние пробелы

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

#### Страница Выделение

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

##### Параметры выделения

Не снимать выделение текста

  Если опция включена, ввод текста не будет снимать выделение или удалять выделенный текст.

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

Заменять выделенный фрагмент

  Если параметр включен, любая вставка текста (ввод или вставка из буфера обмена) повлечет удаление выделенного фрагмента и вставку в это место нового текста.

#### Страница Правка

На этой странице можно настроить редактор &kate;.

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

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

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

  Если эта опция включена, &kate; будет вставлять в документ символ разрыва строки, когда длина строки (в символах) превысит величину, указанную в описанном ниже параметре Переносить после.

Переносить после

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

Заменять табуляцию пробелами

  Если эта опция включена, при вставке символа табуляции (Tab) &kate; будет заменять его на пробелы, количество которых определяется параметром Ширина табуляции.

Удалить завершающие пробелы

  Если эта опция включена, &kate; будет удалять концевые пробелы в строке каждый раз, когда курсор будет выходить за пределы этой строки.

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

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

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

Автоскобки

  Если эта опция включена, при вставке левой скобки &kate; будет автоматически добавлять правую скобку справа от курсора. Поддерживаются следующие виды скобок: (, {, [ и <.

Группировать отмену

  Если эта опция включена, &kate; будет группировать похожие операции (например, ввод, удаление, вставка) в одно действие в истории отмены, т.е. все эти операции можно будет отменить всего одной командой отмены.

Показать табуляцию

  Если эта опция включена, &kate; будет отображать маленькую точку в начале каждого символа табуляции.

Умная реакция на Home

  Заставляет &kate; при нажатии клавиши Home (или другой клавиши, ассоциированной с этой функцией) перемещать курсор не на начало строки, а на первый не пробельный символ.

Переносить курсор

  Если эта опция включена, перемещение курсора вправо после достижения конца строки вызовет его перенос на следующую строку (аналогично, при перемещнии курсора влево от начала строки вызовет его перенос на предыдущую строку).

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

#### Страница Клавиатура

Здесь можно настроить быстрые клавиши для внутренних команд редактора &kate;. Сюда включены команды перемещения по документу и выделения текста. Сочетания клавиш, относящиеся к копированию и вставке, можно настроить в диалоговом окне Быстрые клавиши.

Вы можете изменить основную и альтернативную клавишу для команды.

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

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

2. Если вам не нужна клавиша для этой команды, в нижней панели выберите опцию Нет.

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

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

3. Если вы выбрали опцию По выбору, кнопка для ввода клавиши, находящаяся справа на панели, станет доступной. Чтобы установить клавишу, жмите на эту кнопку. Перед вами появится диалоговое окно &kde; Определить клавишу.

4. 1. Выберите, какую клавишу хотите изменить: основную или альтернативную. Основная клавиша не означает, что вы заменяете стандартную клавишу приложения для этого действия. Вместо неё вы назначаете свою клавишу по умолчанию для этого действия.

   2. Нажмите желаемое сочетание клавиш. После этого оно будет отображено в диалоговом окне и вам нужно будет подтвердить свой выбор (т.е. нажать на кнопку OK).

      Если душа просит приключений, можете поиграться с параметром Многоклавишный. Он позволяет вам использовать &Emacs;-подобные сочетания клавиш (первая клавиша выбирает группу, вторая выполняет действие). После нажатия клавиши группы &kde;, вместо того, чтобы просто тихо ожидать, пока вы нажмете клавишу действия, выдаст всплывающее меню в совершенно неожиданном месте. Не волнуйтесь, жмите вторую клавишу или акселератор меню - оба варианта сработают.

#### Страница Типы файлов

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

To remove an existing filtype, select it from the dropdown list and press the Delete button.

To edit an existing filtype, select it from the dropdown list.

##### Свойства типа файла

Название

  Имя, отображаемое в Сервис Тип файла.

Раздел

  A submenu of Tools Filetypes in which to place this filtype. If the section does not allready exist, it will be created for you.

Переменные

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

Расширения файлов

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

Mime-типы

  Разделённый запятыми список mime-типов, к которым должны применяться данные правила.

Приоритет

  Если документ подходит к нескольким типам, будет выбран тип с наибольшим приортитетом.

#### Страница Проверка правописания

Здесь вы можете настроить &kspell; для работы в &kate;.

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

На этой странице можно настроить цвета и выбор типа подсветки.

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

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

Список содержит четыре или пять столбцов:

Контекст

  Отображает имя контекста в соответствии с настройками цвета и шрифта этого контекста.

Жирный

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

Курсив

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

Обычный

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

Выделенный текст

  Этот столбец содержит кнопки выбора цвета выделенного текста. Чтобы изменить цвет, нажмите на кнопку.

Использовать стандартные

  Этот флажок находится на странице Режимы подсветки. Он показывает, является ли текущий стиль стандартным. Если вы измените какое-либо свойство стиля, флажок автоматически будет снят. Чтобы восстановить стандартный стиль, включите флажок.

##### Вкладка Стили по умолчанию

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

##### Вкладка Режимы подсветки

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

При загрузке файла режим подсветки выбирается в зависимости от типа &MIME; и расширения. Чтобы изменить список файлов с выбранным режимом подсветки, отредактируйте текст в строках ввода Расширения файлов и Типы MIME. Вы можете выбрать типы &MIME; из списка, нажав кнопку мастера (слева от строки ввода). На экране отобразится диалоговое окно со всеми возможными типами &MIME;. Выбрав нужные типы и нажав OK, вы увидите, что строки ввода содержат соответствующие названия &MIME; и расширения файлов.

Диалоговое окно выбора типов &MIME; отображает все доступные типы, собранные в иерархическую структуру. Чтобы выбрать нужный тип, щелкните на флажке слева от него.

Вы можете изменять свойства стиля любого контекста, как это было описано выше.

Внизу вкладки, под списком свойств подсветки, вы видите кнопку Загрузка.... Если вы нажмете на эту кнопку, будет произведена попытка соединения с веб-сайтом &kate; и загрузки новых и обновленных режимов синтаксической подсветки.

### Группа Дополнения

В этой группе находятся страницы, относящиеся к дополнительным модулям (плагинам). Кроме настроек, доступных на странице Перечень, некоторые модули предоставляют дополнительные средства настройки; об этом можете прочитать в документации к конкретным модулям.

#### Страница Перечень

Эта страница позволяет загрузить или выгрузить модули и предоставляет минимальную информацию о конкретных модулях.

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

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

Внизу страницы находится небольшое описание выбранного модуля.

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

Kate variables is kateparts implementation of document variables, similar to emacs and vi modelines. In katepart, the lines has the format `kate: VARIABLENAME VALUE; [ VARIABLENAME VALUE; ... ]` the lines can of cause be in a comment, if the file is in a format with comments. Variable names are single words (no whitespace), and anything up to the next semicolon is the value. The semicolon is required.

Пример строки с переменными, включающими расстановку отступов для файлов C++, java или javascript:

    // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;

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

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

### Как переменные обрабатываются в Kate

Чтение конфигурации происходит в следующем порядке:

- глобальная.

- данные восстановления сеанса.

- "Типы файлов".

- Переменные документа.

- Изменённые во время работы параметры.

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

The variables listed here documents &kate; version 2.4. More variables may be added in the future. There are defied 3 types of values for variables, with the following valid expressions:

- BOOL - on|off|true|false|1|0

- INTEGER - любое целое число

- STRING - всё остальное

#### Доступные переменные

    auto-bracketsBOOL

  В(ы)ключить автовставку завершающих скобок.

    auto-center-linesINT

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

    auto-insert-doxygenBOOL

  В(ы)ключить вставку ведущей звёздочки в комментариях doxygen. Работает только с расстановщиком отступов cstyle.

    background-colorSTRING

  Sets the document background color. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    backspace-indentsBOOL

  В(ы)ключить снятие отступов клавишей backspace.

    block-selectionBOOL

  В(ы)ключить блочное выделение.

    bracket-highlight-colorSTRING

  Sets the color for the bracket highlight. The value must be something that can be evaluated to a valid color, for example "#ff0000"

    current-line-colorSTRING

  Sets the color for the current line. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    dynamic-word-wrapBOOL

  В(ы)ключить динамический перенос слов.

    eol | end-of-lineSTRING

  Sets the end of line mode. Valid settings are unix, mac and dos

    encodingSTRING

  Sets the document encoding. The value must be a valid encoding name, like utf-8.

    font-sizeINT

  Sets the point size of the document font.

    fontSTRING

  Sets the font of the document. The value should be a valid font name, for example courier.

    icon-bar-colorSTRING

  Sets the icon bar color. The value must be something that can be evaluated to a valid color, for example `#ff0000`.

    icon-borderBOOL

  В(ы)ключить отображение границ значков.

    folding-markersBOOL

  В(ы)ключить отображение маркеров сворачивания блоков кода.

    indent-modeSTRING

  Set the auto-indentation mode. The options none, normal, cstyle, csands, python, xml are recognized. See the section Using Automatic Indenting for details.

    indent-widthINT

  Sets the indentation width.

    keep-extra-spacesBOOL

  Сохранять ли лишние пробелы при расчёте ширины отступа.

    keep-indent-profileBOOL

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

    line-numbersBOOL

  Отображать номера строк.

    mixed-indentBOOL

  Sets mixed indentation ala Emacs on or off.

    overwrite-modeBOOL

  Включить режим замены.

    persistent-selectionBOOL

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

    remove-trailing-spaceBOOL

  Включить ли очистку концов строк "на лету".

    replace-tabs-saveBOOL

  В(ы)ключить преобразование tab->space при сохранении.

    replace-tabsBOOL

  В(ы)ключить динамическое преобразование tab->space.

    replace-trailing-space-saveBOOL

  Включить очистку концов строк при сохранении.

    schemeSTRING

  Установить цветовую схему.

    selection-colorSTRING

  Установить цвет для выделенного текста, например "#ff0000".

    show-tabsBOOL

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

    smart-homeBOOL

  В(ы)ключить интеллектуальную обработку Home.

    space-indentBOOL

  В(ы)ключить отступы пробелами.

    tab-indentsBOOL

  В(ы)ключить отступы символами табуляции.

    tab-widthINT

  Sets the tab display width.

    undo-stepsINT

  Sets the number of undo steps to remember.

    word-wrap-columnINT

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

    word-wrap-marker-colorSTRING

  Sets the work wrap marker color. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    word-wrapBOOL

  В(ы)ключить жёсткий перенос слов.

    wrap-cursorBOOL

  Включить или выключить перенос курсора.