Дополнительные возможности

Christopher Hornbaker

    chrishornbaker@earthlink.net

Николай Шафоростов

    shafff@ukr.net

Перевод на русский

# Дополнительные возможности

Эта глава описывает нестандартные возможности &quantaplus; и как их использовать.

## Средства &XML;

В версии 3.2 появились средства работы с &XML;, а в 3.4 была добавлена поддержка DocBook. Все они используют Kommander как front-end (интерфейс) и библиотеки libxml и libxslt как back-end (движок).

### Средства создания документации &kde;

&quantaplus; поддерживает две главных утилиты документации &kde;: `meinproc` и `checkXML`.

#### `meinproc`

Все, кто работал с документацией &kde;, знают какая это замечательная программа. Теперь вы можете забыть о консоли и наслаждаться графическим интерфейсом с предустановленными действиями - нажмите кнопку с изображением процессора и всё готово.

Текущий рабочий каталог

  Meinproc ищет файл `index.docbook`. Если он находится в текущем каталоге, оставьте этот параметр включённым. Иначе - введите путь к другому каталогу.

Выходные файлы сохраняются в один каталог с исходными. Все файлы &HTML; сначала удаляются при каждом запуске `meinproc`.

#### `checkXML`

&quantaplus; также обеспечивает простой графический интерфейс к этой полезной программе.

Текущий рабочий каталог

  Если `index.docbook` открыт и является активным, оставьте Текущий рабочий каталог включённым, иначе введите другой каталог с `index.docbook`.

Вывод

Если имеется вывод, в файле есть ошибки. Исправьте их и попытайтесь ещё раз.

### Проверка &XML;

С &quantaplus; поставляется отличное средство синтаксической проверки &XML;, которое использует xmllint.

Текущий файл

  Если файл, который нужно проверить, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл.

Проверка правильности синтаксиса

  Если вы хотите выполнить только такую проверку, включите этот параметр.

&URI; описания

  Если вы используете &DTD; и он указан в файле &XML;, выберите &DTD; (внутрен.), иначе - &DTD; (внешн.) и укажите адрес описания &DTD;. &W3C; XML Schema и RelaxNG Schema должны быть описаны внешне, через &URI;.

### Обработка &XSL;

&quantaplus; поставляется со средством обработки &XSL;, которое использует программу `xsltproc` из пакета pplication >libxml2.

Текущий файл

  Если файл, который нужно обработать, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл.

Таблица стилей

  Выберите файл &XSL;, который вы хотите использовать.

Имя выходного файла

  Файл сохраняется в ваш домашний каталог, если не указано иначе.

Пока что приложение не имеет гибких настроек. Ждите в следующей версии.

Использование модулей

Mathieu Kooiman

    quanta@map-is.nl

Николай Шафоростов

    shafff@ukr.net

Перевод на русский

## Использование модулей

### Что такое модуль?

&quantaplus; может загружать компоненты KParts. KPart - мощная база интегрирования &kde;. Например, &quantaplus; использует &kate; KPart. Последний уже имел базовые функции, которые требовались &quantaplus;, такие как подсветка синтаксиса. Интегрирование его в &quantaplus; позволило сэкономить время и сразу начать работать над специфическими возможностями программы.

Для добавления модулей в &quantaplus; не нужно ничего делать с самой программой. Вы можете использовать новые возможности, не ожидая пока кто-нибудь интегрирует их (т.е. модуль, обеспечивающий их) с программой! Подробности описываются ниже.

### Что такое диалог редактирования модулей

Чтобы установить модуль (в т.ч. KPart), зайдите в меню Модули Правка :

Окно Модули.

Здесь вы можете управлять модулями, добавлять новые. Опишем каждый его элемент:

Искать в

  При добавлении модуля без Расположения, &quantaplus; будет искать его указанных местах.

Добавить

  Вызывает диалог добавления модуля.

Настройка

  Изменить настройки выбранного модуля.

Удалить

  Удалить выбранный модуль.

Обновить

  Обновить содержание диалога.

Для подробностей о модулях, обратитесь к разделу .

## Командная разработка

В большинстве проектов задействовано несколько человек, связанных определёнными иерархическими отношениями. В &quantaplus; присутствует понятие членов команды, их можно настроить в &Shift;F7 Проект Свойства проекта .

