<chapter id="configuring-kate">
<chapterinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
<othercredit role="translator"
><firstname
>Андрей</firstname
><surname
>Балагута</surname
><affiliation
><address
><email
>uj2@mail.ru</email
></address
></affiliation
><contrib
>Перевод на русский</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Настройка &kate;</title>

<sect1 id="configuring-overview">
<title
>Обзор</title>
<para>
<indexterm>
<primary
>настройка</primary>
<secondary
>параметры</secondary>
<tertiary
>конфигурация</tertiary
></indexterm>
<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> &kate; предоставляет несколько возможностей настройки. Наиболее важные из них: </para>

<variablelist>
<varlistentry>
<term id="configure"
>Диалоговое окно настройки</term>
<listitem
><para
>Главный инструмент, позволяющий настроить &kate;, редактор и дополнительные модули.</para
></listitem>
</varlistentry>
<varlistentry>
<term id="settings"
>Меню <guimenu
>Настройка</guimenu
></term>
<listitem
><para
>Предоставляет доступ к часто изменяемым параметрам. Из этого меню можно открыть диалоговое окно настройки.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Меню <guimenu
>Вид</guimenu
></term>
<listitem
><para
>Содержит команды для разделения текущего фрейма и отображения панелей пиктограмм и номеров строк в активном редакторе.</para
></listitem>
</varlistentry>
</variablelist>

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

</sect1>

<sect1 id="configuring-kate-configdialog">
<title
>Диалоговое окно настройки</title>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="configdialog01.png"/>
</imageobject>
</mediaobject>

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

<sect2 id="config-dialog">
<title
>Группа <quote
>&kate;</quote
></title>
<para
>Эта группа содержит страницы, позволяющие настроить приложение &kate;.</para>

<sect3 id="config-dialog-general">
<title
>Страница <quote
>Общие</quote
></title>
<para
>Общие настройки &kate;</para>

<variablelist>
<varlistentry>
<term
>Режимы приложения</term>
<listitem>
<para
><indexterm
><primary
>MDI</primary
><secondary
>SDI</secondary
></indexterm>
Здесь можно выбрать тип интерфейса &kate;: <quote
>многооконный редактор</quote
> или <quote
>редактор в одном окне</quote
>.</para>
 <para
>Многооконный редактор: режим, который установлен по умолчанию; для всех открытых файлов используется одно окно. Чтобы открыть нужный документ, выберите его в списке файлов (который пристыкован слева к главному окну &kate;) или из меню <guimenu
>Документ</guimenu
>.</para>
<para
>Редактор в одном окне: каждый документ открывается в отдельном окне. Список файлов и селектор файлов расположены в отдельном окне.</para>
 <para
>Изменение этого параметра вступит в силу только после перезапуска &kate;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>При запуске</term>
<listitem
><para
>Эти опции позволяют настроить восстановление сеанса редактирования после нормального завершения &kate; (если приложение восстанавливается менеджером сеанса &kde;, эти опции не играют никакой роли - &kate; попытается восстановить самый недавний сеанс редактирования).</para>

<variablelist>
<varlistentry>
<term>
<anchor id="config-dialog-general-reopen-files"/>
<guibutton
>Открыть последние файлы</guibutton
></term>
<listitem
><para
>Позволяет восстановить в редакторе файлы, которые были открыты при последнем завершении &kate;. Будут восстановлены закладки и настройки последнего активного редактора: позиция курсора, граница пиктограмм и панель номеров строк.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Восстанавливать вид окон</guibutton
></term>
<listitem
><para
>Эта опция позволяет при следующем запуске &kate; восстановить структуру фреймов точно в таком виде, в каком вы ее оставили.</para
></listitem>
</varlistentry>
</variablelist>

</listitem>

</varlistentry>

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

