Christopher Hornbaker

chrishornbaker@earthlink.net

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

shafff@ukr.net

Перевод на русский Эта глава описывает нестандартные возможности &quantaplus; и как их использовать. В версии 3.2 появились средства работы с &XML;, а в 3.4 была добавлена поддержка DocBook. Все они используют Kommander как front-end (интерфейс) и библиотеки libxml и libxslt как back-end (движок). &quantaplus; поддерживает две главных утилиты документации &kde;: meinproc и checkXML. Все, кто работал с документацией &kde;, знают какая это замечательная программа. Теперь вы можете забыть о консоли и наслаждаться графическим интерфейсом с предустановленными действиями - нажмите кнопку с изображением процессора и всё готово. Текущий рабочий каталог Meinproc ищет файл index.docbook. Если он находится в текущем каталоге, оставьте этот параметр включённым. Иначе - введите путь к другому каталогу. Выходные файлы сохраняются в один каталог с исходными. Все файлы &HTML; сначала удаляются при каждом запуске meinproc. &quantaplus; также обеспечивает простой графический интерфейс к этой полезной программе. Текущий рабочий каталог Если index.docbook открыт и является активным, оставьте Текущий рабочий каталог включённым, иначе введите другой каталог с index.docbook. Если имеется вывод, в файле есть ошибки. Исправьте их и попытайтесь ещё раз. С &quantaplus; поставляется отличное средство синтаксической проверки &XML;, которое использует xmllint. Текущий файл Если файл, который нужно проверить, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. Проверка правильности синтаксиса Если вы хотите выполнить только такую проверку, включите этот параметр. &URI; описания Если вы используете &DTD; и он указан в файле &XML;, выберите &DTD; (внутрен.), иначе - &DTD; (внешн.) и укажите адрес описания &DTD;. &W3C; XML Schema и RelaxNG Schema должны быть описаны внешне, через &URI;. &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 в области комментария. <!-- @annotation Кто-то понял, как это работает? --> <!-- @annotation Аннотация на несколько строк. --> /* @annotation Не забудьте, что аннотации в области PHP нужно вводить внутри комментария PH */ Аннотации могут предназначаться для определённого участника команды. В этом случае следует использовать такой формат: @annotation(ник) или @annotation(обязанность), где ник - идентификатор участника команды, а обязанность принимает одно из следующих значений: team leader task leader subproject leader Ссылки на ведущего подпроекта и главного по заданию должны сопровождаться соответствующим именем подпроекта или задания, через двоеточие. <-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --> <-- @annotation(team leader) Это важно для всей команды --> // @annotation(subproject leader:PHP) Как тебе такой расклад? Ники и обязанности должны указываться с учётом регистра, без пробелов рядом со скобками и двоеточием. Более подробная информация об учтасниках команды, обязанностях и никах приведена в разделе . Все аннотации, содержащие в проекте, собираются в служебной панели Аннотации. Она состоит из трёх вкладок: Текущий файл Аннотации в текущем файле. Для вас Аннотации проекта, предназначенные для вас. Список группируются по файлам. Все файлы Все аннотации проекта, сгруппированные по файлам Поиск аннотаций происходит при загрузке проекта и файлов (в т.ч. после внешних модификаций). Поиск может занять некоторое время и окно с сообщением об аннотациях, предназначеннвх для вас, может появиться через несколько секунд после загрузки проекта. &debugging-quanta;