<chapter id="advanced-editing-tools">
<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<author
>&Dominik.Haumann; &Dominik.Haumann.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
>Дополнительные возможности редактирования</title>

<sect1 id="advanced-editing-tools-comment">

<title
>Комментирование</title>

<para
>Команды "Комментировать" и "Раскомментировать", которые доступны из меню <guimenu
>Сервис</guimenu
>, позволяют добавить или убрать маркеры комментариев для выделенного блока текста (или для текущей строки, если текст не выделен), при условии, что комментарии поддерживаются форматом редактируемого текста.</para>

<para
>Правила комментирования определяются синтаксисом; таким образом, если подсветка синтаксиса не включена, то команды "Закомментировать" и "Раскомментировать" будут недоступны. </para>

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

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

<para
>При удалении маркеров комментариев выделение снимается с раскомментированного текста. При удалении маркеров многострочного комментария пробелы снаружи маркеров игнорируются.</para>

<para
><indexterm
><primary
>закомментировать</primary
></indexterm
> Чтобы закомментировать выделенный текст (или активную строку), выберите пункт меню<menuchoice
><guimenu
>Сервис</guimenu
><guimenuitem
>Закомментировать</guimenuitem
></menuchoice
> или нажмите соответствующее сочетание клавиш (по умолчанию <keycombo action="simul"
>&Ctrl;<keycap
>D</keycap
></keycombo
>).</para>

<para
><indexterm
><primary
>раскомментировать</primary
></indexterm
> Чтобы удалить маркеры комментариев, выберите пункт меню <menuchoice
><guimenu
>Сервис</guimenu
><guimenuitem
>Раскомментировать</guimenuitem
> </menuchoice
> или нажмите соответствующее сочетание клавиш ( по умолчанию <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>D</keycap
></keycombo
>).</para>

</sect1>

<sect1 id="advanced-editing-tools-commandline">
<title
>Командная строка компонента редактора</title>

<para
>Модуль Kate имеет встроенную командную строку, позволяющую производить различные действия, оставляя интерфейс минималистским. Она представляет из себя поле ввода внизу области редактора. Для получения к ней доступа, выберите пункт меню <menuchoice
><guimenu
>Вид</guimenu
><guimenuitem
>Переключиться в командную строку</guimenuitem
></menuchoice
> или нажмите <keycombo action="simul"
><keycap
>F7</keycap
></keycombo
> (по умолчанию). Команды, доступные из неё, описаны ниже, кроме того, модули могут предоставлять свои дополнительные команды.</para>

<para
>To execute a command, type the command then press the return key. The command line will indicate whether it succeeded and possibly display a message. If you entered the command line by pressing <keycap
>F7</keycap
> it will automatically hide after a few seconds. To clear the message and enter a new command, press <keycap
>F7</keycap
> again.</para>

<para
>Вы всегда можете получить справку с помощью команды <command
>help</command
>. Для получение списка всех доступных команд, введите <command
>help list</command
>, для просмотра справки по определённой команде - <command
>help <replaceable
>команда</replaceable
></command
>.</para>

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

<sect2 id="advanced-editing-tools-commandline-commands">
<title
>Стандартные команды</title>

<sect3 id="advanced-editing-tools-commandline-commands-configure">
<title
>Параметры редактора</title>

<para
>Установленные таким способом параметры применяются только к текущему экземпляру редактора и не сохраняются. Удобно, если нужно установить параметры, отличные от стандартных (например, отступ). </para>

<variablelist>
<title
>Типы аргументов</title>

<varlistentry>
<term
>BOOLEAN</term>
<listitem
><para
>Используется для команд включения/выключения. Допустимые значения - <userinput
>on</userinput
>, <userinput
>off</userinput
>, <userinput
>true</userinput
>, <userinput
>false</userinput
>, <userinput
>1</userinput
> или <userinput
>0</userinput
></para
></listitem>
</varlistentry>

<varlistentry>
<term
>INTEGER</term>
<listitem
><para
>Целое число</para
></listitem>
</varlistentry>

<varlistentry>
<term
>STRING</term>
<listitem
><para
>Строка</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>

