summaryrefslogtreecommitdiffstats
path: root/tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook
diff options
context:
space:
mode:
authorDarrell Anderson <darrella@hushmail.com>2014-01-21 22:06:48 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2014-01-21 22:06:48 -0600
commit0b8ca6637be94f7814cafa7d01ad4699672ff336 (patch)
treed2b55b28893be8b047b4e60514f4a7f0713e0d70 /tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook
parenta1670b07bc16b0decb3e85ee17ae64109cb182c1 (diff)
downloadtde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.tar.gz
tde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.zip
Beautify docbook files
Diffstat (limited to 'tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook')
-rw-r--r--tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook689
1 files changed, 141 insertions, 548 deletions
diff --git a/tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook b/tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook
index 60909a05843..b169f3b5721 100644
--- a/tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook
+++ b/tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook
@@ -2,237 +2,139 @@
<chapter id="advanced-quanta-3-2">
<chapterinfo>
-<title
->Дополнительные возможности</title>
+<title>Дополнительные возможности</title>
<authorgroup>
-<author
-><firstname
->Christopher</firstname
-> <surname
->Hornbaker</surname
-> <affiliation
-> <address
-><email
->chrishornbaker@earthlink.net</email
-></address>
+<author><firstname>Christopher</firstname> <surname>Hornbaker</surname> <affiliation> <address><email>chrishornbaker@earthlink.net</email></address>
</affiliation>
</author>
-<othercredit role="translator"
-><firstname
->Николай</firstname
-><surname
->Шафоростов</surname
-><affiliation
-><address
-><email
->shafff@ukr.net</email
-></address
-></affiliation
-><contrib
->Перевод на русский</contrib
-></othercredit
->
+<othercredit role="translator"><firstname>Николай</firstname><surname>Шафоростов</surname><affiliation><address><email>shafff@ukr.net</email></address></affiliation><contrib>Перевод на русский</contrib></othercredit>
</authorgroup>
</chapterinfo>
-<title
->Дополнительные возможности</title>
+<title>Дополнительные возможности</title>
-<para
->Эта глава описывает нестандартные возможности &quantaplus; и как их использовать. </para>
+<para>Эта глава описывает нестандартные возможности &quantaplus; и как их использовать. </para>
<sect1 id="xml-tools-3-2">
-<title
->Средства &XML;</title>
+<title>Средства &XML;</title>
-<para
->В версии 3.2 появились средства работы с &XML;, а в 3.4 была добавлена поддержка DocBook. Все они используют Kommander как front-end (интерфейс) и библиотеки libxml и libxslt как back-end (движок). </para>
+<para>В версии 3.2 появились средства работы с &XML;, а в 3.4 была добавлена поддержка DocBook. Все они используют Kommander как front-end (интерфейс) и библиотеки libxml и libxslt как back-end (движок). </para>
<sect2 id="kde-db-3-2">
-<title
->Средства создания документации &kde;</title>
+<title>Средства создания документации &kde;</title>
-<para
->&quantaplus; поддерживает две главных утилиты документации &kde;: <command
->meinproc</command
-> и <command
->checkXML</command
->. </para>
+<para>&quantaplus; поддерживает две главных утилиты документации &kde;: <command>meinproc</command> и <command>checkXML</command>. </para>
<sect3 id="meinproc-3-2">
-<title
-><command
->meinproc</command
-></title>
+<title><command>meinproc</command></title>
-<para
->Все, кто работал с документацией &kde;, знают какая это замечательная программа. Теперь вы можете забыть о консоли и наслаждаться графическим интерфейсом с предустановленными действиями - нажмите кнопку с изображением процессора и всё готово. </para>
+<para>Все, кто работал с документацией &kde;, знают какая это замечательная программа. Теперь вы можете забыть о консоли и наслаждаться графическим интерфейсом с предустановленными действиями - нажмите кнопку с изображением процессора и всё готово. </para>
<variablelist>
<varlistentry>
-<term
-><guilabel
->Текущий рабочий каталог</guilabel
-></term>
+<term><guilabel>Текущий рабочий каталог</guilabel></term>
<listitem>
-<para
->Meinproc ищет файл <filename
->index.docbook</filename
->. Если он находится в текущем каталоге, оставьте этот параметр включённым. Иначе - введите путь к другому каталогу. </para>
+<para>Meinproc ищет файл <filename>index.docbook</filename>. Если он находится в текущем каталоге, оставьте этот параметр включённым. Иначе - введите путь к другому каталогу. </para>
</listitem>
</varlistentry>
</variablelist>
<note>
-<para
->Выходные файлы сохраняются в один каталог с исходными. Все файлы &HTML; сначала удаляются при каждом запуске <command
->meinproc</command
->. </para>
+<para>Выходные файлы сохраняются в один каталог с исходными. Все файлы &HTML; сначала удаляются при каждом запуске <command>meinproc</command>. </para>
</note>
</sect3>
<sect3 id="checkxml-3-2">
-<title
-><command
->checkXML</command
-></title>
+<title><command>checkXML</command></title>
-<para
->&quantaplus; также обеспечивает простой графический интерфейс к этой полезной программе. </para>
+<para>&quantaplus; также обеспечивает простой графический интерфейс к этой полезной программе. </para>
<variablelist>
<varlistentry>
-<term
-><guilabel
->Текущий рабочий каталог</guilabel
-></term>
+<term><guilabel>Текущий рабочий каталог</guilabel></term>
<listitem>
-<para
->Если <filename
->index.docbook</filename
-> открыт и является активным, оставьте <guilabel
->Текущий рабочий каталог</guilabel
-> включённым, иначе введите другой каталог с <filename
->index.docbook</filename
->. </para>
+<para>Если <filename>index.docbook</filename> открыт и является активным, оставьте <guilabel>Текущий рабочий каталог</guilabel> включённым, иначе введите другой каталог с <filename>index.docbook</filename>. </para>
</listitem>
</varlistentry>
</variablelist>
<note>
-<title
->Вывод</title>
-<para
->Если имеется вывод, в файле есть ошибки. Исправьте их и попытайтесь ещё раз. </para>
+<title>Вывод</title>
+<para>Если имеется вывод, в файле есть ошибки. Исправьте их и попытайтесь ещё раз. </para>
</note>
</sect3>
</sect2>
<sect2 id="xmlval-3-2">
-<title
->Проверка &XML;</title>
+<title>Проверка &XML;</title>
-<para
->С &quantaplus; поставляется отличное средство синтаксической проверки &XML;, которое использует <application
->xmllint</application
->. </para>
+<para>С &quantaplus; поставляется отличное средство синтаксической проверки &XML;, которое использует <application>xmllint</application>. </para>
<variablelist>
<varlistentry>
-<term
-><guilabel
->Текущий файл</guilabel
-></term>
+<term><guilabel>Текущий файл</guilabel></term>
<listitem>
-<para
->Если файл, который нужно проверить, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. </para>
+<para>Если файл, который нужно проверить, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Проверка правильности синтаксиса</guilabel
-></term>
+<term><guilabel>Проверка правильности синтаксиса</guilabel></term>
<listitem>
-<para
->Если вы хотите выполнить только такую проверку, включите этот параметр. </para>
+<para>Если вы хотите выполнить только такую проверку, включите этот параметр. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->&URI; описания</guilabel
-></term>
+<term><guilabel>&URI; описания</guilabel></term>
<listitem>
-<para
->Если вы используете &DTD; и он указан в файле &XML;, выберите &DTD; (внутрен.), иначе - &DTD; (внешн.) и укажите адрес описания &DTD;. &W3C; XML Schema и RelaxNG Schema должны быть описаны внешне, через &URI;. </para>
+<para>Если вы используете &DTD; и он указан в файле &XML;, выберите &DTD; (внутрен.), иначе - &DTD; (внешн.) и укажите адрес описания &DTD;. &W3C; XML Schema и RelaxNG Schema должны быть описаны внешне, через &URI;. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="xsltproc-3-2">
-<title
->Обработка &XSL;</title>
+<title>Обработка &XSL;</title>
-<para
->&quantaplus; поставляется со средством обработки &XSL;, которое использует программу <command
->xsltproc</command
-> из пакета <application
->pplication
->libxml2</application
->. </para>
+<para>&quantaplus; поставляется со средством обработки &XSL;, которое использует программу <command>xsltproc</command> из пакета <application>pplication>libxml2</application>. </para>
<variablelist>
<varlistentry>
-<term
-><guilabel
->Текущий файл</guilabel
-></term>
+<term><guilabel>Текущий файл</guilabel></term>
<listitem>
-<para
->Если файл, который нужно обработать, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. </para>
+<para>Если файл, который нужно обработать, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
->Таблица стилей</term>
+<term>Таблица стилей</term>
<listitem>
-<para
->Выберите файл &XSL;, который вы хотите использовать. </para>
+<para>Выберите файл &XSL;, который вы хотите использовать. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Имя выходного файла</guilabel
-></term>
+<term><guilabel>Имя выходного файла</guilabel></term>
<listitem>
-<para
->Файл сохраняется в ваш домашний каталог, если не указано иначе. </para>
+<para>Файл сохраняется в ваш домашний каталог, если не указано иначе. </para>
</listitem>
</varlistentry>
</variablelist>
<note>
-<para
->Пока что приложение не имеет гибких настроек. Ждите в следующей версии. </para>
+<para>Пока что приложение не имеет гибких настроек. Ждите в следующей версии. </para>
</note>
</sect2>
</sect1>
<!-- <sect1 id="tdefilereplace-3-2">
-<title
->KFileReplace</title>
+<title>KFileReplace</title>
<para>
KFileReplace is a terrific new addition to &quantaplus;. It allows one to
@@ -247,8 +149,7 @@ you how to use this wonderful feature.
</para>
<sect2 id="using-kfr-3-2">
-<title
->Using KFileReplace</title>
+<title>Using KFileReplace</title>
<para>
With all these wonderful features KFileReplace has, surely you are
@@ -257,8 +158,7 @@ is on tight, because we are about to dive in!
</para>
<sect3 id="start-kfr-3-2">
-<title
->Starting KFileReplace</title>
+<title>Starting KFileReplace</title>
<para>
You will find KFileReplace in two places: &quantaplus;' main toolbar and the
@@ -267,8 +167,7 @@ menubar (Plugins -> KFileReplace). It is represented by this icon:
<imageobject>
<imagedata fileref="kfr-icon.png" format="PNG"/>
</imageobject>
-</inlinemediaobject
->.
+</inlinemediaobject>.
By executing it from either location, you will be presented with the New
Search &amp; Replace Project dialog.
</para>
@@ -277,17 +176,13 @@ Search &amp; Replace Project dialog.
<imageobject>
<imagedata fileref="kfr-new-dialog.png" format="PNG"/>
</imageobject>
-<caption
-><para
->KFileReplace's New Search &amp; Replace Project dialog.</para
-></caption>
+<caption><para>KFileReplace's New Search &amp; Replace Project dialog.</para></caption>
</mediaobject>
</sect3>
<sect3 id="replace-string-kfr-3-2">
-<title
->Replacing Strings in Files Over Multiple Folders</title>
+<title>Replacing Strings in Files Over Multiple Folders</title>
<para>
@@ -295,396 +190,191 @@ Your boss just gave word that:
<orderedlist numeration="arabic">
<listitem>
-<para
->all image formats will be PNG from now on;</para>
+<para>all image formats will be PNG from now on;</para>
</listitem>
<listitem>
-<para
->all current images must be converted to PNG;</para>
+<para>all current images must be converted to PNG;</para>
</listitem>
<listitem>
-<para
->and it all needs to be done in one hour.</para>
+<para>and it all needs to be done in one hour.</para>
</listitem>
</orderedlist>
-<quote
->One hour!?!?</quote
-> you think to yourself. <quote
->It'll take at
-least 45 minutes to convert the images!</quote
-> Calm down. Convert
+<quote>One hour!?!?</quote> you think to yourself. <quote>It'll take at
+least 45 minutes to convert the images!</quote> Calm down. Convert
the images, load up your project, and fire up KFileReplace. Filter for
only the file types you want to change. Press the <inlinemediaobject>
-<imageobject
-><imagedata format="PNG" fileref=""/></imageobject>
-</inlinemediaobject
-> and for, say GIF images, .gif for the string to
+<imageobject><imagedata format="PNG" fileref=""/></imageobject>
+</inlinemediaobject> and for, say GIF images, .gif for the string to
replace and .png for the replacement string.
</para>
</sect3>
</sect2>
-</sect1
-> -->
+</sect1> -->
<sect1 id="tdeparts-3-2">
<sect1info>
-<title
->Использование модулей</title>
+<title>Использование модулей</title>
<authorgroup>
-<author
-><firstname
->Mathieu</firstname
-> <surname
->Kooiman</surname
-> <affiliation
-> <address
-><email
->quanta@map-is.nl</email
-></address>
+<author><firstname>Mathieu</firstname> <surname>Kooiman</surname> <affiliation> <address><email>quanta@map-is.nl</email></address>
</affiliation>
</author>
-<othercredit role="translator"
-><firstname
->Николай</firstname
-><surname
->Шафоростов</surname
-><affiliation
-><address
-><email
->shafff@ukr.net</email
-></address
-></affiliation
-><contrib
->Перевод на русский</contrib
-></othercredit
->
+<othercredit role="translator"><firstname>Николай</firstname><surname>Шафоростов</surname><affiliation><address><email>shafff@ukr.net</email></address></affiliation><contrib>Перевод на русский</contrib></othercredit>
</authorgroup>
</sect1info>
-<title
->Использование модулей</title>
+<title>Использование модулей</title>
<sect2 id="what-is-a-plugin-3-2">
-<title
->Что такое модуль?</title>
+<title>Что такое модуль?</title>
-<para
->&quantaplus; может загружать компоненты KParts. KPart - мощная база интегрирования &kde;. Например, &quantaplus; использует &kate; KPart. Последний уже имел базовые функции, которые требовались &quantaplus;, такие как подсветка синтаксиса. Интегрирование его в &quantaplus; позволило сэкономить время и сразу начать работать над специфическими возможностями программы. </para>
+<para>&quantaplus; может загружать компоненты KParts. KPart - мощная база интегрирования &kde;. Например, &quantaplus; использует &kate; KPart. Последний уже имел базовые функции, которые требовались &quantaplus;, такие как подсветка синтаксиса. Интегрирование его в &quantaplus; позволило сэкономить время и сразу начать работать над специфическими возможностями программы. </para>
-<para
->Для добавления модулей в &quantaplus; не нужно ничего делать с самой программой. Вы можете использовать новые возможности, не ожидая пока кто-нибудь интегрирует их (т.е. модуль, обеспечивающий их) с программой! Подробности описываются ниже. </para>
+<para>Для добавления модулей в &quantaplus; не нужно ничего делать с самой программой. Вы можете использовать новые возможности, не ожидая пока кто-нибудь интегрирует их (т.е. модуль, обеспечивающий их) с программой! Подробности описываются ниже. </para>
</sect2>
<sect2 id="plugin-dialog-3-2">
-<title
->Что такое диалог редактирования модулей</title>
-
-<para
->Чтобы установить модуль (в т.ч. KPart), зайдите в меню <menuchoice
-> <guimenu
->Модули</guimenu
-> <guimenuitem
->Правка</guimenuitem
-> </menuchoice
->: </para>
+<title>Что такое диалог редактирования модулей</title>
+
+<para>Чтобы установить модуль (в т.ч. KPart), зайдите в меню <menuchoice> <guimenu>Модули</guimenu> <guimenuitem>Правка</guimenuitem> </menuchoice>: </para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="plugin-edit.png"/>
</imageobject>
-<caption
-><para
->Окно Модули.</para
-></caption>
+<caption><para>Окно Модули.</para></caption>
</mediaobject>
-<para
->Здесь вы можете управлять модулями, добавлять новые. Опишем каждый его элемент: <variablelist>
+<para>Здесь вы можете управлять модулями, добавлять новые. Опишем каждый его элемент: <variablelist>
<varlistentry>
-<term
-><guilabel
->Искать в</guilabel
-></term>
+<term><guilabel>Искать в</guilabel></term>
<listitem>
-<para
->При добавлении модуля без <guilabel
->Расположения</guilabel
->, &quantaplus; будет искать его указанных местах. </para>
+<para>При добавлении модуля без <guilabel>Расположения</guilabel>, &quantaplus; будет искать его указанных местах. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Добавить</guilabel
-></term>
+<term><guilabel>Добавить</guilabel></term>
<listitem>
-<para
->Вызывает диалог добавления модуля. </para>
+<para>Вызывает диалог добавления модуля. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Настройка</guilabel
-></term>
+<term><guilabel>Настройка</guilabel></term>
<listitem>
-<para
->Изменить настройки выбранного модуля. </para>
+<para>Изменить настройки выбранного модуля. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Удалить</guilabel
-></term>
+<term><guilabel>Удалить</guilabel></term>
<listitem>
-<para
->Удалить выбранный модуль. </para>
+<para>Удалить выбранный модуль. </para>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Обновить</guilabel
-></term>
+<term><guilabel>Обновить</guilabel></term>
<listitem>
-<para
->Обновить содержание диалога. </para>
+<para>Обновить содержание диалога. </para>
</listitem>
</varlistentry>
</variablelist>
</para>
-<para
->Для подробностей о модулях, обратитесь к разделу <xref linkend="configure-plugins"/>.</para>
+<para>Для подробностей о модулях, обратитесь к разделу <xref linkend="configure-plugins"/>.</para>
</sect2>
</sect1>
<sect1 id="team-members">
- <title
->Командная разработка</title>
- <para
->В большинстве проектов задействовано несколько человек, связанных определёнными иерархическими отношениями. В &quantaplus; присутствует понятие членов команды, их можно настроить в <menuchoice
-><shortcut
-> <keycombo action="simul"
->&Shift;<keycap
->F7</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Проект</guimenu
-> <guimenuitem
->Свойства проекта</guimenuitem
-> </menuchoice
->. </para>
+ <title>Командная разработка</title>
+ <para>В большинстве проектов задействовано несколько человек, связанных определёнными иерархическими отношениями. В &quantaplus; присутствует понятие членов команды, их можно настроить в <menuchoice><shortcut> <keycombo action="simul">&Shift;<keycap>F7</keycap></keycombo> </shortcut> <guimenu>Проект</guimenu> <guimenuitem>Свойства проекта</guimenuitem> </menuchoice>. </para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="team-editing.png"/>
</imageobject>
- <caption
-><para
->Диалог редактирования члена команды</para
-></caption>
+ <caption><para>Диалог редактирования члена команды</para></caption>
</mediaobject>
- <para
->Поля <guilabel
->Имя</guilabel
->, <guilabel
->Email</guilabel
-> не требуют объяснения. <guilabel
->Ник</guilabel
-> - уникальный краткий идентификатор пользователя. </para>
- <para
-><guilabel
->Обязанность</guilabel
-> определяет роль участника в проекте, возможные значения: <itemizedlist>
-<listitem
-><para>
-<guilabel
->Лидер команды</guilabel>
-</para
-></listitem>
-<listitem
-><para>
-<guilabel
->Ведущий подпроекта</guilabel>
-</para
-></listitem>
-<listitem
-><para>
-<guilabel
->Главный по заданию</guilabel>
-</para
-></listitem>
-<listitem
-><para>
-<guilabel
->Участник</guilabel>
-</para
-></listitem>
+ <para>Поля <guilabel>Имя</guilabel>, <guilabel>Email</guilabel> не требуют объяснения. <guilabel>Ник</guilabel> - уникальный краткий идентификатор пользователя. </para>
+ <para><guilabel>Обязанность</guilabel> определяет роль участника в проекте, возможные значения: <itemizedlist>
+<listitem><para>
+<guilabel>Лидер команды</guilabel>
+</para></listitem>
+<listitem><para>
+<guilabel>Ведущий подпроекта</guilabel>
+</para></listitem>
+<listitem><para>
+<guilabel>Главный по заданию</guilabel>
+</para></listitem>
+<listitem><para>
+<guilabel>Участник</guilabel>
+</para></listitem>
</itemizedlist>
</para>
-<para
-><guilabel
->Задание</guilabel
-> - описание задач, закреплённых за участником.</para>
-<para
-><guilabel
->Подпроект</guilabel
->: подпроекты можно создать и настроить нажатием кнопки <guilabel
->Подпроекты...</guilabel
->. Параметры подпроекта - имя и расположение относительно папки проекта, т.е. подпроектом можно назвать папку в дереве проекта. Например, базовым проектом может быть сайт вашей компании, а подпроектом может выступать сайт для вашей внутренней сети, с соответствующей ему в проекте папкой <filename path="intranet"
->intranet</filename
->.</para>
-<para
->У одного члена команды может быть несколько обязанностей.</para>
-<para
->Пользователь должен выбрать свою обязанность в команде. Для этого следует выбрать пункт из списка предлагаемых и нажать кнопку <guilabel
->Взять на себя</guilabel
->. Выбранная обязанность будет содержаться в графе <guilabel
->Ваша должность</guilabel
->.</para>
-<para
->Выбор ника и обязанности необходим для рассылки уведомлений и аннотаций. Информация о последних приведена в разделе <xref linkend="annotations"/>.</para>
-<para
->Вы можете создать событие, передаваемое, например, лидерам проекта, когда произойдёт какое-нибудь событие. Для подробностей см. <xref linkend="event-actions"/>.</para>
+<para><guilabel>Задание</guilabel> - описание задач, закреплённых за участником.</para>
+<para><guilabel>Подпроект</guilabel>: подпроекты можно создать и настроить нажатием кнопки <guilabel>Подпроекты...</guilabel>. Параметры подпроекта - имя и расположение относительно папки проекта, т.е. подпроектом можно назвать папку в дереве проекта. Например, базовым проектом может быть сайт вашей компании, а подпроектом может выступать сайт для вашей внутренней сети, с соответствующей ему в проекте папкой <filename path="intranet">intranet</filename>.</para>
+<para>У одного члена команды может быть несколько обязанностей.</para>
+<para>Пользователь должен выбрать свою обязанность в команде. Для этого следует выбрать пункт из списка предлагаемых и нажать кнопку <guilabel>Взять на себя</guilabel>. Выбранная обязанность будет содержаться в графе <guilabel>Ваша должность</guilabel>.</para>
+<para>Выбор ника и обязанности необходим для рассылки уведомлений и аннотаций. Информация о последних приведена в разделе <xref linkend="annotations"/>.</para>
+<para>Вы можете создать событие, передаваемое, например, лидерам проекта, когда произойдёт какое-нибудь событие. Для подробностей см. <xref linkend="event-actions"/>.</para>
</sect1>
<sect1 id="event-actions">
- <title
->Действия, порождаемые событиями</title>
- <para
->Это действия. выполняемые при возникновении определённого события в проекте. Действие может заключаться, например, в записи времени открытия и закрытия проекта, чтобы можно было посчитать, сколько времени на него потрачено; или в отправке письма при сохранении файла; или в добавлении в CVS файла, добавленного в проект.</para>
- <para
->На вкладке <guilabel
->Параметры событий</guilabel
-> диалога <menuchoice
-><shortcut
-> <keycombo action="simul"
->&Shift;<keycap
->F7</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Проект</guimenu
-> <guimenuitem
->Свойства проекта</guimenuitem
-> </menuchoice
-> можно создавать, изменять и удалять действия, связанные с событиями. </para>
+ <title>Действия, порождаемые событиями</title>
+ <para>Это действия. выполняемые при возникновении определённого события в проекте. Действие может заключаться, например, в записи времени открытия и закрытия проекта, чтобы можно было посчитать, сколько времени на него потрачено; или в отправке письма при сохранении файла; или в добавлении в CVS файла, добавленного в проект.</para>
+ <para>На вкладке <guilabel>Параметры событий</guilabel> диалога <menuchoice><shortcut> <keycombo action="simul">&Shift;<keycap>F7</keycap></keycombo> </shortcut> <guimenu>Проект</guimenu> <guimenuitem>Свойства проекта</guimenuitem> </menuchoice> можно создавать, изменять и удалять действия, связанные с событиями. </para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="event-editing.png"/>
</imageobject>
- <caption
-><para
->Редактор событий</para
-></caption>
+ <caption><para>Редактор событий</para></caption>
</mediaobject>
-<para
->Доступные поля:</para>
+<para>Доступные поля:</para>
<variablelist>
<varlistentry>
-<term
-><guilabel
->Событие</guilabel
-></term>
-<listitem
-><para
->событие, при возникновении которого выполняется действие.</para
-></listitem>
+<term><guilabel>Событие</guilabel></term>
+<listitem><para>событие, при возникновении которого выполняется действие.</para></listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Действие</guilabel
-></term>
-<listitem
-><para
->тип действия, возможные варианты: </para>
+<term><guilabel>Действие</guilabel></term>
+<listitem><para>тип действия, возможные варианты: </para>
<variablelist>
<varlistentry>
-<term
-><guilabel
->Несценарное действие</guilabel
-></term>
-<listitem
-><para
->действие, не заключающееся в запуске внешнего сценария. См. <xref linkend="user-actions"/>. </para>
-<para
-><guilabel
->Имя действия</guilabel
-> определяет выполняемое действие.</para>
+<term><guilabel>Несценарное действие</guilabel></term>
+<listitem><para>действие, не заключающееся в запуске внешнего сценария. См. <xref linkend="user-actions"/>. </para>
+<para><guilabel>Имя действия</guilabel> определяет выполняемое действие.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term
-><guilabel
->Отправить E-Mail</guilabel
-></term>
- <listitem
-><para
->отправить email, получателей можно указать в соответствующем списке. Например, это может быть лидер проекта, или ведущий подпроекта. См. <xref linkend="team-members"/>. </para
->
+ <term><guilabel>Отправить E-Mail</guilabel></term>
+ <listitem><para>отправить email, получателей можно указать в соответствующем списке. Например, это может быть лидер проекта, или ведущий подпроекта. См. <xref linkend="team-members"/>. </para>
</listitem>
</varlistentry>
<varlistentry>
- <term
-><guilabel
->Занести событие в журнал</guilabel
-></term>
- <listitem
-><para
->доступные параметры: </para>
+ <term><guilabel>Занести событие в журнал</guilabel></term>
+ <listitem><para>доступные параметры: </para>
<variablelist>
<varlistentry>
- <term
-><guilabel
->Журнал</guilabel
-></term>
- <listitem
-><para
->полное имя файла (с путём к нему)</para
-></listitem>
+ <term><guilabel>Журнал</guilabel></term>
+ <listitem><para>полное имя файла (с путём к нему)</para></listitem>
</varlistentry>
<varlistentry>
- <term
->Подробности</term>
- <listitem
-><para
->На сколько подробную запись делать </para
-></listitem>
+ <term>Подробности</term>
+ <listitem><para>На сколько подробную запись делать </para></listitem>
</varlistentry>
<varlistentry>
- <term
-><guilabel
->Поведение</guilabel
-></term>
- <listitem
-><para
->Создавать ли журнал в случае его отсутствия, заменять ли существующий журнал или же дополнять его.</para
-></listitem>
+ <term><guilabel>Поведение</guilabel></term>
+ <listitem><para>Создавать ли журнал в случае его отсутствия, заменять ли существующий журнал или же дополнять его.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
-<term
-><guilabel
->Cценарное действие</guilabel
-></term>
-<listitem
-><para
->выполнять сценарий </para>
- <para
-><guilabel
->Имя действия</guilabel
-> определяет выполняемое действие.</para>
+<term><guilabel>Cценарное действие</guilabel></term>
+<listitem><para>выполнять сценарий </para>
+ <para><guilabel>Имя действия</guilabel> определяет выполняемое действие.</para>
</listitem>
</varlistentry>
@@ -692,138 +382,41 @@ replace and .png for the replacement string.
</listitem>
</varlistentry>
</variablelist>
-<para
->Остальные поля зависят от типа действия. </para>
+<para>Остальные поля зависят от типа действия. </para>
</sect1>
<sect1 id="annotations">
-<title
->Аннотации</title>
-<para
->Аннотации - это комментарии определённой формы в документах. От обычных комментариев они имеют следующие отличия: <itemizedlist>
-<listitem
-><para
->аннотации собираются и показываются в одноимённой служебной панели. </para
-></listitem>
-<listitem
-><para
->аннотации могут предназначаться для определённого участника команды. </para
-></listitem>
+<title>Аннотации</title>
+<para>Аннотации - это комментарии определённой формы в документах. От обычных комментариев они имеют следующие отличия: <itemizedlist>
+<listitem><para>аннотации собираются и показываются в одноимённой служебной панели. </para></listitem>
+<listitem><para>аннотации могут предназначаться для определённого участника команды. </para></listitem>
</itemizedlist>
</para>
-<para
->Для добавления аннотации можно воспользоваться пунктом <guilabel
->Добавить аннотацию</guilabel
-> контекстного меню редактора или просто ввести текст аннотации после ключевого слова <emphasis
->@annotation</emphasis
-> в области комментария. <example
-><title
->Пример аннотации в XML</title
-><screen
->&lt;!-- @annotation Кто-то понял, как это работает? --&gt;</screen>
-<screen
->&lt;!-- @annotation
+<para>Для добавления аннотации можно воспользоваться пунктом <guilabel>Добавить аннотацию</guilabel> контекстного меню редактора или просто ввести текст аннотации после ключевого слова <emphasis>@annotation</emphasis> в области комментария. <example><title>Пример аннотации в XML</title><screen>&lt;!-- @annotation Кто-то понял, как это работает? --&gt;</screen>
+<screen>&lt;!-- @annotation
Аннотация
на несколько строк.
---&gt;</screen
-></example>
-<example
-><title
->Пример аннотации в PHP</title
-><screen
->/* @annotation
+--&gt;</screen></example>
+<example><title>Пример аннотации в PHP</title><screen>/* @annotation
Не забудьте, что аннотации в области PHP нужно вводить внутри комментария PH
*/</screen>
</example>
</para>
-<para
->Аннотации могут предназначаться для определённого участника команды. В этом случае следует использовать такой формат: <emphasis
->@annotation(ник)</emphasis
-> или <emphasis
->@annotation(обязанность)</emphasis
->, где <emphasis
->ник</emphasis
-> - идентификатор участника команды, а <emphasis
->обязанность</emphasis
-> принимает одно из следующих значений: <itemizedlist
-> <listitem
-><para
-> team leader </para
-></listitem
-> <listitem
-><para
-> task leader </para
-></listitem
-> <listitem
-><para
-> subproject leader </para
-></listitem
-> </itemizedlist
-> Ссылки на ведущего подпроекта и главного по заданию должны сопровождаться соответствующим именем подпроекта или задания, через двоеточие. </para>
+<para>Аннотации могут предназначаться для определённого участника команды. В этом случае следует использовать такой формат: <emphasis>@annotation(ник)</emphasis> или <emphasis>@annotation(обязанность)</emphasis>, где <emphasis>ник</emphasis> - идентификатор участника команды, а <emphasis>обязанность</emphasis> принимает одно из следующих значений: <itemizedlist> <listitem><para> team leader </para></listitem> <listitem><para> task leader </para></listitem> <listitem><para> subproject leader </para></listitem> </itemizedlist> Ссылки на ведущего подпроекта и главного по заданию должны сопровождаться соответствующим именем подпроекта или задания, через двоеточие. </para>
<para>
-<example
-><title
->Заметка участнику команды с ником <emphasis
->eric</emphasis
-></title>
-<screen
->&lt;-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --&gt;</screen>
+<example><title>Заметка участнику команды с ником <emphasis>eric</emphasis></title>
+<screen>&lt;-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --&gt;</screen>
</example>
-<example
-><title
->Уведомление лидера команды</title>
-<screen
->&lt;-- @annotation(team leader) Это важно для всей команды --&gt;</screen>
+<example><title>Уведомление лидера команды</title>
+<screen>&lt;-- @annotation(team leader) Это важно для всей команды --&gt;</screen>
</example>
-<example
-><title
->Уведомление ведущего подпроекта <emphasis
->PHP</emphasis
-></title>
-<screen
->// @annotation(subproject leader:PHP) Как тебе такой расклад?</screen>
+<example><title>Уведомление ведущего подпроекта <emphasis>PHP</emphasis></title>
+<screen>// @annotation(subproject leader:PHP) Как тебе такой расклад?</screen>
</example>
</para>
-<para
->Ники и обязанности должны указываться с учётом регистра, без пробелов рядом со скобками и двоеточием.</para>
-<para
->Более подробная информация об учтасниках команды, обязанностях и никах приведена в разделе <xref linkend="team-members"/>.</para>
-<para
->Все аннотации, содержащие в проекте, собираются в служебной панели <guilabel
->Аннотации</guilabel
->. Она состоит из трёх вкладок: <variablelist
-> <varlistentry
-> <term
-><guilabel
->Текущий файл</guilabel
-></term
-> <listitem
-><para
->Аннотации в текущем файле.</para
-></listitem
-> </varlistentry
-> <varlistentry
-> <term
-><guilabel
->Для вас</guilabel
-></term
-> <listitem
-><para
-> Аннотации проекта, предназначенные для вас. Список группируются по файлам. </para
-></listitem
-> </varlistentry
-> <varlistentry
-> <term
-><guilabel
->Все файлы</guilabel
-></term
-> <listitem
-><para
-> Все аннотации проекта, сгруппированные по файлам </para
-></listitem
-> </varlistentry
-> </variablelist
-> Поиск аннотаций происходит при загрузке проекта и файлов (в т.ч. после внешних модификаций). Поиск может занять некоторое время и окно с сообщением об аннотациях, предназначеннвх для вас, может появиться через несколько секунд после загрузки проекта. </para>
+<para>Ники и обязанности должны указываться с учётом регистра, без пробелов рядом со скобками и двоеточием.</para>
+<para>Более подробная информация об учтасниках команды, обязанностях и никах приведена в разделе <xref linkend="team-members"/>.</para>
+<para>Все аннотации, содержащие в проекте, собираются в служебной панели <guilabel>Аннотации</guilabel>. Она состоит из трёх вкладок: <variablelist> <varlistentry> <term><guilabel>Текущий файл</guilabel></term> <listitem><para>Аннотации в текущем файле.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Для вас</guilabel></term> <listitem><para> Аннотации проекта, предназначенные для вас. Список группируются по файлам. </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Все файлы</guilabel></term> <listitem><para> Все аннотации проекта, сгруппированные по файлам </para></listitem> </varlistentry> </variablelist> Поиск аннотаций происходит при загрузке проекта и файлов (в т.ч. после внешних модификаций). Поиск может занять некоторое время и окно с сообщением об аннотациях, предназначеннвх для вас, может появиться через несколько секунд после загрузки проекта. </para>
</sect1>
&debugging-quanta; </chapter>