<varlistentry>
<term
><guibutton
>Показывать содержимое при изменении размеров окна</guibutton
></term
> <listitem
><para
>Если эта опция включена, окна будут полностью перерисовываться во время изменения изменении их размеров. Если выключена, будет отображаться только рамка, показывающая новый размер окна.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-general-sync-konsole"/>
<guibutton
>Синхронизировать Konsole с активным документом</guibutton
></term>
<listitem
><para
>Если этот флажок включен, встроенный терминал &konsole; будет менять свой текущий каталог каждый раз при смене активного документа. Если выключен, вам придётся перемещаться по дереву каталогов вручную. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Количество файлов в списке недавно редактировавшихся</guibutton
></term>
<listitem
><para
>Здесь можно указать максимальное число файлов в меню <guimenu
>Открыть недавние</guimenu
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="config-dialog-documentlist">
<title
>Страница <quote
>Список документов</quote
></title>
<para
>Позволяет вам включить визуализацию истории перехода по документам (через оттенки фона соответствующих пунктов списка), а также настроить используемые для этого цвета. Для подробностей, обратитесь к разделу <link linkend="kate-mdi-tools-file-list"
>Список документов</link
>.</para>
</sect3>

<sect3 id="config-dialog-externaltools">
<title
>Внешние инструменты</title>

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

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