<varlistentry>
<term
><cmdsynopsis
><command
>set-tab-width</command
><arg
>INTEGER width</arg
></cmdsynopsis
></term>
<listitem
><para
>Устанавливает расстояние между позициями табуляции</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-indent-width</command
><arg
>INTEGER width</arg
></cmdsynopsis
></term>
<listitem
><para
>Устанавливает ширину отступа. Только при создании отступов пробелами.</para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><cmdsynopsis
><command
>set-icon-border</command
><arg
>BOOLEAN enable</arg
> </cmdsynopsis
></term>
<listitem
><para
>Устанавливает видимость рамок пиктограмм.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-folding-markers</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Устанавливает видимость маркеров сворачивания блоков кода.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-line-numbers</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Устанавливает видимость нумерации строк.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-replace-tabs</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Заменять при вводе символы табуляции на пробелы. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-remove-trailing-space</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Удалять пробелы в конце строки при снятии с неё курсора.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-show-tabs</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Представлять символы табуляции пробельное пространство в конце строк маленькими точками.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-indent-spaces</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Вставлять заданное количество пробелов для каждого уровня отступа, вместо одного символа табуляции.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-mixed-indent</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Использовать для отступов как символы табуляции, так и пробелы. Это реализуется путём замены пробелов в количестве, кратном ширине символа табуляциями, на последние.</para>
<para
>Эта команда также включит расстановку отступов пробелами, и установит ширину отступов, если она не указана, в половину значения <option
>tab-width</option
> (для текущего документа на время выполнения).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-word-wrap</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Динамический перенос слов</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-replace-tabs-save</command
><arg
>BOOLEAN enable </arg
></cmdsynopsis
></term>
<listitem
><para
>Заменять символы табуляции на пробелы при сохранении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-remove-trailing-space-save</command
><arg
>BOOLEAN enable</arg
></cmdsynopsis
></term>
<listitem
><para
>Удалить пробелы в конце строк при сохранении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-indent-mode</command
><arg
>name</arg
></cmdsynopsis
></term>
<listitem
><para
>Выбрать режим расстановки отступов. Параметр <userinput
>name</userinput
> может иметь следующие значения: 'cstyle', 'csands', 'xml', 'python', 'varindent' и 'none'. При других значениях используется 'none'.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-highlight</command
><arg
>highlight</arg
></cmdsynopsis
></term>
<listitem
><para
>Выбрать формат для подсветки, один из содержащихся в подменю<menuchoice
><guimenu
>Сервис</guimenu
><guisubmenu
>Подсветка синтаксиса</guisubmenu
></menuchoice
>. Доступно также автозавершение параметра.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="advanced-editing-tools-commandline-commands-edit">
<title
>Команды редактирования</title>

<para
>Команды, которые непосредственно изменяют текущий документ.</para>

<variablelist>
<varlistentry>
<term
><cmdsynopsis
><command
>indent</command
></cmdsynopsis
></term>
<listitem
><para
>Подставляет отступы к выделенным строкам или к текущей.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>unindent</command
></cmdsynopsis
></term>
<listitem
><para
>Снимает отступы с выделенных строк или с текущей.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>cleanindent</command
></cmdsynopsis
></term>
<listitem
><para
>Очистить отступы в выделенных строках или в текущей в соответствии с параметрами расстановки отступов для текущего документа. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>comment</command
></cmdsynopsis
></term>
<listitem
><para
>Вставляет маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла (определяется способом подсветки синтаксиса).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>uncomment</command
></cmdsynopsis
></term>
<listitem
><para
>Удалить маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>kill-line</command
></cmdsynopsis
></term>
<listitem
><para
>Удаляет текущую строку.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace</command
><arg
>pattern</arg
><arg
>replacement</arg
></cmdsynopsis
></term>
<listitem
><para
>Заменить текст, совпадающий с <userinput
>pattern</userinput
> на <userinput
>replacement</userinput
>. Для включения пробелов в <userinput
>pattern</userinput
>, нужно заключить в двойные или одинарныекавычки и <userinput
>pattern</userinput
>, и <userinput
>replacement</userinput
>. Если аргументы не заключены в кавычки, первое слово будет принято за <userinput
>pattern</userinput
>, а остальное - за <userinput
>replacement</userinput
>. Если <userinput
>replacement</userinput
> не задать, все <userinput
>pattern</userinput
> будут удалены.</para>
<para
>Для настройки параметров поиска, нужно указать соответствующие флаги после двоеточия (<userinput
>replace:options pattern replacement</userinput
>). Возможные параметры: <variablelist>

<varlistentry>
<term
><userinput
>b</userinput
></term>
<listitem
><para
>Искать в обратном направлении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>c</userinput
></term>
<listitem
><para
>Искать от позиции курсора.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>e</userinput
></term>
<listitem
><para
>Искать только в выделенном тексте.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>r</userinput
></term>
<listitem
><para
>Аргумент <userinput
>pattern</userinput
> - регулярное выражение. Вы можете использовать <userinput
>\N</userinput
> в <userinput
>replacement</userinput
> для получения N-ной подстроки найденного текста.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>s</userinput
></term>
<listitem
><para
>С учётом регистра.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>p</userinput
></term>
<listitem
><para
>Подтверждать каждую замену.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>w</userinput
></term>
<listitem
><para
>Только целые слова.</para
></listitem>
</varlistentry>

</variablelist>

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

