# Ferramentas e Utilitários

This section describes some tools and utilities in the MATE Desktop.

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

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

2. Introduza o comando que deseja executar no campo vazio, ou selecione 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 https://, as in https://mate-desktop.org.

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

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

   Selecione a opção Executar numa consola para executar a aplicação ou comando numa janela de consola. Selecione 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.

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

  You can use the tool to modify the default shortcut keys.

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

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

Yelp Help Browser is internationalized, meaning that it has support to view documents in different languages. The documents must be localized or translated for each language and installed properly for Yelp Help Browser to be able to view them.

### Iniciar o Yelp

#### Iniciar o Navegador de Ajuda Yelp

Pode iniciar o Navegador de Ajuda Yelp das seguintes formas:

Menu Sistema

  Selecionando 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

Barra de Menu

  File

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

  Edit

    Utilize este menu para Copiar, Selecionar 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 projeto no item de menu Sobre. Abra este documento com o item de menu Conteúdo ou premindo F1.

Barra de Ferramentas

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

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

  Para selecionar as suas próprias fontes para visualizar a documentação, não ative 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

- Use the Back button in the Toolbar

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

- Use the Forward button in the Toolbar

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

- Use the Help Topics button in the Toolbar

#### 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 coleçã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

To get help to use Yelp Help Browser (and see this document):

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

  Use this URI when you want to access a particular man page. You can append the section of the man page you would like to view if there are multiple man pages with the same name. The section number should be enclosed in parentheses and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.

      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

#### Atualizar o Conteúdo a Pedido

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

### Mais Informação

This section details some helper applications which Yelp Help Browser uses, and provides resources where you can get more information about Yelp Help Browser.

#### 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, `http://mate-desktop.org`, or subscribe to the mailing list, `http://ml.mate-desktop.org/listinfo/mate-dev`.

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

If you are interested in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`