# Руководство &kwrite;

&Thad.McGinnis; &Thad.McGinnis.mail;
&Christoph.Cullmann; &Christoph.Cullmann.mail;
&Lauri.Watts; &Lauri.Watts.mail;
Екатерина
Пыжова

    haleth@yandex.ru

Перевод на русский
Олег
Баталов

    olegbatalov@mail.ru

Обновление русского перевода
2000
2001
&Thad.McGinnis;
&FDLNotice;
2004-08-27
2.00.00

&kwrite; — текстовый редактор &kde;.

KDE
KWrite
текст
редактор

## Введение

&kwrite; — не просто текстовый редактор для среды &kde;. Это также и редактор для программистов, и он может считаться по крайней мере частичной заменой более мощным приложениям. Его лучше всего использовать вместе с &konqueror; для просмотра файлов с исходными кодами на разных языках. &kwrite; хорошо выполняет и обычные функции редактора текстов. Одна из его основных особенностей — подсветка синтаксиса, которая настраивается для разных языков программирования: C/C++, &Java;, Python, Perl, Bash, Modula 2, HTML и Ada.

## Основы

Работа с &kwrite; очень проста. Если вы хоть раз пользовались текстовым редактором, у вас не должно возникнуть проблем.

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

В &kwrite; используется собственный протокол &kde; для манипулирования графическими объектами. Файлы в &kwrite; можно перетаскивать с рабочего стола, из &konqueror; или, например, &FTP;-сайта, открытого в одном из окон &konqueror;.

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

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

#### Укажите файл

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

    % kwrite
    /home/myhome/docs/myfile.txt

#### Укажите файл в Интернете

Описанный выше способ можно использовать и для открытия файлов из Интернета (если вы подключены к нему). Пример:

    % kwrite
    ftp://ftp.kde.org/pub/kde/Welcome.msg

#### Другие параметры командной строки

Доступны следующие дополнительные параметры:

``kwrite` `--help``

  Выводит список всех параметров командной строки с краткими объяснениями. Эти параметры относятся непосредственно к редактору.

``kwrite` `--help-qt``

  Список параметров, влияющих на взаимодействие &kwrite; и &Qt;.

``kwrite` `--help-kde``

  Список параметров, влияющих на взаимодействие &kwrite; и &kde;.

``kwrite` `--help-all``

  Список всех параметров командной строки.

``kwrite` `--author``

  Вывести в окне терминала список авторов &kwrite;.

``kwrite` `--version``

  Вывести информацию о текущих версиях &Qt;, &kde; и &kwrite;. Тот же эффект имеет и команда ``kwrite` `-V``.

### Привязки клавиш

Многие привязки (комбинации) клавиш можно настроить через меню Настройка. По умолчанию в &kwrite; используются следующие привязки.

Insert | Переключение между режимами вставки и замены. В режиме вставки редактор будет добавлять все вводимые символы, перемещая текст справа от курсора дальше. В режиме замены каждый вводимый символ будет удалять символ справа от курсора.
Стрелка влево | Переместить курсор на символ влево.
Стрелка вправо | Переместить курсор на символ вправо.
Стрелка вверх | Переместить курсор на строку выше.
Стрелка вниз | Переместить курсор на строку ниже.
Page Up | Переместить курсор на страницу выше.
Page Down | Переместить курсор на строку ниже.
Backspace | Удалить символ слева от курсора.
Home | Переместить курсор в начало строки.
End | Переместить курсор в конец строки.
Delete | Удалить символ справа от курсора (или выделенный текст).
&Shift;Стрелка влево | Выделить символ слева от курсора.
&Shift;Стрелка вправо | Выделить символ справа от курсора.
F1 | Помощь
&Shift;F1 | Что это?
&Ctrl;F | Поиск по тексту.
F3 | Поиск следующего вхождения.
&Ctrl;C | Скопировать выделенный текст в буфер обмена.
&Ctrl;B | Создать закладку.
&Ctrl;N | Создать документ.
&Ctrl;P | Печать.
&Ctrl;Q | Выход: закрыть текущее окно редактора.
&Ctrl;R | Заменить
&Ctrl;S | Выполнить команду Сохранить.
&Ctrl;V | Вставить текст из буфера обмена.
&Ctrl;X | Удалить выделенный текст и скопировать его в буфер обмена.
&Ctrl;Z | Отменить последнее действие.
&Ctrl;&Shift;Z | Повторить последнее действие.

## Меню

### Меню Файл

&Ctrl;N Файл Создать

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

&Ctrl;O Файл Открыть...

  Показывает стандартный диалог &kde; Открыть файл. В панели файлов выберите файл и нажмите Открыть. Дополнительная информация по работе с диалогом &kde; Открыть файл приведена в Руководстве пользователя &kde;.

Файл Открыть недавние

  Ссылки на последние открывавшиеся документы. Щелкнув по этому элементу, вы увидите собственно ссылки на файлы. Выберите файл, и он откроется в &kwrite;, если, конечно, вы его не переместили и не удалили.

&Ctrl;S Файл Сохранить

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

