diff options
Diffstat (limited to 'tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook')
| -rw-r--r-- | tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook | 689 |
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 & Replace Project dialog. </para> @@ -277,17 +176,13 @@ Search & Replace Project dialog. <imageobject> <imagedata fileref="kfr-new-dialog.png" format="PNG"/> </imageobject> -<caption -><para ->KFileReplace's New Search & Replace Project dialog.</para -></caption> +<caption><para>KFileReplace's New Search & 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 -><!-- @annotation Кто-то понял, как это работает? --></screen> -<screen -><!-- @annotation +<para>Для добавления аннотации можно воспользоваться пунктом <guilabel>Добавить аннотацию</guilabel> контекстного меню редактора или просто ввести текст аннотации после ключевого слова <emphasis>@annotation</emphasis> в области комментария. <example><title>Пример аннотации в XML</title><screen><!-- @annotation Кто-то понял, как это работает? --></screen> +<screen><!-- @annotation Аннотация на несколько строк. ---></screen -></example> -<example -><title ->Пример аннотации в PHP</title -><screen ->/* @annotation +--></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 -><-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --></screen> +<example><title>Заметка участнику команды с ником <emphasis>eric</emphasis></title> +<screen><-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --></screen> </example> -<example -><title ->Уведомление лидера команды</title> -<screen -><-- @annotation(team leader) Это важно для всей команды --></screen> +<example><title>Уведомление лидера команды</title> +<screen><-- @annotation(team leader) Это важно для всей команды --></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> |