<variablelist>
<title
>Свойства внешних инструментов</title>
<varlistentry>
<term
>Название</term>
<listitem
><para
>Текст пункта меню "Внешние инструменты".</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Команда</term>
<listitem
><para
>Команда, которая будет выполнена при выборе пункта меню. Доступны следующие подстановки: <variablelist>
<varlistentry>
<term
>%URL</term>
<listitem
><para
>Полный адрес (с протоколом) текущего документа, если новый документ ещё не был сохранён - пустая строка.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%URLS</term>
<listitem
><para
>Список полных адресов всех открытых файлов (кроме несохранённых) через пробел.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%directory</term>
<listitem
><para
>Папка текущего документа или пустая строка если последний ещё не сохранён на диске.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%filename</term>
<listitem
><para
>Имя текущего файла без пути или пустая строка если последний ещё не сохранён на диске.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%line</term>
<listitem
><para
>Номер текущей строки.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%column</term>
<listitem
><para
>Позиция курсора в текущей строке.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%selection</term>
<listitem
><para
>Выделенный текст или пустая строка если такового нет.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%text</term>
<listitem
><para
>Весь текст документа. Обратите внимание, что его длина может превысить максимально допустимую командной строки.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Программа</term>
<listitem
><para
>Если программа не находится в папке, присутствующей в переменной окружения <envar
>PATH</envar
>, следует указать полный к ней путь.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Mime-типы</term>
<listitem
><para
>Разделённый запятыми список mime-типов, для которых команда должна быть доступна.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Сохранить</term>
<listitem
><para
>Перед запуском сценария файлы должны быть сохранены.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Команда правки</term>
<listitem
><para
>Вы сможете вызвать этот внешний инструмент из <link linkend="advanced-editing-tools-commandline"
>строки команд правки</link
> введя <command
>exttool-<replaceable
>команда_правки</replaceable
></command
> (т.е. её имя дополняется <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="config-dialog-editor">
<title
>Группа <quote
>Редактирование</quote
></title>
<para
>Группа содержит параметры, относящиеся к компоненту редактора. Большинство из них применяются только для обычных текстовых файлов - <link linkend="config-dialog-editor-filetypes"
>параметры для типов файлов</link
>, <link linkend="config-variables"
>переменные документа</link
> имеют больший приоритет, параметры можно также изменить динамически для текущего документа с помощью команд правки (F7).</para>

<sect3 id="config-dialog-editor-colors">
<title
>Страница <guilabel
>Цвета</guilabel
></title
> <para
>Эта страница позволяет изменить цвета фона и выделения. Первоначально &kate; использует цвета, определенные в &kcontrolcenter; на странице <menuchoice
><guimenu
>Внешний вид и интерфейс</guimenu
><guimenuitem
>Цвета</guimenuitem
> </menuchoice
>.</para>

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

<note
><para
>Выбор цвета фона может сделать синтаксическую подсветку нечитаемой. Используйте светлый тон для цвета фона и темный для цвета выделения. </para>
<para
>Иначе вам, возможно, придется изменить <link linkend="config-dialog-editor-highlight-default-styles"
>Стили по умолчанию</link
>.</para>
</note>
</sect3>

<sect3 id="config-dialog-editor-fonts">
<title
>Страница <quote
>Шрифты</quote
></title
> <!-- FIXME LINKS //-->

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

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

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

<sect3 id="config-dialog-editor-indent">
<title
>Страница <quote
>Отступ</quote
></title>
<para
>На этой странице можно настроить параметры отступа.</para>

<variablelist>
<title
>Параметры отступа</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-auto-indent"/>
<guibutton
>Автоматический отступ</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, при переходе на новую строку будет применен отступ предыдущей строки. Если предыдущая строка пустая, используется ближайшая непустая строка выше текущей.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-indent-with-spaces"/>
<guibutton
>Заполнять отступ пробелами</guibutton>
</term>
<listitem>
<para
>Если флажок включен, отступ будет заполняться пробелами, иначе - символами табуляции.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-backspace-key-indents"/>
<guibutton
>Отступы клавишей Backspace</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, то при нажатии на клавишу <keycap
>Backspace</keycap
> в пустой (заполненной только пробелами) строке курсор установится в позицию отступа ближайшей непустой строки.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-tab-key-indents"/>
<guibutton
>Отступы клавишей Tab</guibutton>
</term>
<listitem>
<para
>Позволяет использовать для отступа клавишу <keycap
>Tab</keycap
>. Это будет работать, если в текущей строке до позиции курсора все символы пробельные.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-keep-extra-spaces"/>
<guibutton
>Сохранять лишние пробелы</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, то после вставки отступа все пробелы, которые находятся за курсором, будут оставлены, иначе они будут удалены.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-select">
<title
>Страница <quote
>Выделение</quote
></title>

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

<variablelist>
<title
>Параметры выделения</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-persistent-selections"/>
<guibutton
>Не снимать выделение текста</guibutton>
</term>
<listitem>
<para
>Если опция включена, ввод текста не будет снимать выделение или удалять выделенный текст.</para>
<note
><para
>Этот параметр частично конфликтует с параметром <guilabel
>Заменять выделенный фрагмент</guilabel
>. Если оба они включены, вставка текста или нажатие любой другой клавиши кроме клавиш со стрелками будет заменять выделенный текст на новый.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-overwrite-selections"/>
<guibutton
>Заменять выделенный фрагмент</guibutton>
</term>
<listitem>
<para
>Если параметр включен, любая вставка текста (ввод или вставка из буфера обмена) повлечет удаление выделенного фрагмента и вставку в это место нового текста.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-edit">
<title
>Страница <quote
>Правка</quote
></title>
<para
>На этой странице можно настроить редактор &kate;.</para>

<variablelist>
<title
>Параметры редактора</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-word-wrap"/>
<guibutton
>Перенос строк</guibutton>
</term>
<listitem>
<para
>Перенос строк используется для динамического форматирования текста путем разрыва длинных строк. Разрывы сохраняются в документе, в отличие от динамического переноса строк, который служит лишь для удобочитаемости документа и не сохраняется.</para>
<para
>Если эта опция включена, &kate; будет вставлять в документ символ <link linkend="document-end-of-line"
>разрыва строки</link
>, когда длина строки (в символах) превысит величину, указанную в описанном ниже параметре <link linkend="config-dialog-editor-edit-wrap-words-at"
>Переносить после</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-words-at"/>
<guibutton
>Переносить после</guibutton>
</term>
<listitem>
<para
>При включенной опции <link linkend="config-dialog-editor-edit-word-wrap"
>Перенос строк</link
> этот параметр определяет максимальную длину строки.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-replace-tabs-with-spaces"/>
<guibutton
>Заменять табуляцию пробелами</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, при вставке символа табуляции (<keycap
>Tab</keycap
>) &kate; будет заменять его на пробелы, количество которых определяется параметром <link linkend="config-dialog-editor-edit-tab-indent-width"
>Ширина табуляции</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-remove-trailing-spaces"/>
<guibutton
>Удалить завершающие пробелы</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, &kate; будет удалять концевые пробелы в строке каждый раз, когда курсор будет выходить за пределы этой строки.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-tab-indent-width"/>
<guibutton
>Ширина табуляции</guibutton>
</term>
<listitem>
<para
>Позволяет установить количество пробелов, которыми будет заменяться символ табуляции. Также при включенной опции <link linkend="config-dialog-editor-indent-auto-indent"
>Автоматический отступ</link
> определяет ширину отступа.</para>
<para
>В зависимости от настроек <link linkend="config-dialog-editor-indent"
>отступа</link
>, последний может быть вызван нажатием клавиш <keycap
>Tab</keycap
>, <keycap
>Backspace</keycap
> или выбором пункта меню <link linkend="edit-indent"
><guimenu
>Правка</guimenu
> <guimenuitem
>Отступ</guimenuitem
></link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-auto-brackets"/>
<guibutton
>Автоскобки</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, при вставке левой скобки &kate; будет автоматически добавлять правую скобку справа от курсора. Поддерживаются следующие виды скобок: <keycap
>(</keycap
>, <keycap
>{</keycap
>, <keycap
>[</keycap
> и <keycap
>&lt;</keycap
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-group-undos"/>
<guibutton
>Группировать отмену</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, &kate; будет группировать похожие операции (например, ввод, удаление, вставка) в одно действие в истории отмены, т.е. все эти операции можно будет отменить всего одной командой отмены.</para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-show-tabs"/>
<guibutton
>Показать табуляцию</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, &kate; будет отображать маленькую точку в начале каждого символа табуляции.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-smart-home"/>
<guibutton
>Умная реакция на Home</guibutton>
</term>
<listitem>
<para
>Заставляет &kate; при нажатии клавиши <keycap
>Home</keycap
> (или другой клавиши, ассоциированной с этой функцией) перемещать курсор не на начало строки, а на первый не пробельный символ.</para>
</listitem>
</varlistentry>

<!-- NOTE This option has gone (anders)
<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-page-up-down-moves-cursor"/>
<guibutton
>Page Up/Down moves cursor</guibutton>
</term>
<listitem>
<para
>If enabled, the cursor will be moved to the first/last visible
line when <keycap
>Page Up</keycap
>/<keycap
>Page Down</keycap
> (or
other key assigned to those functions) is pressed, rather than being
kept at its relative position.</para>
</listitem>
</varlistentry>
-->
<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-cursor"/>
<guibutton
>Переносить курсор</guibutton>
</term>
<listitem>
<para
>Если эта опция включена, перемещение курсора вправо после достижения конца строки вызовет его перенос на следующую строку (аналогично, при перемещнии курсора влево от начала строки вызовет его перенос на предыдущую строку).</para>
<para
>Если же эта опция выключена, курсор нельзя будет переместить левее начала строки (так, чтобы он переместился на конец предыдущей строки), но зато его можно неограниченно перемещать вправо за границу строки. При этом, если будет вставлен текст, все пространство между концом строки и этим текстом будет заполнено пробелами. Иногда это бывает очень полезно, в особенности для программистов.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-keyboard">
<title
>Страница <quote
>Клавиатура</quote
></title>

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

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

<procedure>
<title
>Чтобы сменить сочетание клавиш, проделайте следующее:</title>
<step>
<para
>Выберите команду, для которой вы хотите настроить быструю клавишу.</para>
</step>
<step>
<para
>Если вам не нужна клавиша для этой команды, в нижней панели выберите опцию <guibutton
>Нет</guibutton
>.</para>
<para
>Чтобы установить стандартное для этой команды сочетание клавиш, выберите опцию <guibutton
>По умолчанию</guibutton
>.</para>
<para
>Чтобы установить другое или добавить альтернативное сочетание клавиш, выберите опцию <guibutton
>По выбору</guibutton
>.</para>
</step>
<step>
<para
>Если вы выбрали опцию <guibutton
>По выбору</guibutton
>, кнопка для ввода клавиши, находящаяся справа на панели, станет доступной. Чтобы установить клавишу, жмите на эту кнопку. Перед вами появится диалоговое окно &kde; <quote
>Определить клавишу</quote
>.</para>
</step>
<step>
<procedure>
<step>
<para
>Выберите, какую клавишу хотите изменить: основную или альтернативную. <guilabel
>Основная</guilabel
> клавиша не означает, что вы заменяете стандартную клавишу приложения для этого действия. Вместо неё вы назначаете свою клавишу по умолчанию для этого действия.</para>
</step>
<step>
<para
>Нажмите желаемое сочетание клавиш. После этого оно будет отображено в диалоговом окне и вам нужно будет подтвердить свой выбор (т.е. нажать на кнопку <guibutton
>OK</guibutton
>). </para>

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

<sect3 id="config-dialog-editor-filetypes">
<title
>Страница <quote
>Типы файлов</quote
></title>

<para
>Здесь вы можете указать параметры редактора для разных типов файлов. При открытии документа, его тип определяется по расширению, mime-типу, или <link linkend="config-variables"
>переменным документа</link
>.</para>

 

 

 

<variablelist>

<title
>Свойства типа файла</title>

<varlistentry>
<term
>Название</term>
<listitem
><para
>Имя, отображаемое в <menuchoice
><guisubmenu
>Сервис</guisubmenu
><guisubmenu
>Тип файла</guisubmenu
></menuchoice
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Раздел</term>
<listitem
><para
>Подменю <menuchoice
><guisubmenu
>Сервис</guisubmenu
><guisubmenu
>Тип файла</guisubmenu
></menuchoice
>, в котором будет расположен новый тип. Если раздел не существует, он будет создан.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Переменные</term>
<listitem
><para
>Здесь можно задать значения параметров, перекрывающие стандартные. <link linkend="config-variables"
>Здесь</link
> можно найти список доступных переменных и пояснения к ним.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Расширения файлов</term>
<listitem
><para
>Разделённый запятыми список масок файлов, к которым должны применяться данные правила.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Mime-типы</term>
<listitem
><para
>Разделённый запятыми список mime-типов, к которым должны применяться данные правила.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Приоритет</term>
<listitem
><para
>Если документ подходит к нескольким типам, будет выбран тип с наибольшим приортитетом.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-spelling">
<title
>Страница <quote
>Проверка правописания</quote
></title>
<para
>Здесь вы можете настроить &kspell; для работы в &kate;.</para>
</sect3>

<sect3 id="config-dialog-editor-hl">
<title
>Страница <quote
>Подсветка</quote
></title>

<para
>На этой странице можно настроить цвета и выбор типа подсветки.</para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configdialog02.png"/></imageobject>
</mediaobject>
</para>
<para
>Чтобы вникнуть поглубже в систему подсветки, читайте раздел ??</para>

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

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

<variablelist>

<varlistentry>
<term
>Контекст</term>
<listitem
><para
>Отображает имя контекста в соответствии с настройками цвета и шрифта этого контекста.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Жирный</term>
<listitem
><para
>Состояние этого флажка определяет, нужно ли при отображении использовать полужирный шрифт.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Курсив</term>
<listitem
><para
>Состояние этого флажка определяет, нужно ли при отображении использовать наклонный шрифт.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Обычный</term>
<listitem
><para
>Этот столбец содержит кнопки выбора цвета, используемого для обычного отображения (когда текст не выделен). Чтобы изменить цвет, нажмите на кнопку.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Выделенный текст</term>
<listitem
><para
>Этот столбец содержит кнопки выбора цвета выделенного текста. Чтобы изменить цвет, нажмите на кнопку.</para
></listitem>
</varlistentry>

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

</variablelist>

<sect4 id="config-dialog-editor-highlight-default-styles">
<title
>Вкладка <quote
>Стили по умолчанию</quote
></title>
<para
>Чтобы настроить любой из стандартный стилей, просто измените нужное свойство.</para>
</sect4>

<sect4 id="config-dialog-editor-highlight-highlight-modes">
<title
>Вкладка <quote
>Режимы подсветки</quote
></title>

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

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="mimetypechooser.png"/></imageobject>
</mediaobject>
<para
>Диалоговое окно выбора типов &MIME; отображает все доступные типы, собранные в иерархическую структуру. Чтобы выбрать нужный тип, щелкните на флажке слева от него. </para>

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

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

</sect4>

</sect3>

</sect2>

<sect2 id="config-dialog-plugins">
<title
>Группа <quote
>Дополнения</quote
></title>

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

<sect3 id="config-dialog-plugins-manager">
<title
>Страница <quote
>Перечень</quote
></title>

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

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

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

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

</sect2>

</sect1>

<sect1 id="config-variables">

<title
>Переменные документа</title>

<para
>Переменные документа - аналог "modeline" в emacs и vi. Формат:<userinput
>kate: ИМЯ_ПЕРЕМЕННОЙ ЗНАЧЕНИЕ; [ ИМЯ_ПЕРЕМЕННОЙ ЗНАЧЕНИЕ; ... ]</userinput
>, такие строки, конечно, могут быть расположены в комментариях (если такое понятие присутствует в формате файла).</para>

<para
>Пример строки с переменными, включающими расстановку отступов для файлов C++, java или javascript: <programlisting
>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
</para>

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

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

<sect2 id="config-variables-howto">
<title
>Как переменные обрабатываются в Kate</title>

<para
>Чтение конфигурации происходит в следующем порядке: <itemizedlist
> <listitem
><para
>глобальная.</para
></listitem
> <listitem
><para
>данные восстановления сеанса.</para
></listitem
> <listitem
><para
>"Типы файлов".</para
></listitem
> <listitem
><para
>Переменные документа.</para
></listitem
> <listitem
><para
>Изменённые во время работы параметры.</para
></listitem
> </itemizedlist
> При сохранении документа, все переменные в нём перечитываются, и перекрывают изменения (из меню или командами правки), сделанные перед этим во время работы.</para>

 

<para
>Приводящиеся ниже переменные соответствуют &kate; 2.4. Возможны 3 типа значений переменных: <itemizedlist>
<listitem
><para
>BOOL - on|off|true|false|1|0</para
></listitem>
<listitem
><para
>INTEGER - любое целое число</para
></listitem>
<listitem
><para
>STRING - всё остальное</para
></listitem>
</itemizedlist>
</para>

<variablelist>
<title
>Доступные переменные</title>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-brackets</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить автовставку завершающих скобок.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-center-lines</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить количество строк автоцентрирования.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-insert-doxygen</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить вставку ведущей звёздочки в комментариях doxygen. Работает только с расстановщиком отступов cstyle. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>background-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить фоновый цвет документа, например "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>backspace-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить снятие отступов клавишей backspace.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>block-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить блочное выделение.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>bracket-highlight-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить цвет для подсветки скобок, например "#ff0000" </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>current-line-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить цвет для активной строки,  например "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>dynamic-word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить динамический перенос слов.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>eol | end-of-line</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить режим конца строк. Возможные значение -  <quote
>unix</quote
>, <quote
>mac</quote
> и <quote
>dos</quote
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>encoding</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить кодировку документа, например <quote
>utf-8</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font-size</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить размер шрифта.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить шрифт для отображения текста документа, например <quote
>courier</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-bar-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить цвет панели значков, например <literal
>#ff0000</literal
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-border</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить отображение границ значков.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>folding-markers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить отображение маркеров сворачивания блоков кода.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-mode</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить режим расстановки перемносов. Возможные значения -  <quote
>none</quote
>, <quote
>normal</quote
>, <quote
>cstyle</quote
>, <quote
>csands</quote
>, <quote
>python</quote
>, <quote
>xml</quote
>. Для подробностей, см раздел <xref linkend="kate-part-autoindent"/>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Устанавливает ширину отступов.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-extra-spaces</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Сохранять ли лишние пробелы при расчёте ширины отступа.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-indent-profile</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Не сбрасывать отступ если хотя бы одна строка выше не имеет отступа.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>line-numbers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Отображать номера строк.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>mixed-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить смешанные переносы, как в Emacs.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>overwrite-mode</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Включить режим замены.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>persistent-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Отключить ли снятие выделения текста при переводе курсора.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>remove-trailing-space</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Включить ли очистку концов строк "на лету".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить преобразование tab-&gt;space при сохранении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить динамическое преобразование tab-&gt;space.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-trailing-space-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Включить очистку концов строк при сохранении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>scheme</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить цветовую схему.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>selection-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить цвет для выделенного текста, например "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>show-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить визуальное представление символа табуляции.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>smart-home</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить интеллектуальную обработку Home.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>space-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить отступы пробелами.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить отступы символами табуляции.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить ширину представления символов табуляции.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>undo-steps</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить количество действий, которые можно отменить</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-column</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить максимальную длину строк в случае, если включён автоматический перенос.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-marker-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Установить цвет маркера переноса, например "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>В(ы)ключить жёсткий перенос слов.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wrap-cursor</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Включить или выключить перенос курсора.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>
