<?xml version="1.0" encoding="utf-8"?>
<?db.chunk.max_depth 3?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="tools" xml:lang="pt">
    <info><title>Ferramentas e Utilitários</title>
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Hugo Carvalho</db:firstname>
      </db:personname>
      <db:email>hugokarvalho@hotmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2018</db:year>
      
      <db:holder>Hugo Carvalho</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>José Vieira</db:firstname>
      </db:personname>
      <db:email>jvieira33@sapo.pt</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2021</db:year>
      
      <db:holder>José Vieira</db:holder>
    </db:copyright>
  </info>

  <highlights>
    <para xml:lang="en">This section describes some tools and utilities in the MATE Desktop.</para>
  </highlights>

  <section xml:id="tools-run-app"><info><title>Executar Aplicações</title></info>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor xml:id="gospanel-23"/>
    <indexterm xml:lang="en">
      <primary>Run Application dialog, using</primary>
    </indexterm>
    <para>O diálogo de <guilabel>Executar Aplicação</guilabel> dá-lhe acesso à linha de comando. Quando executa um comando no diálogo de <guilabel>Executar Aplicação</guilabel>, não consegue visualizar o resultado desse comando.</para>
    <para>Para executar um comando a partir da linha de comandos siga os seguintes passos:</para>
    <orderedlist>
      <listitem>
        <para xml:lang="en">Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term xml:lang="en">From a panel</term>
          <listitem><para xml:lang="en">You can add the <application>Run Application</application> button to any 
          panel. See <xref linkend="panels-addobject"/>. Click on the <guibutton>Run Application</guibutton> 
          panel button to open the <guilabel>Run Application</guilabel> dialog.</para></listitem></varlistentry>
          <varlistentry><term xml:lang="en">Using shortcut keys</term>
          <listitem>
            <para xml:lang="en">
              Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. You can change 
              the shortcut keys that display the <guilabel>Run Application</guilabel> dialog
              in the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool.
            </para>
          </listitem>
          </varlistentry>
        </variablelist>
      </para>
      <para>O diálogo de <guilabel>Executar Aplicação</guilabel> é apresentado.</para>
    </listitem>
    <listitem>
      <para>Introduza o comando que deseja executar no campo vazio, ou selecione da lista de aplicações conhecidas.</para>
      <para xml:lang="en">If you enter only the location of a file, an appropriate application will launch to open it.
      If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.org.
      </para>
      <para>Para selecionar um comando que tenha executado anteriormente, clique na seta para baixo que está ao lado do campo de comando e depois selecione o comando a executar.</para>
      <para>Pode também utilizar o botão <guibutton>Executar com ficheiro</guibutton> para selecionar um ficheiro para acrescentar à linha de comando. Por exemplo, pode introduzir <application>emacs</application> como o comando e depois selecionar um ficheiro a editar.</para>
      <para>Selecione a opção <guilabel>Executar numa consola</guilabel> para executar a aplicação ou comando numa janela de consola. Selecione esta opção para aplicações ou comandos que não criem uma janela na qual se executem.</para>
    </listitem>
    <listitem>
      <para>Clique no botão <guibutton>Executar</guibutton> no diálogo <guilabel>Executar Aplicação</guilabel>.</para>
    </listitem>
      </orderedlist>
  </section>