Диалог редактирования члена команды

Поля Имя, Email не требуют объяснения. Ник - уникальный краткий идентификатор пользователя.

Обязанность определяет роль участника в проекте, возможные значения:

- Лидер команды

- Ведущий подпроекта

- Главный по заданию

- Участник

Задание - описание задач, закреплённых за участником.

Подпроект: подпроекты можно создать и настроить нажатием кнопки Подпроекты.... Параметры подпроекта - имя и расположение относительно папки проекта, т.е. подпроектом можно назвать папку в дереве проекта. Например, базовым проектом может быть сайт вашей компании, а подпроектом может выступать сайт для вашей внутренней сети, с соответствующей ему в проекте папкой `intranet`.

У одного члена команды может быть несколько обязанностей.

Пользователь должен выбрать свою обязанность в команде. Для этого следует выбрать пункт из списка предлагаемых и нажать кнопку Взять на себя. Выбранная обязанность будет содержаться в графе Ваша должность.

Выбор ника и обязанности необходим для рассылки уведомлений и аннотаций. Информация о последних приведена в разделе .

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

## Действия, порождаемые событиями

Это действия. выполняемые при возникновении определённого события в проекте. Действие может заключаться, например, в записи времени открытия и закрытия проекта, чтобы можно было посчитать, сколько времени на него потрачено; или в отправке письма при сохранении файла; или в добавлении в CVS файла, добавленного в проект.

На вкладке Параметры событий диалога &Shift;F7 Проект Свойства проекта можно создавать, изменять и удалять действия, связанные с событиями.

Редактор событий

Доступные поля:

Событие

  событие, при возникновении которого выполняется действие.

Действие

  тип действия, возможные варианты:

  Несценарное действие

    действие, не заключающееся в запуске внешнего сценария. См. .

    Имя действия определяет выполняемое действие.

  Отправить E-Mail

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

  Занести событие в журнал

    доступные параметры:

    Журнал

      полное имя файла (с путём к нему)

    Подробности

      На сколько подробную запись делать

    Поведение

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

  Cценарное действие

    выполнять сценарий

    Имя действия определяет выполняемое действие.

Остальные поля зависят от типа действия.

## Аннотации

Аннотации - это комментарии определённой формы в документах. От обычных комментариев они имеют следующие отличия:

- аннотации собираются и показываются в одноимённой служебной панели.

- аннотации могут предназначаться для определённого участника команды.

Для добавления аннотации можно воспользоваться пунктом Добавить аннотацию контекстного меню редактора или просто ввести текст аннотации после ключевого слова @annotation в области комментария.

Пример аннотации в XML

    <!-- @annotation Кто-то понял, как это работает? -->

    <!-- @annotation
     Аннотация
     на несколько строк.
    -->

Пример аннотации в PHP

    /* @annotation
    Не забудьте, что аннотации в области PHP нужно вводить внутри комментария PH
    */

Аннотации могут предназначаться для определённого участника команды. В этом случае следует использовать такой формат: @annotation(ник) или @annotation(обязанность), где ник - идентификатор участника команды, а обязанность принимает одно из следующих значений:

- team leader

- task leader

- subproject leader

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

Заметка участнику команды с ником eric

    <-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ -->

Уведомление лидера команды

    <-- @annotation(team leader) Это важно для всей команды -->

Уведомление ведущего подпроекта PHP

    // @annotation(subproject leader:PHP) Как тебе такой расклад?

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

Более подробная информация об учтасниках команды, обязанностях и никах приведена в разделе .

Все аннотации, содержащие в проекте, собираются в служебной панели Аннотации. Она состоит из трёх вкладок:

Текущий файл

  Аннотации в текущем файле.

Для вас

  Аннотации проекта, предназначенные для вас. Список группируются по файлам.

Все файлы

  Все аннотации проекта, сгруппированные по файлам

Поиск аннотаций происходит при загрузке проекта и файлов (в т.ч. после внешних модификаций). Поиск может занять некоторое время и окно с сообщением об аннотациях, предназначеннвх для вас, может появиться через несколько секунд после загрузки проекта.
&debugging-quanta;