# Ferramentas e Utilitários

Esta seção descreve alguns utilitários e ferramentas do GNOME.

## Executando Aplicações

O diálogo Executar Aplicação lhe dá acesso à linha de comando. Quando você executa um comando nesse diálogo, você não recebe a saída do comando.

Para executar um comando a partir da linha de comando execute os seguintes passos:

1. Abra o diálogo Executar Aplicação em uma das duas formas a seguir:

   A partir de um painel

     Você pode adicionar o botão Executar Aplicação a qualquer painel. Veja . Clique no botão Executar para abrir o diálogo Executar Aplicação.

   Usando teclas de atalho

     Pressione AltF2. Você pode alterar as teclas de atalho que exibem o diálogo Executar Aplicação na ferramenta de preferências Atalhos de Teclado.

   O diálogo Executar Aplicação será exibido.

2. Digite o comando que você deseja executar no campo em branco, ou escolha a partir da lista de aplicações conhecidas.

   Se você digitar somente a localização de um arquivo, uma aplicação apropriada 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://gnome.org.

   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.

   Você também pode usar o botão Executar com arquivo para escolher um arquivo para acrescentar à linha de comando. Por exemplo, você pode digitar emacs como o comando, e então escolher um arquivo para editar.

   Selecione a opção Executar em um terminal para executar a aplicação ou comando numa janela de terminal. Marque essa opção para uma aplicação ou comando que não crie a própria janela.

3. Clique no botão Executar do diálogo Executar Aplicação.

## Capturando Imagens da Tela

Você pode capturar uma imagem de qualquer das seguintes formas:

- A partir de qualquer painel

  Você pode adicionar um botão Capturar Imagem da Tela a qualquer painel. Para instruções sobre como fazer isso, veja . Clique no botão Capturar Imagem da Tela para capturar uma imagem da tela inteira.

- Usando teclas de atalho

  Para capturar uma tela, use as seguintes teclas de atalho:

  Teclas de Atalho Padrão | Função
  --- | ---
  Print Screen | Captura uma imagem da tela inteira.
  AltPrint Screen | Captura uma imagem da janela para a qual o mouse aponta.

  Você pode usar a ferramenta de preferências Atalhos de Teclado para modificar as teclas de atalho padrão.

- A partir da barra de menu

  Escolha Aplicações AcessóriosCapturar Imagem da Tela.

- A partir do terminal

  Você pode usar o comando `gnome-screenshot` para capturar uma imagem da tela. O comando `gnome-screenshot` captura uma imagem da tela inteira e exibe o diálogo Salvar Captura da Tela. Use esse diálogo para salvar a imagem da tela.

  Você também pode usar as seguintes opções no comando `gnome-screenshot`:

  Opção | Função
  --- | ---
  `--window` | Captura uma imagem da janela em foco.
  `--delay=segundos` | Captura uma imagem da tela após o número de segundos especificado e mostra o diálogo Salvar Captura da Tela. Use esse diálogo para salvar a imagem da tela.
  `--include-border` | Captura uma imagem da tela incluindo a borda da tela.
  `--border-effect=shadow` | Captura uma imagem da tela e adiciona um efeito.
  `--border-effect=border` | Captura uma imagem da tela e adiciona um efeito de borda ao redor dela.
  `--help` | Exibe as opções para o comando.

Quando você captura uma imagem da tela, o diálogo Salvar Captura da Tela se abre. Para salvar a imagem da tela como um arquivo, digite o nome do mesmo e escolha uma localização a partir da lista suspensa de locais.

## Navegador de Ajuda Yelp

### Introdução

O Navegador de Ajuda Yelp 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.

O Navegador de Ajuda Yelp é 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.

### Iniciando o Yelp

#### Iniciar o Navegador de Ajuda Yelp

Você pode iniciar o Navegador de Ajuda Yelp das seguintes formas:

Menu Sistema

  Escolha Ajuda

Linha de Comando

  Execute o seguinte comando: `yelp`

#### Interface

