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

  <highlights>
    <para>Esta secção descreve algumas das ferramentas e utilitários no Ambiente GNOME.</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>Executar Aplicação, utilizar o diálogo de</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>Abra o diálogo de <guilabel>Executar Aplicação</guilabel> de qualquer uma das seguintes formas: <variablelist>
          <varlistentry><term>A partir de um painel</term>
          <listitem><para>Pode adicionar o botão <application>Executar Aplicação</application> a qualquer painel. Consulte <xref linkend="panels-addobject"/>. Clique no botão de painel <guibutton>Executar Aplicação</guibutton> para abrir o diálogo de <guilabel>Executar Aplicação</guilabel>.</para></listitem></varlistentry>
          <varlistentry><term>Utilizando teclas de atalho</term>
          <listitem>
            <para>Prima <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. Pode alterar as teclas de atalho que apresentam o diálogo de <guilabel>Executar Aplicação</guilabel> na <link linkend="prefs-keyboard-shortcuts">ferramenta de preferências de <application>Atalhos de Teclado</application></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>capturas de ecrã</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>Seleccione <menuchoice><guimenu>Aplicações</guimenu><guimenuitem>Acessórios</guimenuitem><guimenuitem>Capturar uma Imagem do Ecrã</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>A partir da Consola</para>
      <para>Pode utilizar o comando <command>gnome-screenshot</command> para obter uma captura de ecrã. O comando <command>gnome-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>gnome-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>segundos</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>--ajuda</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 GNOME 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>Janela do <application>Navegador de Ajuda Yelp</application></title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Navegador de Ajuda Yelp</application> contém os seguintes elementos em <xref linkend="fig-yelp-window"/></para>

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

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>Ficheiro</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>Editar</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>Ir</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>Marcadores</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Ajuda</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>Barra de Ferramentas</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>Retroceder</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Avançar</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Tópicos de Ajuda</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>Painel de Navegação</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 Nautilus 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>Clique <menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Nova Janela</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>Clique <menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Sobre Este Documento</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>Clique <menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Imprimir esta Página</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Clique <menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Imprimir este Documento</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>Clique <menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Fechar Janela</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>Clique <menuchoice><guimenu>Editar</guimenu><guimenuitem>Preferências</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist>Surgirá uma janela semelhante a <xref linkend="yelp-preferences"/>:</para>

      <para><figure id="yelp-preferences">
          <title>Janela de Preferências do <application>Navegador de Ajuda Yelp</application></title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>As opções disponíveis neste diálogo têm as seguintes funcionalidades:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Utilizar fontes do sistema</guilabel></term>

            <listitem>
              <para>Seleccione esta opção para visualizar a documentação utilizando as fontes por omissão utilizadas no Ambiente de Trabalho GNOME.</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>Largura Variável</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>Largura Fixa</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>Navegar com cursor</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>Clique <menuchoice><guimenu>Ir</guimenu><guimenuitem>Retroceder</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>Clique <menuchoice><guimenu>Ir</guimenu><guimenuitem>Avançar</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>Clique <menuchoice><guimenu>Ir</guimenu><guimenuitem>Tópicos de Ajuda</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>Clique <menuchoice><guimenu>Ir</guimenu><guimenuitem>Secção Anterior</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>Clique <menuchoice><guimenu>Ir</guimenu><guimenuitem>Secção Seguinte</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>Clique <menuchoice><guimenu>Ir</guimenu><guimenuitem>Conteúdo</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>Clique <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Adicionar Marcador</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Será apresentada uma janela semelhante a <xref linkend="yelp-add-bookmark"/>.</para>

      <para><figure id="yelp-add-bookmark">
          <title>Janela de Adicionar Marcador</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Introduza o título desejado para o marcador no campo de introdução de texto <guilabel>Título</guilabel>. Depois clique <guibutton>Adicionar</guibutton> para adicionar o marcador, ou clique <guibutton>Cancelar</guibutton> para cancelar o pedido.</para>
    </section>

    <section>
      <title>Editar Marcadores</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Clique em <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Editar Marcadores...</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilize a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Será apresentada uma janela semelhante a <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Janela de Edição de Marcadores</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>Pode gerir os seus marcadores utilizando esta janela das seguintes formas:</para>

      <para><variablelist>
          <varlistentry>
            <term><guibutton>Abrir</guibutton></term>

            <listitem>
              <para>Utilize este botão para abrir o marcador seleccionado numa nova janela.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Renomear</guibutton></term>

            <listitem>
              <para>Utilize este botão para renomear o título do seu marcador.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Remover</guibutton></term>

            <listitem>
              <para>Utilize este botão para remover o marcador da sua colecção.</para>
            </listitem>
          </varlistentry>
        </variablelist>Uma vez terminada a gestão dos seus marcadores, clique no botão <guibutton>Fechar</guibutton> para sair da <interface>Janela de Edição de Marcadores</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>Clique <menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Conteúdo</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>Nautilus</application>, ou arraste o ícone do <application>Nautilus</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/gnome/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>ghelp:</option> ou <option>gnome-help:</option></term>

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

              <screen><userinput>yelp ghelp: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 ghelp: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 GNOME</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Facilitar a tradução de documentos para diferentes idiomas.</para>
          </listitem>

          <listitem>
            <para>Disponibilizar um conjunto de ferramentas para ajudar a empacotar e instalar documentação no local correcto e registar essa documentação no scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Realizar a conversão do formato DocBook para um formato adequado a ser apresentado.</para>
          </listitem>
        </itemizedlist>O <application>Navegador de Ajuda Yelp</application> baseia-se nas <ulink url="ghelp:gnome-doc-xslt">Folhas de Estilo XSLT do GNOME</ulink> para realizar a conversão de DocBook em HTML. Os autores das aplicações confiam nos <ulink url="ghelp:gnome-doc-make">Utilitários de Criação de Documentação do GNOME</ulink> para que instalem e registem a documentação no sistema de ajuda.</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/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink> (ambos os recursos em inglês).</para>
    </section>
  </section>

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

    <para>Caso esteja interessado em ajudar a produzir e actualizar documentação para o projecto GNOME, 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>