<varlistentry>
<term
><cmdsynopsis
><command
>date</command
><arg
>format</arg
></cmdsynopsis
></term>
<listitem
><para
>Вставить строку с датой/временем в указанном формате (задаётся параметром <userinput
>format</userinput
>), или в <quote
>yyyy-MM-dd hh:mm:ss</quote
>, если параметр упущен. Доступны следующие подстановки: <informaltable
> <tgroup cols="2"
> <tbody>
<row
><entry
><literal
>d</literal
></entry
><entry
>Номер дня в месяце без ведущего нуля (1-31).</entry
></row>
<row
><entry
><literal
>dd</literal
></entry
><entry
>Номер дня в месяце с ведущим нулём (01-31).</entry
></row>
<row
><entry
><literal
>ddd</literal
></entry
><entry
>Сокращённое название дня недели ('Пн'..''Вс, 'Mon'..'Sun').</entry
></row>
<row
><entry
><literal
>dddd</literal
></entry
><entry
>Полное названия дня недели ('Понедельник'..'Воскресенье', 'Monday'..'Sunday').</entry
></row>
<row
><entry
><literal
>M</literal
></entry
><entry
>Номер месяца без ведущего нуля (1-12).</entry
></row>
<row
><entry
><literal
>MM</literal
></entry
><entry
>Номер месяца с ведущим нулём (01-12).</entry
></row>
<row
><entry
><literal
>MMM</literal
></entry
><entry
>Сокращённое название месяца ('Янв'..'Дек', 'Jan'..'Dec').</entry
></row>
<row
><entry
><literal
>yy</literal
></entry
><entry
>Год двумя цифрами (00-99).</entry
></row>
<row
><entry
><literal
>yyyy</literal
></entry
><entry
>Год четырьмя цифрами (1752-8000).</entry
></row>
<row
><entry
><literal
>h</literal
></entry
><entry
>Час без ведущего нуля (0..23 или 1..12, в зависимости от настроек).</entry
></row>
<row
><entry
><literal
>hh</literal
></entry
><entry
>Час с ведущим нулём (00..23 or 01..12, в зависимости от настроек).</entry
></row>
<row
><entry
><literal
>m</literal
></entry
><entry
>Минуты без ведущего нуля (0..59).</entry
></row>
<row
><entry
><literal
>mm</literal
></entry
><entry
>Минуты с ведущим нулём (00..59).</entry
></row>
<row
><entry
><literal
>s</literal
></entry
><entry
>Секунды без ведущего нуля (0..59).</entry
></row>
<row
><entry
><literal
>ss</literal
></entry
><entry
>Секунды с ведущим нулём (00..59).</entry
></row>
<row
><entry
><literal
>z</literal
></entry
><entry
>Миллисекунды без ведущих нулей (0..999).</entry
></row>
<row
><entry
><literal
>zzz</literal
></entry
><entry
>Миллисекунды с ведущими нулями (000..999).</entry
></row>
<row
><entry
><literal
>AP</literal
></entry
><entry
>Использовать 12-часовый формат часов. AP будет заменено на "AM" или "PM".</entry
></row>
<row
><entry
><literal
>ap</literal
></entry
><entry
>Использовать 12-часовый формат часов. ap будет заменено на "am" или "pm".</entry
></row>

</tbody>
</tgroup>
</informaltable>

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

<varlistentry>
<term
><cmdsynopsis
><command
>char</command
><arg
>identifier</arg
></cmdsynopsis
></term>
<listitem>
<para
>Эта команда позволяет вставить символ по его числовому идентификатору в десятичной, восьмеричной или шестнадцатеричной системах счисления. Чтобы использовать её, откройте диалоговое окно "Команда правки" и наберите <userinput
>char: [number]</userinput
> в строке ввода, после чего нажмите кнопку <guibutton
>OK</guibutton
>.</para>

<example>
<title
>Примеры использования команды <command
>char</command
></title>

<para
>Введите: <userinput
>char:234</userinput
></para>
<para
>Получите: <computeroutput
>&#234;</computeroutput
></para>
<para
>Введите: <userinput
>char:0x1234</userinput
></para>
<para
>Получите: <computeroutput
>&#x1234;</computeroutput
></para>
</example>

</listitem>
</varlistentry>

<varlistentry>
<term>
<indexterm
><primary
>замена в стиле sed</primary>
<secondary
>поиск в стиле sed</secondary
></indexterm>
<command
>s///[ig]</command
> <command
>%s///[ig]</command
></term>

<listitem>
<para
>"Типичный пользователь" при виде этих команд обязательно вздрогнет и начнёт искать на клавиатуре кнопку "Windows". В самом деле, кому придёт в голову искать текст подобным образом? Но вы же не "типичный", не так ли? Поэтому попробуем разобраться в этих двух sed-подобных командах. Первая выполняет поиск/замену в текущей строке, вторая -- во всём файле (<command
>%s///</command
>).</para>

<para
>Вкратце, команды производят поиск текста, заданного <emphasis
>маской поиска</emphasis
> -- регулярным выражением (regexp) между первой и второй наклонной чертой, и, при нахождении, выполняет замену выражением, которое задано между второй и третьей чертой. Круглые скобки в маске поиска позволяют задать подстроки в найденном тексте, на которые можно потом ссылаться в выражении замены. Обратная ссылка -- это регулярное выражение, которое при совпадении заменяется на фактический текст и может быть использовано в шаблоне замены. Для этого, в нужном месте поставьте обратную черту, а за ней номер подстроки по порядку (<userinput
>\1</userinput
> -- для первой пары скобок, <userinput
>\2</userinput
> -- для второй, и т. д.).</para>

<para
>Чтобы искать сами скобки <literal
>(</literal
> или <literal
>)</literal
>, нужно предварить их обратной чертой: <userinput
>\(\)</userinput
></para>

