<?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>