<chapter fileref='tkxsltproc.xml'>
  <title>tkxsltproc</title>
  <subtitle>GUI Application for xsltproc</subtitle>

  <chapterinfo>
    <revhistory>
      <revision>
	<revnumber>1.6</revnumber>
	<date>2004-12-21</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>v1.7 announcement.</para>
	</revremark>
      </revision>
      <revision>
	<revnumber>1.5</revnumber>
	<date>2004-09-02</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>v1.6 announcement.</para>
	</revremark>
      </revision>
      <revision>
	<revnumber>1.4</revnumber>
	<date>2004-07-20</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>v1.5 announcement.</para>
	</revremark>
      </revision>
      <revision>
	<revnumber>1.3</revnumber>
	<date>20040621</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>v1.4 Mac OS X announcement.</para>
	</revremark>
      </revision>
      <revision>
	<revnumber>1.2</revnumber>
	<date>20030924</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>v1.1 Mac OS X announcement.</para>
	</revremark>
      </revision>
      <revision>
	<revnumber>1.1</revnumber>
	<date>20030923</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>v1.1b1 announcement.</para>
	</revremark>
      </revision>
      <revision>
	<revnumber>1.0</revnumber>
	<date>20030221</date>
	<authorinitials>SRB</authorinitials>
	<revremark>
	  <para>Initial version</para>
	</revremark>
      </revision>
    </revhistory>
  </chapterinfo>

  <para><application>xsltproc</application> is a command-line tool for transforming XML documents.  It is part of the <ulink url='http://xmlsoft.org/XSLT/'>Gnome libxslt package</ulink>.  <application>tkxsltproc</application> is a GUI version of that tool.</para>

  <mediaobject>
    <imageobject>
      <imagedata fileref='tkxsltproc/screenshot.png'/>
    </imageobject>
  </mediaobject>

  <section>
    <title>Download and Installation</title>

     <orderedlist>
      <listitem>
	<itemizedlist>
	  <listitem>
	    <para>Version 1.7: <ulink url='http://prdownloads.sourceforge.net/tclxml/tkxsltproc-1.7.dmg.gz'>Mac OS X</ulink> <ulink url='http://prdownloads.sourceforge.net/tclxml/tkxsltproc-1.7.zip'>MS Windows</ulink> (Linux: Coming soon!)</para>
	  </listitem>
	</itemizedlist>
      </listitem>
      <listitem>
	<para>Unpack the distribution.</para>
	<itemizedlist>
	  <listitem>
	    <para>Windows users: use WinZip and extract the zip file.</para>
	  </listitem>
	  <listitem>
	    <para>Mac users: StuffIt Expander will decompress the disk image and mount it on your desktop.</para>
	  </listitem>
	</itemizedlist>
      </listitem>
      <listitem>
	<para>Use the program.</para>
	<itemizedlist>
	  <listitem>
	    <para>Windows users: double-click the <application>tkxsltproc.exe</application> program.</para>
	    <para>NB. If you want to move the application to a new location, you <emphasis>must</emphasis> move the entire directory - not just the executable file.</para>
	  </listitem>
	  <listitem>
	    <para>Mac users: Copy the <application>tkxsltproc</application> application to your <filename>Applications</filename> folder.</para>
	  </listitem>
	</itemizedlist>
      </listitem>
    </orderedlist>
  </section>

  <section>
    <title>Usage</title>

    <orderedlist>
      <listitem>
	<para>Use the "browse" button to locate the source XML document.  A future release will allow a HTTP URL to be entered.</para>
      </listitem>
      <listitem>
	<para>Use the "browse" button to locate the stylesheet document.  A future release will allow a HTTP URL to be entered.</para>
      </listitem>
      <listitem>
	<para>Optionally use the "browse" button to locate where the result document will be saved.  If you don't specify a location for the result document the result will appear in the messages window.</para>
      </listitem>
      <listitem>
	<para>Set the controls, such as XInclude and timing.  Future releases will support more of the standard <application>xsltproc</application> options.</para>
      </listitem>
      <listitem>
	<para>When the stylesheet is loaded (see step 2 above) the application automatically "senses" the parameters that the stylesheet accepts.  These are displayed in the "Parameters" pane and you may set their values.</para>
      </listitem>
      <listitem>
	<para>Press the "Transform" button.</para>
      </listitem>
    </orderedlist>
  </section>

<!--
  <section>
    <title>Documentation</title>

    <para>User Guide coming soon.</para>
  </section>
-->
</chapter>
