From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- .../docs/tdewebdev/quanta/adv-quanta.docbook | 689 +++++---------------- 1 file changed, 141 insertions(+), 548 deletions(-) (limited to 'tde-i18n-ru/docs/tdewebdev/quanta/adv-quanta.docbook') 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 @@ -Дополнительные возможности +Дополнительные возможности -Christopher Hornbaker
chrishornbaker@earthlink.net
+Christopher Hornbaker
chrishornbaker@earthlink.net
 -НиколайШафоростов
shafff@ukr.net
Перевод на русский +НиколайШафоростов
shafff@ukr.net
Перевод на русский -Дополнительные возможности +Дополнительные возможности -Эта глава описывает нестандартные возможности &quantaplus; и как их использовать. +Эта глава описывает нестандартные возможности &quantaplus; и как их использовать. -Средства &XML; +Средства &XML; -В версии 3.2 появились средства работы с &XML;, а в 3.4 была добавлена поддержка DocBook. Все они используют Kommander как front-end (интерфейс) и библиотеки libxml и libxslt как back-end (движок). +В версии 3.2 появились средства работы с &XML;, а в 3.4 была добавлена поддержка DocBook. Все они используют Kommander как front-end (интерфейс) и библиотеки libxml и libxslt как back-end (движок). -Средства создания документации &kde; +Средства создания документации &kde; -&quantaplus; поддерживает две главных утилиты документации &kde;: meinproc и checkXML. +&quantaplus; поддерживает две главных утилиты документации &kde;: meinproc и checkXML. -<command ->meinproc</command -> +<command>meinproc</command> -Все, кто работал с документацией &kde;, знают какая это замечательная программа. Теперь вы можете забыть о консоли и наслаждаться графическим интерфейсом с предустановленными действиями - нажмите кнопку с изображением процессора и всё готово. +Все, кто работал с документацией &kde;, знают какая это замечательная программа. Теперь вы можете забыть о консоли и наслаждаться графическим интерфейсом с предустановленными действиями - нажмите кнопку с изображением процессора и всё готово. -Текущий рабочий каталог +Текущий рабочий каталог -Meinproc ищет файл index.docbook. Если он находится в текущем каталоге, оставьте этот параметр включённым. Иначе - введите путь к другому каталогу. +Meinproc ищет файл index.docbook. Если он находится в текущем каталоге, оставьте этот параметр включённым. Иначе - введите путь к другому каталогу. -Выходные файлы сохраняются в один каталог с исходными. Все файлы &HTML; сначала удаляются при каждом запуске meinproc. +Выходные файлы сохраняются в один каталог с исходными. Все файлы &HTML; сначала удаляются при каждом запуске meinproc. -<command ->checkXML</command -> +<command>checkXML</command> -&quantaplus; также обеспечивает простой графический интерфейс к этой полезной программе. +&quantaplus; также обеспечивает простой графический интерфейс к этой полезной программе. -Текущий рабочий каталог +Текущий рабочий каталог -Если index.docbook открыт и является активным, оставьте Текущий рабочий каталог включённым, иначе введите другой каталог с index.docbook. +Если index.docbook открыт и является активным, оставьте Текущий рабочий каталог включённым, иначе введите другой каталог с index.docbook. -Вывод -Если имеется вывод, в файле есть ошибки. Исправьте их и попытайтесь ещё раз. +Вывод +Если имеется вывод, в файле есть ошибки. Исправьте их и попытайтесь ещё раз. -Проверка &XML; +Проверка &XML; -С &quantaplus; поставляется отличное средство синтаксической проверки &XML;, которое использует xmllint. +С &quantaplus; поставляется отличное средство синтаксической проверки &XML;, которое использует xmllint. -Текущий файл +Текущий файл -Если файл, который нужно проверить, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. +Если файл, который нужно проверить, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. -Проверка правильности синтаксиса +Проверка правильности синтаксиса -Если вы хотите выполнить только такую проверку, включите этот параметр. +Если вы хотите выполнить только такую проверку, включите этот параметр. -&URI; описания +&URI; описания -Если вы используете &DTD; и он указан в файле &XML;, выберите &DTD; (внутрен.), иначе - &DTD; (внешн.) и укажите адрес описания &DTD;. &W3C; XML Schema и RelaxNG Schema должны быть описаны внешне, через &URI;. +Если вы используете &DTD; и он указан в файле &XML;, выберите &DTD; (внутрен.), иначе - &DTD; (внешн.) и укажите адрес описания &DTD;. &W3C; XML Schema и RelaxNG Schema должны быть описаны внешне, через &URI;. -Обработка &XSL; +Обработка &XSL; -&quantaplus; поставляется со средством обработки &XSL;, которое использует программу xsltproc из пакета pplication ->libxml2. +&quantaplus; поставляется со средством обработки &XSL;, которое использует программу xsltproc из пакета pplication>libxml2. -Текущий файл +Текущий файл -Если файл, который нужно обработать, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. +Если файл, который нужно обработать, активный в &quantaplus;, оставьте этот параметр включённым. Иначе - выберите другой файл. -Таблица стилей +Таблица стилей -Выберите файл &XSL;, который вы хотите использовать. +Выберите файл &XSL;, который вы хотите использовать. -Имя выходного файла +Имя выходного файла -Файл сохраняется в ваш домашний каталог, если не указано иначе. +Файл сохраняется в ваш домашний каталог, если не указано иначе. -Пока что приложение не имеет гибких настроек. Ждите в следующей версии. +Пока что приложение не имеет гибких настроек. Ждите в следующей версии. + --> -Использование модулей +Использование модулей -Mathieu Kooiman
quanta@map-is.nl
+Mathieu Kooiman
quanta@map-is.nl
 -НиколайШафоростов