Ao iniciar o Navegador de Ajuda Yelp, você verá a seguinte janela.

O

##### Janela do Navegador de Ajuda Yelp

Navegador de Ajuda Yelp contém os seguintes elementos na

Barra de menu

  Arquivo

    Use esse menu para Abrir uma Nova Janela, ver a página Sobre Este Documento, imprimir o documento atual, ou fechar a janela.

  Editar

    Use esse menu para Copiar, Selecionar tudo, Localizar..., ou para definir suas Preferências.

  Ir

    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.

  Marcadores

    Use esse menu para Adicionar Marcador(es), ou Editar Marcador(es).

  Ajuda

    Veja informações sobre o Navegador de Ajuda Yelp e sobre as pessoas que contribuem para o projeto através do item de menu Sobre. Abra este documento com o item Conteúdo ou pressionando F1.

Barra de ferramentas

  Voltar

    Use esse botão para voltar no histórico do documento.

  Avançar

    Use esse botão para avançar no histórico do documento.

  Tópicos da ajuda

    Use esse botão para retornar para a tabela principal de conteúdo (exibida em ).

Painel de navegação

  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.

### Usando o Yelp

#### Abrindo um documento

Para abrir um documento no Navegador de Ajuda Yelp, use a Tabela de Conteúdo para navegar no documento desejado.

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 para saber mais.

#### Abrindo uma Nova Janela

Para abrir uma nova janela:

- Clique em Arquivo Nova Janela

- Use a combinação de teclas CtrlN

#### Sobre este documento

Para ver informações sobre o documento atualmente aberto:

- Clique em Arquivo Sobre Este Documento

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.

#### Imprimindo uma página

Para imprimir qualquer página que você consiga ver no Navegador de Ajuda Yelp:

- Clique Arquivo Imprimir Esta Página

#### Imprimindo um documento

Para imprimir um documento inteiro:

- Clique em Arquivo Imprimir Este Documento

Essa opção só está disponível para documentação no formato DocBook.

#### Fechando uma janela

Para fechar uma janela no Navegador de Ajuda Yelp, faça o seguinte:

- Clique em Arquivo Fechar Janela; ou

- Use a combinação de teclas CtrlW.

#### Definindo preferências

Para definir preferências no Navegador de Ajuda Yelp:

- Clique em Editar Preferências.

Aparecerá uma janela parecida com a :

##### Janela de Preferências do Navegador de Ajuda Yelp

As opções que estão disponíveis nesse diálogo têm as seguintes funções:

Usar fontes do sistema

  Marque essa opção para exibir a documentação usando as fontes padrão usadas pelo GNOME.

  Para escolher suas próprias fontes para exibir documentação, desmarque essa opção e clique nos botões ao lado do texto Largura Variável ou Largura Fixa.

  Largura Variável

    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.

  Largura Fixa

    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.

Navegar com cursor

  Clique nessa opção se você quiser ver um cursor no . Essa opção lhe permite navegar no documento mais facilmente ao mostrar onde o cursor está no documento.

#### Voltando no Histórico de um Documento

Para voltar no histórico de um documento:

- Clique em Ir Voltar

- Use a combinação de teclas AltEsquerda

- Use o botão Voltar na Barra de Ferramentas

#### Avançando no Histórico de um Documento

Para avançar no histórico de um documento:

- Clique em Ir Avançar

- Use a combinação de teclas AltDireita

- Use o botão Avançar na Barra de Ferramentas

#### Indo para Tópicos da Ajuda

Para ir para os Tópicos da Ajuda:

- Clique em Ir Tópicos da Ajuda

- Use a combinação de teclas AltHome

- Use o botão Tópicos da Ajuda na Barra de Ferramentas

#### Indo para a Seção Anterior

Para ir para a seção anterior:

- Clique em Ir Seção Anterior

- Use a combinação de teclas AltUp

Essa opção só está disponível em documentos com o formato DocBook.

#### Indo para a Próxima Seção

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

- Clique em Ir Próxima Seção

- Use a combinação de teclas AltAbaixo

