# Ferramentas e Utilitários

Esta secção descreve algumas das ferramentas e utilitários no Ambiente GNOME.

## Executar Aplicações

O diálogo de Executar Aplicação dá-lhe acesso à linha de comando. Quando executa um comando no diálogo de Executar Aplicação, não consegue visualizar o resultado desse comando.

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

1. Abra o diálogo de Executar Aplicação de qualquer uma das seguintes formas:

   A partir de um painel

2. Pode adicionar o botão Executar Aplicação a qualquer painel. Consulte panels-addobject. Clique no botão de painel Executar Aplicação para abrir o diálogo de Executar Aplicação.

Utilizando teclas de atalho

- Prima Alt F2. Pode alterar as teclas de atalho que apresentam o diálogo de Executar Aplicação na ferramenta de preferências de Atalhos de Teclado.

O diálogo de Executar Aplicação é apresentado.

- Introduza o comando que deseja executar no campo vazio, ou seleccione da lista de aplicações conhecidas.

  Se introduzir apenas a localização de um ficheiro, a aplicação apropriada será iniciada para o abrir. Se introduzir o endereço de uma página web, o seu navegador web por omissão abrirá a página. Prefixe o endereço da página web com http://, como em http://www.gnome.org.

  Para seleccionar um comando que tenha executado anteriormente, clique na seta para baixo que está ao lado do campo de comando e depois seleccione o comando a executar.

  Pode também utilizar o botão Executar com ficheiro para seleccionar um ficheiro para acrescentar à linha de comando. Por exemplo, pode introduzir emacs como o comando e depois seleccionar um ficheiro a editar.

  Seleccione a opção Executar numa consola para executar a aplicação ou comando numa janela de consola. Seleccione esta opção para aplicações ou comandos que não criem uma janela na qual se executem.

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

## Capturar Imagens do Ecrã

Pode capturar uma imagem do seu ecrã de uma das seguintes formas:

- A partir de qualquer painel

  Pode adicionar um botão Capturar Ecrã a qualquer painel. Para instruções sobre como o fazer, consulte panels-addobject. Clique no botão Capturar Ecrã para obter uma captura de todo o ecrã.

- Utilizando teclas de atalho

  Para obter uma captura de ecrã, utilizar as seguintes teclas de atalho:

  Teclas de Atalho por Omissão | Função
  Print Screen | Obtem uma captura de todo o ecrã.
  Alt Print Screen | Takes a screenshot of the window which is active.

  Pode utilizar a ferramenta de preferências de Atalhos de Teclado para alterar as teclas de atalho por omissão

- A partir da Barra de Menu

  Seleccione Aplicações Acessórios Capturar uma Imagem do Ecrã.