Файл Сохранить как...

  Сохранить документ под новым именем файла. При этом будет открыто окно, очень похожее на окно открытия файла.

&Ctrl;P Файл Печать...

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

&Ctrl;Q Файл Выход

  Закрыть окно редактора. Если запущены другие экземпляры &kwrite;, с ними ничего не случится.

### Меню Правка

&Ctrl;Z Правка Отменить действие

  Отменяет самое последнее действие.

&Ctrl;&Shift;Z Правка Повторить отменённое действие

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

&Ctrl;X Правка Вырезать

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

&Ctrl;C Правка Копировать

  Копировать выделенный текст в буфер обмена, так чтобы его можно было потом вставить куда-нибудь еще. Буфер обмена KDE позволяет приложениям обмениваться друг с другом информацией.

&Ctrl;V Правка Вставить

  Вставить содержимое буфера обмена на текущую позицию курсора. Буфер обмена KDE позволяет приложениям обмениваться друг с другом информацией.

&Ctrl;A Правка Выделить все

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

&Ctrl;G Правка Перейти на строку

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

&Ctrl;F Правка Найти...

  Открывает окно, в котором можно Искать текст. Там есть поля для ввода искомого выражения, которое также комбинируется с выпадающим списком ранее использовавшихся выражений. Есть и другие параметры, которые делают поиск эффективным. Установив флажок С учетом регистра, вы ограничите множество совпадений: в него будут входить только те выражения, у которых все буквы находятся в том же регистре, что и у искомого. Флажок Искать назад меняет направление поиска. Флажок Выделенный текст ограничивает область поиска текущим выделением. Если установлен флажок Только полные слова, за совпадения не будут считаться слова, содержащие искомое. Если вы установите флажок От курсора, поиск начнется не с начала документа, а с текущей позиции курсора.

F3 Правка Продолжить поиск

  Повторить последнюю операцию поиска, не открывая окно ввода искомого выражения.

&Shift;F3 Правка Найти предыдущий

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

&Ctrl;R Правка Заменить...

  Открывает окно замены. Оно очень похоже на описываемое выше окно поиска: добавлено поле ввода с выпадающим списком Текст для замены. То есть в этом окне вы можете указать и выражение для поиска, и выражение-замену. Дополнительный флажок Спрашивать при замене позволяет запрашивать подтверждение каждой замены.

### Меню Закладки

Закладки Очистить все закладки

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

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

### Меню Сервис

Сервис Проверка правописания...

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

  Неизвестное слово:

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

  Заменить на:

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

  Предлагаемые слова:

    Список возможных замен слова с ошибкой. Если вы щелкнете по какой-нибудь из них, она появится в поле Замена: (см. выше).

  Язык:

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

  В правой части диалога расположено 5 кнопок, которые позволяют управлять процессом проверки правописания:

  Добавить в словарь

    Добавить слово из поля Ошибочное слово: в словарь модуля. Это значит, что при следующих запусках модуля проверки слово будет считаться правильным.

  Заменить

    Это кнопка для подтверждения замены слова с ошибкой словом из поля Замена:.

  Заменить все

    Указывает программе заменить не только текущее неизвестное слово, на слово в поле Замена:, но и автоматически выполнять подобную замену для всехвстречающихся в документе слов из поля Неизвестное слово:.

  Игнорировать

    Продолжить поиск ошибок, не меняя текущее подозрительное слово.

  Игнорировать все

    Нажатие этой кнопки указывает программе проверки пропустить текущее Неизвестное слово: и поступать аналогичным способом со всеми аналогичным словами в документе.

    Это относится только к текущему процессу проверки орфографии. При последующем запуске вам снова будет предложено заменить это слово.

  Ещё три кнопки расположены выше индикатора прогресса:

  Справка

    Открывает окно справки &kwrite; (этот документ).

  Готово

    Это кнопка завершает процесс проверки правописания (сохраняя все исправления).

  Отмена

    Это кнопка отменяет процесс проверки правописания (не сохраняя исправления).

  &Ctrl;I Сервис Отступ

    Увеличить отступ абзаца на значение, указанное в настройках.

  &Ctrl;&Shift;# Сервис Убрать отступ

    Уменьшить отступ абзаца на значение, указанное в настройках.

  Сервис Убрать отступы

    Ещё не реализовано.

  &Ctrl;# Сервис Закомментировать

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

  &Ctrl;&Shift;# Сервис Раскомментировать

    Удалить знак комментария и пробел, которым этот знак отделялся от начала текста в строке.

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

Настройка Показать панель инструментов

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

Настройка Показать строку состояния

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

Настройка Показать путь

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

Настройка Настроить редактор...

  Открывает окно, где можно менять различные настройки редактора.

Настройка Настроить комбинации клавиш

  Открывает окно, в котором можно изменить привязки клавиш.В верхней части окна находится список команд (действий), для которых определены комбинации клавиш. Под списком расположены три переключателя. Вы можете использовать клавиши по умолчанию, по выбору или не использовать их вообще. Помните, что из этих трех вариантов вы можете выбрать только один. Привязки по умолчанию доступны только для тех команд, для которых они действительно предопределены. Выбрав вариант По выбору, вы откроете ещё одно окно, в котором можно определить привязку. Например, если в списке команд выбрана О KDE, вы можете удерживать нажатыми &Ctrl; и Alt и нажать K. Тогда каждый раз, когда вы будете повторять эту комбинацию в &kwrite;, будет открываться окно О KDE.

