# Ferramentas e Utilitários

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

## Executando aplicativos

O diálogo Executar aplicativo lhe dá acesso à linha de comando. Quando você executa um comando nesse diálogo, você não recebe 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:

   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 Executar aplicativo será exibido.

2. Digite o comando que você deseja executar no campo em branco, ou escolha a partir da lista de aplicativos conhecidos.

   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 escolher um comando que você executou anteriormente, clique na seta para baixo, ao lado do campo de comando, e escolha o comando a ser executado.

   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 o aplicativo ou comando numa janela de terminal. Marque essa opção para um aplicativo ou comando que não crie a própria janela.

3. Clique no botão Executar do diálogo Executar aplicativo.

## Capturando Imagens da Tela

Você pode capturar uma imagem da tela 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 a . Clique no botão Capturar imagem da tela para capturar uma imagem da tela inteira.

- Usando teclas de atalho

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

  Teclas de Atalho Padrão | Função
  --- | ---
  Print Screen | Captura uma imagem da tela inteira.
  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 do terminal

  Você pode usar o comando `mate-screenshot` para capturar uma imagem da tela. O comando `mate-screenshot` captura uma imagem da tela inteira e exibe o diálogo Salvar captura de tela. Use esse diálogo para salvar a captura de tela.

  Você também pode usar as seguintes opções no comando `mate-screenshot`:

  Opção | Função
  --- | ---
  `--window` | Captura uma imagem da janela em foco.
  `--delay=seconds` | Captura uma imagem da tela após o número de segundos especificado, e exibe o diálogo Salvar captura de tela. Use esse diálogo para salvar a imagem da tela.
  `--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` | Faz uma captura de tela e adiciona efeito ao redor.
  `--interactive` | Opens a window that lets you set options before taking the screenshot.
  `--help` | Exibe 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

O Navegador de Ajuda Yelp lhe permite ver a documentação sobre o MATE 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 "info", 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.

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.

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

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

##### Yelp Help Browser Window

Yelp Help Browser contains the following elements in

Barra de menu

  File

    Use esse menu para Abrir uma Nova Janela, ver a página Sobre Este Documento, imprimir o documento atual, ou fechar a janela.

  Edit

    Use esse menu para Copiar, Selecionar tudo, Localizar..., ou para definir suas Preferências.

  Go

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

  Bookmarks

    Use esse menu para Adicionar Marcador(es), ou Editar Marcador(es).

  Ajuda

    Veja informações sobre o Navegador de Ajuda Yelp e sobre as 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

  Back

    Use esse botão para voltar no histórico do documento.

  Forward

    Use esse botão para avançar no histórico do documento.

  Help Topics

    Use esse botão para retornar para a tabela principal de conteúdo (exibida em ).

Browser Pane

  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

#### Abrindo 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, você pode ver um documento em particular chamando o Navegador de Ajuda Yelp a partir da linha de comando, ou arrastando arquivo para o Yelp. Veja para saber mais.

#### Abrindo uma Nova Janela

Para abrir uma nova janela:

- Click File New Window

- Use a combinação de teclas Ctrl N

#### Sobre este documento

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

- Clicar Arquivo Sobre este documento

Essa opção só está disponível para documentação no formato DocBook. Geralmente notas legais e as pessoas que contribuíram com a documentação estão listados nessa seção.

#### Imprimindo uma página

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

- Click File Print this Page

#### Imprimindo um documento

Para imprimir um documento inteiro:

- Click File Print this Document

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

#### Fechando uma janela

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

- Click File Close Window

- Use a combinação de teclas Ctrl W.

#### Definindo preferências

Para definir preferências no Navegador de Ajuda Yelp:

- Click Edit Preferences

Irá aparecer uma janela que se parece com:

##### Yelp Help Browser Preferences Window

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

Use system fonts

  Marque essa opção para exibir a documentação usando as fontes padrão usadas pelo MATE.

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

  Largura fixa

    Esta é a fonte a ser usada quando todos os caracteres do texto precisam ser do mesmo tamanho. Essa fonte é usada para indicar comandos, blocos de código ou outros textos que se encaixem nessa categoria.

Browse with caret

  Clique nessa opção se você quiser ver um cursor no . Essa opção lhe permite navegar no documento mais facilmente ao mostrar onde o cursor está no documento.

#### Voltando no Histórico de um Documento

Para voltar no histórico de um documento:

- Clicar Ir Voltar

- Use a combinação de teclas Alt Esquerda

- Use the Back button in the Toolbar

#### Avançando no Histórico de um Documento

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

- Click Go Forward

- Use a combinação de teclas Alt Direita

- Use the Forward button in the Toolbar

#### Indo para Tópicos da Ajuda

Para ir para os Tópicos da Ajuda:

- Click Go Help Topics

- Use a combinação de teclas Alt Home

- Use the Help Topics button in the Toolbar

#### Indo para a Seção Anterior

Para ir para a seção anterior:

- Click Go Previous Section

- Use a combinação de teclas Alt Up

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

#### Indo para a Próxima Seção

Para ir para a próxima seção:

- Click Go Next Section

- Use a combinação de teclas Alt Abaixo

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:

- Click Go Contents

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

#### Adicionando um marcador

Para adicionar um marcador a um determinado documento:

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

#### Obtendo ajuda

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

- Click Help Contents

### Recursos Avançados

#### Abrindo Documentos Específicos

##### Abrindo Documentos no Gerenciador de Arquivos

Para abrir um documento, como um arquivo XML, a partir do gerenciador de arquivos, abra o documento no Caja, ou arraste o ícone de dentro do Caja para o painel de documentos do Yelp ou lançador do Yelp.

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

O Navegador de Ajuda Yelp tem suporte à 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/help/C/mate-control-center/config-mouse.xml

`help:`

  Use esta URI quando quiser acessar documentos de ajuda do MATE, tipicamente 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:`

  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 tem suporte às teclas de atalho Ctrl R, que recarregam o documento DocBook atualmente aberto. Isso permite que desenvolvedores vejam as alterações nos documentos à medida em que elas são feitas.

### Mais Informações

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

A documentação distribuída com o MATE usa esse conjunto de utilitários para várias coisas:

- 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 e Lista de discussã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`.

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