# Ferramentas e Utilitários

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

## Executando aplicativos

O diálogo Executar aplicativo 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 aplicativo em uma das duas formas a seguir:

   A partir de um painel

2. Você pode adicionar o botão Executar aplicativo a qualquer painel. Veja panels-addobject. Clique no botão Executar para abrir o diálogo Executar aplicativo.

Usando teclas de atalho

- Pressione Alt F2. Você pode alterar as teclas de atalho que exibem o diálogo Executar aplicativo na ferramenta de preferências Atalhos de Teclado.

O diálogo Executar aplicativo será exibido.

- Digite o comando que você deseja executar no campo em branco, ou escolha a partir da lista de aplicativos conhecidos.

  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 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 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.

- Clique no botão Executar do diálogo Executar aplicativo.

## Capturando Imagens da Tela

Você pode capturar uma imagem da tela 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 a panels-addobject. Clique no botão Capturar imagem da tela para capturar uma imagem da tela inteira.

- Usando teclas de atalho

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

  Teclas de Atalho Padrão | Função
  Print Screen | Captura uma imagem da tela inteira.
  Alt Print Screen | Takes a screenshot of the window which is active.

  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 Aplicativos Acessórios Capturar 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 de tela. Use esse diálogo para salvar a captura de 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 exibe o diálogo Salvar captura de tela. Use esse diálogo para salvar a imagem da tela.
  `--include-border` | Takes a screenshot including the border of the window.
  `--remove-border` | Takes a screenshot without the border of the window.
  `--border-effect=shadow` | Takes a screenshot and adds a shadow bevel effect around it.
  `--border-effect=border` | Takes a screenshot and adds a border effect around it.
  `--interactive` | Opens a window that lets you set options before taking the screenshot.
  `--help` | Exibe as opções para o comando.

When you take a screenshot, the Save Screenshot 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 Save button. You can also use the Copy to Clipboard button to copy the image to the clipboard or transfer it to another application by drag-and-drop.

## 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 fig-yelp-window

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 fig-yelp-window).

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

To open a document in Yelp Help Browser:

- In an application, click Help Contents

- Use the Table of Contents to navigate to the desired document.

- You can drag a Docbook XML file from Nautilus to the Yelp window or launcher.

- Press the F1 key.

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

#### Abrindo uma Nova Janela

Para abrir uma nova janela:

- Clique em Arquivo Nova Janela

- Use a combinação de teclas Ctrl N

#### 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 Ctrl W.

#### Definindo preferências

Para definir preferências no Navegador de Ajuda Yelp:

- Clique em Editar Preferências.

Aparecerá uma janela parecida com a yelp-preferences:

##### 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 yelp-browser-pane. 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 Alt Esquerda

- 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 Alt Direita

- 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 Alt Home

- 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 Alt Up

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 Alt Abaixo

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 Ctrl D

Aparecerá uma janela que se parece com yelp-add-bookmark.

##### 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 Ctrl B

Aparecerá uma janela que se parece com yelp-edit-bookmarks.

##### 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 Ctrl R, 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 alguns dos aplicativos auxiliares usados pelo Navegador 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 aplicativos 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