<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY xsldbg "<application
>xsldbg</application
>">
  <!ENTITY kappname "&xsldbg;">
  <!ENTITY package "kdewebdev">
  <!ENTITY % addindex "IGNORE">
<!ENTITY % Ukrainian "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<author
><personname
><firstname
>Keith</firstname
><surname
>Isdale</surname
></personname
><email
>keith@kdewebdev.org</email
></author>
<date
>27 березня 2006 року</date>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>xsldbg</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
><command
>xsldbg</command
></refname>
<refpurpose
>Інструмент командного рядка для зневаджування скриптів XSLT</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>xsldbg</command
> <group
><option
>--shell</option
></group
> <group
><option
>--cd &lt;ШЛЯХ&gt;</option
></group
> <group
><option
>--param &lt;НАЗВА&gt;:&lt;ЗНАЧЕННЯ&gt;</option
></group
> <group
><option
>--lang &lt;МОВА&gt;</option
></group
> <group
><option
>--output &lt;ФАЙЛ&gt;</option
></group
> <group
><option
>--version</option
></group
> <group
><option
>--verbose</option
></group
> <group
><option
>--timing</option
></group
> <group
><option
>--repeat</option
></group
> <group
><option
>--debug</option
></group
> <group
><option
>--valid</option
></group
> <group
><option
>--out</option
></group
> <group
><option
>--maxdepth val</option
></group
> <group
><option
>--html</option
></group
> <group
><option
>--docbook</option
></group
> <group
><option
>--net</option
></group
> <group
><option
>--catalogs</option
></group
> <group
><option
>--xinclude</option
></group
> <group
><option
>--profile</option
></group
> <group
><option
>--gdb</option
></group
> <group
><option
>--autoencode</option
></group
> <group
><option
>--utf8input</option
></group
> <group
><option
>--preferhtml</option
></group
> <group
><option
>--stdout</option
></group
> <group
><option
>--autorestart</option
></group
> <group
><option
>+XSLSource</option
></group
> <group
><option
>+XMLData</option
></group
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Опис</title>

<para
>&xsldbg; — це інструмент призначений для того, щоб допомогти вам зрозуміти таблиці стилів. Від інших інструментів для усування вад у таблицях стилів його відрізняє можливість пошуку потрібних елементів і слідкування за виконанням таблиці стилів. </para>

<para
>&xsldbg; — інструмент усування вад з таблиць стилів (мовою розширюваних таблиць стилів — eXtensible Stylesheet Language), який працює у текстовому режимі і має команди, подібні до команд інструменту усування вад у Unix/Linux, gdb. Програма може працювати у трьох основних режимах виконання таблиць стилів. </para>
<itemizedlist>
<listitem
><para
>Запуск для всієї таблиці стилів</para
></listitem>
<listitem
><para
>Перейти до наступної інструкції xsl</para
></listitem>
<listitem
><para
>Продовжувати до наступної точки зупину або до перезапуску таблиці стилів</para
></listitem>
</itemizedlist>

</refsect1>



<refsect1>
<title
>Параметри</title>

<variablelist>
<title
>Параметри програми</title>
<para
>Зауваження: щоб вимкнути певний параметр, додайте «no» перед назвою параметра, наприклад, «nonet».</para>
<para
>Зауваження: параметри, позначені символом «*» типово увімкнено.</para>
<varlistentry>
<term
><option
>--shell</option
></term>
<listitem
><para
>Запустити оболонку, після запуску використати команду help &xsldbg; для отримання довідки з запуску.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--cd &lt;ШЛЯХ&gt;</option
></term>
<listitem
><para
>Адреса каталогу, куди слід перейти перед завантаженням файлів. Див. документацію щодо команди «cd».</para
></listitem>
</varlistentry>

<varlistentry>
	<term
><option
>--param &lt;НАЗВА&gt;:&lt;ЗНАЧЕННЯ&gt;</option
></term>
	<listitem
><para
>Додати параметр з назвою &lt;НАЗВА&gt; і значенням &lt;ЗНАЧЕННЯ&gt; до середовища XSL. Див. документацію з команди «addparam».</para>
		<para
>Зауваження: Замість «:» між назвою і значенням можна використовувати «=».</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--lang &lt;МОВА&gt;</option
></term>
<listitem
><para
>Вживати вказаний код мови ISO 639, наприклад, en_US</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--output &lt;ФАЙЛ&gt;</option
></term>
<listitem
><para
>Зберегти до вказаного файла. Перегляньте також документацію команди виводу</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--version</option
></term>
<listitem
><para
>Показати версії використаних libxml і libxslt</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--verbose</option
></term>
<listitem
><para
>Показувати записи журналу</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--timing</option
></term>
<listitem
><para
>Показати витрачений час</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--repeat</option
></term>
<listitem
><para
>Виконати перетворення 20 разів, якщо --repeat вказано двічі, виконати перетворення 100 разів</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--debug</option
></term>
<listitem
><para
>Отримати дамп дерева результату, якщо підтримку такого отримання увімкнено у libxml.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--valid*</option
></term>
<listitem
><para
>Вмикає фазу завантаження DTD, типово цей параметр увімкнено.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--out*</option
></term>
<listitem
><para
>Вмикає виведення результату, типово увімкнено</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--maxdepth значення</option
></term>
<listitem
><para
>Збільшити максимальну глибину</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--html</option
></term>
<listitem
><para
>Вхідними документами є файли HTML, які слід обробляти відповідно, якщо у libxml увімкнено підтримку таких документів</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--docbook</option
></term>
<listitem
><para
>Вхідним документом є docbook SGML, якщо у libxml увімкнено підтримку таких документів.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--net*</option
></term>
<listitem
><para
>Увімкнути отримання DTD і записів за допомогою мережі, типово цей параметр увімкнено.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--catalogs</option
></term>
<listitem
><para
>Використовувати каталоги з $SGML_CATALOG_FILES, якщо у libxml увімкнено підтримку таких каталогів.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--xinclude*</option
></term>
<listitem
><para
>Увімкнути обробку XInclude під час отримання вхідних даних документа, якщо у libxml увімкнено підтримку такої обробки, типово цей параметр увімкнено.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--profile</option
></term>
<listitem
><para
>Надрукувати інформацію профілювання</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--gdb*</option
></term>
<listitem
><para
>Запустити у режимі сумісності з GDB і виводити докладні відомості, типово увімкнено</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autoencode*</option
></term>
<listitem
><para
>Виявляти і використовувати кодування в таблицях стилів</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--utf8input</option
></term>
<listitem
><para
>Припускати, що ввід командного рядка в UTF-8</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--preferhtml</option
></term>
<listitem
><para
>Вживати вивід HTML для створення звітів пошуку</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--stdout</option
></term>
<listitem
><para
>Виводити всі повідомлення про помилки на stdout, зазвичай вони виводяться на stderr</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autorestart</option
></term>
<listitem
><para
>Увімкнути автоматичний перезапуск виконання після завершення виконання поточного проходу</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XSLSource</option
></term>
<listitem
><para
>Скрипт XSL, який слід запустити (за бажання)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XMLData</option
></term>
<listitem
><para
>Дані XML, які слід перетворити (якщо вказано XSLSource)</para
></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1>
<title
>Автори</title>
<para
>Поточним автором і супровідником &xsldbg; є Keith Isdale<email
>keith@kdewebdev.org</email
> </para>
</refsect1>


</refentry>