Настройка Настроить панели инструментов...

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

### Меню Помощь

&help.menu.documentation;

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

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

Это Помощь для вызова справочной системы, OK для подтверждения изменений и Отмена для закрытия окна без сохранения изменений. Доступные категории: Цвета, Шрифты, Отступ, Выделение, Редактирования, Подсветка и другие. Они описаны ниже.

### Цвета

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

Это специальное окно выбора цвета. В левом верхнем углу находится прямоугольник со спектром цветов. Справа от него расположена шкала яркости цвета, от самого темного внизу до самого светлого вверху. Вы можете выбирать цвета в спектре и уточнять их с помощью шкалы яркости. Любой цвет может быть представлен в виде смеси трех основных: красного, зеленого и синего (RGB) — а также в виде сочетаниятон, насыщенность и яркость (HSV). Численные значения этих представлений находятся под областью спектра. Вы можете вводить свои значения этих компонентов. Кроме того в центре окна внизу находится прямоугольник, закрашиваемый выбранным на данный момент цветом. Справа от него расположено поле ввода HTML:. В нем показан код текущего цвета в формате, пригодном для использования на веб-страницах.

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

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

Фон

  Цвет фона области редактирования в &kwrite;.

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

  Цвет фона выделенного текста.

### Шрифты

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

### Отступ

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

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

Отступы пробелами

  Замена символа табуляции количеством пробелов, равным ширине табуляции. Ширина табуляции задается в группе Редактирование.

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

  Возможность использовать backspace как клавишу для вставки отступов.

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

  Возможность использовать tab как клавишу для вставки отступов.

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

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

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

Статический перенос строк

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

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

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

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

  &kwrite; будет заменять символы табуляции последовательностью пробелов, длина которой задана в поле Ширина табуляции и отступов.

Ширина табуляции и отступов

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

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

  &kwrite; автоматически удалит лишние пробелы в конце строк.

Автоскобки

  Если вы введёте символ открывающей скобки ([, ( или {), &kwrite; автоматически вставит закрывающую (}, ) или ]) справа от курсора.

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

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

Page Up/Down перемещают курсор

  Этот параметр определяет реакцию курсора на нажатие клавиш Page Up и Page Down. Если флажок снят, курсор будет сохранять свою относительную позицию в видимом тексте документа. Поэтому если до нажатия клавиши курсор был в середине экрана, он там и останется после нажатия (если, конечно, не достигнет конца или начала). Если флажок установлен, первое нажатие на клавишу переместит курсор вниз или вверх экрана.

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

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

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

Число шагов отмены:

  Здесь вы можете указать количество шагов, которое &kwrite; будет хранить в памяти для выполнения отмены. Чем больше шагов указано, тем больше памяти нужно будет программе. Если вы установите например значение 10, вы сможете отменить только последние 10 действий, то есть после 10 нажатий подряд на кнопку Отменить отмена совершаться не будет.

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

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

Создавать сочетания корней/аффиксов не в словаре

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

Считать ошибкой написанные вместе одинаковые слова

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

Словарь:

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

Кодировка:

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

Клиент:

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

## Авторские права и лицензирование

(C) 2001 &kwrite;, команда разработчиков &kate;.

Программа основывается на первоначальной версии &kwrite;, созданной Йохеном Вильгельми (Jochen Wilhelmy) digisnap@cs.tu-berlin.de, 2000.

Участники проекта:

- &Christoph.Cullmann; &Christoph.Cullmann.mail;

- Майкл Бартл (Michael Bartl) michael.bartl1@chello.at

- Филип (Phlip) phlip_cpp@my-deja.com

- &Anders.Lund; &Anders.Lund.mail;

- Мэтт Ньюэлл (Matt Newell) newellm@proaxis.com

- &Joseph.Wenninger; &Joseph.Wenninger.mail;

- Йохен Вильгельми (Jochen Wilhelmy) digisnap@cs.tu-berlin.de

- &Michael.Koch; &Michael.Koch.mail;

- &Christian.Gebauer; &Christian.Gebauer.mail;

- &Simon.Hausmann; &Simon.Hausmann.mail;

- Глен Паркер (Glen Parker) glenebob@nwlink.com

- Скотт Мэнсон (Scott Manson) sdmanson@altel.net

- &John.Firebaugh; &John.Firebaugh.mail;

Оригинальная документация &Thad.McGinnis; &Thad.McGinnis.mail;

Текущая версия руководства &kwrite; основана на оригинале &Cristian.Tibirna; &Cristian.Tibirna.mail;

Преобразование в docbook и форматирование &Lauri.Watts; &Lauri.Watts.mail;

Перевод на русский - Екатерина С. Пыжова haleth@yandex.ru

Обновление перевода - Олег Баталовolegbatalov@mail.ru

&underFDL; &underGPL;

&documentation.index;