# Основы

У пользователей, имеющих опыт использования текстовых редакторов, проблем с работой в &kate; возникнуть не должно. Следующие два раздела Запуск &kate; и Работа в &kate; позволят узнать всё, что нужно для начала продуктивной работы с редактором.

## Запуск &kate;

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

### Из меню запуска

Откройте меню программ &kde;, щёлкнув левой кнопкой мыши по значку на панели инструментов, который расположен в левом нижнем углу экрана. В появившемся меню запуска выберите пункт Приложения Служебные &kate; (Улучшенный текстовый редактор) или просто введите «kate» в строке поиска.

### Из командной строки

Чтобы запустить &kate;, введите «kate» в командной строке. Если указать имя файла в качестве параметра, как это сделано в приведённом ниже примере, то редактор откроет или создаст этот файл.

    %kate myfile.txt

При наличии доступа в Интернет появляется возможность открывать и сохранять удалённые файлы благодаря реализации «прозрачной» работы с сетью в &kde;.

    %kate &kde-ftp;README

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

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### Параметры командной строки

При запуске &kate; из командной строки возможно указать следующие ключи:

``kate` `--help``

- Выводит список всех доступных команд.

``kate` `-s` `--start` `имя_сеанса``

- Запускает &kate; и открывает сеанс `имя_сеанса`. Если указанный сеанс не существует, он будет создан. Если программа &kate; с данным сеансом уже запущена, то переданные в командной строке файлы будут открыты в уже существующем окне программы.

``kate` `-p` `--pid` `PID``

- Открывает файл в экземпляре с указанным PID (идентификатор процесса).

``kate` `-e` `--encoding` `кодировка` `URL``

- Использует определённую кодировку для документа.

``kate` `-l` `--line` `номер_строки` `URL``

- Переходит к строке с указанным номером после открытия документа.

``kate` `-c` `--column` `позиция` `URL``

- Переходит в указанную позицию строки после открытия документа.

``kate` `-i` `--stdin``

- Получает текст из стандартного ввода. Аналогично указанию `-`, используемому во многих программах с наличием командной строки, и позволяет направить вывод команды в &kate;.

``kate` `--startanon``

- Запускает &kate; с новым безымянным сеансом, подразумевает параметр `-n`.

``kate` `-n` `--new``

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

``kate` `-b` `--block``

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

  С этой опцией &kate; возможно использовать в качестве редактора для набора сообщений фиксации для таких систем контроля версий, как &git; или Subversion. Для работы с этими системами необходима блокировка редактора до того момента, пока пользователь не напишет сообщение, потому что затем они открывают временный файл, который в противном случае был бы пустым.

  Эта опция также используется в KIO (ввод/вывод &kde;) при открытии сетевого файла (загруженного в качестве временного), который требует повторной отправки после сохранения.

``kate` `--tempfile``

- Использует указанные файлы как временные и удаляет их (если они локальные, а у пользователя достаточно прав) при закрытии, если только они не были изменены с момента их открытия.

``kate` `--desktopfile` `имя_файла``

- Имя файла .desktop (без пути) для этого приложения.

  Это особенно полезно для приложений-оболочек и приложений, имеющих, как правило, несколько файлов рабочей области. У каждого файла рабочей области может быть своя командная строка для записи `Exec`.

``kate` `--author``

- Показывает список авторов &kate; в окне терминала.

``kate` `-v` `--version``

- Показывает сведения о версии &kate;.

``kate` `--license``

- Показывает информацию о лицензии.

### Перетаскивание

&kate; поддерживает протокол перетаскивания мышью &kde;. Файлы возможно перетащить в &kate; с рабочего стола, из диспетчера файлов &dolphin; или с какого-либо сетевого &FTP;-сайта, открытого в окне &dolphin;.

## Работа в &kate;

В разделе Начало работы рассказано о четырёх опциях, которые позволят быстро настроить основные возможности &kate;. Раздел Комбинации клавиш содержит описание некоторых комбинаций клавиш для тех, кто не может или не желает работать с мышью.

