# Ferramentas e Utilitários

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

## 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. Open the Run Application dialog in any of the following ways:

   From a panel

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

   Using shortcut keys

     Press Alt F2. You can change the shortcut keys that display the Run Application dialog in the Keyboard Shortcuts preference tool.

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

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

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

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

Run Application dialog, using

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

  Choose Applications Accessories Take Screenshot.

- A partir da Consola

  Pode utilizar o comando `mate-screenshot` para obter uma captura de ecrã. O comando `mate-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 `mate-screenshot` da seguinte forma:

  Opção | Função
  --- | ---
  `--window` | Obtém uma captura da janela que tiver o foco.
  `--delay=seconds` | 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.
  `--help` | 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.

screenshots, taking

## Navegador de Ajuda Yelp

### Introdução

A aplicação Navegador de Ajuda Yelp permite-lhe visualizar documentação relacionada com o MATE 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.

Yelp Help Browser Window

Yelp Help Browser contains the following elements in

Menubar

  File

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

  Edit

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

  Go

    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.

  Bookmarks

    Utilize este menu para Adicionar Marcadores ou Editar Marcadores.

  Help

    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.

Toolbar

  Back

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

  Forward

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

  Help Topics

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

Browser Pane

  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 Caja 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 para mais informações.

#### Abrir uma Nova Janela

Para abrir uma nova janela:

- Click File New Window

- Utilize a combinação de teclas Ctrl N

#### Sobre Este Documento

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

- Click File About This Document

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:

- Click File Print this Page

#### Imprimir um Documento

Para imprimir um documento completo:

- Click File Print this Document

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:

- Click File Close Window

- Utilize a combinação de teclas Ctrl W

#### Definir Preferências

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

- Click Edit Preferences

A window will appear that looks like :

Yelp Help Browser Preferences Window

The options that are available in this dialog have the following functions:

Use system fonts

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

  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.

  Variable Width

    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.

  Fixed Width

    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.

Browse with caret

  Clique nesta opção se desejar ver um cursor no . 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:

- Click Go Back

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

- Click Go Forward

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

- Click Go Help Topics

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

- Click Go Previous Section

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

- Click Go Next Section

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

- Click Go Contents

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

#### Adicionar um Marcador

Para adicionar um marcador num documento em específico:

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like .

Add Bookmark Window

Enter your desired bookmark title in to the Title text entry field. Then click Add to add the bookmark, or click Cancel to cancel the request.

#### Editar Marcadores

Para editar a sua colecção de marcadores:

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like .

Edit Bookmarks Window

You can manage your bookmarks using this window in the following ways:

Open

  Use this button to open the selected bookmark in a new window.

Rename

  Use this button to rename the title of your bookmark.

Remove

  Use this button to delete the bookmark from your collection.

Once you are finished managing your bookmarks, click the Close button to exit the Edit Bookmarks Window.

#### Obter Ajuda

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

- Click Help Contents

### 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 Caja, ou arraste o ícone do Caja 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/help/C/mate-control-center/config-mouse.xml

`help:`

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

      yelp help:mate-terminal

  If you want to open the help document at a particular section, append a slash to the end of the URI, followed by the section id.

      yelp help:mate-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:mate-panel

  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 MATE

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

- Ease translation of documents to different languages.

- Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.

- Perform conversion from DocBook format to a format suitable for display.

Yelp Help Browser relies on MATE XSLT Stylesheets to perform conversion from DocBook to HTML. MATE Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

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

For further information on Yelp Help Browser, please visit the Documentation Project homepage, , or subscribe to the mailing list, .

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

If you are interesting in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage:

Yelp