<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<chapter id="tools" lang="pt">
  <title>Ferramentas e Utilitários</title>

  <highlights>
    <para>Esta secção descreve algumas das ferramentas e utilitários no Ambiente MATE.</para>
  </highlights>

  <section id="tools-run-app">
    <title>Executar Aplicações</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <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>Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term>From a panel</term>
          <listitem><para>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>Using shortcut keys</term>
          <listitem>
            <para>
              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 <link linkend="prefs-keyboard-shortcuts"><application>Keyboard Shortcuts</application> 
            preference tool</link>.</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 seleccione da lista de aplicações conhecidas.</para>
      <para>Se introduzir apenas a localização de um ficheiro, a aplicação apropriada será iniciada para o abrir. Se introduzir o endereço de uma página web, o seu navegador web por omissão abrirá a página. Prefixe o endereço da página web com http://, como em http://www.gnome.org.</para>
      <para>Para seleccionar um comando que tenha executado anteriormente, clique na seta para baixo que está ao lado do campo de comando e depois seleccione o comando a executar.</para>
      <para>Pode também utilizar o botão <guibutton>Executar com ficheiro</guibutton> para seleccionar um ficheiro para acrescentar à linha de comando. Por exemplo, pode introduzir <application>emacs</application> como o comando e depois seleccionar um ficheiro a editar.</para>
      <para>Seleccione a opção <guilabel>Executar numa consola</guilabel> para executar a aplicação ou comando numa janela de consola. Seleccione 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 id="tools-screenshot">
  <title>Capturar Imagens do Ecrã</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor id="goseditmainmenu-53"/>   
  <indexterm>
    <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><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>Pode utilizar a <link linkend="prefs-keyboard-shortcuts">ferramenta de preferências de <application>Atalhos de Teclado</application></link> para alterar as teclas de atalho por omissão</para>
    </listitem>
    <listitem>
      <para>A partir da Barra de Menu</para>
      <para>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>
                  <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>
                  <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>
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot including the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot without the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot and adds a border effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Opens a window that lets you set options before taking the screenshot.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <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>
  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 id="yelp">
  <title>Navegador de Ajuda Yelp</title>
  <indexterm>
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section id="yelp-introduction">
    <title>Introdução</title>

    <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>O <application>Navegador de Ajuda Yelp</application> está internacionalizado, o que significa que possui suporte para visualizar documentos em diferentes idiomas. Os documentos têm de ser localizados ou traduzidos para cada idioma e apropriadamente instalados para que o Navegador de Ajuda Yelp os possa ver.</para>
  </section>

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

  <section id="yelp-getting-started">
    <title>Iniciar o Yelp</title>

    <section>
      <title>Iniciar o <application>Navegador de Ajuda Yelp</application></title>

      <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>Seleccionando <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>
      <title>Interface</title>

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

      <para><figure id="fig-yelp-window">
          <title><application>Yelp Help Browser</application> Window</title>

          <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>Menubar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>File</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Edit</guimenu></term>

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

                <varlistentry>
                  <term><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><guimenu>Bookmarks</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Help</guimenu></term>

                  <listitem>
                    <para>Visualize informação sobre o Navegador de Ajuda Yelp e quem contribuiu para o projecto no item de menu <guimenuitem>About</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>Toolbar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><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><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><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 id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface>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 id="yelp-usage">
    <title>Utilizar o Yelp</title>

    <section>
      <title>Abrir um Documento</title>

      <para>To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para>In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para>Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para>You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para>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>
      <title>Abrir uma Nova Janela</title>

      <para>Para abrir uma nova janela:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Sobre Este Documento</title>

      <para>Para visualizar informação sobre o documento actualmente aberto:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Imprimir uma Página</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

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

    <section>
      <title>Imprimir um Documento</title>

      <para>Para imprimir um documento completo:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Fechar uma Janela</title>

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

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Definir Preferências</title>

      <para>Para definir as suas preferências no <application>Navegador de Ajuda Yelp</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>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><figure id="yelp-preferences">
          <title><application>Yelp Help Browser</application> Preferences Window</title>

          <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><guilabel>Use system fonts</guilabel></term>

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

              <para>Para seleccionar as suas próprias fontes para visualizar a documentação, não active 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><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><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><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>
      <title>Retroceder no Histórico do Documento</title>

      <para>Para retroceder no histórico de navegação do documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Back</guimenuitem>
              </menuchoice></para>
          </listitem>

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

          <listitem>
            <para>Utilize o botão <guibutton>Retroceder</guibutton> na <interface>Barra de Ferramentas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Avançar no Histórico do Documento</title>

      <para>Para avançar no histórico de navegação do documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>Utilize o botão <guibutton>Avançar</guibutton> na <interface>Barra de Ferramentas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Ir para os Tópicos de Ajuda</title>

      <para>Para ir para os Tópicos de Ajuda:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>Utilize o botão <guibutton>Tópicos de Ajuda</guibutton> na <interface>Barra de Ferramentas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Ir para a Secção Seguinte</title>

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

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Ir para os Conteúdos</title>

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

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Adicionar um Marcador</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

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

          <listitem>
            <para>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><figure id="yelp-add-bookmark">
          <title>Add Bookmark Window</title>

          <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>
      <title>Editar Marcadores</title>

      <para>Para editar a sua colecção de marcadores:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>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><figure id="yelp-edit-bookmarks">
          <title>Edit Bookmarks Window</title>

          <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><variablelist>
          <varlistentry>
            <term><guibutton>Open</guibutton></term>

            <listitem>
              <para>Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Rename</guibutton></term>

            <listitem>
              <para>Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Remove</guibutton></term>

            <listitem>
              <para>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>Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section>
      <title>Obter Ajuda</title>

      <para>Para obter ajuda na utilização do <application>Navegador de Ajuda Yelp</application> (e visualizar este documento):</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Help</guimenu>

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

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

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

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

    <section id="yelp-open-drag">
      <title>Abrir Documentos a partir do Gestor de Ficheiros</title>
        <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 id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Utilizar a Linha de Comando para Abrir Documentos</title>

      <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><option>file:</option></term>

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

              <screen><userinput>yelp file:///usr/share/mate/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>help:</option> ou <option>mate-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><userinput>yelp help:gcalctool</userinput></screen>

              <para>Se deseja abrir o documento de ajuda numa secção específica, acrescente um ponto de interrogação no final do URI, seguido do ID da secção.</para>
              
              <screen><userinput>yelp help:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>man:</option></term>

            <listitem>
              <para>Utilize este URI quando desejar aceder a uma página man específica. Pode acrescentar a secção da página man que deseja consultar caso existão várias páginas man com o mesmo nome. O número de secção deverá estar entre parêntesis e como tal poderá ser necessário escapar o argumento para que a consola não interprete os parêntesis.</para>

              <screen><userinput>yelp man:gcalctool</userinput></screen>
              
              <para>ou</para>

              <screen><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>info:</option></term>

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

              <screen><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>

   </section>

    <section>
      <title>Actualizar o Conteúdo a Pedido</title>

      <para>O <application>Navegador de Ajuda Yelp</application> suporta as teclas de atalho <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>, que relêem o documento DocBook actualmente aberto. Isto permite aos programadores e escritores visualizarem as alterações à medida que elas são feitas.</para>
    </section>
  </section>

  <section id="yelp-moreinfo">
    <title>Mais Informação</title>

    <para>Esta secção detalha algumas das aplicações de apoio que o <application>Navegador de Ajuda Yelp</application> utiliza, e disponibiliza recursos onde poderá obter mais informação sobre o <application>Navegador de Ajuda Yelp</application>.</para>

    <section>
      <title>Scrollkeeper</title>

      <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>
      <title>Utilitários de Documentação MATE</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Ease translation of documents to different languages.</para>
          </listitem>

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

    <section>
      <title>Página Web e Lista de Distribuição</title>

      <para>Para mais informações sobre o <application>Navegador de Ajuda Yelp</application>, visite a página do Projecto de Documentação, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, ou subscreva a lista de distribuição, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/mate-doc-devel-list">mate-doc-devel-list@mate.org</ulink> (ambos os recursos em inglês).</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Juntar-se ao Projecto de Documentação do MATE</title>

    <para>Caso esteja interessado em ajudar a produzir e actualizar documentação para o projecto MATE, visite a página do Projecto de Documentação: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink> (em inglês)</para>
  </section>

</section>

</chapter>
