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

  <highlights>
    <para>Esta seção descreve alguns utilitários e ferramentas do MATE.</para>
  </highlights>

  <section id="tools-run-app">
    <title>Executando aplicativos</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Run Application dialog, using</primary>
    </indexterm>
    <para>O diálogo <guilabel>Executar aplicativo</guilabel> lhe dá acesso à linha de comando. Quando você executa um comando nesse diálogo, você não recebe a saída do comando.</para>
    <para>Para executar um comando a partir da linha de comando execute 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 <guilabel>Executar aplicativo</guilabel> será exibido.</para>
    </listitem>
    <listitem>
      <para>Digite o comando que você deseja executar no campo em branco, ou escolha a partir da lista de aplicativos conhecidos.</para>
      <para>Se você digitar somente a localização de um arquivo, um aplicativo apropriado será executada para abri-lo. Se você digitar um endereço web, o seu navegador web padrão irá abrir a página. Coloque o prefixo http:// no endereço web, como em http://www.gnome.org.</para>
      <para>Para escolher um comando que você executou anteriormente, clique na seta para baixo, ao lado do campo de comando, e escolha o comando a ser executado.</para>
      <para>Você também pode usar o botão <guibutton>Executar com arquivo</guibutton> para escolher um arquivo para acrescentar à linha de comando. Por exemplo, você pode digitar <application>emacs</application> como o comando, e então escolher um arquivo para editar.</para>
      <para>Selecione a opção <guilabel>Executar em um terminal</guilabel> para executar o aplicativo ou comando numa janela de terminal. Marque essa opção para um aplicativo ou comando que não crie a própria janela.</para>
    </listitem>
    <listitem>
      <para>Clique no botão <guibutton>Executar</guibutton> do diálogo <guilabel>Executar aplicativo</guilabel>.</para>
    </listitem>
      </orderedlist>
    </section>