<section xml:id="tools-screenshot"><info><title>Capturar Imagens do Ecrã</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm xml:lang="en">
    <primary>screenshots, taking</primary>
  </indexterm>
  <para>Pode capturar uma imagem do seu ecrã de uma das seguintes formas:</para>
  <itemizedlist>
    <listitem>
      <para>A partir de qualquer painel</para>
      <para>Pode adicionar um botão <guibutton>Capturar Ecrã</guibutton> a qualquer painel. Para instruções sobre como o fazer, consulte <xref linkend="panels-addobject"/>. Clique no botão <guibutton>Capturar Ecrã</guibutton> para obter uma captura de todo o ecrã.</para>
    </listitem>
    <listitem>
      <para>Utilizando teclas de atalho</para>
      <para>Para obter uma captura de ecrã, utilizar as seguintes teclas de atalho:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Teclas de Atalho por Omissão</para>
              </entry>
              <entry>
                <para>Função</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycap>Print Screen</keycap></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Obtem uma captura de todo o ecrã.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en"><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para xml:lang="en">You can use the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool to modify the default shortcut keys.</para>
    </listitem>
    <listitem>
      <para>A partir da Barra de Menu</para>
      <para xml:lang="en">Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>A partir da Consola</para>
      <para>Pode utilizar o comando <command>mate-screenshot</command> para obter uma captura de ecrã. O comando <command>mate-screenshot</command> obtém uma captura da totalidade do ecrã e apresenta o diálogo de <guilabel>Gravar Captura de Ecrã</guilabel>. Utilize o diálogo de <guilabel>Gravar Captura de Ecrã</guilabel> para gravar a imagem.</para>
      <para>Pode também utilizar opções no comando <command>mate-screenshot</command> da seguinte forma:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Opção</para>
              </entry>
              <entry>
                <para>Função</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Obtém uma captura da janela que tiver o foco.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--delay=<replaceable>seconds</replaceable></command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Obtém uma captura de ecrã após a quantidade especificada de segundos, apresentando o diálogo de <guilabel>Gravar Captura de Ecrã</guilabel>. Utilize o diálogo de <guilabel>Gravar Captura de Ecrã</guilabel> para gravar a imagem.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot including the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot without the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot and adds a border effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Opens a window that lets you set options before taking the screenshot.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Apresenta as opções para o comando.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para xml:lang="en">
  When you take a screenshot, the <guilabel>Save Screenshot</guilabel> dialog 
  opens. To save the screenshot as an image file, enter the filename for the 
  screenshot, choose a location from the drop-down list and click the <guilabel>Save</guilabel> button. You can also use the <guilabel>Copy to Clipboard</guilabel> button to copy the image to the clipboard or transfer it to another application by drag-and-drop.
  </para>
  
</section>

