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

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

  <section id="tools-run-app">
    <title>Executando aplicativos</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Diálogo Executar aplicativo, usando o</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>Abra o diálogo <guilabel>Executar aplicativo</guilabel> em uma das duas formas a seguir: <variablelist>
          <varlistentry><term>A partir de um painel</term>
          <listitem><para>Você pode adicionar o botão <application>Executar aplicativo</application> a qualquer painel. Veja <xref linkend="panels-addobject"/>. Clique no botão <guibutton>Executar</guibutton> para abrir o diálogo <guilabel>Executar aplicativo</guilabel>.</para></listitem></varlistentry>
          <varlistentry><term>Usando teclas de atalho</term>
          <listitem>
            <para>Pressione <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. Você pode alterar as teclas de atalho que exibem o diálogo <guilabel>Executar aplicativo</guilabel> na <link linkend="prefs-keyboard-shortcuts"> ferramenta de preferências <application>Atalhos de Teclado</application></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>imagens da tela, capturando</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>Captura uma imagem da janela para a qual o mouse aponta.</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>Escolha <menuchoice><guimenu>Aplicativos</guimenu><guimenuitem>Acessórios</guimenuitem><guimenuitem>Capturar imagem da tela</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>A partir do terminal</para>
      <para>Você pode usar o comando <command>gnome-screenshot</command> para capturar uma imagem da tela. O comando <command>gnome-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>gnome-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>segundos</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>Captura uma imagem da tela e adiciona um efeito de sombra.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Captura uma imagem da tela e adiciona um efeito de borda.</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 GNOME 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>O <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 na <xref linkend="fig-yelp-window"/></para>

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

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

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

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

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

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

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

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

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

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

                <varlistentry>
                  <term><guibutton>Tópicos da ajuda</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>Painel de navegação</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>Para abrir um documento no <application>Navegador de Ajuda Yelp</application>, use a Tabela de Conteúdo para navegar no documento desejado.</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>Clique em <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Nova Janela</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>Clique em <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Sobre Este Documento</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>Clique <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Imprimir Esta Página</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Imprimindo um documento</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Clique em <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Imprimir Este Documento</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>Clique em <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Fechar Janela</guimenuitem></menuchoice>; ou</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>Clique em <menuchoice><guimenu>Editar</guimenu><guimenuitem>Preferências</guimenuitem></menuchoice>.</para>
          </listitem>
        </itemizedlist>Aparecerá uma janela parecida com 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 que estão disponíveis nesse diálogo têm as seguintes funções:</para>

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

            <listitem>
              <para>Marque essa opção para exibir a documentação usando as fontes padrão usadas pelo GNOME.</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>Largura Variável</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>Largura Fixa</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>Navegar com cursor</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>Clique em <menuchoice><guimenu>Ir</guimenu><guimenuitem>Voltar</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>Clique em <menuchoice><guimenu>Ir</guimenu><guimenuitem>Avançar</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>Clique em <menuchoice><guimenu>Ir</guimenu><guimenuitem>Tópicos da Ajuda</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>Clique em <menuchoice><guimenu>Ir</guimenu><guimenuitem>Seção Anterior</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>Clique em <menuchoice><guimenu>Ir</guimenu><guimenuitem>Próxima Seção</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>Clique em <menuchoice><guimenu>Ir</guimenu><guimenuitem>Conteúdo</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>Clique em <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Adicionar Marcador</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Use a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Aparecerá uma janela que se parece com <xref linkend="yelp-add-bookmark"/>.</para>

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

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

    <section>
      <title>Editando marcadores</title>

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

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

          <listitem>
            <para>Use a combinação de teclas <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Aparecerá uma janela que se parece com <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Janela Editar Marcadores</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>Você pode gerenciar seus marcadores, usando essa janela, das seguintes formas:</para>

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

            <listitem>
              <para>Use esse botão para abrir o marcador selecionado numa nova janela.</para>
            </listitem>
          </varlistentry>

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

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

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

            <listitem>
              <para>Use esse botão para excluir o marcador da sua coleção.</para>
            </listitem>
          </varlistentry>
        </variablelist>Assim que você tiver terminado de gerenciar os seus marcadores, clique no botão <guibutton>Fechar</guibutton> para sair da <interface>janela Editar Marcadores</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>Clique em <menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Conteúdo</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>Nautilus</application>, ou arraste o ícone de dentro do <application>Nautilus</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/gnome/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Use esta URI quando quiser acessar documentos de ajuda do GNOME, tipicamente escritos no formato DocBook.</para>

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

      <para>A documentação distribuída com o GNOME usa esse conjunto de utilitários para várias coisas:</para>

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

          <listitem>
            <para>Fornecer um conjunto de ferramentas para ajudar a empacotar e instalar documentação no local correto e registrá-la com o scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Converter do formato DocBook para um formato apropriado para exibição.</para>
          </listitem>
        </itemizedlist>O <application>Navegador de Ajuda Yelp</application> conta com a <ulink url="ghelp:gnome-doc-xslt">Folha de Estilos GNOME XSLT</ulink> para fazer conversões de DocBook para HTML. Os autores de aplicativos contam com os <ulink url="ghelp:gnome-doc-make">Utilitários de Construção de Documentação do GNOME</ulink> para instalar e registrar documentações no sistema de ajuda.</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/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

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

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

</section>

</chapter>