Essa opção só está disponível em documentos com o formato DocBook.

#### Ir para o conteúdo

Para ir para o conteúdo de um documento:

- Clique em Ir Conteúdo

Essa opção só está disponível em documentos com o formato DocBook.

#### Adicionando um marcador

Para adicionar um marcador a um determinado documento:

- Clique em Marcadores Adicionar Marcador

- Use a combinação de teclas CtrlD

Aparecerá uma janela que se parece com .

##### Janela Adicionar Marcador

Digite o título desejado para o marcador no campo de entrada de texto Título. Então clique em Adicionar para adicionar o marcador, ou clique em Cancelar para cancelar o pedido.

#### Editando marcadores

Para editar sua coleção de marcadores:

- Clique em Marcadores Editar Marcadores...

- Use a combinação de teclas CtrlB

Aparecerá uma janela que se parece com .

##### Janela Editar Marcadores

Você pode gerenciar seus marcadores, usando essa janela, das seguintes formas:

Abrir

  Use esse botão para abrir o marcador selecionado numa nova janela.

Renomear

  Use esse botão para renomear o título do seu marcador.

Remover

  Use esse botão para excluir o marcador da sua coleção.

Assim que você tiver terminado de gerenciar os seus marcadores, clique no botão Fechar para sair da janela Editar Marcadores.

#### Obtendo ajuda

Para obter ajuda sobre o uso do Navegador de Ajuda Yelp (e ver este documento):

- Clique em Ajuda Conteúdo

### Recursos Avançados

#### Abrindo Documentos Específicos

##### Abrindo Documentos no Gerenciador de Arquivos

Para abrir um documento, como um arquivo XML, a partir do gerenciador de arquivos, abra o documento no Nautilus, ou arraste o ícone de dentro do Nautilus para o painel de documentos do Yelp ou lançador do Yelp.

##### Usando a Linha de Comando para Abrir Documentos

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:

`file:`

  Use esta URI quando quiser acessar um arquivo com o yelp, por exemplo:

      yelp file:///usr/share/gnome/help/gcalctool/C/gcalctool.xml

`ghelp:` ou `gnome-help:`

  Use esta URI quando quiser acessar documentos de ajuda do GNOME, tipicamente escritos no formato DocBook.

      yelp ghelp:gcalctool

  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.

      yelp ghelp:user-guide?yelp-advanced-cmdline

`man:`

  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 shell não não interprete os parênteses.

      yelp man:gcalctool

  ou

      yelp 'man:intro(1)'
      yelp 'man:intro(2)'

`info:`

  Use esta URI quando quiser acessar uma página de informações GNU em particular.

      yelp info:make

#### Atualizando o Conteúdo sob Demanda

O Navegador de Ajuda Yelp tem suporte às teclas de atalho CtrlR, que recarregam o documento DocBook atualmente aberto. Isso permite que desenvolvedores vejam as alterações nos documentos à medida em que elas são feitas.

### Mais Informações

Essa seção detalha algumas das aplicações auxiliares usadas peloNavegador de Ajuda Yelp, e indica onde você pode obter mais informações sobre ele.

#### Scrollkeeper

O Navegador de Ajuda Yelp 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.

#### Utilitários de documentação do GNOME

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

- Facilitar a tradução de documentos para diferentes idiomas.

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

- Converter do formato DocBook para um formato apropriado para exibição.

O Navegador de Ajuda Yelp conta com a Folha de Estilos GNOME XSLT para fazer conversões de DocBook para HTML. Os autores de aplicações contam com os Utilitários de Construção de Documentação do GNOME para instalar e registrar documentações no sistema de ajuda.

#### Página e Lista de discussão

Para mais informações sobre o Navegador de Ajuda Yelp, por favor visite a página de documentação do projeto, http://live.gnome.org/Yelp, ou inscreva-se na lista de discussão, gnome-doc-devel-list@gnome.org.

### Juntando-se ao Projeto de Documentação do GNOME

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: http://live.gnome.org/DocumentationProject