You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
103 lines
3.2 KiB
103 lines
3.2 KiB
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<sect1 id="configure">
|
|
<sect1info>
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Keith</firstname>
|
|
<surname>Isdale</surname>
|
|
<affiliation>
|
|
<address><email>k_isdale@tpg.com.au</email></address>
|
|
</affiliation>
|
|
</author>
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
</sect1info>
|
|
|
|
<title>Configuring a &kxsldbg; Session</title>
|
|
|
|
<para>
|
|
You start configuration by clicking
|
|
<menuchoice>
|
|
<guimenu>Debug</guimenu>
|
|
<guimenuitem>Configure</guimenuitem>
|
|
</menuchoice> in the Menubar.
|
|
</para>
|
|
|
|
<screenshot>
|
|
<screeninfo>The Configuration Dialog</screeninfo>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="configure_window.png" format="PNG" />
|
|
</imageobject>
|
|
<textobject><phrase>The Configuration Dialog</phrase></textobject>
|
|
<caption><para>The Configuration Dialog.</para></caption>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
<sect2>
|
|
<title>Getting Started</title>
|
|
|
|
<para>
|
|
To be able to run a stylesheet you need to specify the:
|
|
<itemizedlist mark="bullet">
|
|
<listitem><para>&XSL; source</para></listitem>
|
|
<listitem><para>&XML; data</para></listitem>
|
|
<listitem><para>Output file</para></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
|
|
<para> By using the <guibutton>...</guibutton> button to choose file
|
|
desired. The <guilabel>&XSL; source</guilabel> and <guilabel>>&XML; data</guilabel> may refer
|
|
to URI that contains a http://, ftp:// or file://. The <guilabel>Output file</guilabel>
|
|
must refer to a writable local file.</para>
|
|
<para>
|
|
To follow along with the examples, select the following files in the
|
|
example <filename role="directory"><KDE PREFIX>/share/apps/kxsldbg</filename> folder
|
|
<itemizedlist mark="bullet">
|
|
<listitem><para>&XSL; source: testdoc.xsl</para></listitem>
|
|
<listitem><para>&XML; data: testdoc.xml</para></listitem>
|
|
<listitem><para>Output file: /tmp/xsldbg_output.txt</para></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Working With Options</title>
|
|
|
|
<para>
|
|
You can select zero or more options from the <guilabel>Options</guilabel> dialog. Each option has a tooltip with a hint on what effect it has.
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Working With Parameters</title>
|
|
|
|
<para>
|
|
You can add zero or more parameters via the <guilabel>LibXSLT Parameters</guilabel>
|
|
section of dialog. This allows you to provide parameter values to the
|
|
stylesheet.
|
|
</para>
|
|
|
|
<para>
|
|
For example you could add a enter a <guilabel>Parameter name</guilabel> of <parameter>myparam</parameter>
|
|
with a <guilabel>Parameter value</guilabel> of <parameter>'Hello World!'</parameter> and click the <guibutton>Add</guibutton> button.
|
|
. To update the value of an existing
|
|
parameter just use the navigate to the value you wish to change with the <guibutton>Prev</guibutton> or <guibutton>Next</guibutton> button, provide a new <guilabel>Parameter value</guilabel> then click the <guibutton>Apply</guibutton>.
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Apply Changes</title>
|
|
|
|
<para>
|
|
For the changes you have made to take effect press the <guibutton>Apply</guibutton>
|
|
button. To ignore any changes press the <guibutton>Cancel</guibutton> button.
|
|
</para>
|
|
|
|
<para>
|
|
You can close the dialog using the <guibutton>X</guibutton> provided at the top right of the window. If you need to change the configuration just re-open the
|
|
configuration dialog as shown before.
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|