<para
>Если в самом конце указать <userinput
>i</userinput
>, поиск будет проводиться с учётом регистра, а если <userinput
>g</userinput
> - будут заменены все вхождения текста, совпадающего с регулярным выражением, иначе - только первое.</para>

<example>

<title
>Замена текста в текущей строке</title>

<para
>Будучи противником принципа "разделяй и властвуй", вы решили откомпилировать свою программу. Но компилятор начал на вас ругаться: класс <classname
>myClass</classname
>, упомянутый в строке 3902, не определён.</para>

<para
>&quot;Чёрт!&quot;, - думаете вы, -- &quot;да это же мой класс <classname
>MyClass</classname
>&quot;. Вы добираетесь до строки 3902 и, вместо того, чтобы пытаться искать слово в этой длинной строке (а кто сейчас укладывает каждую строчку кода в 60 символов?), вы запускаете диалоговое окно "Команда правки", вводите <userinput
>s/myclass/MyClass/i</userinput
>, жмёте <guibutton
>OK</guibutton
>, сохраняете и компилируйте -- успешно и без ошибок.</para>

</example>

<example>
<title
>Замена текста во всём файле</title>

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

<para
>Вызовите командную строку и введите следующий текст: <userinput
>%s/госпожа Иванова/госпожа Петрова/</userinput
> -- и ваша работа сделана.</para>

</example>

<example>
<title
>Более сложный пример</title>

<para
>Этот пример показывает, как пользоваться <emphasis
>обратными ссылками</emphasis
> и <emphasis
>классами символов</emphasis
> (если вы не знаете, что это такое, советуем ознакомиться с приведенными ниже разделами).</para>

<para
>Допустим, у вас набрана такая строка: <programlisting
>void MyClass::DoStringOps( String      &amp;foo, String &amp;bar String *p, int  &amp;a, int &amp;b )</programlisting>
</para>
<para
>Теперь вы думаете, что это недостаточно "красивый" код, и решаете, что вам нужно использовать ключевое слово <constant
>const</constant
> с параметрами, передаваемыми по ссылке (теми, перед которыми стоит амперсанд). Вы также хотите удалить лишние пробелы.</para>

<para
>Запустите диалоговое окно "Команда правки" и наберите: <userinput
>s/\s+(\w+)\s+(&amp;)/ const \1 \2/g</userinput
>, и не забудьте нажать кнопку <guibutton
>OK</guibutton
> -- иначе ничего не выйдет. Символ <userinput
>g</userinput
> в конце команды указывает компилятору "пересчитывать" регулярное выражение обратной ссылки каждый раз, когда встречаются совпадения.</para>

<para
>Вывод: <computeroutput
>void MyClass::DoStringOps( const String &amp;foo, const String &amp;bar String *p, const int &amp;a, const int &amp;b )</computeroutput
></para>

<para
>Миссия завершена! Ну, и что же произошло? Мы искали некоторое количество пробелов (<literal
>\s+</literal
>), за которыми идут несколько латинских символов (<literal
>\w+</literal
>), следом за ними опять несколько пробелов (<literal
>\s+</literal
>), после которых стоит амперсанд, и по ходу дела сохраняли эти алфавитные символы и амперсанд для использования их в операции замены. После этого мы заменили совпадающие части строки следующей последовательностью: один пробел, за которым идёт спецификатор <quote
>const</quote
>, за ним ещё один пробел, после которого наши сохранённые символы (<literal
>\1</literal
>), ещё один пробел и сохранённый амперсанд (<literal
>\2</literal
>)</para>

<para
>В одном случае латинские символы составили слово <quote
>String</quote
>, в другом -- слово <quote
>int</quote
>, т.е. символьный класс <literal
>\w</literal
> с последующим знаком <literal
>+</literal
> определяет символьный набор произвольной длины.</para>

</example>

</listitem>

</varlistentry>

</variablelist>

</sect3>

<sect3 id="advanced-editing-tools-commandline-commands-navigation">
<title
>Команды навигации</title>

<variablelist>

<varlistentry>
<term
><cmdsynopsis
><command
>goto</command
><arg
>INT line</arg
></cmdsynopsis
></term>
<listitem
><para
>Перейти к указанной строке.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>find</command
><arg
>pattern</arg
></cmdsynopsis
></term>
<listitem
><para
>Перейти к первому образцу, заданному параметром <userinput
>pattern</userinput
>. Последующие вхождения образца можно найти посредством пункта меню <menuchoice
><guimenu
>Правка</guimenu
><guimenuitem
>Найти далее</guimenuitem
></menuchoice
> (клавиша по умолчанию - <keycap
>F3</keycap
>).</para>
<para
>Параметры команды поиска можно задавать добавлением двоеточия и "флагов" после её имени (<userinput
>find:options pattern</userinput
>). Флаги - набор из следующих букв: <variablelist>