- A partir da Consola

  Pode utilizar o comando `gnome-screenshot` para obter uma captura de ecrã. O comando `gnome-screenshot` obtém uma captura da totalidade do ecrã e apresenta o diálogo de Gravar Captura de Ecrã. Utilize o diálogo de Gravar Captura de Ecrã para gravar a imagem.

  Pode também utilizar opções no comando `gnome-screenshot` da seguinte forma:

  Opção | Função
  `--window` | Obtém uma captura da janela que tiver o foco.
  `--delay=`segundos`` | Obtém uma captura de ecrã após a quantidade especificada de segundos, apresentando o diálogo de Gravar Captura de Ecrã. Utilize o diálogo de Gravar Captura de Ecrã para gravar a imagem.
  `--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.
  `--ajuda` | Apresenta 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

A aplicação Navegador de Ajuda Yelp permite-lhe visualizar documentação relacionada com o GNOME e outros componentes através de uma variedade de formatos. Estes formatos incluem ficheiros docbook, páginas de ajuda em HTML, páginas de manual e páginas de info (suporte para páginas man e info poderá ser opcionalmente incluído na compilação). Apesar dos diferentes formatos suportados, o Yelp esforça-se por uniformizar a aparência e comportamento dos documentos independentemente do formato do documento original.

O Navegador de Ajuda Yelp está internacionalizado, o que significa que possui suporte para visualizar documentos em diferentes idiomas. Os documentos têm de ser localizados ou traduzidos para cada idioma e apropriadamente instalados para que o Navegador de Ajuda Yelp os possa ver.

### Iniciar o Yelp

#### Iniciar o Navegador de Ajuda Yelp

Pode iniciar o Navegador de Ajuda Yelp das seguintes formas:

Menu Sistema

- Seleccionando Ajuda

Linha de Comando

- Execute o seguinte comando: `yelp`

#### Interface

Ao iniciar o Navegador de Ajuda Yelp, surgirá a seguinye janela.

##### Janela do Navegador de Ajuda Yelp

Navegador de Ajuda Yelp contém os seguintes elementos em fig-yelp-window

Barra de Menu

- Ficheiro

- Utilize este menu para Abrir uma Nova Janela, visualizar a página Sobre este Documento, Imprimir o documento actual ou Fechar a janela.

Editar

- Utilize este menu para Copiar, Seleccionar tudo, Procurar..., ou para definir as suas Preferências.

Ir

- Utilize este menu para Retroceder, Avançar ou navegar até à página de Tópicos de Ajuda. Ao visualizar um documento DocBook, utilize este menu para navegar para a Secção Seguinte, Secção Anterior ou para o Conteúdo.

Marcadores

- Utilize este menu para Adicionar Marcadores ou Editar Marcadores.

Ajuda

- Visualize informação sobre o Navegador de Ajuda Yelp e quem contribuiu para o projecto no item de menu About. Abra este documento com o item de menu Conteúdo ou premindo F1.

Barra de Ferramentas

- Retroceder

- Utilize este botão para navegar atrás no seu histórico de documentos.

Avançar

- Utilize este botão para navegar em frente no seu histórico de documentos.

Tópicos de Ajuda

- Utilize este botão para voltar à tabela principal de conteúdos (apresentada em fig-yelp-window).

Painel de Navegação

- O painel de navegação é onde lhe será apresentada a tabela de conteúdos ou a documentação. Utilize a tabela de conteúdos para navegar até à documentação de que necessita.

### Utilizar o Yelp

#### Abrir 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, poderá visualizar um documento específico invocando o Navegador de Ajuda Yelp a partir da linha de comando ou arrastando ficheiros para o Yelp. Consulte yelp-open-specific para mais informações.

#### Abrir uma Nova Janela

Para abrir uma nova janela:

- Clique Ficheiro Nova Janela

- Utilize a combinação de teclas Ctrl N

#### Sobre Este Documento

Para visualizar informação sobre o documento actualmente aberto:

- Clique Ficheiro Sobre Este Documento

Esta opção apenas está disponível para documentação DocBook. Notas legais e contribuições para a documentação normalmente também estão listadas nesta secção.

#### Imprimir uma Página

Para imprimir uma página que esteja a visualizar no Navegador de Ajuda Yelp:

- Clique Ficheiro Imprimir esta Página

#### Imprimir um Documento

Para imprimir um documento completo:

- Clique Ficheiro Imprimir este Documento

Esta opção apenas está disponível para documentação DocBook.

#### Fechar uma Janela

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

- Clique Ficheiro Fechar Janela

- Utilize a combinação de teclas Ctrl W

#### Definir Preferências

Para definir as suas preferências no Navegador de Ajuda Yelp:

- Clique Editar Preferências

Surgirá uma janela semelhante a yelp-preferences:

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

As opções disponíveis neste diálogo têm as seguintes funcionalidades:

Utilizar fontes do sistema

- Seleccione esta opção para visualizar a documentação utilizando as fontes por omissão utilizadas no Ambiente de Trabalho GNOME.

  Para seleccionar as suas próprias fontes para visualizar a documentação, não active esta opção e clique nos botões ao lado do texto Largura Variável ou Largura Fixa.

  Largura Variável

- Esta é a fonte a utilizar quando não é necessária uma fonte estática ou de largura fixa. A maior parte do texto será apresentado com esta fonte.

Largura Fixa

- Esta é a fonte a utilizar quando todos os caracteres de texto têm de ser do mesmo tamanho. Esta fonte é normalmente utilizada para indicar comandos, blocos de programação ou outros tipos de texto nesta categoria.

Navegar com cursor

- Clique nesta opção se desejar ver um cursor no yelp-browser-pane. Isto permite-lhe navegar mais facilmente no documento pois torna-se visível onde neste se encontra o cursor.

#### Retroceder no Histórico do Documento

Para retroceder no histórico de navegação do documento:

- Clique Ir Retroceder

- Utilize a combinação de teclas Alt Esquerda

- Utilize o botão Retroceder na Barra de Ferramentas

#### Avançar no Histórico do Documento

Para avançar no histórico de navegação do documento:

- Clique Ir Avançar

- Utilize a combinação de teclas Alt Direita

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

#### Ir para os Tópicos de Ajuda

Para ir para os Tópicos de Ajuda:

- Clique Ir Tópicos de Ajuda

- Utilize a combinação de teclas Alt Home

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

#### Ir para a Secção Anterior

Para ir para a secção anterior:

- Clique Ir Secção Anterior

- Utilize a combinação de teclas Alt Acima

Esta opção apenas está disponível nos documentos em formato DocBook.

#### Ir para a Secção Seguinte

Para ir para a secção seguinte:

- Clique Ir Secção Seguinte

- Utilize a combinação de teclas Alt Abaixo

Esta opção apenas está disponível nos documentos em formato DocBook.

#### Ir para os Conteúdos

Para ir para a lista de conteúdos de um documento:

- Clique Ir Conteúdo

Esta opção apenas está disponível nos documentos em formato DocBook.

#### Adicionar um Marcador

Para adicionar um marcador num documento em específico:

- Clique Marcadores Adicionar Marcador

- Utilize a combinação de teclas Ctrl D

Será apresentada uma janela semelhante a yelp-add-bookmark.

##### Janela de Adicionar Marcador

Introduza o título desejado para o marcador no campo de introdução de texto Título. Depois clique Adicionar para adicionar o marcador, ou clique Cancelar para cancelar o pedido.

#### Editar Marcadores

Para editar a sua colecção de marcadores:

- Clique em Marcadores Editar Marcadores...

- Utilize a combinação de teclas Ctrl B

Será apresentada uma janela semelhante a yelp-edit-bookmarks.

##### Janela de Edição de Marcadores

Pode gerir os seus marcadores utilizando esta janela das seguintes formas:

Abrir

- Utilize este botão para abrir o marcador seleccionado numa nova janela.

Renomear

- Utilize este botão para renomear o título do seu marcador.

Remover

- Utilize este botão para remover o marcador da sua colecção.

Uma vez terminada a gestão dos seus marcadores, clique no botão Fechar para sair da Janela de Edição de Marcadores.

#### Obter Ajuda

Para obter ajuda na utilização do Navegador de Ajuda Yelp (e visualizar este documento):

- Clique Ajuda Conteúdo

### Funcionalidades Avançadas

#### Abrir Documentos Específicos

##### Abrir Documentos a partir do Gestor de Ficheiros

Para abrir um documento, tal como um ficheiro XML, a partir do gestor de ficheiros, abra o documento no Gestor de Ficheiros Nautilus, ou arraste o ícone do Nautilus para o painel de documento ou iniciador do Yelp.

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

O Navegador de Ajuda Yelp suporta abrir documentos a partir da linha de comando. Existe um conjunto de URIs (Identificadores Uniformes de Recursos) que podem ser utilizados. Estes incluem:

`file:`

- Utilize este URI quando deseja aceder a um ficheiro através do yelp, por exemplo:

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

`ghelp:` ou `gnome-help:`

- Utilize este URI quando desejar aceder a documentos de ajuda do GNOME, que tipicamente estão escritos no formato DocBook.

      yelp ghelp:gcalctool

  Se deseja abrir o documento de ajuda numa secção específica, acrescente um ponto de interrogação no final do URI, seguido do ID da secção.

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

`man:`

- Utilize este URI quando desejar aceder a uma página man específica. Pode acrescentar a secção da página man que deseja consultar caso existão várias páginas man com o mesmo nome. O número de secção deverá estar entre parêntesis e como tal poderá ser necessário escapar o argumento para que a consola não interprete os parêntesis.

      yelp man:gcalctool

  ou

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

`info:`

- Utilize este URI quando desejar aceder a uma página info GNU em específico.

      yelp info:make

#### Actualizar o Conteúdo a Pedido

O Navegador de Ajuda Yelp suporta as teclas de atalho Ctrl R, que relêem o documento DocBook actualmente aberto. Isto permite aos programadores e escritores visualizarem as alterações à medida que elas são feitas.

### Mais Informação

Esta secção detalha algumas das aplicações de apoio que o Navegador de Ajuda Yelp utiliza, e disponibiliza recursos onde poderá obter mais informação sobre o Navegador de Ajuda Yelp.

#### Scrollkeeper

O Navegador de Ajuda Yelp utiliza o scrollkeeper para gerar as tabelas de conteúdos dos documentos DocBook e HTML, e também para se manter a par das traduções de cada documento.

#### Utilitários de Documentação GNOME

A documentação distribuída com o GNOME utiliza este conjunto de utilitários para uma variedade de situações:

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

- Disponibilizar um conjunto de ferramentas para ajudar a empacotar e instalar documentação no local correcto e registar essa documentação no scrollkeeper.

- Realizar a conversão do formato DocBook para um formato adequado a ser apresentado.

O Navegador de Ajuda Yelp baseia-se nas Folhas de Estilo XSLT do GNOME para realizar a conversão de DocBook em HTML. Os autores das aplicações confiam nos Utilitários de Criação de Documentação do GNOME para que instalem e registem a documentação no sistema de ajuda.

#### Página Web e Lista de Distribuição

Para mais informações sobre o Navegador de Ajuda Yelp, visite a página do Projecto de Documentação, http://live.gnome.org/Yelp, ou subscreva a lista de distribuição, gnome-doc-devel-list@gnome.org (ambos os recursos em inglês).

### Juntar-se ao Projecto de Documentação do GNOME

Caso esteja interessado em ajudar a produzir e actualizar documentação para o projecto GNOME, visite a página do Projecto de Documentação: http://live.gnome.org/DocumentationProject (em inglês)