### Начало работы

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

При первом запуске &kate; появятся две области с белым фоном. Над ними будет находиться панель инструментов с наиболее часто используемыми командами. Ещё выше — строка меню.

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

Если программа &kate; запущена для открытия файла (например, из Dolphin), то в правой области появится текст редактируемого файла, а в списке файлов, который находится на боковой панели, — его имя. С помощью селектора файлов возможно просматривать файловую структуру и открывать файлы для редактирования.

Включить и отключить все служебные панели возможно либо с помощью меню Вид Боковые панели, либо с помощью комбинации клавиш &Ctrl;&Alt;&Shift;F. При использовании этого меню становятся очевидны широта возможностей и гибкость &kate;.

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

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

Почти все комбинации клавиш &kate; возможно перенастроить с помощью меню Настройка. По умолчанию комбинации клавиш в &kate; настроены следующим образом:

F1 | Справка
&Shift;F1 | Что это?
&Ctrl;N | Создать документ
&Ctrl;L | Сохранить всё
&Ctrl;O | Открыть документ
&Ctrl;&Alt;O | Быстрый переход
&Ctrl;&Shift;F | Полноэкранный режим
&Ctrl;&Shift;, | Настроить &kate;
&Ctrl;W / &Ctrl;&Esc; | Закрыть
&Ctrl;Q | Выход — закрыть редактор
&Ctrl;&Alt;&Shift;F | Показать боковые панели
&Ctrl;&Shift;T | Разделить по горизонтали
&Ctrl;&Shift;L | Разделить по вертикали
F8 | Следующая створка
&Shift;F8 / &Ctrl;&Esc; | Предыдущая створка
&Ctrl;&Shift;R | Закрыть текущую створку
&Alt;&Right; | Следующая вкладка
&Alt;&Left; | Предыдущая вкладка
&Ctrl;&Shift;T | Открыть последние закрытые документы заново

Кроме того, возможно использовать комбинации клавиш, предоставляемые компонентом &katepart; и всеми подключёнными модулями модулями &kate;.

## Работа с многодокументным интерфейсом &kate;

### Обзор

Окно, представление, документ, панель, редактор... Что означают эти понятия в терминологии &kate;? Эта глава даст ответы на все вопросы, связанные с окнами &kate;.

#### Главное окно

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

Самая важная часть окна — это область редактирования; по умолчанию она содержит один компонент для редактирования текста, в котором происходит работа с документами.

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

Размещение служебных панелей возможно изменить. Для этого щёлкните правой кнопкой мыши по вкладке панели и выберите край экрана, в который следует её перенести.

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

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

### Область редактирования

В &kate; возможно редактировать несколько документов одновременно, разделив область редактирования на панели (наподобие тех, что используются в &konqueror; и emacs). С помощью панелей (фреймов) возможно просматривать в области редактирования несколько документов (или несколько экземпляров одного документа). Например, если в начале файла расположены важные определения, с которыми нужно часто сверяться, эту возможность сложно не оценить по достоинству. Ещё один пример: при написании программы удобно будет в одной панели открыть заголовочный файл, а в другой — файл реализации.

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

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

После разделения редактора на две панели они имеют одинаковую ширину и отображают текущий документ этого редактора. Новая панель будет снизу (в случае разделения по горизонтали) или справа (в случае разделения по вертикали). Активной становится новая панель — об этом говорит мигающий текстовый курсор.

## Работа с сеансами

Сеанс позволяет открывать несколько документов и настраивать расположение элементов интерфейса на своё усмотрение. Поддерживается возможность создания бесконечного количества именованных сеансов, а также использования безымянных и анонимных сеансов для файлов, открываемых только один раз. Благодаря реализации концепции сеансов появилась возможность запуска нескольких экземпляров &kate; одновременно — с разными сеансами в каждом.

Поддержка сеансов присутствует в трёх областях:

- Ключи командной строки — возможность выбора сеанса при открытии &kate; с помощью командной строки.

- Меню «Сеанс» — позволяет переключаться между сеансами, сохранять и настраивать их.

