# Ferramentas e Utilitários

Esta seção descreve alguns utilitários e ferramentas do MATE.

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

2. You can add the Run Application button to any panel. See panels-addobject. 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 Executar aplicativo será exibido.

- 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 http://, as in http://www.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.

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

  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

  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` | Takes a screenshot and adds a border effect around it.
  `--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.

O Navegador de Ajuda Yelp é internacionalizado, ou seja, tem suporte à visualização de documentos em diferentes idiomas. Para isso, os documentos devem ser traduzidos para cada idioma e instalados apropriadamente.

### 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 fig-yelp-window

Menubar

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

Help

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

Toolbar

- 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 fig-yelp-window).

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 yelp-open-specific 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:

- Click File About This Document

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

A window will appear that looks like yelp-preferences:

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

  Variable Width

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

Fixed Width

- 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 yelp-browser-pane. 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:

- Click Go Back

- Use a combinação de teclas Alt Esquerda

- Use o botão Voltar na Barra de Ferramentas

#### 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 o botão Avançar na Barra de Ferramentas

#### 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 o botão Tópicos da Ajuda na Barra de Ferramentas

#### 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 yelp-add-bookmark.

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

#### Editando 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 yelp-edit-bookmarks.

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

Para obter ajuda sobre o uso do Navegador de Ajuda Yelp (e ver este documento):

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

Essa seção detalha alguns dos aplicativos auxiliares usados pelo Navegador de Ajuda Yelp, e indica 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 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, , or subscribe to the mailing list, .

### Juntando-se ao Projeto 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: