# Ferramentas e utilitários

Esta seção descreve alguns dos utilitários e ferramentas no Ambiente GNOME.

## Aplicações em execução

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

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

1. Open the Run Application dialog in any of the following ways:

   De um painel

     You can add the Run Application button to any panel. See . Click on the Run Application panel button to open the Run Application dialog.

   Usando teclas de atalho

     Pressione Alt F2. 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 é exibido.

2. Enter the command that you want to run in the blank field, or choose from the list of known applications.

   If you enter only the location of a file, an appropriate application will launch to open it. If you enter a web page address, your default web browser will open the page. Prefix the web page address with http://, as in http://www.gnome.org.

   To choose a command that you ran previously, click the down arrow button beside the command field, then choose the command to run.

   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 cria uma janela na qual executar.

3. Clique no botão Executar no 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 Tela para capturar uma imagem da tela inteira.

- Use teclas de atalho

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

  Teclas de Atalho Padrão | Função
  --- | ---
  Tela Cheia | Captura uma imagem da tela inteira.
  Alt Tela Cheia | 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órios Capturar Tela.

- A partir do terminal

  You can use the `gnome-screenshot` command to take a screenshot. The `gnome-screenshot` command takes a screenshot of the entire screen, and displays the Save Screenshot dialog. Use the Save Screenshot dialog to save the screenshot.

  You can also use options on the `gnome-screenshot` command as follows:

  Opção | Função
  --- | ---
  `--window` | Captura uma imagem da janela que tem 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` | Takes a screenshot including the border of the screen.
  `--border-effect=shadow` | Takes a screenshot and adds a shadow bevel effect arround it.
  `--border-effect=border` | Takes a screenshot and adds a border effect arround it.
  `--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 de imagem, digite o nome do arquivo e escolha uma localização a partir da lista suspensa de locais.

## Navegador de Ajuda Yelp

### Introdução

O Navegador de Ajuda Yelp te permite ver 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 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, o que quer dizer que ele suporta ver documentos em diferentes idiomas. Os documentos devem ser traduzidos para cada idioma e instalados apropriadamente para que o Yelp consiga exibí-lo.

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

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

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 arquivos e pastas, ou para definir suas preferências.

  Ir

    Use esse menu para navegar para trás, para frente e para a página Tópidos 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 ou editar marcadores.

  Ajuda

    Veja informações sobre o Navegador de Ajuda Yelp e 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 this button to return to the main table of contents (shown in ).

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

#### Abrir um documento

To open a document in Yelp Help Browser, use the Table of Contents to navigate to the desired document.

Alternatively, you may view a particular document by invoking Yelp Help Browser from the command line or dragging files to Yelp. See for more on this.

#### Abrir uma nova janela

Para abrir uma nova janela:

- Clique em Arquivo Nova Janela

- Use the key combination Ctrl N

#### Sobre este documento

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

- Clique em Arquivo Sobre Este Documento

Issa opção só está disponível para documentação no formato DocBook. Notas legais e pessoas que contribuem com a documentação são geralmente listados nessa seção.

#### Imprimir uma página

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

- Clique Arquivo Imprimir esta página

#### Imprimir um documento

Imprimir um documento inteiro:

- Clique em Arquivo Imprimir este Documento

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

#### Fechar uma janela

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

- Clique em Arquivo Fechar Janela

- Use the key combination Ctrl W

#### Definir preferências

Para definir preferências no Navegador de Ajuda Yelp:

- Clique em Editar Preferências

Aparecerá uma janela que se parece com :

##### 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 Ambiente 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 usada quando uma fonte estática ou fixa não for necessária. A maior parte dos textos serão desse tipo.

  Largura Fixa

    Essa é a fonte usada quando todos os caracteres do texto precisam ser do mesmo tamanho. Essa fonte é usada para indicar comandos, blocos de programas 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 te permite navegar no documento mais facilmente ao mostrar onde o cursor está no documento.

#### Voltar no histórico de um documento

Para voltar no histórico de um documento:

- Clique em Ir Voltar

- Use the key combination Alt Left

- Use o botão Voltar na Barra de Ferramentas

#### Avançar no histórico de um documento

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

- Clique em Ir Avançar

- Use the key combination Alt Right

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

#### Ir para Tópicos da Ajuda

Para ir para os Tópicos da Ajuda:

- Clique em Ir Tópicos da Ajuda

- Use the key combination Alt Home

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

#### Ir para a sessão anterior

Para ir para a sessão anterior:

- Clique em Ir Seção Anterior

- Use the key combination Alt Up

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

#### Ir para a próxima sessão

Para ir para a próxima sessão:

- Clique em Ir Próxima Seção

- Use the key combination Alt Down

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.

#### Adicionar um marcador

Adicionar um marcador para um documento em particular:

- Clique em Marcadores Adicionar Marcador

- Use the key combination Ctrl D

Aparecerá uma janela que se parece com .

##### Janela Adicionar Marcador

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

#### Editar marcadores

To edit your collection of bookmarks:

- Clique em Marcadores Editar Marcadores

- Use the key combination Ctrl B

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

#### Obtenha ajuda

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

- Clique em Ajuda Conteúdo

### Recursos Avançados

#### Opening Specific Documents

##### Opening Documents from the File Manager

To open a document, such as an XML file, from the file manager, open the document in Nautilus File Manager, or drag the icon from Nautilus to the Yelp document pane or launcher.

##### Usando a linha de comando para abrir documentos

O Navegador de Ajuda Yelp suporta a 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, que são 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 suporta as teclas de atalho Ctrl R, que recarregam o documento DocBook que está atualmente aberto. Isso permite que desenvolvedores vejam as alterações nos documentos assim enquanto elas são feitas.

### Mais informações

Essa seção detalha algumas das aplicações de ajuda que o Navegador de Ajuda Yelp usa, e fornece referências 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:

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

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

- Converte 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 registrar documentação no sistema de ajuda.

#### Homepage and Mailing List

For further information on Yelp Help Browser, please visit the Documentation Project homepage, http://live.gnome.org/Yelp, or subscribe to the mailing list, gnome-doc-devel-list@gnome.org.

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

If you are interesting in helping produce and update documentation for the GNOME project, please visit the Documentation Project homepage: http://live.gnome.org/DocumentationProject