- Окно настройки — позволяет настроить параметры работы с сеансами.

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

При загрузке любого сохранённого сеанса в заголовке окна &kate; отображается его имя. Следовательно, заголовок окна выглядит следующим образом: «`имя_сеанса`: `имя_документа или ссылка` — &kate;».

Если при открытии файлов из командной строки указывается ключ `--start `имя_сеанса`` или выбирается сеанс в диалоге выбора сеансов, то перед открытием указанных в командной строке файлов загружаются файлы соответствующего выбранного сеанса. &kate; позволяет всегда открывать файлы в новом сеансе. Для этого установите соответствующий флажок на странице параметров сеансов диалога настройки программы или укажите ключ `--start` с пустым аргументом: `''`.

Начиная с &kate; 2.5.1 PID текущего экземпляра экспортируется в переменную окружения `KATE_PID`. Для открытия файлов из встроенного терминала используется текущий экземпляр программы, если явно не указано иного.

## Быстрый переход

В Kate встроен диалог для быстрого открытия файлов и переключения между ними. Чтобы вызвать этот диалог, воспользуйтесь комбинацией клавиш &Ctrl;&Alt;O.

В окне этого диалога можно просмотреть все открытые в Kate документы, а также все файлы в открытых проектах. Для просмотра файлов проектов следует включить Модуль проектов.

### Работа с быстрым переходом

Использовать быстрый переход очень просто: откройте соответствующее диалоговое окно и введите (полностью или частично) имя файла, который требуется открыть. Показанный в окне список файлов будет отфильтрован. Выбранный файл открывается по нажатию клавиши ввода, а при нажатии клавиши &Esc; диалог быстрого открытия будет скрыт.

По умолчанию при фильтрации поиск ведётся только по имени файла. Чтобы учитывался и путь, в набираемом тексте должен быть символ «/». Например: «doc/index» позволит найти все файлы, в имени которых присутствует текст «index», в папке «doc».

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

### Настройка быстрого перехода

Быстрый переход

В диалоге быстрого перехода предусмотрено несколько параметров настройки. Чтобы получить доступ к ним, щелкните правой кнопкой мыши в строке ввода.

В текущей версии программы доступны следующие параметры:

- `Текущий проект` — показать файлы только из текущего проекта

  `Все проекты` — показать файлы из всех открытых проектов

  `Нечёткая фильтрация` — использовать нечёткое сопоставление для фильтрации файлов

  `Фильтрация по подстановочным знакам` — использовать сопоставление по подстановочным знакам для фильтрации файлов

## Получение справки

### Получение справки в &kate;

Данное руководство

- Здесь детально описаны все команды меню, параметры настройки, инструменты, диалоговые окна, модули. Также здесь описано главное окно &kate;, сам редактор и различные понятия и концепции, которые используются в приложении.

  Чтобы открыть руководство, нажмите клавишу F1 или вызовите пункт меню Справка Руководство пользователя &kate;.

Контекстная справка («Что это?»)

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

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

  Чтобы вызвать контекстную справку, воспользуйтесь комбинацией клавиш &Shift;F1 или выберите пункт меню Справка Что это?. Указатель мыши примет вид стрелки со знаком вопроса; теперь достаточно просто щёлкнуть левой кнопкой мыши по нужному элементу окна — небольшое окно с контекстной справкой тут же появится на экране (если, конечно, такая справка доступна).

Кнопки справки в диалоговых окнах

- В некоторых диалоговых окнах присутствует кнопка Справка. При нажатии этой кнопки будет открыт соответствующий раздел документации в &khelpcenter;.

### Получение справки из внешних файлов

В настоящее время &kate; не поддерживает чтение документации, относящейся к редактируемому документу. В зависимости от типа редактируемого файла, может быть полезен встроенный эмулятор терминала, например, для просмотра руководств &UNIX; (man-страницы) или документации в формате info. Также возможно использовать &konqueror;.

### Статьи про &kate;

Дополнительная информация доступна на домашней странице &kate;.