<chapter id="kdevelop-scripting">

<chapterinfo>
  <authorgroup>
    <author
><firstname
>Ian</firstname
><surname
>Geiser</surname
></author>
    <!-- ROLES_OF_TRANSLATORS -->
  </authorgroup>
</chapterinfo>

<title
>Поддержка сценариев</title>

<sect1 id="running-scripts">
<title
>Выполнение сценариев</title>
<para
>Для получения доступа к сценариям воспользуйтесь меню <menuchoice
><guimenu
>Сервис</guimenu
><guimenuitem
>Сценарии</guimenuitem
></menuchoice
>. Если его нет, значит в KDevelop не установленных сценариев. </para>
</sect1>

<sect1 id="adding-scripts">
<title
>Добавление сценариев</title>
<para
>После добавления поддержки KScript в ваше главное приложение, добавление в него сценариев становится лёгкой задачей. Сценарии состоят из двух частей  - файла .desktop, содержащего метаданные (текст пункта меню и интерпретатор), и собственно сценария. Этот подход был использован из соображений безопасности и простоты использования. </para>
<para
>Этот пример демонстрирует основные части, которые нужны KScript. Первый элемент, "Name", определяет имя сценария, показываемое пользователи, а текст элемента "Comment" будет показан во всплывающей подсказке. Наиболее важным является "Type", он определяет интерпретатор, который будет использован для сценария. На текущий момент есть два возможных варианта -  "ShellScript/bash" и "JavaScript/kjs".  нашем примере выбран первый. Сценарию передаётся два аргумента . Первый - DCOP ID (дескриптор) главного приложения. </para>

<para
>Приведенный сценарий устанавливает текст первого документа в вывод команды "ls -l"</para>

<para
>Самое полезная программа для разработки таких сценариев - KDCOP.</para>
<figure id="screenshot-kdcop" float="1">
  <title
>Работа с DCOP-интерфейсами в &kdevelop; с помощью KDCOP</title>
  <mediaobject>
    <imageobject
><imagedata fileref="kdcop_browsing.png"/></imageobject>
  </mediaobject>
</figure>

<para
>KDCOP позволяет просматривать и отлаживать интерфейсы приложений. На текущий момент KDCOP поддерживает KJSEmbed, Python и оболочки UNIX для работы с DCOP.</para>

<para
>Когда сценарий написан, осталось его установить. Разработчики основного приложения должны позаботиться об этой процедуре, или хотя бы задокументировать пути, в которых будут искаться сценарии. В примере выше, сценарий Kate расположен в "$KDEDIRS/share/apps/kate/scripts".</para>

<figure id="screenshot-scripts" float="1">
  <title
>Сценарии &kdevelop; в файловой системе</title>
  <mediaobject>
    <imageobject
><imagedata fileref="script_location.png"/></imageobject>
  </mediaobject>
</figure>

<para
>Файл .desktop должен быть в одной папке со сценарием. Разработчикам сценариев также рекомендуется хранить вспомогательные файлы, такие как файлы пользовательского интерфейса, файлы данных, в той же папке. Также заметим, что основное приложение блокируется на время выполнения сценария. но это будет изменено в KDE 4. </para>

</sect1>


</chapter>
