# 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. Abra o diálogo Executar Aplicação. Você pode abrí-lo de qualquer uma das seguintes formas:

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

2. Digite o comando que vocês deseja executar no campo em branco.

   Como alternativa, para escolher um comando que você executou anteriormente, clique na seta para baixo ao lado do campo de comando e escolha o comando para executar.

   Você também pode selecionar a opção Exibir lista de aplicações conhecidas para ver uma lista das aplicações conhecidas.

   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.

## Setting up a Printer

To set up a printer to use with GNOME, choose System Administration Printing in the panel menubar. The Printers window opens.

Choose Printer Add Printer. The Add a Printer assistant opens. This guides you through the process of setting up the printer.

You can also use the Printers window to check the status of print jobs, and remove or alter the properties of printers that are already set up.

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

#### Abrir um documento

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

Como alternativa, você pode ver um documento em particular chamando o Navegador de Ajuda Yelp a partir da linha de comando. Por favor, ver .

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

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