diff options
Diffstat (limited to 'tde-i18n-ru/docs/kdebase/kate/configuring.docbook')
| -rw-r--r-- | tde-i18n-ru/docs/kdebase/kate/configuring.docbook | 2600 |
1 files changed, 2600 insertions, 0 deletions
diff --git a/tde-i18n-ru/docs/kdebase/kate/configuring.docbook b/tde-i18n-ru/docs/kdebase/kate/configuring.docbook new file mode 100644 index 00000000000..01362187209 --- /dev/null +++ b/tde-i18n-ru/docs/kdebase/kate/configuring.docbook @@ -0,0 +1,2600 @@ +<chapter id="configuring-kate"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Андрей</firstname +><surname +>Балагута</surname +><affiliation +><address +><email +>uj2@mail.ru</email +></address +></affiliation +><contrib +>Перевод на русский</contrib +></othercredit +><othercredit role="translator" +><firstname +>Алексей</firstname +><surname +>Опарин</surname +><affiliation +><address +><email +>opaleksej@yandex.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 +>Поведение встроенного терминала определяется его настройкой в Центре управления KDE, и может быть изменено через контекстное меню или меню <guimenuitem +>Настройка</guimenuitem +>.</para> + +</sect1> + +<sect1 id="configuring-kate-configdialog"> +<title +>Основной диалог настройки</title> + +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="configdialog01.png"/> +</imageobject> +</mediaobject> + +<para +>В диалоге настройки слева отображаются разделы, организованные в древовидную структуру, а справа - страница настройки, соответствующая выбранному разделу.</para> + +<para +>Параметры настройки делятся на две основные группы <itemizedlist> +<listitem +><para +><link linkend="config-dialog" +>Настройка программы</link> +</para +></listitem> +<listitem +><para +><link linkend="config-dialog-editor" +>Настройка компонентов редактора</link +></para +></listitem> + +</itemizedlist> + +</para> + +</sect1> + +<sect1 id="config-dialog"> +<title +>Настройка программы &kate;</title> +<para +>Эта группа содержит страницы общей настройки программы &kate;</para> + +<sect2 id="config-dialog-general"> +<title +>Страница <quote +>Общие настройки</quote +></title> +<para +>Здесь можно настроить несколько основных параметров &kate;</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-general-show-full-path"/> +<guilabel +>Показывать полный путь в заголовке окна</guilabel +></term> +<listitem +><para +>Если флажок установлен, в заголовке окна &kate; будет отображать не только имя файла, но и полный путь к нему.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-behavior"/> +<guilabel +>Поведение</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term> +<anchor id="config-dialog-general-sync-konsole"/> +<guibutton +>Синхронизировать терминал с активным документом</guibutton +></term> +<listitem +><para +>Если флажок установлен, встроенный терминал будет менять свой текущий каталог при каждой смене активного документа. Если сброшен, вам придётся перемещаться по дереву каталогов вручную. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-dialog-general-warn-mod"/> +<guilabel +>Предупреждать об изменении файла другой программой</guilabel +></term> +<listitem +><para +>Если флажок установлен, &kate; уведомит вас об изменении файла другой программой, как только главное окно получит фокус ввода. Вы можете производить обновления, сохранять или отменять изменения сразу для группы файлов.</para> +<para +>Если флажок сброшен, то, при получении фокуса ввода файлом, изменённым другой программой, &kate; задаст вопрос о необходимых действиях.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry +><!-- /behavior group --> + +<varlistentry> +<term +><anchor id="config-general-meta-data"/> +<guilabel +>Мета-данные</guilabel +></term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="config-general-keep-meta-information"/> +<guilabel +>Сохранять мета-данные прошлых сеансов</guilabel +></term> +<listitem +><para +>Если флажок установлен, &kate; сохранит мета-данные (закладки, настройку сеанса), даже когда вы закроете документ. Эти данные могут понадобиться, если документ вновь будет открыт в прежнем виде.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-delete-meta-information-after"/> +<guilabel +>Удалить настройки сеансов после</guilabel +></term> +<listitem +><para +>Устанавливает время, в течение которого будут храниться мета-данные файла. Долговременное хранение приводит к переполнению базы данных.</para +></listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry +><!-- /meta data group --> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-sessions"> +<title +>Страница <quote +>Сеансы</quote +></title> + +<para +>Раздел содержит параметры, связанные с <link linkend="fundamentals-using-sessions" +>использованием сеансов</link +>.</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-elements"/> +<guilabel +>Элементы сеансов</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Восстанавливать настройку окна</guilabel +></term> +<listitem +><para +>Если флажок установлен, &kate; будет восстанавливать настройку окна в каждом новом сеансе.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /elements of sessions --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-startup-behavior"/> +<guilabel +>Поведение при запуске приложения</guilabel +></term> +<listitem> +<para +>Определяет поведение &kate; при запуске. Эту настройку можно изменить параметрами <link linkend="command-line-options" +>командной строки</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Начинать новый сеанс</guilabel +></term> +<listitem +><para +>Если установить этот флажок, &kate; при каждом запуске будет начинать новый безымянный сеанс.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Загрузить последний сеанс</guilabel +></term> +<listitem +><para +>При запуске &kate; может открывать прошлый сеанс. Удобно, если вы не любите менять настройки.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Выбрать сеанс</guilabel +></term> +<listitem +><para +>&kate; может предлагать на выбор несколько недавних сеансов. Эта настройка действует по умолчанию. Удобно для любителей частой смены настроек.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /startup behavior --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-exit-behavior"/> +<guilabel +>Поведение при выходе из приложения или переключении сеанса</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Не сохранять сеанс</guilabel +></term> +<listitem +><para +>Изменения данных сеанса (открывавшихся файлов и, если было включено, настройки окна) не сохранятся. Естественно, будет задан вопрос о сохранении изменённых файлов. Установите этот флажок - и при открытии нового сеанса ненужные файлы перестанут открываться.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Сохранить сеанс</guilabel +></term> +<listitem +><para +>&kate; сохранит данные любого сеанса, если он не безымянный. Если флажок установлен, ваш сеанс будет восстановлен в том самом виде, в котором вы его закрыли. Это поведение по умолчанию. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Спросить пользователя</guilabel +></term> +<listitem +><para +>Вопрос о сохранении сеанса будет задан при закрытии любого именованного сеанса.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /exit/switch behavior --> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-fileselector"> +<title +>Страница <guilabel +>Панель выбора файла</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Панель инструментов</guilabel +></term> +<listitem +><para +>Выберите нужные вам кнопки для диалога выбора файла путём перемещения их в окно <guilabel +>Выбранные действия</guilabel +>. Расположение кнопок установите стрелками рядом с окном.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Автоматическая синхронизация</guilabel +></term> +<listitem +><para +>Диалог выбора файла может автоматически переходить к директории, содержащей текущий документ, при наступлении следующих событий:<itemizedlist +><listitem +><para +>При активизации документа</para +></listitem +><listitem +><para +>При показе панели выбора файлов</para +></listitem +></itemizedlist +> Даже если вы не пользуетесь этим свойством, синхронизацию можно выполнить вручную, нажав кнопку <guilabel +>Синхронизировать</guilabel +>. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сохранять расположение</guilabel +></term> +<listitem +><para +>Установите размер журнала. Сохраняются только фактические адреса, копии удаляются.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сохранять фильтры</guilabel +></term> +<listitem +><para +>Установите желаемое количество сохраняемых фильтров. Сохраняются только сами фильтры, копии удаляются.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сеанс</guilabel +></term> +<listitem> +<para +>Определите, будет ли сохраняться расположение и фильтр для каждого сеанса.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-documentlist"> +<title +>Страница <guilabel +>Список документов</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Подсветка фона</guilabel +></term> +<listitem +><para +>Позволяет вам включить визуализацию истории перехода по документам (через оттенки фона соответствующих пунктов списка), а также настроить используемые для этого цвета. Для подробностей, обратитесь к разделу <link linkend="kate-mdi-tools-file-list" +>Список документов</link +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Сортировать по</guilabel +></term> +<listitem +><para +>Порядок сортировки документов в списке. Эти же команды можно найти в контекстном меню списка документов.</para +></listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="config-dialog-plugins"> +<title +>Страница <guilabel +>Модули</guilabel +></title> + +<para +>На этой странице представлены установленные модули &kate;. Для каждого отображается название и краткое описание. Для подключения нужного модуля нужно установить соответствующий флажок. </para> + +<para +>Если модуль настраиваемый, параметры его настройки появятся в дочернем окне этой страницы.</para> + +</sect2> + + +<sect2 id="config-dialog-externaltools"> +<title +>Внешние инструменты</title> + +<para +>Меню <guimenu +>Сервис</guimenu +> содержит подменю <guisubmenu +>Внешние инструменты</guisubmenu +>. Эти инструменты вызывают внешние приложения для обработки данных соответствующего типа (интернет-адреса, директории, текста или выделения). На этой странице можно настраивать меню, редактировать, добавлять и удалять инструменты.</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> + +</sect2> + +</sect1> + +<sect1 id="config-dialog-editor"> +<title +>Настройка компонентов редактора</title> +<para +>Группа содержит параметры, относящиеся к компонентам редактора. Большинство из них предустановлены, но могут быть изменены установками параметров <link linkend="config-dialog-editor-filetypes" +>Установки, специфичные для типов файлов</link +>, <link linkend="config-variables" +>Переменные документа</link +>. Параметры для текущего документа можно также изменить динамически с помощью команд правки (F7).</para> + + +<sect2 id="config-dialog-editor-appearance"> +<title +>Внешний вид</title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Перенос строк</guilabel +></term> +<listitem> +<variablelist> +<varlistentry id="appearance-settings"> +<term +><guilabel +>Динамический перенос строк</guilabel +></term> +<listitem +><para +>При установленном флажке строки будут переноситься в пределах окна.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Маркёры динамического переноса строк</guilabel +></term> +<listitem +><para +>Определяет отображение маркёров динамического переноса строк. </para +></listitem +></varlistentry> +<varlistentry> +<term +><guilabel +>Отступ динамически перенесённых строк до уровня: </guilabel +></term> +<listitem +><para +>Устанавливает отступ динамически перенесённой строки от уровня предыдущей. Такой код удобнее читать.</para +><para +>Дополнительно можно установить предел отступов динамически перенесённых строк в процентах. Например, если установить этот параметр в 50%, экрана, то за этим пределом отступ применяться уже не будет.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сворачивание блоков кода</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Показывать маркёры сворачивания блоков (если поддерживается) </guilabel +></term> +<listitem +><para +>Если флажок установлен, то в текущем документе будут показаны маркёры сворачивания блоков кода (если сворачивание доступно).</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Границы</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Показывать панель значков </guilabel +></term> +<listitem +><para +>Если флажок установлен, то слева от текстового поля будут отображаться значки, например значки закладок.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Показывать номера строк </guilabel +></term> +<listitem +><para +>Если флажок установлен, то слева от текста будут отображаться номера строк.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Показывать отметки </guilabel +></term> +<listitem +><para +>Если флажок установлен, то на полосе прокрутки текущего документа будут отображаться отметки, например закладки.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Меню управления закладками </guilabel +></term> +<listitem +><para> +<variablelist> +<varlistentry> +<term +><guilabel +>По позиции </guilabel +></term> +<listitem +><para +>Закладки будут упорядочены по номерам строк, на которые они установлены.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>По времени создания </guilabel +></term> +<listitem +><para +>Новая закладка будет добавлена в конец списка, независимо от её положения в документе.</para +></listitem> +</varlistentry> +</variablelist> +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Отображать линии отступов </guilabel +></term> +<listitem +><para +>Если флажок установлен, в редакторе будут отображаться вертикальные линии для выравнивания отступов.</para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-colors"> +<title +>Шрифты и цвета</title> + +<para +>В этой части диалога можно настроить цвета и шрифты для любой выбранной вами цветовой схемы. Можно создать новую схему или удалить существующую. Каждая схема содержит пакет настроек шрифтов и цветов для обычного и выделенного текстов. </para> + +<para +>&kate; использует предустановленные параметры. Для включения иной схемы необходимо выбрать её в выпадающем списке.</para> + +<sect3 id="config-dialog-editor-colors-colors"> +<title +>Цвета</title> + +<variablelist> +<varlistentry id="config-dialog-editor-colors-colors-text-background"> +<term +><guilabel +>Фон текстового поля</guilabel +></term> +<listitem> + +<variablelist> + +<varlistentry id="config-dialog-editor-colors-normal-text"> +<term +><guilabel +>Обычный текст</guilabel +></term> +<listitem +><para +>Это основной цвет текстового поля.</para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-selected-text"> +<term +><guilabel +>Выделенный текст</guilabel +></term> +<listitem +><para +>Фон выделенного текста. По умолчанию действует глобальная настройка &kde;. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-current-line"> +<term +><guilabel +>Текущая строка</guilabel +></term> +<listitem +><para +>Цвет текущей строки. Цветовое выделение поможет следить за фокусом ввода. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-marks"> +<term +><guilabel +>Закладка</guilabel +></term> +<listitem +><para +>В этом списке можно выбрать цвета для различных типов закладок. Этот цвет подмешивается к фону текущей строки, поэтому может не вполне соответствовать установленному. В эти же цвета окрашиваются отметки на полосе прокрутки.</para +></listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-colors-other-elements"> +<term +><guilabel +>Другие элементы</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Фон левой границы</guilabel +></term> +<listitem +><para +>Определяет окраску всех панелей, находящихся слева от текстового поля (если они отображаются). </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Номера строк</guilabel +></term> +<listitem +><para +>Этим цветом окрашиваются номера строк (если они отображаются).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Цвет фигурных скобок</guilabel +></term> +<listitem +><para +>Этим цветом окрашиваются соответствующие друг другу фигурные скобки. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Маркёры переноса строк</guilabel +></term> +<listitem +><para +>Этим цветом окрашиваются маркёры слева от динамически перенесённых строк (если они выровнены вертикально) и маркёры статического переноса строк.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Маркёры позиций табуляции</guilabel +></term> +<listitem +><para +>Этим цветом окрашиваются пустые пространства текста, если их отображение включено. </para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect3> + +<sect3 id="config-dialog-editor-colors-fonts"> +<title +>Шрифты</title> +<para +>Выбор шрифта для схемы. Доступен любой шрифт из вашей системы, можно настроить размер по умолчанию. Образец текста приводится в нижней части диалога, поэтому результат изменения виден сразу. </para> +</sect3> + +<sect3 id="config-dialog-editor-colors-normal-text-styles"> +<title +>Стили обычного текста</title> +<para +>Стили обычного текста наследуются из стилей выделенного, поэтому редактор может более вразумительно отображать текст. Например, текст комментария использует стили почти всех текстовых форматов, которые kate в состоянии обрабатывать.</para> +<para +>Во время настройки стиля есть возможность предварительно просмотреть её результаты. </para> +<para +>Для каждого стиля можно настроить обычные атрибуты, цвета фона и самого текста. Перенастроить фон можно через контекстное меню.</para> +</sect3> + +<sect3 id="config-dialog-editor-colors-highlighting-text-styles"> +<title +>Стили подсветки текста</title> +<para +>Здесь можно настроить стили текста для определённого правила подсветки. Имеются предустановленные настройки, но в выпадающем списке <guilabel +>Подсветка</guilabel +> можно установить другие параметры. </para> +<para +>Во время настройки стиля есть возможность предварительно просмотреть её результаты. </para> +<para +>Для каждого стиля можно настроить обычные атрибуты, цвета фона и самого текста. Перенастроить фон можно через контекстное меню. Есть возможность сравнить текущий стиль с предустановленным и устранить возможное несоответствие.</para> +<para +>Можно заметить, что многие стили подсветки содержат другие стили, представленные группами в списке. Например, большинство стилей используют стиль Alert, а многие форматы языков программирования используют стиль Doxygen. Цвета редактирования для этих групп применяются только во время работы с соответствующими форматами. </para> +</sect3> + +</sect2> + +<sect2 id="config-dialog-editor-cursor-selection"> +<title +>Курсор и выделение</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Перемещение курсора</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Умная реакция на home</guilabel +></term> +<listitem> +<para +>Если флажок установлен, то нажатие клавиши Home вызовет перемещение курсора в начало строки.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Переносить курсор</guilabel +></term> +<listitem> +<para +>Если флажок установлен, то курсор ввода будет перемещаться клавишами <emphasis role="bold" +>Влево</emphasis +> и <emphasis role="bold" +>Вправо</emphasis +> на предыдущую/следующую строку в начало/конец строки, так же как в большинстве других редакторов.</para +><para +>Если флажок сброшен, то курсор невозможно переместить левее начала строки, но можно переместить правее конца строки, что удобно для программистов. Когда флажок установлен, перемещение курсора стрелочными клавишами за конец строки (вправо) вызовет его смещение на начало следующей строки. Перемещение курсора левее начала строки вызовет его переход на конец предыдущей строки. Если флажок сброшен, то передвижение курсора вправо за конец строки приведёт только к движению его в пределах данной строки, а передвижение левее начала строки вообще невозможно.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Клавиши Page Up/Page Down перемещают курсор</guilabel +></term> +<listitem> +<para +>Этот параметр определяет реакцию курсора на нажатие клавиш <keycap +>Page Up</keycap +> или <keycap +>Page Down</keycap +>. Если флажок сброшен, то первое нажатие клавиши вызовет появление новой страницы. Если флажок установлен, то первое нажатие клавиши вызовет сначала перемещение курсора в начало или конец видимого текста, и только потом откроется новая страница.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Автоцентровка курсора (строк):</guilabel +></term> +<listitem> +<para +>Количество строк, остающихся по возможности видимыми над и под курсором.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Режим выделения</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Обычный</guilabel +></term> +<listitem> +<para +>Выделенный фрагмент будет перезаписан вводимым текстом, выделение будет снято при перемещении курсора.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Не снимать выделение</guilabel +></term> +<listitem> +<para +>При перемещении курсора и вводе текста фрагмент остаётся выделенным.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-edit"> +<title +>Редактирование</title> +<variablelist> + +<varlistentry> +<term +><guilabel +>Табуляция</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Заполнять отступы пробелами</guilabel +></term> +<listitem> +<para +>Если флажок установлен, то при нажатии клавиши <keycap +>TAB</keycap +> будут введены пробелы в количестве, определённом параметром <option +>tab-width</option +>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Показать символы табуляции</guilabel +></term> +<listitem> +<para +>Если установить этот флажок, &kate; будет отображать символы табуляции маленькими точками.</para> +<note +><para +>Это может вызвать также отображение в виде точек завершающих пробелов. В будущих версиях &kate; будет исправлено.</para +></note> +</listitem> +</varlistentry> +<varlistentry> +<term id="config-dialog-editor-tab-width" +>Ширина табуляции</term +> <listitem +><para +>Этим параметром определяется количество пробелов, заменяющих символ табуляции при включённом параметре <link linkend="config-dialog-editor-word-wrap" +><guilabel +>Заменять символы табуляции пробелами</guilabel +></link +>.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term id="config-dialog-editor-word-wrap" +><guilabel +>Статичный перенос строк</guilabel +></term> +<listitem +><para +>Перенос строк - это свойство редактора автоматически начинать новую строку и переносить курсор на её начало. &kate; автоматически начинает новую строку при достижении величины, определённой параметром <link linkend="config-dialog-editor-wrap-words-at" +>Переносить после:</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Переносить строки</guilabel +></term> +<listitem> +<para +>Включает/выключает статичный перенос строк.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Отображать маркёры статичного переноса строк (если возможно)</guilabel +></term> +<listitem> +<para +>Если этот параметр включён, то на границе переноса строк будет отображаться вертикальная линия, как определено в меню <menuchoice +><guimenu +>Настройка</guimenu +> <guimenuitem +>Редактирование</guimenuitem +></menuchoice +> на вкладке Правка. Заметьте, что этот маркёр может отображаться, только если вы используете моноширинный шрифт.</para> +</listitem> +</varlistentry> +<varlistentry id="config-dialog-editor-wrap-words-at"> +<term +><guilabel +>Переносить после:</guilabel +></term> +<listitem> +<para +>Здесь устанавливается количество символов, после которого начинается новая строка при включённом параметре <link linkend="config-dialog-editor-word-wrap" +>Перенос строк</link +>.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Удалить завершающие пробелы</guilabel +></term> +<listitem +><para +>&kate; может автоматически удалять лишние завершающие пробелы.</para +></listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Автоскобки</guilabel +></term +> <listitem +><para +>Когда пользователь вводит левую скобку любого вида, &kate; автоматически подставляет аналогичную скобку справа от курсора.</para +></listitem> +</varlistentry> + +<varlistentry +> <term +>Число <link linkend="undo" +>шагов отмены</link +>:</term> +<listitem +><para +>Здесь устанавливается предельное число операций, которые &kate; будет сохранять в памяти. Чем больше это число, тем больше памяти будет занято откатами. Указав число 10, пользователь получит возможность кнопкой "Отменить действие" вернуться назад на десять своих последних шагов и выбрать из них наиболее удачный.</para +></listitem +> </varlistentry> + +<varlistentry +> <term +>Интеллектуальный поиск текста с:</term> +<listitem +><para +>Здесь определяется, где &kate; будет искать текст для поиска (этот текст будет автоматически помещён в диалог поиска текста): <itemizedlist +> <listitem +><para +><emphasis role="bold" +>Не искать нигде:</emphasis +>Поиск текста не производится.</para +></listitem +><listitem +><para +><emphasis role="bold" +>Только в выделении:</emphasis +> Используется текущее выделение (если возможно). </para +></listitem +><listitem +><para +><emphasis role="bold" +>В выделении, затем в текущем слове:</emphasis +> Используется, если возможно, текущее выделение, в противном случае текущее слово.</para +></listitem +><listitem +><para +><emphasis role="bold" +>Только в текущем слове:</emphasis +> Используется, если возможно, только то слово, в котором находится курсор.</para +></listitem +><listitem +><para +><emphasis role="bold" +>Текущее слово, затем выделение:</emphasis +> Используется, если возможно, текущее слово, в противном случае текущее выделение. </para +></listitem +></itemizedlist +>Учтите, что, если во всех вышеописанных режимах строка для поиска не указана или не может быть найдена, в диалоге поиска текста появится последняя введённая строка. </para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-indent"> +<title +>Отступ</title> +<variablelist> +<varlistentry> +<term +><guilabel +>Автоматический отступ</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Правила отступа:</guilabel +></term> +<listitem> +<para +>Выбор используемого по умолчанию режима отступов. Настоятельно рекомендуется пользоваться значением <userinput +>Нет</userinput +> или <userinput +>Обычный</userinput +>, а для формирования других режимов использовать установки, специфичные для типов файлов, таких как файлов кода C/C++ или &XML;.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Автоматически добавлять комментарии Doxygen при наборе</guilabel +></term> +<listitem> +<para +>При наборе комментариев в стиле doxygen к ним автоматически добавляются "*". Этот параметр применяется только там, где возможно.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Отступ пробелами</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Отступы пробелами вместо символов табуляции</guilabel +></term> +<listitem> +<para +>Символы табуляции заменяются пробелами в количестве, указанном тут же, в поле <guilabel +>Количество пробелов:</guilabel +>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Смешанный режим в стиле Emacs</guilabel +></term> +<listitem> +<para +>Применяется смешанный режим отступов табуляторами и пробелами.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Количество пробелов:</guilabel +></term> +<listitem> +<para +>Устанавливает количество пробелов, вводимых для замены символов табуляции, если этот флажок установлен.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сохранять настройки отступов</guilabel +></term> +<listitem +><para +>Если этот флажок установлен, то редактор не будет убирать отступы в последующих строках выделения, когда в предыдущих отступы снимаются. Может быть полезно, если вам часто приходится снимать отступы с блоков кода. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сохранять лишние пробелы</guilabel +></term> +<listitem +><para +>Отступы длиной более, чем заданное число пробелов, не будут сокращаться.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Использовать клавиши</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Отступы клавишей Tab</guilabel +></term> +<listitem> +<para +>Для отступов используется клавиша <keycombo action="simul" +><keycap +>tab</keycap +></keycombo +>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Отступы клавишей Backspace</guilabel +></term> +<listitem> +<para +>Для отступов используется клавиша <keycombo action="simul" +><keycap +>backspace</keycap +></keycombo +>.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Отступы клавишей Tab, если ничего не указано</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Вставлять символы отступа</guilabel +></term> +<listitem> +<para +>Клавишей <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> вставляются символы отступа.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Вставить символ табуляции</guilabel +></term> +<listitem> +<para +>Клавишей <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> вставляются символы табуляции.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Сделать отступ на текущей строке</guilabel +></term> +<listitem> +<para +>Клавишей <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> можно сделать отступ в текущей строке.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-open-save"> +<title +>Открытие/сохранение</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Формат файла</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Кодировка:</guilabel +></term> +<listitem> +<para +>Устанавливает кодировку по умолчанию для сохраняемых файлов.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Конец строки:</guilabel +></term> +<listitem> +<para +>Выбор необходимого формата окончания строк для текущего файла. Выбрать можно между форматами &UNIX;, DOS/&Windows; или Macintosh.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Автоопределение формата конца строки</guilabel +></term> +<listitem> +<para +>Выбор этого параметра поредоставит редактору самостоятельно определять формат конца строки. Первое найденное окончание строки будет применено затем ко всему файлу.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Использование памяти</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Количество загружаемых блоков для каждого файла:</guilabel +></term> +<listitem> +<para +>Редактор будет загружать в память указанное количество блоков текста (каждый примерно из 2048 строк). Если размер файла больше указанного предела, то остальные блоки будут сброшены на диск, а затем в случае надобности загружены в память.</para> +<para +>Подобный сброс может вызывать задержки во время навигации по файлу. Большее количество блоков ускоряет работу за счёт увеличения количества используемой памяти. </para +><para +>Лучше выбрать максимально доступное количество блоков. Ограничения разумны только в случае нехватки памяти.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Автоматическая очистка при открытии/сохранении</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Удалить завершающие пробелы</guilabel +></term> +<listitem> +<para +>Лишние пробелы в конце строки при загрузке и сохранении будут автоматически удаляться.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Папка файла настройки</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Глубина поиска файла настройки:</guilabel +></term> +<listitem> +<para +>Редактор просмотрит заданное количество уровней иерархии папок в поисках файла настройки &kate; и загрузит из него строку настройки.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Создавать резервную копию при сохранении</guilabel +></term> +<listitem +><para +>Создание резервной копии при сохранении означает, что при записи на диск изменённого файла будет записана также резервная копия с именем <prefix><filename><suffix>', без внесённых изменений. Суффикс по умолчанию <emphasis role="bold" +>~</emphasis +>, а префикс по умолчанию пуст. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Локальные файлы</guilabel +></term> +<listitem> +<para +>Установите этот флажок, если хотите сохранять резервные копии локальных файлов.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Удалённые файлы</guilabel +></term> +<listitem> +<para +>Установите этот флажок, если хотите сохранять резервные копии удалённых файлов.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Префикс</guilabel +></term> +<listitem> +<para +>Введите префикс для вставки перед именами сохраняемых резервных файлов.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Суффикс</guilabel +></term> +<listitem> +<para +>Введите суффикс для вставки после имён сохраняемых резервных файлов.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-highlighting"> +<title +>Подсветка</title> +<para +>Эта группа параметров используется для изменения стилей подсветки для каждого типа языков программирования. Любые изменения, сделанные в других вкладках этого диалога, влияют только на данный стиль подсветки.</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Подсветка:</guilabel +></term> +<listitem +><para +>Выбор языка для настройки.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Сведения</guilabel +></term> +<listitem> +<para +>Просмотр сведений о правилах подсветки синтаксиса выбранного языка: имя автора и лицензия. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Свойства</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Расширения файлов:</guilabel +></term> +<listitem +><para +>Список расширений файлов, используемых для определения необходимого режима подсветки.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Типы MIME:</guilabel +></term> +<listitem +><para +>Нажатие кнопки с символом мастера вызовет диалог выбора доступных mime-типов.</para +><para +>Текст в поле <emphasis role="bold" +>Расширения файлов</emphasis +> при изменении mime-типа будет изменяться соответственно.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Приоритет:</guilabel +></term> +<listitem +><para +>Устанавливает приоритет правила подсветки.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Загрузить...</guibutton +></term> +<listitem> +<para +>Нажатием этой кнопки можно загрузить новое или обновить существующее правило подсветки синтаксиса с веб-сайта &kate;. </para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-filetypes"> +<title +>Типы файлов</title> +<para +>Здесь вы можете указать параметры редактора для разных типов файлов. При открытии документа, его тип определяется по расширению или mime-типу. Если подходят несколько типов, будет использован тип с высшим приоритетом. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Тип файла:</guilabel +></term> +<listitem +><para +>Тип файла с наивысшим приоритетом указывается в выпадающем списке первым. Если есть другие подходящие типы, они тоже присутствуют в списке.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Создать</guilabel +></term> +<listitem +><para +>Эта кнопка используется для создания нового типа файлов. При нажатии все поля под ней становятся редактируемыми, и в них вводятся те свойства, которыми должен обладать ваш новый тип файлов.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Удалить</guilabel +></term> +<listitem +><para +>Для удаления существующего типа файлов, выберите его в выпадающем списке и нажмите кнопку "Удалить".</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Свойства текущего типа файлов</guilabel +></term> +<listitem +><para +>Тип файла с наивысшим приоритетом указывается в выпадающем списке первым. Если есть другие подходящие типы, они тоже присутствуют в списке.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Название:</guilabel +></term> +<listitem +><para +>Название типа текущего файла должно соответствовать тексту соответствующего пункта меню <menuchoice +><guimenu +>Сервис</guimenu +><guimenuitem +>Типы файлов</guimenuitem +> </menuchoice +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Раздел:</guilabel +></term> +<listitem +><para +>Название раздела используется для организации типов файлов в меню <menuchoice +><guimenu +>Сервис</guimenu +><guimenuitem +>Типы файлов</guimenuitem +> </menuchoice +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Переменные:</guilabel +></term> +<listitem +><para +>Это поле позволяет настроить обработку выбранных типов файлов с использованием переменных &kate;. Можно настроить почти любой параметр (подсветку, отступы, кодировку и т.п.).</para +><para +>Список всех доступных переменных содержится в руководстве.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Расширения файлов:</guilabel +></term> +<listitem +><para +>Маски позволяют выбирать файлы по их расширению. Типичная маска состоит из звёздочки и расширения файла, например <filename +>*.txt; *.text</filename +>. Строка состоит из списка разделённых точкой с запятой масок.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Типы MIME:</guilabel +></term> +<listitem +><para +>Запускает мастер выбора mime-типов.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Приоритет:</guilabel +></term> +<listitem +><para +>Устанавливает приоритет типа файлов. Если при открытии файла к нему подходят несколько типов, будет использован тип с наивысшим приоритетом.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-shortcuts"> +<title +>Комбинации клавиш</title> +<para +>Здесь можно изменить настройку горячих клавиш. Если хотите изменить настройки по умолчанию - выберите действие и нажмите кнопку <guilabel +>По выбору</guilabel +>.</para> +<para +>Строка поиска позволяет просмотреть сочетания клавиш, определённые для различных действий.</para> +</sect2> + +<sect2 id="config-dialog-editor-plugins"> +<title +>Модули</title> +<para +>На этой вкладке можно выбрать, какие модули вы хотели бы использовать. Выделив нужный модуль, с помощью появившейся кнопки можно <guibutton +>Настроить</guibutton +> его.</para> +</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 +>Переменные, не описанные ниже, хранятся в документе и могут использоваться другими объектами, такими как модули, для собственных целей. Например, переменная режима отступов использует для своей настройки переменные документа.</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 +>Если имеет значение true, то отступ не снимается с блока до тех пор, пока хоть одна строка сохраняет отступ.</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 +>Включает/выключает преобразование символов табуляции в пробелы при сохранении.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Включает/выключает динамическое преобразование символов табуляции в пробелы.</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> |