<section id="tools-screenshot">
  <title>Capturando Imagens da Tela</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor id="goseditmainmenu-53"/>   
  <indexterm>
    <primary>screenshots, taking</primary>
  </indexterm>
  <para>Você pode capturar uma imagem da tela de qualquer das seguintes formas:</para>
  <itemizedlist>
    <listitem>
      <para>A partir de qualquer painel</para>
      <para>Você pode adicionar um botão <guibutton>Capturar imagem da tela</guibutton> a qualquer painel. Para instruções sobre como fazer isso, veja a <xref linkend="panels-addobject"/>. Clique no botão <guibutton>Capturar imagem da tela</guibutton> para capturar uma imagem da tela inteira.</para>
    </listitem>
    <listitem>
      <para>Usando teclas de atalho</para>
      <para>Para capturar uma imagem da tela, use 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 Padrã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>Captura uma imagem da tela inteira.</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>Você pode usar a <link linkend="prefs-keyboard-shortcuts">ferramenta de preferências <application>Atalhos de teclado</application></link> para modificar as teclas de atalho padrã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 do terminal</para>
      <para>Você pode usar o comando <command>mate-screenshot</command> para capturar uma imagem da tela. O comando <command>mate-screenshot</command> captura uma imagem da tela inteira e exibe o diálogo <guilabel>Salvar captura de tela</guilabel>. Use esse diálogo para salvar a captura de tela.</para>
      <para>Você também pode usar as seguintes opções no comando <command>mate-screenshot</command>:</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>Captura uma imagem da janela em 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>Captura uma imagem da tela após o número de segundos especificado, e exibe o diálogo <guilabel>Salvar captura de tela</guilabel>. Use esse diálogo para salvar a imagem da tela.</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>Exibe 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>O <application>Navegador de Ajuda Yelp</application> lhe permite ver a documentação sobre o MATE e outros componentes através de vários de formatos. Esses formatos incluem arquivos DocBook, páginas de ajuda HTML, páginas de manual e páginas "info", de informação (suporte para páginas de manual e de informação pode ser incluídos na compilação opcionalmente). Independentemente dos formatos de arquivo, o Yelp faz o melhor possível para dar uma aparência unificada a eles, não importando o formato original.</para>

    <para>O <application>Navegador de Ajuda Yelp</application> é internacionalizado, ou seja, tem suporte à visualização de documentos em diferentes idiomas. Para isso, os documentos devem ser traduzidos para cada idioma e instalados apropriadamente.</para>
  </section>

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

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

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

      <para>Você pode iniciar o <application>Navegador de Ajuda Yelp</application> das seguintes formas:</para>

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

            <listitem>
              <para>Escolha <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>, você verá a seguinte 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>Use esse menu para Abrir uma Nova Janela, ver a página Sobre Este Documento, imprimir o documento atual, ou fechar a janela.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use esse menu para Copiar, Selecionar tudo, Localizar..., ou para definir suas Preferências.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Go</guimenu></term>

                  <listitem>
                    <para>Use esse menu para navegar para trás, para frente e para a página Tópicos da Ajuda. Ao visualizar um documento DocBook, use esse menu para navegar para a Próxima Seção, Seção Anterior ou para o Conteúdo.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Bookmarks</guimenu></term>

                  <listitem>
                    <para>Use esse menu para Adicionar Marcador(es), ou Editar Marcador(es).</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Veja informações sobre o Navegador de Ajuda Yelp e sobre as pessoas que contribuem para o projeto através do item de menu <guimenuitem>Sobre</guimenuitem>. Abra este documento com o item <guimenuitem>Conteúdo</guimenuitem> ou pressionando <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>Use esse botão para voltar no histórico do documento.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Forward</guibutton></term>

                  <listitem>
                    <para>Use esse botão para avançar no histórico do documento.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Help Topics</guibutton></term>

                  <listitem>
                    <para>Use esse botão para retornar para a tabela principal de conteúdo (exibida 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 você verá a tabela de conteúdo ou a documentação. Use a tabela de conteúdo para navegar para a documentação que você precisa.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

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

  <section id="yelp-usage">
    <title>Usando o Yelp</title>

    <section>
      <title>Abrindo 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, você pode ver um documento em particular chamando o Navegador de Ajuda Yelp a partir da linha de comando, ou arrastando arquivo para o Yelp. Veja <xref linkend="yelp-open-specific"/> para saber mais.</para>
    </section>

    <section>
      <title>Abrindo 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>Use 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 ver informações sobre o documento atualmente aberto:</para>

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

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Essa opção só está disponível para documentação no formato DocBook. Geralmente notas legais e as pessoas que contribuíram com a documentação estão listados nessa seção.</para>
        </note></para>
    </section>

    <section>
      <title>Imprimindo uma página</title>

      <para>Para imprimir qualquer página que você consiga ver 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>Imprimindo um documento</title>

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

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

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Essa opção só está disponível para documentação no formato DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Fechando 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>Use a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>.</para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Definindo preferências</title>

      <para>Para definir 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>Marque essa opção para exibir a documentação usando as fontes padrão usadas pelo MATE.</para>

              <para>Para escolher suas próprias fontes para exibir documentação, desmarque essa 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 ser usada quando uma fonte estática ou fixa não for necessária. A maior parte do texto será desse tipo.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para>Esta é a fonte a ser usada quando todos os caracteres do texto precisam ser do mesmo tamanho. Essa fonte é usada para indicar comandos, blocos de código ou outros textos que se encaixem nessa categoria.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para>Clique nessa opção se você quiser ver um cursor no <xref linkend="yelp-browser-pane"/>. Essa opção lhe permite navegar no documento mais facilmente ao mostrar onde o cursor está no documento.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Voltando no Histórico de um Documento</title>

      <para>Para voltar no histórico de um documento:</para>

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

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

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

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

    <section>
      <title>Avançando no Histórico de um Documento</title>

      <para>Para avançar no histórico de um documento:</para>

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

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

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

          <listitem>
            <para>Use o botão <guibutton>Avançar</guibutton> na <interface>Barra de Ferramentas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Indo para Tópicos da Ajuda</title>

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

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

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

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

          <listitem>
            <para>Use o botão <guibutton>Tópicos da Ajuda</guibutton> na <interface>Barra de Ferramentas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Indo para a Seção Anterior</title>

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

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

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

          <listitem>
            <para>Use a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Essa opção só está disponível em documentos com o formato DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Indo para a Próxima Seção</title>

      <para>Para ir para a próxima seção:</para>

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

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

          <listitem>
            <para>Use a combinação de teclas <keycombo><keycap>Alt</keycap><keycap>Abaixo</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Essa opção só está disponível em documentos com o formato DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Ir para o conteúdo</title>

      <para>Para ir para o conteúdo de um documento:</para>

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

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Essa opção só está disponível em documentos com o formato DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Adicionando um marcador</title>

      <para>Para adicionar um marcador a um determinado documento:</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>Editando marcadores</title>

      <para>Para editar sua coleçã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>Obtendo ajuda</title>

      <para>Para obter ajuda sobre o uso do <application>Navegador de Ajuda Yelp</application> (e ver 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>Recursos Avançados</title>

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

    <section id="yelp-open-drag">
      <title>Abrindo Documentos no Gerenciador de Arquivos</title>
        <para>Para abrir um documento, como um arquivo XML, a partir do gerenciador de arquivos, abra o documento no <application>Caja</application>, ou arraste o ícone de dentro do <application>Caja</application> para o painel de documentos do <application>Yelp</application> ou lançador do Yelp.</para>
    </section>

    <section id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Usando a Linha de Comando para Abrir Documentos</title>

      <para>O Navegador de Ajuda Yelp tem suporte à abertura de documentos a partir da linha de comando. Há vários URIs (Identificadores Uniformes de Recurso) que podem ser usados. Estes incluem:</para>

      <variablelist>
          <varlistentry>
            <term><option>file:</option></term>

            <listitem>
              <para>Use esta URI quando quiser acessar um arquivo com o 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>Use esta URI quando quiser acessar documentos de ajuda do MATE, tipicamente escritos no formato DocBook.</para>

              <screen><userinput>yelp help:gcalctool</userinput></screen>

              <para>Se você quiser abrir o documento de ajuda numa seção em particular, acrescente um ponto de interrogação ao fim do URI, seguido pelo identificador da seção.</para>
              
              <screen><userinput>yelp help:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Use esse URI quando quiser acessar uma página de manual em particular. Se houver múltiplas páginas com o mesmo nome, você pode acrescentar a seção do manual que quer ver. O número da seção deve vir entre parênteses e, por isso, pode ser necessário escapar o argumento para que a <foreignphrase>shell</foreignphrase> não não interprete os parênteses.</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>Use esta URI quando quiser acessar uma página de informações GNU em particular.</para>

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

   </section>

    <section>
      <title>Atualizando o Conteúdo sob Demanda</title>

      <para>O <application>Navegador de Ajuda Yelp</application> tem suporte às teclas de atalho <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>, que recarregam o documento DocBook atualmente aberto. Isso permite que desenvolvedores vejam as alterações nos documentos à medida em que elas são feitas.</para>
    </section>
  </section>

  <section id="yelp-moreinfo">
    <title>Mais Informações</title>

    <para>Essa seção detalha alguns dos aplicativos auxiliares usados pelo <application>Navegador de Ajuda Yelp</application>, e indica onde você pode obter mais informações sobre ele.</para>

    <section>
      <title>Scrollkeeper</title>

      <para>O <application>Navegador de Ajuda Yelp</application> usa o scrollkeeper para gerar a tabela de conteúdo para documentação DocBook e HTML, e também mantém controle das traduções para cada documento.</para>
    </section>

    <section>
      <title>Utilitários de documentação do MATE</title>

      <para>A documentação distribuída com o MATE usa esse conjunto de utilitários para várias coisas:</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 e Lista de discussão</title>

      <para>Para mais informações sobre o <application>Navegador de Ajuda Yelp</application>, por favor visite a página de documentação do projeto, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, ou inscreva-se na lista de discussão, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/mate-doc-devel-list">mate-doc-devel-list@mate.org</ulink>.</para>
    </section>
  </section>

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

    <para>Se estiver interessado em ajudar a produzir e atualizar a documentação para o Projeto MATE, por favor visite a página de documentação do projeto: <ulink url="http://live.gnome.org/DocumentationProject">http://live.mate.org/DocumentationProject</ulink></para>
  </section>

</section>

</chapter>