<varlistentry>
<term
><userinput
>b</userinput
></term>
<listitem
><para
>Искать в обратном направлении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>c</userinput
></term>
<listitem
><para
>Искать от позиции курсора.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>e</userinput
></term>
<listitem
><para
>Искать только в выделенном тексте.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>r</userinput
></term>
<listitem
><para
>Аргумент <userinput
>pattern</userinput
> - регулярное выражение. Вы можете использовать <userinput
>\N</userinput
> в <userinput
>replacement</userinput
> для получения N-ной подстроки найденного текста.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>s</userinput
></term>
<listitem
><para
>С учётом регистра.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>w</userinput
></term>
<listitem
><para
>Только целые слова.</para
></listitem>
</varlistentry>

</variablelist>

</para>

</listitem>

</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>ifind</command
><arg
>pattern</arg
></cmdsynopsis
></term>
<listitem
><para
>Поиск по мере набора. Поддерживается установка дополнительных флагов <variablelist>
<varlistentry>
<term
><userinput
>b</userinput
></term>
<listitem
><para
>Искать в обратном направлении.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>r</userinput
></term>
<listitem
><para
>Поиск по регулярному выражению.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>s</userinput
></term>
<listitem
><para
>С учётом регистра.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>c</userinput
></term>
<listitem
><para
>Искать от позиции курсора.</para
></listitem>
</varlistentry>

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

</variablelist>

</sect3>

</sect2>

</sect1>

<sect1 id="advanced-editing-tools-code-folding">
<title
>Использование сворачивания кода</title>

<para
>Сворачивание кода позволяет скрывать участки документа в редакторе, упрощая осмотр громоздких документов. В &kate; разделение на сворачиваемые участки определяется правилами подсветки синтаксиса, следовательно, доступно не для всех форматов файлов. В основном, сворачивание кода доступно в режиме написания исходного кода, XML-разметки и т.п. Большинство способов подсветки позволяют также самостоятельно определять скрываемые области, чаще всего используя ключевые слова <userinput
>BEGIN</userinput
> и <userinput
>END</userinput
>.</para>

<para
>Для того чтобы включить/отключить функцию сворачивания, выберите пункт меню <menuchoice
><guimenu
>Вид</guimenu
><guimenuitem
>Показать маркеры сворачивания</guimenuitem
></menuchoice
>. На панели маркеров сворачивания с левой стороны документа появится графическое представление сворачиваемых участков. Стрелка вниз показывает, что участок развёрнут, стрелка вверх обозначает свёрнутый участок. Щелчок на стрелке вверх приведёт к  разворачиванию свёрнутого участка, и наоборот (с одновременным изменением графического представления).</para>

<para
>Для управления состоянием сворачиваемых участков служат четыре команды, смотрите <link linkend="view-code-folding"
>справку по меню</link
>. </para>

<para
>Если вы не хотите использовать функцию сворачивания, можно отключить параметр <guilabel
>Показать маркеры сворачивания (если доступны)</guilabel
> на <link linkend="appearance"
>странице настройки внешнего вида редактора</link
></para>

</sect1>

<sect1 id="advanced-editing-tools-scripting">

<title
>Написание сценариев Javascript в компоненте редактора</title>

<sect2 id="advanced-editing-tools-scripting-introduction">

<title
>Введение</title>

<para
>Начиная с версии 2.5, компонент редактора &kate; поддерживает написание сценариев на языке ECMA, известном также как JavaScript.</para>

<para
>Сценарии можно вызывать только из <link linkend="advanced-editing-tools-commandline"
> встроенной командной строки</link
>. При этом необходимо, чтобы сценарий и файл .desktop (если он существует) находились в той папке, в которой &kate; сможет их разыскать. Подходящая папка для этого - <filename
>katepart/scripts</filename
> в папках данных &kde;. Найти папки данных можно командой <command
>kde4-config <option
>--path</option
> <parameter
>data</parameter
></command
>. Как правило, существуют системная и пользовательские папки данных. Естественно, сценарии в системных папках доступны всем пользователям системы, а в пользовательских - только их владельцам.</para>

<note
><para
>Эта функциональность находится на экспериментальной стадии разработки, весьма вероятно его изменение в дальнейшем.</para>
<para
>Сценарии нельзя добавлять в меню или назначать им комбинации клавиш. Может быть, в дальнейшем мы сможем это исправить.</para>
<para
>Также невозможно использовать в сценариях аргументы. Потерпите, в светлом будущем это вполне может произойти ;)</para>
</note>

</sect2>

<sect2 id="advanced-editing-tools-scripting-reference">

<title
>Программный интерфейс (API) Kate JavaScript</title>

<para
>Здесь приведен полный список функций и свойств, доступных для объектов <type
>document</type
> и <type
>view</type
>. Разумеется, доступны любые стандартные объекты языка, такие как <type
>Math</type
>, <type
>String</type
>, <type
>Regex</type
> и т.д.</para>

<para
>Во время исполнения сценария, объектом <classname
>document</classname
> является текущий документ, а объектом <classname
>view</classname
> является текущий вид (панель).</para>

<note
><para
>Конечно, в настоящее время типы аргументов в JavaScript не используются, они просто информируют, какие виды значений ожидаются функциями.</para
></note>