<!-- ============= Yelp ============================= -->
<section xml:id="yelp"><info><title>Navegador de Ajuda Yelp</title></info>
  <indexterm xml:lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title>Introdução</title></info>
    <para>A aplicação <application>Navegador de Ajuda Yelp</application> permite-lhe visualizar documentação relacionada com o MATE e outros componentes através de uma variedade de formatos. Estes formatos incluem ficheiros docbook, páginas de ajuda em HTML, páginas de manual e páginas de info (suporte para páginas man e info poderá ser opcionalmente incluído na compilação). Apesar dos diferentes formatos suportados, o Yelp esforça-se por uniformizar a aparência e comportamento dos documentos independentemente do formato do documento original.</para>

    <para xml:lang="en"><application>Yelp Help Browser</application> is internationalized, meaning that it has support
    to view documents in different languages. The documents must be localized
    or translated for each language and installed properly for Yelp Help
    Browser to be able to view them.</para>
  </section>

  <!-- ============= Getting Started  ================================ -->

  <section xml:id="yelp-getting-started"><info><title>Iniciar o Yelp</title></info>
  
    <section><info><title>Iniciar o <application>Navegador de Ajuda Yelp</application></title></info>
      <para>Pode iniciar o <application>Navegador de Ajuda Yelp</application> das seguintes formas:</para>

      <para><variablelist>
          <varlistentry>
            <term>Menu <guimenu>Sistema</guimenu></term>

            <listitem>
              <para>Selecionando <application>Ajuda</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Linha de Comando</term>

            <listitem>
              <para>Execute o seguinte comando: <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Interface</title></info>
      <para>Ao iniciar o <application>Navegador de Ajuda Yelp</application>, surgirá a seguinye janela.</para>

      <para xml:lang="en"><figure xml:id="fig-yelp-window"><info><title xml:lang="en"><application>Yelp Help Browser</application> Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp Help Browser</application> contains the following elements in <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Barra de Menu</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guimenu>File</guimenu></term>

                  <listitem>
                    <para>Utilize este menu para Abrir uma Nova Janela, visualizar a página Sobre este Documento, Imprimir o documento atual ou Fechar a janela.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Edit</guimenu></term>

                  <listitem>
                    <para>Utilize este menu para Copiar, Selecionar tudo, Procurar..., ou para definir as suas Preferências.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Go</guimenu></term>

                  <listitem>
                    <para>Utilize este menu para Retroceder, Avançar ou navegar até à página de Tópicos de Ajuda. Ao visualizar um documento DocBook, utilize este menu para navegar para a Secção Seguinte, Secção Anterior ou para o Conteúdo.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Bookmarks</guimenu></term>

                  <listitem>
                    <para>Utilize este menu para Adicionar Marcadores ou Editar Marcadores.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Help</guimenu></term>

                  <listitem>
                    <para>Visualize informação sobre o Navegador de Ajuda Yelp e quem contribuiu para o projeto no item de menu <guimenuitem>Sobre</guimenuitem>. Abra este documento com o item de menu <guimenuitem>Conteúdo</guimenuitem> ou premindo <keycap>F1</keycap>.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Barra de Ferramentas</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guibutton>Back</guibutton></term>

                  <listitem>
                    <para>Utilize este botão para navegar atrás no seu histórico de documentos.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guibutton>Forward</guibutton></term>

                  <listitem>
                    <para>Utilize este botão para navegar em frente no seu histórico de documentos.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guibutton>Help Topics</guibutton></term>

                  <listitem>
                    <para>Utilize este botão para voltar à tabela principal de conteúdos (apresentada em <xref linkend="fig-yelp-window"/>).</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry xml:id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface xml:lang="en">Browser Pane</interface></term>

          <listitem>
            <para>O painel de navegação é onde lhe será apresentada a tabela de conteúdos ou a documentação. Utilize a tabela de conteúdos para navegar até à documentação de que necessita.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

  <!--===================== Usage ========================-->

  <section xml:id="yelp-usage"><info><title>Utilizar o Yelp</title></info>

    <section><info><title>Abrir um Documento</title></info>
      <para xml:lang="en">To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para xml:lang="en">In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para xml:lang="en">Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para>Alternativamente, poderá visualizar um documento específico invocando o Navegador de Ajuda Yelp a partir da linha de comando ou arrastando ficheiros para o Yelp. Consulte <xref linkend="yelp-open-specific"/> para mais informações.</para>
    </section>

    <section><info><title>Abrir uma Nova Janela</title></info>
      <para>Para abrir uma nova janela:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Sobre Este Documento</title></info>
      <para>Para visualizar informação sobre o documento atualmente aberto:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opção apenas está disponível para documentação DocBook. Notas legais e contribuições para a documentação normalmente também estão listadas nesta secção.</para>
        </note></para>
    </section>

    <section><info><title>Imprimir uma Página</title></info>
      <para>Para imprimir uma página que esteja a visualizar no <application>Navegador de Ajuda Yelp</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Page</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Imprimir um Documento</title></info>
      <para>Para imprimir um documento completo:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opção apenas está disponível para documentação DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Fechar uma Janela</title></info>
      <para>Para fechar uma janela no <application>Navegador de Ajuda Yelp</application>, faça o seguinte:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Close Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Definir Preferências</title></info>
      <para>Para definir as suas preferências no <application>Navegador de Ajuda Yelp</application>:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Edit</guimenu>

                <guimenuitem>Preferences</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-preferences"/>:</para>

      <para xml:lang="en"><figure xml:id="yelp-preferences"><info><title xml:lang="en"><application>Yelp Help Browser</application> Preferences Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>The options that are available in this dialog have the
      following functions:</para>

      <para><variablelist>
          <varlistentry>
            <term xml:lang="en"><guilabel>Use system fonts</guilabel></term>

            <listitem>
              <para>Selecione esta opção para visualizar a documentação utilizando as fontes por omissão utilizadas no Ambiente de Trabalho MATE.</para>

              <para>Para selecionar as suas próprias fontes para visualizar a documentação, não ative esta opção e clique nos botões ao lado do texto <guilabel>Largura Variável</guilabel> ou <guilabel>Largura Fixa</guilabel>.</para>

              <para><variablelist>
                  <varlistentry>
                    <term xml:lang="en"><guilabel>Variable Width</guilabel></term>

                    <listitem>
                      <para>Esta é a fonte a utilizar quando não é necessária uma fonte estática ou de largura fixa. A maior parte do texto será apresentado com esta fonte.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term xml:lang="en"><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para>Esta é a fonte a utilizar quando todos os caracteres de texto têm de ser do mesmo tamanho. Esta fonte é normalmente utilizada para indicar comandos, blocos de programação ou outros tipos de texto nesta categoria.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para>Clique nesta opção se desejar ver um cursor no <xref linkend="yelp-browser-pane"/>. Isto permite-lhe navegar mais facilmente no documento pois torna-se visível onde neste se encontra o cursor.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Retroceder no Histórico do Documento</title></info>
      <para>Para retroceder no histórico de navegação do documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Clique <menuchoice> <guimenu>Voltar</guimenu> <guimenuitem>Atrás</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Esquerda</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Back</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Avançar no Histórico do Documento</title></info>
      <para>Para avançar no histórico de navegação do documento:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Forward</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Direita</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Forward</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Ir para os Tópicos de Ajuda</title></info>
      <para>Para ir para os Tópicos de Ajuda:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Help Topics</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Help Topics</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Ir para a Secção Anterior</title></info>
      <para>Para ir para a secção anterior:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Previous Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Acima</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opção apenas está disponível nos documentos em formato DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Ir para a Secção Seguinte</title></info>
      

      <para>Para ir para a secção seguinte:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Next Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Abaixo</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opção apenas está disponível nos documentos em formato DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Ir para os Conteúdos</title></info>
      

      <para>Para ir para a lista de conteúdos de um documento:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opção apenas está disponível nos documentos em formato DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Adicionar um Marcador</title></info>
      

      <para>Para adicionar um marcador num documento em específico:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

                <guimenuitem>Add Bookmark</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-add-bookmark"/>.</para>

      <para xml:lang="en"><figure xml:id="yelp-add-bookmark"><info><title xml:lang="en">Add Bookmark Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Enter your desired bookmark title in to the
      <guilabel>Title</guilabel> text entry field. Then click
      <guibutton>Add</guibutton> to add the bookmark, or click
      <guibutton>Cancel</guibutton> to cancel the request.</para>
    </section>

    <section><info><title>Editar Marcadores</title></info>
      <para>Para editar a sua coleção de marcadores:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para xml:lang="en"><figure xml:id="yelp-edit-bookmarks"><info><title xml:lang="en">Edit Bookmarks Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>You can manage your bookmarks using this window in the
      following ways:</para>

      <para xml:lang="en"><variablelist>
          <varlistentry>
            <term xml:lang="en"><guibutton>Open</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Rename</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Remove</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to delete the bookmark from your
              collection.</para>
            </listitem>
          </varlistentry>
        </variablelist>Once you are finished managing your bookmarks, click
      the <guibutton>Close</guibutton> button to exit the <interface xml:lang="en">Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section><info><title>Obter Ajuda</title></info>
      <para xml:lang="en">To get help to use <application>Yelp Help Browser</application> (and see this
      document):</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

  <!--=============== Advanced Features ====================-->

  <section xml:id="yelp-advanced"><info><title>Funcionalidades Avançadas</title></info>

   <section xml:id="yelp-open-specific" xreflabel="Opening Specific Documents"><info><title>Abrir Documentos Específicos</title></info>

    <section xml:id="yelp-open-drag"><info><title>Abrir Documentos a partir do Gestor de Ficheiros</title></info>
        <para>Para abrir um documento, tal como um ficheiro XML, a partir do gestor de ficheiros, abra o documento no Gestor de Ficheiros <application>Caja</application>, ou arraste o ícone do <application>Caja</application> para o painel de documento ou iniciador do <application>Yelp</application>.</para>
    </section>

    <section xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title>Utilizar a Linha de Comando para Abrir Documentos</title></info>
      <para>O Navegador de Ajuda Yelp suporta abrir documentos a partir da linha de comando. Existe um conjunto de URIs (Identificadores Uniformes de Recursos) que podem ser utilizados. Estes incluem:</para>

      <variablelist>
          <varlistentry>
            <term xml:lang="en"><option>file:</option></term>

            <listitem>
              <para>Utilize este URI quando deseja aceder a um ficheiro através do yelp, por exemplo:</para>

              <screen xml:lang="en"><userinput>yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>help:</option></term>

            <listitem>
              <para>Utilize este URI quando desejar aceder a documentos de ajuda do MATE, que tipicamente estão escritos no formato DocBook.</para>

              <screen xml:lang="en"><userinput>yelp help:mate-terminal</userinput></screen>

              <para xml:lang="en">If you want to open the help document at a particular section,
              append a slash to the end of the URI, followed by the section id.</para>
              
              <screen xml:lang="en"><userinput>yelp help:mate-user-guide/yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>man:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a particular man
              page. You can append the section of the man page you would like
              to view if there are multiple man pages with the same
              name.  The section number should be enclosed in parentheses and 
              therefore it may be necessary to escape the argument so that the
              shell does not interpret the parenthesis.</para>

              <screen xml:lang="en"><userinput>yelp man:mate-panel</userinput></screen>
              
              <para>ou</para>

              <screen xml:lang="en"><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>info:</option></term>

            <listitem>
              <para>Utilize este URI quando desejar aceder a uma página info GNU em específico.</para>

              <screen xml:lang="en"><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>
   </section>

    <section><info><title>Atualizar o Conteúdo a Pedido</title></info>
      <para>O <application>Navegador de Ajuda Yelp</application> suporta as teclas de atalho <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>, que tornam a ler o documento DocBook atualmente aberto. Isto permite aos programadores e escritores visualizarem as alterações à medida que elas são feitas.</para>
    </section>
  </section>

  <section xml:id="yelp-moreinfo"><info><title>Mais Informação</title></info>
    <para xml:lang="en">This section details some helper applications which 
    <application>Yelp Help Browser</application> uses, and provides resources where you can get more information
    about <application>Yelp Help Browser</application>.</para>

    <section><info><title>Scrollkeeper</title></info>
      <para>O <application>Navegador de Ajuda Yelp</application> utiliza o scrollkeeper para gerar as tabelas de conteúdos dos documentos DocBook e HTML, e também para se manter a par das traduções de cada documento.</para>
    </section>

    <section><info><title>Utilitários de Documentação MATE</title></info>
      <para>A documentação distribuída com o MATE utiliza este conjunto de utilitários para uma variedade de situações:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Ease translation of documents to different languages.</para>
          </listitem>

          <listitem>
            <para xml:lang="en">Provide a set of tools to help package and install
            documentation into the correct location and register the
            documentation with scrollkeeper.</para>
          </listitem>

          <listitem>
            <para xml:lang="en">Perform conversion from DocBook format to a format suitable
            for display.</para>
          </listitem>
        </itemizedlist><application>Yelp Help Browser</application> relies on <link xlink:href="help:mate-doc-xslt">MATE XSLT
      Stylesheets</link> to perform conversion from DocBook to HTML.  <link xlink:href="help:mate-doc-make">MATE Documentation
      Build Utilities</link> are relied upon by application authors to install and register documentation within the help system.</para>
    </section>

    <section><info><title>Página Web e Lista de Distribuição</title></info>
      <para xml:lang="en">For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <uri xlink:href="http://mate-desktop.org">http://mate-desktop.org</uri>, or subscribe to
      the mailing list, <uri xlink:href="http://ml.mate-desktop.org/listinfo/mate-dev">http://ml.mate-desktop.org/listinfo/mate-dev</uri>.</para>
    </section>
  </section>

  <section xml:id="yelp-joininggdp"><info><title>Juntar-se ao Projeto de Documentação do MATE</title></info>
    <para xml:lang="en">If you are interested in helping produce and update documentation
    for the MATE project, please visit the Documentation Project homepage: <uri xlink:href="http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team">http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team</uri></para>
  </section>
</section>
</chapter>
