docs/kdevelop/kdevelop/kdevelop-scripting.docbook

   1 <chapter id="kdevelop-scripting">
   2
   3 <chapterinfo>
   4   <authorgroup>
   5     <author
   6 ><firstname
   7 >Ian</firstname
   8 ><surname
   9 >Geiser</surname
  10 ></author>
  11     <!-- ROLES_OF_TRANSLATORS -->
  12   </authorgroup>
  13 </chapterinfo>
  14
  15 <title
  16 >Поддержка сценариев</title>
  17
  18 <sect1 id="running-scripts">
  19 <title
  20 >Выполнение сценариев</title>
  21 <para
  22 >Для получения доступа к сценариям воспользуйтесь меню <menuchoice
  23 ><guimenu
  24 >Сервис</guimenu
  25 ><guimenuitem
  26 >Сценарии</guimenuitem
  27 ></menuchoice
  28 >. Если его нет, значит в KDevelop не установленных сценариев. </para>
  29 </sect1>
  30
  31 <sect1 id="adding-scripts">
  32 <title
  33 >Добавление сценариев</title>
  34 <para
  35 >После добавления поддержки KScript в ваше главное приложение, добавление в него сценариев становится лёгкой задачей. Сценарии состоят из двух частей  - файла .desktop, содержащего метаданные (текст пункта меню и интерпретатор), и собственно сценария. Этот подход был использован из соображений безопасности и простоты использования. </para>
  36 <para
  37 >Этот пример демонстрирует основные части, которые нужны KScript. Первый элемент, "Name", определяет имя сценария, показываемое пользователи, а текст элемента "Comment" будет показан во всплывающей подсказке. Наиболее важным является "Type", он определяет интерпретатор, который будет использован для сценария. На текущий момент есть два возможных варианта -  "ShellScript/bash" и "JavaScript/kjs".  нашем примере выбран первый. Сценарию передаётся два аргумента . Первый - DCOP ID (дескриптор) главного приложения. </para>
  38
  39 <para
  40 >Приведенный сценарий устанавливает текст первого документа в вывод команды "ls -l"</para>
  41
  42 <para
  43 >Самое полезная программа для разработки таких сценариев - KDCOP.</para>
  44 <figure id="screenshot-kdcop" float="1">
  45   <title
  46 >Работа с DCOP-интерфейсами в &kdevelop; с помощью KDCOP</title>
  47   <mediaobject>
  48     <imageobject
  49 ><imagedata fileref="kdcop_browsing.png"/></imageobject>
  50   </mediaobject>
  51 </figure>
  52
  53 <para
  54 >KDCOP позволяет просматривать и отлаживать интерфейсы приложений. На текущий момент KDCOP поддерживает KJSEmbed, Python и оболочки UNIX для работы с DCOP.</para>
  55
  56 <para
  57 >Когда сценарий написан, осталось его установить. Разработчики основного приложения должны позаботиться об этой процедуре, или хотя бы задокументировать пути, в которых будут искаться сценарии. В примере выше, сценарий Kate расположен в "$KDEDIRS/share/apps/kate/scripts".</para>
  58
  59 <figure id="screenshot-scripts" float="1">
  60   <title
  61 >Сценарии &kdevelop; в файловой системе</title>
  62   <mediaobject>
  63     <imageobject
  64 ><imagedata fileref="script_location.png"/></imageobject>
  65   </mediaobject>
  66 </figure>
  67
  68 <para
  69 >Файл .desktop должен быть в одной папке со сценарием. Разработчикам сценариев также рекомендуется хранить вспомогательные файлы, такие как файлы пользовательского интерфейса, файлы данных, в той же папке. Также заметим, что основное приложение блокируется на время выполнения сценария. но это будет изменено в KDE 4. </para>
  70
  71 </sect1>
  72
  73
  74 </chapter>