<?xml version="1.0" encoding="UTF-8" ?> <sect1 id="mainwindow-section"> <sect1info> <authorgroup> <author ><firstname >Keith</firstname > <surname >Isdale</surname > <affiliation > <address ><email >k_isdale@tpg.com.au</email ></address> </affiliation> </author> <othercredit role="translator" ><firstname >José</firstname ><surname >Pires</surname ><affiliation ><address ><email >jncp@netcabo.pt</email ></address ></affiliation ><contrib >Tradução</contrib ></othercredit > </authorgroup> </sect1info> <title >Usar a Janela Principal</title> <screenshot> <screeninfo >A Janela Principal</screeninfo> <mediaobject> <imageobject> <imagedata fileref="main_window.png" format="PNG"/> </imageobject> <textobject ><phrase >Uma janela de texto com o ficheiro actual a ser depurado</phrase ></textobject> <caption ><para >Uma janela de texto com o ficheiro actual a ser depurado.</para ></caption> </mediaobject> </screenshot> <sect2> <title >Trabalhar na Janela Principal</title> <para >O estado de um determinado ponto de paragem é indicado através do texto relevante com uma cor de fundo diferente. Poderá escolher a cor desejada: veja na janela em <menuchoice ><guimenu >Configuração</guimenu ><guimenuitem >Configurar o Editor</guimenuitem ></menuchoice >, na página de <guilabel >Cores</guilabel >.</para> <para >Você poderá definir, desactivar ou remover um ponto de paragem, usando as teclas, o menu <guimenu >Depurar</guimenu > ou os botões da barra de ferramentas.</para> <para >Você poderá mover o cursor pelo texto, usando as seguintes teclas:</para> <simplelist> <member >Teclas de cursores: <keysym >Esquerda</keysym >, <keysym >Direita</keysym >, <keysym >Cima</keysym > ou <keysym >Baixo</keysym >.</member> <member >Teclas de página: <keycap >Page Up</keycap > ou <keycap >Page Down</keycap ></member> </simplelist> </sect2> <sect2> <title >Lidar com o Resultado do &kxsldbg;</title> <para >Grande parte do resultado do &kxsldbg; é capturado e apresentado tanto na janela dos inspectores como no resultado do &kxsldbg;. As excepções a esta regra são:</para> <itemizedlist> <listitem> <para >Uma mensagem de erro que vem do &kxsldbg; e que é mostrada dentro de uma janela de mensagens.</para> </listitem> <listitem> <para >O resultado da avaliação de uma expressão que é também mostrado numa janela de mensagens.</para> </listitem> <listitem> <para >O resultado da procura é enviado par ao ficheiro indicado na janela de resultado do &kxsldbg;.</para> </listitem> </itemizedlist> </sect2> <!-- FIXME: There's way too many things wrong with this, for people to bother translating it just yet. We can fix post 3.2 Specifically: Wrong icon images, all keybindings are incorrect, all keybindings in the app are unmodified and therefore will probably be changed, and this isn't the ideal place to put a toolbar ref anyway. Plan: Add a menu ref chapter, include an updated toolbar ref in it <sect2> <title >&kxsldbg; Toolbar</title> <variablelist> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="configure.png" format="PNG"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Configure</guimenuitem> </menuchoice> </term> <listitem> <para> Configuration for a session, <xref linkend="configure"/> </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="configure.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Inspect</guimenuitem> </menuchoice> </term> <listitem> <para> To be written. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="run.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Run</guimenuitem> </menuchoice> </term> <listitem> <para> Restart execution applying current configuration. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="1downarrow.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Continue</guimenuitem> </menuchoice> </term> <listitem> <para> Continue execution stoping at next breakpoint. This will cause the debugger to stop at the start of the stylesheet if no further breakpoints are found. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="step.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Step</guimenuitem> </menuchoice> </term> <listitem> <para> Step to the next XSLT instruction found. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="next.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Next</guimenuitem> </menuchoice> </term> <listitem> <para> Proceed to the next instruction at the same call stack depth. This is useful for stepping over a <emphasis >xsl:apply-templates</emphasis > or <emphasis >xsl:call-template</emphasis >. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_stepup.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >StepUp</guimenuitem> </menuchoice> </term> <listitem> <para> Proceed to the next instruction in a cooler stack frame. This is best used within a template at a greater depth than the root match template. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_stepdown.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >StepDown</guimenuitem> </menuchoice> </term> <listitem> <para> Proceed to the next instruction in a warmer stack frame. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_break.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Break</guimenuitem> </menuchoice> </term> <listitem> <para> Add a breakpoint at the current cursor location </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_delete.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Delete</guimenuitem> </menuchoice> </term> <listitem> <para> Delete a breakpoint at the current cursor location </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_enable.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Enable/Disable</guimenuitem> </menuchoice> </term> <listitem> <para> Enable or disable a breakpoint at the current cursor location </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_source.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Source</guimenuitem> </menuchoice> </term> <listitem> <para> Cause the current XSLT source file to be shown </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_data.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Data</guimenuitem> </menuchoice> </term> <listitem> <para> Cause the current &XML; data file to be shown </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_output.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Output</guimenuitem> </menuchoice> </term> <listitem> <para> Cause the current Output file to be shown </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo> </shortcut> <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="xsldbg_refresh.png"/> </imageobject> </inlinemediaobject> </guiicon> <guimenu >Debug</guimenu> <guimenuitem >Reload</guimenuitem> </menuchoice> </term> <listitem> <para> Cause the displayed file to be reloaded from disk </para> </listitem> </varlistentry> </variablelist> </sect2> --> </sect1>