shafff@ukr.net
Перевод на русский +НиколайШафоростов
shafff@ukr.net
Перевод на русский -Использование модулей +Использование модулей -Что такое модуль? +Что такое модуль? -&quantaplus; может загружать компоненты KParts. KPart - мощная база интегрирования &kde;. Например, &quantaplus; использует &kate; KPart. Последний уже имел базовые функции, которые требовались &quantaplus;, такие как подсветка синтаксиса. Интегрирование его в &quantaplus; позволило сэкономить время и сразу начать работать над специфическими возможностями программы. +&quantaplus; может загружать компоненты KParts. KPart - мощная база интегрирования &kde;. Например, &quantaplus; использует &kate; KPart. Последний уже имел базовые функции, которые требовались &quantaplus;, такие как подсветка синтаксиса. Интегрирование его в &quantaplus; позволило сэкономить время и сразу начать работать над специфическими возможностями программы. -Для добавления модулей в &quantaplus; не нужно ничего делать с самой программой. Вы можете использовать новые возможности, не ожидая пока кто-нибудь интегрирует их (т.е. модуль, обеспечивающий их) с программой! Подробности описываются ниже. +Для добавления модулей в &quantaplus; не нужно ничего делать с самой программой. Вы можете использовать новые возможности, не ожидая пока кто-нибудь интегрирует их (т.е. модуль, обеспечивающий их) с программой! Подробности описываются ниже. -Что такое диалог редактирования модулей - -Чтобы установить модуль (в т.ч. KPart), зайдите в меню Модули Правка : +Что такое диалог редактирования модулей + +Чтобы установить модуль (в т.ч. KPart), зайдите в меню Модули Правка : -Окно Модули. +Окно Модули. -Здесь вы можете управлять модулями, добавлять новые. Опишем каждый его элемент: +Здесь вы можете управлять модулями, добавлять новые. Опишем каждый его элемент: -Искать в +Искать в -При добавлении модуля без Расположения, &quantaplus; будет искать его указанных местах. +При добавлении модуля без Расположения, &quantaplus; будет искать его указанных местах. -Добавить +Добавить -Вызывает диалог добавления модуля. +Вызывает диалог добавления модуля. -Настройка +Настройка -Изменить настройки выбранного модуля. +Изменить настройки выбранного модуля. -Удалить +Удалить -Удалить выбранный модуль. +Удалить выбранный модуль. -Обновить +Обновить -Обновить содержание диалога. +Обновить содержание диалога. -Для подробностей о модулях, обратитесь к разделу . +Для подробностей о модулях, обратитесь к разделу . - Командная разработка - В большинстве проектов задействовано несколько человек, связанных определёнными иерархическими отношениями. В &quantaplus; присутствует понятие членов команды, их можно настроить в &Shift;F7 Проект Свойства проекта . + Командная разработка + В большинстве проектов задействовано несколько человек, связанных определёнными иерархическими отношениями. В &quantaplus; присутствует понятие членов команды, их можно настроить в &Shift;F7 Проект Свойства проекта . - Диалог редактирования члена команды + Диалог редактирования члена команды - Поля Имя, Email не требуют объяснения. Ник - уникальный краткий идентификатор пользователя. - Обязанность определяет роль участника в проекте, возможные значения: - -Лидер команды - - -Ведущий подпроекта - - -Главный по заданию - - -Участник - + Поля Имя, Email не требуют объяснения. Ник - уникальный краткий идентификатор пользователя. + Обязанность определяет роль участника в проекте, возможные значения: + +Лидер команды + + +Ведущий подпроекта + + +Главный по заданию + + +Участник + -Задание - описание задач, закреплённых за участником. -Подпроект: подпроекты можно создать и настроить нажатием кнопки Подпроекты.... Параметры подпроекта - имя и расположение относительно папки проекта, т.е. подпроектом можно назвать папку в дереве проекта. Например, базовым проектом может быть сайт вашей компании, а подпроектом может выступать сайт для вашей внутренней сети, с соответствующей ему в проекте папкой intranet. -У одного члена команды может быть несколько обязанностей. -Пользователь должен выбрать свою обязанность в команде. Для этого следует выбрать пункт из списка предлагаемых и нажать кнопку Взять на себя. Выбранная обязанность будет содержаться в графе Ваша должность. -Выбор ника и обязанности необходим для рассылки уведомлений и аннотаций. Информация о последних приведена в разделе . -Вы можете создать событие, передаваемое, например, лидерам проекта, когда произойдёт какое-нибудь событие. Для подробностей см. . +Задание - описание задач, закреплённых за участником. +Подпроект: подпроекты можно создать и настроить нажатием кнопки Подпроекты.... Параметры подпроекта - имя и расположение относительно папки проекта, т.е. подпроектом можно назвать папку в дереве проекта. Например, базовым проектом может быть сайт вашей компании, а подпроектом может выступать сайт для вашей внутренней сети, с соответствующей ему в проекте папкой intranet. +У одного члена команды может быть несколько обязанностей. +Пользователь должен выбрать свою обязанность в команде. Для этого следует выбрать пункт из списка предлагаемых и нажать кнопку Взять на себя. Выбранная обязанность будет содержаться в графе Ваша должность. +Выбор ника и обязанности необходим для рассылки уведомлений и аннотаций. Информация о последних приведена в разделе . +Вы можете создать событие, передаваемое, например, лидерам проекта, когда произойдёт какое-нибудь событие. Для подробностей см. . - Действия, порождаемые событиями - Это действия. выполняемые при возникновении определённого события в проекте. Действие может заключаться, например, в записи времени открытия и закрытия проекта, чтобы можно было посчитать, сколько времени на него потрачено; или в отправке письма при сохранении файла; или в добавлении в CVS файла, добавленного в проект. - На вкладке Параметры событий диалога &Shift;F7 Проект Свойства проекта можно создавать, изменять и удалять действия, связанные с событиями. + Действия, порождаемые событиями + Это действия. выполняемые при возникновении определённого события в проекте. Действие может заключаться, например, в записи времени открытия и закрытия проекта, чтобы можно было посчитать, сколько времени на него потрачено; или в отправке письма при сохранении файла; или в добавлении в CVS файла, добавленного в проект. + На вкладке Параметры событий диалога &Shift;F7 Проект Свойства проекта можно создавать, изменять и удалять действия, связанные с событиями. - Редактор событий + Редактор событий -Доступные поля: +Доступные поля: -Событие -событие, при возникновении которого выполняется действие. +Событие +событие, при возникновении которого выполняется действие. -Действие -тип действия, возможные варианты: +Действие +тип действия, возможные варианты: -Несценарное действие -действие, не заключающееся в запуске внешнего сценария. См. . -Имя действия определяет выполняемое действие. +Несценарное действие +действие, не заключающееся в запуске внешнего сценария. См. . +Имя действия определяет выполняемое действие. - Отправить E-Mail - отправить email, получателей можно указать в соответствующем списке. Например, это может быть лидер проекта, или ведущий подпроекта. См. . + Отправить E-Mail + отправить email, получателей можно указать в соответствующем списке. Например, это может быть лидер проекта, или ведущий подпроекта. См. . - Занести событие в журнал - доступные параметры: + Занести событие в журнал + доступные параметры: - Журнал - полное имя файла (с путём к нему) + Журнал + полное имя файла (с путём к нему) - Подробности - На сколько подробную запись делать + Подробности + На сколько подробную запись делать - Поведение - Создавать ли журнал в случае его отсутствия, заменять ли существующий журнал или же дополнять его. + Поведение + Создавать ли журнал в случае его отсутствия, заменять ли существующий журнал или же дополнять его. -Cценарное действие -выполнять сценарий - Имя действия определяет выполняемое действие. +Cценарное действие +выполнять сценарий + Имя действия определяет выполняемое действие. @@ -692,138 +382,41 @@ replace and .png for the replacement string. -Остальные поля зависят от типа действия. +Остальные поля зависят от типа действия. -Аннотации -Аннотации - это комментарии определённой формы в документах. От обычных комментариев они имеют следующие отличия: -аннотации собираются и показываются в одноимённой служебной панели. -аннотации могут предназначаться для определённого участника команды. +Аннотации +Аннотации - это комментарии определённой формы в документах. От обычных комментариев они имеют следующие отличия: +аннотации собираются и показываются в одноимённой служебной панели. +аннотации могут предназначаться для определённого участника команды. -Для добавления аннотации можно воспользоваться пунктом Добавить аннотацию контекстного меню редактора или просто ввести текст аннотации после ключевого слова @annotation в области комментария. Пример аннотации в XML<!-- @annotation Кто-то понял, как это работает? --> -<!-- @annotation +Для добавления аннотации можно воспользоваться пунктом Добавить аннотацию контекстного меню редактора или просто ввести текст аннотации после ключевого слова @annotation в области комментария. Пример аннотации в XML<!-- @annotation Кто-то понял, как это работает? --> +<!-- @annotation Аннотация на несколько строк. ---> -Пример аннотации в PHP/* @annotation +--> +Пример аннотации в PHP/* @annotation Не забудьте, что аннотации в области PHP нужно вводить внутри комментария PH */ -Аннотации могут предназначаться для определённого участника команды. В этом случае следует использовать такой формат: @annotation(ник) или @annotation(обязанность), где ник - идентификатор участника команды, а обязанность принимает одно из следующих значений: team leader task leader subproject leader Ссылки на ведущего подпроекта и главного по заданию должны сопровождаться соответствующим именем подпроекта или задания, через двоеточие. +Аннотации могут предназначаться для определённого участника команды. В этом случае следует использовать такой формат: @annotation(ник) или @annotation(обязанность), где ник - идентификатор участника команды, а обязанность принимает одно из следующих значений: team leader task leader subproject leader Ссылки на ведущего подпроекта и главного по заданию должны сопровождаться соответствующим именем подпроекта или задания, через двоеточие. -Заметка участнику команды с ником <emphasis ->eric</emphasis -> -<-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --> +Заметка участнику команды с ником <emphasis>eric</emphasis> +<-- @annotation(eric) Эрик, глянь-ка, что это я тут сотворил. Андрэ --> -Уведомление лидера команды -<-- @annotation(team leader) Это важно для всей команды --> +Уведомление лидера команды +<-- @annotation(team leader) Это важно для всей команды --> -Уведомление ведущего подпроекта <emphasis ->PHP</emphasis -> -// @annotation(subproject leader:PHP) Как тебе такой расклад? +Уведомление ведущего подпроекта <emphasis>PHP</emphasis> +// @annotation(subproject leader:PHP) Как тебе такой расклад? -Ники и обязанности должны указываться с учётом регистра, без пробелов рядом со скобками и двоеточием. -Более подробная информация об учтасниках команды, обязанностях и никах приведена в разделе . -Все аннотации, содержащие в проекте, собираются в служебной панели Аннотации. Она состоит из трёх вкладок: Текущий файл Аннотации в текущем файле. Для вас Аннотации проекта, предназначенные для вас. Список группируются по файлам. Все файлы Все аннотации проекта, сгруппированные по файлам Поиск аннотаций происходит при загрузке проекта и файлов (в т.ч. после внешних модификаций). Поиск может занять некоторое время и окно с сообщением об аннотациях, предназначеннвх для вас, может появиться через несколько секунд после загрузки проекта. +Ники и обязанности должны указываться с учётом регистра, без пробелов рядом со скобками и двоеточием. +Более подробная информация об учтасниках команды, обязанностях и никах приведена в разделе . +Все аннотации, содержащие в проекте, собираются в служебной панели Аннотации. Она состоит из трёх вкладок: Текущий файл Аннотации в текущем файле. Для вас Аннотации проекта, предназначенные для вас. Список группируются по файлам. Все файлы Все аннотации проекта, сгруппированные по файлам Поиск аннотаций происходит при загрузке проекта и файлов (в т.ч. после внешних модификаций). Поиск может занять некоторое время и окно с сообщением об аннотациях, предназначеннвх для вас, может появиться через несколько секунд после загрузки проекта. &debugging-quanta; -- cgit v1.2.1