<?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 % German "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> <author ><personname ><firstname >Keith</firstname ><surname >Isdale</surname ></personname ><email >keith@kdewebdev.org</email ></author> <date >27. März 2006</date> </refentryinfo> <refmeta> <refentrytitle ><command >xsldbg</command ></refentrytitle> <manvolnum >1</manvolnum> </refmeta> <refnamediv> <refname ><command >xsldbg</command ></refname> <refpurpose >Ein Befehlszeilenprogramm für das Debuggen von XSLT-Skripten</refpurpose> </refnamediv> <refsynopsisdiv> <cmdsynopsis ><command >xsldbg</command > <group ><option >--shell</option ></group > <group ><option >--cd <PATH></option ></group > <group ><option >--param <NAME>:<VALUE></option ></group > <group ><option >--lang <LANG></option ></group > <group ><option >--output <FILE></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 >Beschreibung</title> <para >&xsldbg; ist ein Werkzeug zur Untersuchung von Stilvorlagen. Im Unterschied zu anderen Programmen für Stilvorlagen ist die Suche nach bestimmten Elementen möglich und die Ausführung der Stilvorlage kann verfolgt werden. </para> <para >&xsldbg; ist ein Programm zur Fehlersuche (debuggen) in XSL-Stilvorlagen (XSL = eXtensible Stylesheet Language). &xsldbg; hat ähnliche Befehle wie der Unix/Linux Debugger gdb. Es gibt drei Möglichkeiten, eine Stilvorlage auszuführen: </para> <itemizedlist> <listitem ><para >Ausführung der gesamten Stilvorlage</para ></listitem> <listitem ><para >Schrittweise zum nächsten XSL-Befehl</para ></listitem> <listitem ><para >Ausführung bis zum nächsten Haltepunkt oder bis zum Neustart der Stilvorlage</para ></listitem> </itemizedlist> </refsect1> <refsect1> <title >Optionen</title> <variablelist> <title >Anwendungsoptionen</title> <para >Hinweis: Um eine Option abzuschalten, setzen Sie ein „no“ vor den Namen der Option, ⪚ „nonet“</para> <para >Hinweis: Alle mit „*“ markierten Optionen sind als Voreinstellung eingeschaltet</para> <varlistentry> <term ><option >--shell</option ></term> <listitem ><para >Startet eine Shell. Geben Sie dann den &xsldbg;-Befehl „help“ ein, um eine Übersicht der Hilfe zu erhalten.</para ></listitem> </varlistentry> <varlistentry> <term ><option >--cd <PATH></option ></term> <listitem ><para >Pfad zum Ordner, in den vor dem Laden von Dateien gewechselt werden soll. Sihe auch die Dokumentation zum Befehl „cd“</para ></listitem> </varlistentry> <varlistentry> <term ><option >--param <NAME>:<VALUE></option ></term> <listitem ><para >Fügt den Parameter mit dem Namen <NAME> und dem Wert <VALUE> zu den XSL-Umgebungsvariablen hinzu. Siehe auch die Dokumentation zum Befehl „addparam“</para> <para >Hinweis: Auch das Zeichen „=“ kann anstelle des „:“ als Trennung zwischen Name und Wert benutzt werden</para ></listitem> </varlistentry> <varlistentry> <term ><option >--lang <LANG></option ></term> <listitem ><para >Verwendet den angegebenen ISO-639-Sprachcode, zum Beispiel de_DE</para ></listitem> </varlistentry> <varlistentry> <term ><option >--output <FILE></option ></term> <listitem ><para >Speichert in eine angegebene Datei. Siehe die Dokumentation zu Ausgabebefehlen</para ></listitem> </varlistentry> <varlistentry> <term ><option >--version</option ></term> <listitem ><para >Zeigt die Version von libxml und libxslt an</para ></listitem> </varlistentry> <varlistentry> <term ><option >--verbose</option ></term> <listitem ><para >Zeigt Protokolle über den Ablauf an</para ></listitem> </varlistentry> <varlistentry> <term ><option >--timing</option ></term> <listitem ><para >Zeigt die verstrichene Zeit an</para ></listitem> </varlistentry> <varlistentry> <term ><option >--repeat</option ></term> <listitem ><para >Führt die Umwandlung 20 mal aus, wenn --repeat zweifach aangegeben ist, wird die Umwandlung 100 mal ausgeführt</para ></listitem> </varlistentry> <varlistentry> <term ><option >--debug</option ></term> <listitem ><para >Ausgabe des Ergebnisbaums, wenn die Unterstützung dafür in libxml aktiviert worden ist</para ></listitem> </varlistentry> <varlistentry> <term ><option >--valid*</option ></term> <listitem ><para >Führt den DTD-Ladevorgang aus, das ist als Voreinstellung eingeschaltet</para ></listitem> </varlistentry> <varlistentry> <term ><option >--out*</option ></term> <listitem ><para >Aktiviert die Ausgabe des Ergebnisses, das ist als Voreinstellung eingeschaltet</para ></listitem> </varlistentry> <varlistentry> <term ><option >--maxdepth val</option ></term> <listitem ><para >Vergrößert die maximale Tiefe</para ></listitem> </varlistentry> <varlistentry> <term ><option >--html</option ></term> <listitem ><para >Die Eingabedokumente werden als HTML-Dateien behandelt, wenn die Unterstützung dafür in libxml aktiviert worden ist</para ></listitem> </varlistentry> <varlistentry> <term ><option >--docbook</option ></term> <listitem ><para >Das Eingabedokument wird als SGML-Docbook behandelt, wenn die Unterstützung dafür in libxml aktiviert worden ist</para ></listitem> </varlistentry> <varlistentry> <term ><option >--net*</option ></term> <listitem ><para >Ermöglicht das Laden von DTDs oder Entitäten über das Netzwerk, das ist als Voreinstellung eingeschaltet</para ></listitem> </varlistentry> <varlistentry> <term ><option >--catalogs</option ></term> <listitem ><para >Verwendet die Kataloge in $SGML_CATALOG_FILES, wenn die Unterstützung dafür in libxml aktiviert worden ist</para ></listitem> </varlistentry> <varlistentry> <term ><option >--xinclude*</option ></term> <listitem ><para >Aktiviert die XInclude-Verarbeitung des Eingabedokuments, wenn die Unterstützung dafür in libxml aktiviert worden ist. Das ist als Voreinstellung eingeschaltet</para ></listitem> </varlistentry> <varlistentry> <term ><option >--profile</option ></term> <listitem ><para >Profiling-Informationen drucken</para ></listitem> </varlistentry> <varlistentry> <term ><option >--gdb*</option ></term> <listitem ><para >Ausführung im GDB-Kompalibitätsmodus mit ausführlichen Informationen, das ist als Voreinstellung eingeschaltet</para ></listitem> </varlistentry> <varlistentry> <term ><option >--autoencode*</option ></term> <listitem ><para >Sucht nach einer Kodierung in der Stilvorlage und benutzt diese Kodierung</para ></listitem> </varlistentry> <varlistentry> <term ><option >--utf8input</option ></term> <listitem ><para >Behandelt die Befehlszeileneingabe als UTF-8 kodiert</para ></listitem> </varlistentry> <varlistentry> <term ><option >--preferhtml</option ></term> <listitem ><para >Verwendet HTML-Ausgabe beim Erstellen der Suchergebnisse</para ></listitem> </varlistentry> <varlistentry> <term ><option >--stdout</option ></term> <listitem ><para >Druckt alle Fehlermeldungen nach stdout, normalerweise gehen Fehlermeldungen nach stderr</para ></listitem> </varlistentry> <varlistentry> <term ><option >--autorestart</option ></term> <listitem ><para >Schaltet den automatischen Neustart der Ausführung ein, wenn der gegenwärtige Durchlauf beendet ist</para ></listitem> </varlistentry> <varlistentry> <term ><option >+XSLSource</option ></term> <listitem ><para >XSL-Skript zum Ausführen (optional)</para ></listitem> </varlistentry> <varlistentry> <term ><option >+XMLData</option ></term> <listitem ><para >XML-Dateen zur Umwandlung (optional wenn die XSL-Quelle angegeben wurde)</para ></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> <title >Autor</title> <para >&xsldbg; wurde von Keith Isdale<email >keith@kdewebdev.org</email > geschrieben. Er ist auch der derzeitige Betreuer. </para> </refsect1> </refentry>