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.
588 lines
9.7 KiB
588 lines
9.7 KiB
<?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>
|