<variablelist id="advanced-editing-tools-scripting-global">
<title
>Глобальные функции</title>
<varlistentry>
<term
><function
>debug( <parameter
><replaceable
>string</replaceable
></parameter
>) [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>параметры</title>
<listitem
><para
><parameter
>string</parameter
> выводимая строка</para>
</listitem>
</itemizedlist>
<para
>Выводит строку на <acronym
>STDERR</acronym
>, используя <function
>kDebug()</function
>. Для вывода используется выделенное пространство, в начало может быть добавлен префикс <computeroutput
>Kate (KJS Scripts):</computeroutput
> </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist id="advanced-editing-tools-scripting-document">
<title
>Программный интерфейс (API) класса <classname
>document</classname
></title>

<varlistentry>
<term
><function
>document.attribute( <parameter
><replaceable
>line</replaceable
> </parameter
>, <parameter
><replaceable
>column</replaceable
></parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>uint line</parameter
> Строка, в которой находится атрибут.</para
></listitem>
<listitem
><para
><parameter
>uint column</parameter
> Столбец, в котором находится атрибут.</para
></listitem>
</itemizedlist>
<para
>Возвращает числовые значения позиции атрибута в документе [<parameter
>line</parameter
>,<parameter
>column</parameter
>]. Атрибут представляет собой вид или стиль текста, а также используется для определения подсветки синтаксиса в различных частях текста смешанных форматов вроде HTML или PHP.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.canBreakAt( <parameter
>Char c</parameter
>, <parameter
>uint attribute</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>c</parameter
> Знак для проверки</para
></listitem>
<listitem
><para
><parameter
>attribute</parameter
> Атрибут для позиции <parameter
>c</parameter
>.</para
></listitem>
</itemizedlist>
<para
> Возвращает допустимость разрыва строки на знаке c с атрибутом attribute. Результат зависит от того, какие атрибуты допускают разрыв строки без потери принадлежности подсветки.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.canComment( <parameter
>uint start_attribute</parameter
>, <parameter
>uint end_attribute</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>start_attribute</parameter
> Атрибут начала участка комментария.</para
></listitem>
<listitem
><para
><parameter
>end_attribute</parameter
> Атрибут конца участка комментария.</para
></listitem>
</itemizedlist>
<para
>Возвращает принадлежность start_attribute и end_attribute к одной и той же системе подсветки синтаксиса. Если это так - всё нормально. </para>
<example>
<title
>использование canComment</title>
<programlisting
>if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) {
    // 1,0 и 5,0 принадлежат к одной системе подсветки синтаксиса
}
</programlisting>
</example>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.clear(); [функция]</function
></term>
<listitem
><para
>Очищает документ.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.commentStart( <parameter
>uint attribute</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>attribute</parameter
> Атрибут текста, для которого вводится строка commentStart.</para
></listitem>
</itemizedlist>
<para
>Возвращает строку, необходимую для начала многострочного комментария к тексту с атрибутом, или пустую строку, если в этом тексте не поддерживаются многострочные комментарии.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.commentMarker( <parameter
>uint attribute</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>attribute</parameter
> Атрибут текста, для которого вводится строка commentMarker</para
></listitem>
</itemizedlist>
<para
>Возвращает пометку остатка строки как комментария к тексту с атрибутом, либо пустую строку для текста, в котором не поддерживаются комментарии в той же строке.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.commentEnd( <parameter
>uint attribute</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>attribute</parameter
> Атрибут текста, для которого вводится строка commentEnd</para
></listitem>
</itemizedlist>
<para
>Возвращает строку, необходимую для окончания многострочного комментария к тексту с атрибутом, либо пустую строку для текста, в котором многострочные комментарии не поддерживаются.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.editBegin(); [функция]</function
></term>
<listitem>
<para
>Начало группы редактирования. Все действия включаются в одну группу отмены до вызова editEnd().</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.editEnd(); [функция]</function
></term>
<listitem>
<para
>Окончание группы редактирования.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.highlightMode; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Название режима подсветки (JavaScript или C++). Если к документу не применяется режим подсветки, устанавливается значение None. Помните - необходимо использовать англоязычное название.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.indentMode; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Название режима отступов документа, такое как <literal
>normal</literal
> или <literal
>cstyle</literal
>. Помните - если режим отступов не задан, устанавливается значение <literal
>none</literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.indentWidth; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Устанавливает ширину отступа. Только при создании отступов пробелами.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.insertLine( <parameter
>uint line</parameter
>, <parameter
>string text</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>line</parameter
> номер строки в документе</para>
</listitem>
<listitem
><para
><parameter
>text</parameter
> вставляемый текст</para
></listitem>
</itemizedlist>
<para
>Вставляет новую строку с текстом <parameter
>text</parameter
> в строку под номером <parameter
>line</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.insertText( <parameter
>uint line</parameter
>, <parameter
>uint column</parameter
>, <parameter
>string text</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>line</parameter
> номер строки</para
></listitem>
<listitem
><para
><parameter
>column</parameter
> номер столбца</para
></listitem>
<listitem
><para
><parameter
>text</parameter
> вставляемый текст</para
></listitem>
</itemizedlist>
<para
>Вставляет текст <parameter
>text</parameter
> в строку номер <parameter
>line</parameter
>, столбец номер <parameter
>column</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>document.length(); [функция]</term>
<listitem>
<para
>Возвращает размер документа в байтах.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.lines(); [функция]</function
></term>
<listitem>
<para
>Возвращает число строк в документе.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>document.mixedIndent; [свойство:только для чтения]</term>
<listitem>
<para
>Логическая величина. Сообщает, применяется ли в документе смешанный тип отступов. Если это так - отступы осуществляются при помощи и пробелов, и позиций табуляции, сходно с редактором Emacs.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>document.removeLine( <parameter
>uint line</parameter
> ); [функция]</term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>line</parameter
> номер строки</para
></listitem>
</itemizedlist>
<para
>Удаляет строку документа номер line.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.removeText( <parameter
>uint startLine</parameter
>, <parameter
>uint startColumn</parameter
>, <parameter
>uint endLine</parameter
>, <parameter
>uint endColumn</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>startLine</parameter
> указывает начальную строку</para
></listitem>
<listitem
><para
><parameter
>startColumn</parameter
> указывает начальный столбец</para
></listitem>
<listitem
><para
><parameter
>endLine</parameter
> указывает конечную строку</para
></listitem>
<listitem
><para
><parameter
>endColumn</parameter
> указывает конечный столбец</para
></listitem>
</itemizedlist>
<para
>Удаляет участок текста, начиная от строки номер <parameter
>startLine</parameter
> и столбца номер <parameter
>startColumn</parameter
> до строки номер <parameter
>endLine</parameter
> и столбца номер <parameter
>endColumn</parameter
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.setText( <parameter
>string text</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>text</parameter
> текст документа</para
></listitem>
</itemizedlist>
<para
>Приводит всё содержимое документа к тексту с параметрами <parameter
>text</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.spaceIndent; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Логическая величина. Сообщает, применяется ли к документу отступ пробелами. Если это так, то отступы в документе производятся на величину indentWidth между уровнями, иначе сдвиг происходит на одну позицию табуляции.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.textFull(); [функция]</function
></term>
<listitem>
<para
>Возвращает весь текст документа. Если в тексте есть переводы строк, то знак перевода строки отобразится как <constant
>\n</constant
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.textLine( uint line ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>line</parameter
> строка номер</para
></listitem>
</itemizedlist>
<para
>Возвращает текст строки номер <parameter
>line</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>document.textRange( <parameter
>uint startLine</parameter
>, <parameter
>uint startColumn</parameter
>, <parameter
>uint endLine</parameter
>, <parameter
>uint endColumn</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>startLine</parameter
> указывает начальную строку</para
></listitem>
<listitem
><para
><parameter
>startColumn</parameter
> указывает начальный столбец</para
></listitem>
<listitem
><para
><parameter
>endLine</parameter
> указывает конечную строку</para>
</listitem>
<listitem
><para
><parameter
>endColumn</parameter
> указывает конечный столбец</para
></listitem>
</itemizedlist>
<para
>Возвращает указанный участок текста. Если в пределах участка есть переводы строк, то знак перевода отобразится как <constant
>\n</constant
>.</para>
</listitem>
</varlistentry>

</variablelist
><!--/ document API -->

<variablelist id="advanced-editing-tools-scripting-view">
<title
>Аппаратно-программный интерфейс (API) <classname
>view</classname
></title>

<varlistentry>
<term
><function
>view.clearSelection(); [функция]</function
></term>
<listitem>
<para
>Снимает выделение со всего текста.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.cursorColumn(); [функция]</function
></term>
<listitem>
<para
>Возвращает столбец, в котором находится курсор (учитываются все знаки табуляции).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.cursorColumnReal(); [функция]</function
></term>
<listitem>
<para
>Возвращает номер столбца, в котором реально находится курсор (знак табуляции считается за один символ).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.cursorLine(); [функция]</function
></term>
<listitem>
<para
>Возвращает номер строки, в которой находится курсор.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.hasSelection(); [функция]</function
></term>
<listitem>
<para
>Если выделенный текст есть, возвращает <constant
>true</constant
>, иначе <constant
>false</constant
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.removeSelectedText(); [функция]</function
></term>
<listitem>
<para
>Если есть выделенный текст, он удаляется.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.selectAll(); [функция]</function
></term>
<listitem>
<para
>Выделяет весь текст.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.selection(); [функция]</function
></term>
<listitem>
<para
>Возвращает выделенный текст. Если в пределах выделенного текста есть переводы строк, они отображаются знаком <constant
>\n</constant
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.selectionEndColumn; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Возвращает номер последней позиции выделяемого участка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.selectionEndLine; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Возвращает номер последней строки выделяемого участка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.selectionStartColumn; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Возвращает номер начальной позиции выделяемого участка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.selectionStartLine; [свойство:только для чтения]</function
></term>
<listitem>
<para
>Возвращает номер начальной строки выделяемого участка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.setCursorPosition( <parameter
>uint line</parameter
>, <parameter
>uint column</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>line</parameter
> Указывает строку для курсора.</para
></listitem>
<listitem
><para
><parameter
>column</parameter
> Указывает столбец для курсора.</para
></listitem>
</itemizedlist>
<para
>Устанавливает курсор ввода в позицию [<parameter
>line</parameter
>, <parameter
>col</parameter
>]. Установка курсора происходит визуально, символ табуляции считается за несколько символов, в зависимости от расположения текста, но не больше значения параметра <guilabel
>Ширина табуляции</guilabel
>. Отсчёт номеров строк и столбцов начинается от нуля.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.setCursorPositionReal( <parameter
>uint line</parameter
>, <parameter
>uint column</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>line</parameter
> Указывает строку для курсора.</para
></listitem>
<listitem
><para
><parameter
>column</parameter
> Указывает столбец для курсора.</para
></listitem>
</itemizedlist>
<para
>Устанавливает курсор в позицию [<parameter
>line</parameter
>, <parameter
>col</parameter
>]. При рассчёте позиции табуляция соответствует одному символу. Отсчёт строк и столбцов начинается от нуля.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><function
>view.setSelection( <parameter
>uint startLine</parameter
>, <parameter
>uint startColumn</parameter
>, <parameter
>uint endLine</parameter
>, <parameter
>uint endColumn</parameter
> ); [функция]</function
></term>
<listitem>
<itemizedlist>
<title
>Параметры</title>
<listitem
><para
><parameter
>startLine</parameter
> указывает начальную строку</para
></listitem>
<listitem
><para
><parameter
>startColumn</parameter
> указывает начальный столбец</para
></listitem>
<listitem
><para
><parameter
>endLine</parameter
> указывает конечную строку</para
></listitem>
<listitem
><para
><parameter
>endColumn</parameter
> указывает конечный столбец</para
></listitem>
</itemizedlist>
<para
>Устанавливает выделение от строки номер <parameter
>startLine</parameter
> и столбца номер <parameter
>startColumn</parameter
> до строки номер <parameter
>endLine</parameter
> и столбца номер <parameter
>endColumn</parameter
>.</para>
</listitem>
</varlistentry>

</variablelist>

<example id="advanced-editing-tools-scripting-example">

<title
>Пример сценария</title>
<para
>В качестве примера рассмотрим небольшой сценарий, переводящий выделенный текст в верхний регистр. Очевидно, сначала необходимо проверить, есть ли выделенный текст вообще. Если есть - возьмём этот текст, изменим регистр и заменим его новым текстом. Сценарий будет выглядеть примерно так:</para>

<programlisting
>if ( view.hasSelection() )
{
  column = view.selectionStartColumn;
  line = view.selectionStartLine;

  selection = view.selection().toUpperCase();

  document.editBegin();
  view.removeSelectedText();
  document.insertText( line, column, selection );
  document.editEnd();
}
</programlisting>

<para
>Для группировки действий так, чтобы их можно было отменить одним вызовом пункта меню <guimenuitem
>Отмена</guimenuitem
>, мы поместили строки <programlisting
>view.removeSelectedText()</programlisting
> и <programlisting
>document.insertText()</programlisting
> между <programlisting
>document.editBegin()</programlisting
> и <programlisting
>document.editEnd()</programlisting
>.</para>

</example>

<example id="advanced-editing-tools-desktop-example">
<title
>Пример файла <filename
>.desktop</filename
></title>

<para
>Вот пример простого .desktop-файла, соответствующего приведенному выше сценарию.</para>

<programlisting
>[Desktop Entry]
Encoding=UTF-8
Name=Kate Part JavaScript Uppercase
Comment=Script to uppercase the selection
X-Kate-Command=uppercase-selection
X-Kate-Help=&lt;p&gt;Usage: &lt;code&gt;uppercase-selection&lt;/code&gt;&lt;/p&gt;
</programlisting>

<para
>Мы видим, что здесь можно определить кодировку, ввести название, комментарий, указать путь к справке с помощью X-Kate-Help и название для командной строки через X-Kate-Command. Если файлы находятся в SVN-хранилище KDE, то пункты Name, Comment and X-Kate-Help автоматически переводятся на другие языки командами переводчиков KDE.</para>

</example>

<sect3>
<title
>Резюме</title>

<para
>&kate; может разыскивать в определённых папках (см. <link linkend="advanced-editing-tools-scripting-introduction"
>выше</link
>) файлы <filename
>*.js</filename
>. Для каждого найденного файла будет проведен поиск соответствующего файла <filename
>.desktop</filename
>, например файлу uppercase.js соответствует файл uppercase.desktop. </para>
<para
>Если требуемый файл <filename
>.desktop</filename
> не найден, сценарий будет зарегистрирован в командной строке katepart с именем без расширения .js, для нашего примера это будет <literal
>uppercase</literal
>.Если такое формирование названия команды подходит, и вам не требуются какие-то дополнительные возможности, которые предоставляет файл <filename
>.desktop</filename
>, он может не понадобиться вам совсем. </para>
<para
>Если файл <filename
>.desktop</filename
> найден, то katepart считывает имя из пункта .desktop-файла X-Kate-Command, например X-Kate-Command=uppercase-selection.</para>

</sect3>

</sect2>

</sect1>

</chapter>
