# Manual do Pluma

## Introdução

O pluma permite a você criar e editar arquivos de texto.

O propósito do pluma é ser um editor de texto simples e fácil de usar. Recursos mais poderosos podem ser habilitados com diferentes plug-ins, permitindo uma variedade de tarefas relacionadas à edição de texto.

## Iniciando

### Iniciando o pluma

Você pode iniciar o pluma das seguintes formas:

Menu Aplicações

- Selecione Acessórios Editor de Texto.

Linha de comando

- Execute o seguinte comando: `pluma`

Por padrão, quando você abre um arquivo de texto no gerenciador de arquivos, pluma irá iniciar e exibir o documento.

### A Janela do pluma

Quando iniciar o pluma, a seguinte janela é exibida:

#### Janela do pluma

Shows pluma main window.

A janela do pluma contém os seguintes elementos:

Barra de Menus

- Os menus na barra de menus contêm todos os comandos de que você precisa para trabalhar com arquivos no pluma.

Barra de Ferramentas

- A barra de ferramentas contém um subconjunto dos comandos que você pode acessar a partir da barra de menus.

Área de Visualização

- A área de visualização contém o texto do arquivo que está sendo editado.

Barra de Status

- A barra de status exibe informação sobre a atividade corrente do pluma e informação contextual sobre os itens do menu. A barra de status também exibe a seguinte informação:

  - Posição do cursor: o número da linha e da coluna onde o cursor está localizado.

  - Modo de edição: Se o editor estiver em modo de inserção, a barra de status exibe o texto INS. Se o editor estiver em modo de sobrescrita, a barra de status exibe o texto SBR. Pressione a tecla Insert para alterar o modo de edição.

Painel Lateral

- O painel lateral exibe uma lista de documentos abertos e outras informações, dependendo de quais plug-ins estão sendo usados.

  Por padrão o painel lateral não é exibido. Para exibi-lo, escolha Ver Painel Lateral.

Painel Inferior

- O painel inferior é usado por ferramentas de programação como o plug-in Console Python para exibir saída.

  Por padrão o painel inferior não é mostrado. Para mostrá-lo, escolha Ver Painel Inferior.

Quando você pressiona o botão direito do mouse na janela do pluma, é exibido um menu de contexto. O menu de contexto contém os comandos de edição mais usados.

Like other MATE applications, actions in pluma can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the User Guide.

### Executando pluma a partir da Linha de Comando

Você pode executar o pluma a partir da linha de comando e abrir um ou vários arquivos. Para abrir vários arquivos pela linha de comando, digite o seguinte comando, então pressione Enter:

`pluma `file1.txt file2.txt file3.txt``

Em alternativa, você pode especificar um URI em lugar de um nome de arquivo.

Para mais informações em como executar o pluma a partir da linha de comando, veja a página do manual unix para pluma,

pluma

1.

## Trabalhando com Arquivos

### Criando um Novo Documento

Para criar um novo documento, escolha Arquivo Novo. A aplicação exibe um novo documento em branco na janela do pluma.

### Abrindo um Arquivo

Para abrir um arquivo, escolha Arquivo Abrir para exibir a janela de Abrir Arquivo. Selecione o arquivo que você quer abrir, então clique no botão Abrir. O arquivo é exibido na janela do pluma.

The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the File menu. You can also click on the Shows Recent Files menu icon. icon on the toolbar to display the list of recent files.

Você pode abrir vários arquivos no pluma. A aplicação adiciona uma aba na janela para cada arquivo aberto. Para mais informações veja a pluma-tabs.

### Salvando um Arquivo

Você pode salvar arquivos das seguintes formas:

- Para salvar alterações a um arquivo existente, escolha Arquivo Salvar.

- To save a new file or to save an existing file under a new filename, choose File Save As . Enter a name for the file in the Save As dialog, then click Save.

- To save all of the files that are currently open in pluma, choose Documents Save All .

To close all of the files that are currently open in pluma, choose Documents Close All .

### Abrindo um Arquivo a partir de um URI

Para abrir um arquivo a partir de um Identificador Uniforme de Recursos (do inglês URI, Uniform Resource Identifier), efetue os seguintes passos:

1. Choose File Open Location to display the Open Location dialog.

2. Digite o URI do arquivo que você deseja abrir.

3. Use a lista Codificação de caracteres para selecionar a codificação de caracteres apropriada.

4. Clique no botão Abrir.

Tipos válidos de `URI` são `http:`, `ftp:`, `file:` e todos os métodos aceitos pelo `mate-vfs`.

Arquivos que estão em alguns tipos de URI são abertos como somente para leitura, e qualquer mudança que você fizer deve ser salva em um local diferente. O HTTP só permite que os arquivos sejam lidos. Arquivos aberto a partir de FTP são somente para leitura porque nem todos os servidores de FTP trabalham corretamente salvando arquivos remotos.

Salvar em servidores FTP pode ser habilitado com o Editor de Configurações, ajustando a chave `/apps/pluma/preferences/editor/save/writable_vfs_schemes`, mas isso pode causar erros.

### Trabalhando com Abas

Quando mais de um arquivo está aberto, o pluma mostra uma aba para cada documento acima da área de visualização. Para mudar para outro documento, clique na aba correspondente.

Para mover um documento para outra janela do pluma, arraste a aba correspondente ao arquivo para a janela que você deseja que receba o arquivo.

To move a document to a new pluma window, either drag its tab to the desktop, or choose Documents Move to New Window .

## Trabalhando com Texto

### Editando Texto

Você pode editar o texto de um arquivo das seguintes maneiras:

- Digite o novo texto no teclado. O cursor de inserção piscante marca o ponto onde o novo texto aparece. Para mudar isso, use as teclas de seta no teclado ou clique com o mouse.

- To copy the selected text to the clipboard, choose Edit Copy .

- To delete the selected text from the file and move the selected text to the clipboard, choose Edit Cut .

- To permanently delete the selected text from the file, choose Edit Delete .

- To insert the contents of the clipboard at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file, either from pluma or another application.

- To select all of the text in a file, choose Edit Select All .

### Desfazendo e Refazendo Alterações

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## Procurando e Substituindo

No pluma, há duas formas de pesquisar por texto. Você pode usar a janela Localizar para procurar por um pedaço de texto específico, ou a Pesquisa Incremental para destacar o texto à medida que você for digitando.

### Procurando Texto

Para pesquisar em um arquivo por uma seqüência de texto, efetue os seguintes passos:

1. Choose Search Find to display the Find dialog.

2. Digite o texto que você deseja procurar no campo Pesquisar por. Você pode incluir caracteres especiais como uma nova linha ou tabulação: veja a pluma-find-escapes.

3. Clique no botão Localizar para pesquisar no arquivo a primeira ocorrência do texto depois da posição atual do cursor. Se o pluma encontrar o texto, a aplicação seleciona a primeira ocorrência do mesmo. Outras ocorrências do texto são destacadas.

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### Pesquisa Incremental

Pesquisa incremental destaca o texto no documento à medida que você digita, letra por letra. (É similar ao recurso de pesquisa em diversos navegadores web.)

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

Comece a digitar e o texto será destacado no documento. A primeira instância depois da posição do cursor também é selecionada.

Para avançar a seleção para a próxima ocorrência enquanto mantém a caixa de pesquisa incremental aberta, pressione Ctrl G. Pressione Ctrl Shift G para voltar à ocorrência anterior.

Você pode também usar as teclas de seta para cima e para baixo ou o botão de rolagem do mouse para mover a seleção entre as ocorrências.

### Substituindo Texto

Para pesquisar em um arquivo por uma seqüência de texto e substituí-la por uma seqüência alternativa, siga os seguintes passos:

1. Choose Search Replace to display the Replace dialog.

2. Digite o texto que você quer procurar no campo Pesquisar por. Você pode incluir caracteres especiais como uma nova linha ou tabulação: veja a pluma-find-escapes.

3. Digite o texto que você deseja usar para substituir o que você encontrar, no campo Substituir por.

Para examinar cada ocorrência do texto antes de substituir, clique no botão Localizar. Se o pluma encontrar o texto, a aplicação o seleciona. Clique no botão Substituir para substituir a ocorrência selecionada do texto. Para procurar pela próxima ocorrência do texto, clique no botão Localizar novamente.

Para substituir todas as ocorrências do texto por todo documento, clique no botão Substituir Todas.

### Opções de Procurar e Substituir

A janela Localizar e a janela Substituir ambas têm as seguintes opções:

- Selecione a opção Diferenciar maiúsculas/minúsculas para encontrar somente ocorrências do texto que coincidam com as letras maiúsculas e minúsculas no texto que você digitou. Por exemplo, com Diferenciar maiúsculas/minúsculas selecionada, "TEXTO" não encontrará "texto".

- Selecione a opção Coincidir apenas com palavra completa para procurar somente ocorrências do texto que coincidam com todas as palavras do texto que você digitou. Por exemplo, com Coincidir apenas com palavra completa selecionada, "text" não encontrará "textura".

- Selecione a opção Pesquisar para trás para pesquisar voltando em direção ao início do documento.

- Selecione a opção Voltar ao início para pesquisar até o fim do documento e então continuar a pesquisa a partir do início do arquivo.

### Caracteres Especiais

Você pode incluir as seguintes seqüências de escape nos textos a encontrar ou substituir para representar caracteres especiais:

`\n`

- Especifica uma nova linha.

`\t`

- Especifica um caractere de tabulação.

`\r`

- Especifica um retorno do carro (do inglês CR, carriage return).

`\\`

- O próprio caractere de barra invertida deve ser escapado se ele estiver na busca. Por exemplo, se você estiver procurando pela literal "`\n`", terá que escrever "\\n" no campo Pesquisar por. Ou se você estiver procurando por uma seqüência de barras invertidas, você terá que dobrar o número de barras invertidas pesquisadas.

### Posicionando o Cursor em uma Linha Específica

To position the cursor on a specific line in the current file, choose Search Go to Line . The line number box appears at the top of the display area.

Comece a digitar o número da linha para a qual você deseja mover o cursor e o documento irá até a linha especificada.

Para fechar a caixa e mover o cursor à linha especificada, pressione Enter.

## Imprimindo

### Configurando as Opções de Página

To set the page options, choose File Page Setup to display the Page Setup dialog.

A janela de Configuração de Página permite a você especificar as seguintes opções de impressão:

#### Seção da Aba Geral

Print syntax highlighting

- Selecione essa opção para imprimir o destaque de sintaxe. Para mais informações sobre destaque de sintaxe, veja a pluma-set-highlightmode.

Print page headers

- Selecione essa opção para incluir um cabeçalho em cada página que você imprimir. Você não pode alterar o cabeçalho.

Line Numbers

- Selecione a opção Imprimir números de linha para incluir os números de linha quando você imprimir um arquivo.

  Use o seletor numérico Enumerar a cada ... linhas para especificar com que freqüência imprimir as linhas numeradas, por exemplo, a cada 5 linhas, a cada 10 linhas, e assim por diante.

Text Wrapping

- Selecione a opção Habilitar quebra de texto para quebrar o texto em uma nova linha, num nível de caractere, quando você imprimir um arquivo. A aplicação conta linhas quebradas como uma nova linha para propósitos de numeração de linhas.

  Selecione a opção Não dividir uma palavra em duas linhas para quebrar o texto em uma nova linha sem dividir a palavra, quando você imprimir um arquivo.

#### Fontes

Body

- Clique nesse botão para selecionar a fonte a ser usada na impressão do corpo do texto de um arquivo.

Line numbers

- Clique nesse botão para selecionar a fonte a ser usada na impressão dos números de linha.

Headers and footers

- Clique nesse botão para selecionar a fonte a ser usada na impressão dos cabeçalhos e rodapés em um arquivo.

Para restaurar as fontes para impressão de um arquivo no pluma para o padrão, clique em Restaurar Fontes Padrão.

### Imprimindo um Documento

Você pode usar o pluma para realizar as seguintes operações de impressão:

- Imprimir um documento para uma impressora.

- Imprimir a saída do comando de impressão para um arquivo.

Se você imprimir para um arquivo, o pluma envia a saída do arquivo para um formato de arquivo pré-impresso. Os formatos pré-impressos mais comuns são o PostScript e o Portable Document Format (PDF, Formato de Documento Portátil, em português).

To preview the pages that you want to print, choose File Print Preview .

To print the current file to a printer or a file, choose File Print to display the Print dialog.

A janela Imprimir permite a você especificar as seguintes opções de impressão:

#### Seção da Aba Trabalho

Print range

- Selecione uma das seguintes opções para determinar quantas páginas imprimir:

  - All

    Selecione essa opção para imprimir todas as páginas no arquivo.

  - Lines

    Selecione essa opção para imprimir somente as linhas especificadas. Use os seletores numéricos De e Até para especificar o intervalo de linhas.

  - Selection

    Selecione essa opção para imprimir somente o texto selecionado. Essa opção só está disponível se você selecionar um texto.

Copies

- Use o seletor numérico Número de cópias para especificar o número de cópias do arquivo que você deseja imprimir.

  Se você imprimir múltiplas cópias do arquivo, selecione a opção Agrupar para agrupar as cópias impressas.

#### Seção da Aba Impressora

Printer

- Use essa lista suspensa para selecionar a impressora para a qual você deseja mandar imprimir o arquivo.

Settings

- Use essa lista suspensa para selecionar as configurações da impressora.

  Para configurar a impressora, clique em Configurar. Você pode, por exemplo, habilitar ou desabilitar impressão duplex, ou agendar impressão com atraso, se a impressora tiver suporte a essa funcionalidade.

Location

- Use essa lista suspensa para selecionar um dos seguintes destinos de impressão:

  CUPS

- Imprimir o arquivo para uma impressora CUPS.

  Se a impressora selecionada é uma impressora CUPS, CUPS é a única opção nessa lista suspensa.

lpr

- Imprimir o arquivo em uma impressora.

File

- Imprimir o arquivo em um arquivo PostScript.

  Clique em Salvar Como para exibir uma janela onde você especifica o nome e localização do arquivo PostScript.

Custom

- Use o comando especificado para imprimir o arquivo.

  Digite o nome do comando na caixa de texto. Inclua todos os argumentos de linha de comando.

State

- Esta versão do pluma não tem suporte a essa funcionalidade.

Type

- Esta versão do pluma não tem suporte a essa funcionalidade.

Comment

- Esta versão do pluma não tem suporte a essa funcionalidade.

#### Seção da Aba Papel

Paper size

- Use essa lista suspensa para selecionar o tamanho do papel no qual você deseja imprimir o arquivo.

Width

- Use esse seletor numérico para especificar a largura do papel. Use a lista suspensa adjacente para alterar a unidade de medida.

Height

- Use esse seletor numérico para especificar a altura do papel.

Feed orientation

- Use essa lista suspensa para selecionar a orientação do papel na impressora.

Page orientation

- Use essa lista suspensa para selecionar a orientação da página.

Layout

- Use essa lista suspensa para selecionar a disposição da página. Uma visualização de cada disposição que você selecionar é exibida na área de Visualização.

Paper tray

- Use essa lista suspensa para selecionar a bandeja de papel.

## Recursos de Programação

Vários dos recursos para programação do pluma são proporcionados com plug-ins. Por exemplo, o plug-in de Lista de Tags oferece uma lista de tags comumente usadas em diferentes linguagens de marcação: veja a pluma-tag-list-plugin.

### Destaque de Sintaxe

O destaque de sintaxe faz o código fonte ficar mais legível, mostrando as diferentes partes do texto em cores diferenciadas.

pluma chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

- Não exibe qualquer destaque de sintaxe.

Sources

- Exibe destaques de sintaxe para editar código fonte. Use o submenu Fontes para selecionar o tipo de código fonte.

Markup

- Exibe destaques de sintaxe para editar código de marcação. Use o submenu Marcação para selecionar o tipo de código de marcação.

Scripts

- Exibe destaque de sintaxe para editar código de script. Use o submenu Scripts para selecionar o tipo de código de script.

Others

- Exibe destaque de sintaxe para editar outros tipos de código. Use o submenu Outros para selecionar o tipo de código.

### Passando a Saída de um Comando para um Arquivo

Você pode usar o pluma para redirecionar a saída de um comando para um arquivo de texto. Por exemplo, para passar a saída de um comando `ls` para um arquivo de texto, digite `ls | pluma`, então pressione Enter.

A saída do comando `ls` é exibida num novo arquivo de texto na janela do pluma.

Opcionalmente, você pode usar o plug-in Ferramentas externas para redirecionar a saída de um comando para o arquivo atual.

## Teclas de Atalho

Use as teclas de atalho para realizar as tarefas mais comuns mais rapidamente que com o mouse e menus. As seguintes tabelas listam todas as teclas de atalho do pluma.

For more on shortcut keys, see the Desktop User Guide.

Tabulações

Atalhos para abas:

Tecla de Atalho | Comando
Ctrl + Alt + PageUp | Muda para a próxima aba à esquerda.
Ctrl + Alt + PageDown | Muda para a próxima aba à direita.
Ctrl + W | Fecha a aba.
Ctrl + Shift + L | Salva todas as abas.
Ctrl + Shift + W | Fecha todas as abas.
Alt + n | Pula para a aba número n.

Arquivos

Atalhos para trabalhar com arquivos:

Tecla de Atalho | Comando
Ctrl + N | Criar um novo documento.
Ctrl + O | Abrir um documento.
Ctrl + L | Abrir uma localização.
Ctrl + S | Salvar o documento atual para o disco.
Ctrl + Shift + S | Salvar o documento atual com um novo nome.
Ctrl + P | Imprimir o documento atual.
Ctrl + Shift + P | Visualizar a impressão.
Ctrl + W | Fechar o documento atual.
Ctrl + Q | Sair do Pluma.

Editar

Atalhos para edição de documentos:

Tecla de Atalho | Comando
Ctrl + Z | Desfazer a última ação.
Ctrl + Shift + Z | Refazer a última ação desfeita.
Ctrl + X | Cortar o texto selecionado ou região e mandar para a área de transferência.
Ctrl + C | Copiar o texto selecionado ou região para a área de transferência.
Ctrl + V | Colar o conteúdo da área de transferência.
Ctrl + A | Selecionar tudo.
Ctrl + D | Remove a linha atual.
Alt + Up | Move the selected line up one line.
Alt + Down | Move the selected line down one line.

Painéis

Atalhos para mostrar e esconder painéis:

Tecla de Atalho | Comando
F9 | Mostrar/esconder o painel lateral.
Ctrl + F9 | Mostrar/esconder o painel inferior.

Pesquisa

Atalhos para pesquisa:

Tecla de Atalho | Comando
Ctrl + F | Localizar um texto.
Ctrl + G | Localizar a próxima instância do texto.
Ctrl + Shift + G | Localizar a instância anterior do texto.
Ctrl + K | Pesquisa interativa.
Ctrl + H | Pesquisar e substituir.
Ctrl + Shift + K | Limpar destaque.
Ctrl + I | Ir para a linha.

Ferramentas

Atalhos para ferramentas:

Tecla de Atalho | Comando
Shift + F7 | Verificar ortografia (com plug-in).
Alt + F12 | Remover espaços à direita (com plug-in).
Ctrl + T | Criar recuo (com plug-in).
Ctrl + Shift + T | Remover recuo (com plug-in).
F8 | Executa "make" no diretório atual (com plug-in).
Ctrl + Shift + D | Listar diretórios (com plug-in).

Ajuda

Atalhos para ajuda:

Tecla de Atalho | Comando
F1 | Abrir o manual do usuário do pluma.

## Preferências

To configure pluma, choose Edit Preferences . The Preferences dialog contains the following categories:

- pluma-prefs-view

- pluma-prefs-editor

- pluma-prefs-fontsandcolors

- pluma-prefs-plugins

### Preferências de Visualização

Text Wrapping

- Selecione a opção Habilitar quebra de texto para que linhas grandes de texto formem parágrafos, ao invés de se perderem além do limite da área de texto. Isso evita ter que rolar o texto horizontalmente.

  Selecione a opção Não dividir uma palavra em duas linhas para que a opção quebra de texto preserve palavras inteiras quando o texto fluir para a próxima linha. Isso torna o texto mais fácil de ler.

Line Numbers

- Selecione a opção Mostrar números de linha para exibir os números de linha no lado esquerdo da janela do pluma.

Current Line

- Selecione a opção Destacar linha atual para destacar a linha onde o cursor está posicionado.

Right Margin

- Selecione a opção Mostrar margem direita para exibir uma linha vertical que indica a margem direita.

  Use o seletor numérico Margem direita na coluna para especificar a localização da linha vertical.

Bracket Matching

- Selecione a opção Destacar parênteses correspondentes para destacar o parêntese correspondente quando o cursor está posicionado em um caractere de parêntese.

### Preferências do Editor

Tabs

- Use o seletor numérico Largura das tabulações para especificar a largura do espaço que o pluma insere quando você pressiona a tecla Tab.

  Selecione a opção Inserir espaços em vez de tabulações para especificar que o pluma insira espaços ao invés de caracteres de tabulações quando você pressionar a tecla Tab.

Auto Indentation

- Selecione a opção Habilitar recuo automático para especificar que a próxima linha inicie no mesmo nível de recuo da linha atual.

File Saving

- Selecione a opção Criar uma cópia de backup dos arquivos antes de salvar para criar uma cópia de segurança de um arquivo cada vez que salvar o arquivo. A cópia de segurança do arquivo contém um ~ no final do nome do arquivo.

  Selecione a opção Salvar arquivos automaticamente a cada ... minutos para salvar automaticamente o arquivo atual em intervalos regulares. Use o seletor numérico para especificar com que freqüência você deseja salvar o arquivo.

### Preferências de Fonte & Cores

Font

- Selecione a opção Usar fonte de largura fixa padrão para usar a fonte padrão do sistema para o texto na área de texto do pluma.

  O campo Fonte do editor exibe a fonte que o pluma usa para exibir texto. Clique no botão para especificar o tipo de fonte, estilo e tamanho a usar para o texto.

Color Scheme

- Você pode escolher um esquema de cor na lista de esquema de cores. Por padrão, os esquemas de cores instalados são:

  Classic

- Esquema de cor baseado no esquema de cor do gvim.

Cobalt

- Esquema de cor no azul.

Kate

- Esquema de cor usado no editor de texto Kate.

Oblivion

- Esquema de cor escuro usando a paleta de cor Tango.

Tango

- Esquema de cor usando o esquema de cor Tango.

Você pode adicionar um novo esquema de cor clicando em Adicionar..., e selecionando o arquivo de esquema de cor

Você pode remover o esquema de cor selecionado clicando em Remover

### Preferências de Plug-ins

Plug-ins adicionam recursos extras ao pluma. Para mais informações sobre plug-ins e como usar os plug-ins embutidos, veja a pluma-plugins-overview.

#### Habilitando um Plug-in

Para habilitar um plug-in do pluma, siga os seguintes passos:

1. Choose Edit Preferences .

2. Selecione a aba Plug-ins.

3. Selecione a caixa de seleção próxima ao nome do plug-in que você deseja habilitar.

4. Clique no botão Fechar para fechar a janela de Preferências.

#### Desativando um Plug-in

Um plug-in permanece habilitado quando você fechar o pluma.

Para desativar um plug-in do pluma, siga os seguintes passos:

1. Choose Edit Preferences .

2. Selecione a aba Plug-ins.

3. Selecione a caixa de seleção próxima ao nome do plug-in que você deseja desabilitar.

4. Clique no botão Fechar para fechar a janela de Preferências.

## Plug-ins

### Trabalhando com Plug-ins

Você pode adicionar recursos extras ao pluma ativando plug-ins. Um plug-in é um programa suplementar que aumenta a funcionalidade de uma aplicação. Plug-ins adicionam novos itens aos menus do pluma para os novos recursos que eles provêem.

Vários plug-ins vêm embutidos com o pluma, e você pode instalar mais. O site do pluma lista plug-ins de terceiros.

Para habilitar e desabilitar plug-ins, ou ver quais plug-ins estão habilitados no momento, use as Preferências de Plug-ins.

Os seguintes plug-ins vêm embutidos com o pluma:

- Alterar Maiusculização permite que você mude as letras maiúsculas e minúsculas do texto selecionado.

- Estatísticas do Documento mostra o número de linhas, palavras e caracteres no documento.

- Ferramentas Externas permite que você execute comandos externos a partir do pluma.

- Navegador de Arquivos permite que você navegue seus arquivos e pastas no painel lateral.

- Recuar Linhas adiciona ou remove recuo nas linhas selecionadas.

- Inserir Data/Hora adiciona a hora e data atual em um documento.

- Modelines permite que você defina preferências de edição para documentos individuais, e aceita as modelines do tipo Emacs, Kate e Vim.

- Console Python permite que você execute comandos na linguagem de programação python.

- Trechos permite que você armazene pedaços de texto freqüentemente usados e inseri-los rapidamente em um documento.

- Ordenar arruma linhas selecionadas de texto em ordem alfabética.

- Verificador Ortográfico corrige a ortografia no texto selecionado ou marca erros automaticamente no documento.

- Lista de Tags permite que você insira tags comumente usadas para HTML e outras linguagens, a partir de uma lista no painel lateral.

Para mais informações sobre a criação de plug-ins, veja o Site do pluma .

### Plug-in de Alterar Maiusculização

O plug-in Alterar Maiusculização muda as letras maiúsculas e minúsculas do texto selecionado.

Os seguintes itens são adicionados ao menu Editar quando o plug-in Alterar Maiusculização está habilitado:

Item de Menu | Ação | Exemplo
Edit Change Case All Upper Case | Altera cada caractere para maiúsculo. | `Este texto` torna-se `ESTE TEXTO`
Edit Change Case All Lower Case | Altera cada caractere para minúsculo. | `Este Texto` torna-se `este texto`
Edit Change Case Invert Case | Altera cada caractere de minúsculo para maiúsculo, e altera cada maiúsculo para minúsculo. | `Este Texto` torna-se `eSTE tEXTO`
Edit Change Case Title Case | Altera o primeiro caractere de cada palavra para maiúsculo. | `este texto` torna-se `Este Texto`

### Plug-in de Estatísticas do Documento

O plug-in de Estatísticas do Documento conta o número de linhas, palavras, caracteres com espaços, caracteres sem espaços e bytes no arquivo atual. O plug-in exibe os resultados numa janela de Estatísticas do Documento. Para usar o plug-in Estatísticas do Documento, siga os seguintes passos:

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - Número de linhas no documento atual.

   - Número de palavras no documento atual.

   - Número de caracteres, incluindo espaços, no documento atual.

   - Número de caracteres, não incluindo espaços, no documento atual.

   - Número de bytes no documento atual.

2. Você pode continuar a modificar o arquivo do pluma enquanto a janela de Estatísticas do Documento está aberta. Para atualizar o conteúdo da janela de Estatísticas do Documento, clique no botão Atualizar.

### Plug-in de Ferramentas Externas

O plug-in Ferramentas Externas permite que você execute comandos externos a partir do pluma. Você pode redirecionar um conteúdo dentro de um comando e utilizar sua saída (por exemplo, sed), ou lançar um comando predefinido (por exemplo, make).

Use o Gerenciador de Ferramentas Externas para criar e editar comandos. Para executar um comando externo, escolha-o a partir do menu Ferramentas.

#### Comandos Embutidos

Os seguintes comando estão disponíveis com o plug-in Ferramentas Externas:

Compilar

- Executa o comando make no diretório do documento atual.

Listagem de Diretórios

- Lista o conteúdo do diretório do documento atual em um novo documento.

Variáveis de Ambiente

- Exibe a lista de variáveis de ambiente no painel inferior.

Grep

- Pesquisa por um termo em todos os arquivos no diretório do documento atual, usando o padrão correspondente. Os resultados são mostrados no painel inferior.

Remover Espaços à Direita

- Remove todos os espaços do final das linhas no documento.

#### Definindo um Comando

Para adicionar um comando externo, escolha Ferramentas Ferramentas Externas.

Na janela do Gerenciador de Ferramentas Externas, clique no botão Novo. Você pode especificar os seguintes detalhes para o novo comando:

Descrição

- Esta descrição é mostrada na barra de status quando o comando é selecionado no menu.

Tecla de atalho

- Digite um atalho de teclado para o comando.

Comandos

- Os comandos atuais a serem executados. Várias variáveis de ambiente do pluma podem ser usadas para passar conteúdos para esses comandos: veja a pluma-external-tools-plugin-variables.

Entrada

- O conteúdo que pode ser dado aos comandos (como `stdin`): todo o texto do documento atual, a seleção atual, linha ou palavra.

Saída

- O que pode ser feito com a saída dos comandos: exibir no painel inferior, lançar em um novo documento, ou colocar no documento atual, no final, na posição do cursor ou substituindo a seleção ou o documento por completo.

Aplicabilidade

- Determina que tipo de documentos podem ser afetados pelo comando, por exemplo se está salvo ou não, e se é local ou remoto.

#### Editando e Removendo Ferramentas

Para editar uma ferramenta, selecione-a na lista e faça alterações nas suas propriedades.

Para renomear uma ferramenta, clique nela novamente na lista.

Para restaurar uma ferramenta embutida que você alterou, pressione Reverter.

Para remover uma ferramenta, selecione-a na lista e pressione no botão Remover. Você não pode remover ferramentas embutidas, só as que você mesmo criou.

#### Variáveis

Você pode usar as seguintes variáveis no campo Comandos da definição do comando:

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### Plug-in de Navegador de Arquivos

O Plug-in Navegador de Arquivos mostra seus arquivos e pastas no painel lateral, permitindo que você abra arquivos rapidamente.

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### Navegando nos seus Arquivos

A aba do Navegador de Arquivos inicialmente mostra seus marcadores do gerenciador de arquivos. Para navegar no conteúdo de qualquer item, dê um clique duplo nele.

Para mostrar uma pasta pai, escolha a partir da lista superior ou pressione a seta para cima na barra de ferramentas do Navegador de Arquivos.

Para mostrar a pasta que contém o documento no qual você está trabalhando, clique com o botão direito na lista de arquivo e escolha Definir raiz para documento ativo.

#### Abrindo um Arquivo

Para abrir um arquivo no pluma, dê um clique duplo neste na lista de arquivo.

#### Criando Arquivos e Pastas

Para criar um novo arquivo de texto vazio na pasta mostrada no navegador, aperte o botão direito na lista de arquivos e escolha Novo Arquivo.

Para criar uma nova pasta dentro da pasta mostrada no navegador, clique com o botão direito na lista de arquivos e escolha Nova Pasta.

### Plug-in de Recuar Linhas

O plug-in Recuar Linhas adiciona ou remove espaço do início das linhas do texto.

Para recuar ou desfazer recuo no texto, siga os seguintes passos:

1. Selecione as linhas que você deseja recuar. Para recuar ou desfazer o recuo em uma única linha, deixe o cursor em qualquer lugar da linha.

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

O tamanho do espaço usado, e se será usado caractere de tabulação ou caracteres de espaço, depende da configuração de Paradas de Tabulação nas Preferências de Editor: veja a pluma-prefs-editor.

### Plug-in de Inserir Data/Hora

O plug-in Inserir Data/Hora insere a data e hora atual em um documento. Para usar o plug-in de Inserir Data/Hora, siga os seguintes passos:

1. Choose Edit Insert Date and Time .

   Se você não configurou o plug-in de Inserir Data/Hora para inserir automaticamente a data/hora sem perguntar pelo formato, o pluma exibe a janela Inserir Data e Hora. Selecione o formato de data/hora apropriado na lista. Clique no botão Inserir para fechar a janela de Inserir Data e Hora. O pluma insere a data/hora na posição do cursor no arquivo atual.

   Se você configurou o pluma para usar um formato de data/hora particular, a janela Inserir Data e Hora não é exibida. A data/hora é inserida automaticamente na posição do cursor no arquivo atual.

#### Configurando o Plug-in de Inserir Data/Hora

Para configurar o plug-in Inserir Data/Hora, siga os seguintes passos:

1. Choose Edit Preferences .

2. Selecione a aba Plug-ins.

3. Selecione o plug-in Inserir Data/Hora.

4. Clique em Configurar Plug-in para exibir a janela Configurar o plug-in de inserção de data/hora.

5. Selecione uma das opções, como se segue:

   - Para especificar o formato de data/hora cada vez que você inserir a data/hora, selecione a opção Alertar para um formato.

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see

     strftime

     3. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

6. Clique no botão OK para fechar a janela Configurar o plug-in de inserção de data/hora.

7. Para fechar a janela de Preferências, clique no botão Fechar.

### Plug-in de Modelines

O plug-in Modelines permite que você configure preferências para documentos individuais. Uma modeline é uma linha de texto no início ou no fim do documento com configurações que o pluma reconhece.

Preferências definidas usando modelines têm prioridade sobre as especificadas na janela de preferências.

Você pode definir as seguintes preferências com modelines:

- Largura da tabulação

- Largura do recuo

- Inserir espaços ao invés de tabulações

- Quebra de Texto

- Largura da margem à direita

O plug-in Modelines aceita um subconjunto de opções usadas por outros editores de texto: Emacs, Kate e Vim.

#### Modelines de Emacs

As primeiras duas linhas de um documento são analisadas em busca de modelines do Emacs.

As opções do Emacs: tab-width, indent-offset, indent-tabs-mode e autowrap são aceitas. Para mais informações, veja o Manual do GNU Emacs.

#### Modelines de Kate

As primeiras e últimas dez linhas de um documento são analisadas em busca de modelines do Kate.

As opções do Kate: tab-width, indent-width, space-indent, word-wrap e word-wrap-column são aceitas. Para mais informações, veja o Site do Kate.

#### Modelines de Vim

As primeiras e últimas três linhas de um documento são analisadas em busca de modelines do Vim.

A opções do Vim: et, expandtab, ts, tabstop, sw, shiftwidth, wrap e textwidth são aceitas. Para mais informações, veja o Site do Vim.

### Plug-in de Console Python

O Plug-in Console Python permite que você execute comandos na linguagem de programação python a partir do pluma. Ativando o plug-in adiciona uma aba ao painel inferior. Este mostra a saída recente e um campo de prompt de comando.

Comandos digitados dentro do console python não são verificados antes que eles sejam executados. Conseqüentemente, é possível que travem o pluma, por exemplo entrando um loop infinito.

### Plug-in de Trechos

O plug-in Trechos permite que você armazene pedaços de texto usados freqüentemente, chamados trechos, e inseri-los rapidamente dentro de um documento.

Os trechos são específicos à sintaxe da linguagem do documento atual. Por exemplo, quando você está trabalhando com um documento HTML, você pode escolher de uma lista de trechos que são úteis para HTML. Além disso, alguns trechos são globais e estão disponíveis para todos os documentos.

Um número de trechos embutidos já vem instalado com o pluma, e pode ser modificado.

#### Inserindo Trechos

Para inserir um trecho dentro de um documento, digite seu disparador e pressione Tab. Um disparador de trecho é geralmente as primeiras letras do trecho, ou alguma outra coisa que seja pequena e fácil de lembrar.

Opcionalmente, pressione Ctrl Space para ver uma lista de trechos que você pode inserir.

#### Adicionando Trechos

Para criar um novo trecho, faça o seguinte:

1. Selecione Ferramentas Gerenciar Trechos. A janela Gerenciador de Trechos será aberta.

2. A lista de trechos é agrupada por linguagens. Selecione a linguagem para a qual você quer adicionar um trecho, ou um trecho nesse grupo. Para adicionar um trecho, escolha Global no topo da lista. A sintaxe do documento que você estiver trabalhando é mostrada por padrão.

3. Clique no botão Novo. Um novo trecho aparece na lista.

4. Digite as seguintes informações para o novo trecho:

   Nome

5. Insira um nome para o trecho no campo de texto dentro da lista de trechos. O nome de um trecho serve somente para lembrar para o que ele serve. Você pode mudar o nome de um trecho que você criou clicando nele na lista.

Texto do trecho

- Insira o texto do trecho na caixa de texto de Editar trecho. Para códigos especiais que você pode usar, veja a pluma-snippets-plugin-syntax.

  Você pode mudar para a janela do documento para copiar texto sem fechar a janela do Gerenciador de Trechos.

Disparador

- Insira o disparador para o trecho. Este é o texto que você digita antes de pressionar Tab para inserir o trecho.

  A identificação deve ser uma única palavra contendo somente letras, ou qualquer caractere. O Disparador destacará em vermelho se um disparador inválido é inserido.

Tecla de atalho

- Digite uma tecla de atalho a usar para inserir o trecho.

#### Editando e Removendo Trechos

Para editar um trecho, selecione-o na lista e faça as alterações ao texto e propriedades de ativação.

Para renomear um trecho, clique no trecho novamente na lista.

Para restaurar um trecho embutido que você alterou, pressione em Reverter.

Para remover um trecho, selecione-o na lista e pressione no botão Remover. Você não pode remover trechos embutidos, só aqueles que você criou.

#### Substituições de Trechos

Além de inserir textos armazenados, um trecho pode incluir textos personalizados, ou espaços marcados aos quais você pode adicionar texto, uma vez que o trecho é inserido em seu documento.

Você pode usar os seguintes códigos para marcadores de substituição em trechos de texto:

Marcadores de substituição

- `$`n`` define um marcador de substituição, onde `n` é qualquer número de 1 para cima.

  `${`n`:`padrão`}` define um marcador de substituição com um valor padrão.

  Um marcador de substituição marca um local no trecho onde você pode adicionar texto depois que o trecho é inserido.

  Para usar os marcadores de substituição, insira o trecho normalmente. O cursor irá até o primeiro marcador. Digite o texto e pressione Tab para ir para o próximo. O Número no código do marcador define a ordem na qual o cursor avança ao pressionar Tab.

  Pressione Shift Tab para retornar ao marcador de substituição anterior. Pressionar Tab quando não há mais marcadores de substituição move o cursor até o fim do trecho, ou até o marcador de fim, se existir.

Marcadores espelhos

- Um marcador de substituição repetido irá copiar o marcador já definido. Isso permite a você digitar só uma vez um texto que você quer que apareça várias vezes no trecho.

Marcador de fim

- `$0` define um marcador de fim. Isso permite a você terminar de trabalhar no trecho com o cursor em um lugar diferente do fim do trecho.

Variáveis de ambiente

- Variáveis de ambiente como `$PATH` e `$HOME` são substituídas no texto do trecho. As seguintes variáveis específicas do pluma podem ser usadas:

  $PLUMA_SELECTED_TEXT

- O texto selecionado no momento.

$PLUMA_FILENAME

- O nome completo de arquivo do documento, ou uma seqüência vazia se o documento ainda não estiver salvo.

$PLUMA_BASENAME

- O nome do arquivo sem a extensão, ou uma seqüência vazia se o documento ainda não estiver salvo.

$PLUMA_CURRENT_WORD

- A palavra que estiver na posição do cursor no documento. Quando essa variável é usada, a palavra atual será substituída pelo texto do trecho.

Marcadores de substituição do Shell

- `$(`cmd`)` é substituído pelo resultado da execução de `cmd` no shell.

  `$(`n`:`cmd`)` permite a você dar a esse marcador de substituição uma referência, onde `n` é qualquer número de 1 para cima. Use `$`n`` para usar a saída de um marcador de substituição de shell como entrada em outro.

Marcadores de substituição do Python

- `$<`cmd`>` é substituído pelo resultado da execução de `cmd` no interpretador python.

  `$<`a`:`cmd`>` especifica outro marcador de substituição do python como uma dependência, onde `a` fornece sua ordem no trecho. Isso permite a você usar funções do python definidos em outro trecho. Para especificar várias dependências, separe os números com vírgulas, assim: `$<`a`,`b`:`cmd`>`

  Para usar uma variável em todos os outros trechos de python, declare-a como `global`.

### Plug-in de Ordenar

O plug-in Ordenar arruma linhas selecionadas de texto em ordem alfabética.

You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose File Revert .

Para usar o plug-in Ordenar, siga os seguintes passos:

1. Selecione as linhas de texto que você quer ordenar.

2. Choose Edit Sort . The Sort dialog opens.

3. Selecione as opções que você deseja para ordenar:

   - Para arrumar o texto em ordem inversa, selecione Inverter ordem.

   - Para apagar linhas duplicadas, selecione a opção Remover duplicadas.

   - Para ignorar a distinção entre maiúsculas e minúsculas, selecione Ignorar maiúsculas/minúsculas.

   - Para que a ordenação ignore os caracteres no início das linhas, defina o primeiro caractere a ser usado para ordenação no seletor numérico Iniciar na coluna.

4. Para efetuar a operação de ordenação, clique no botão Ordenar.

### Plug-in de Verificador Ortográfico

O plug-in Verificador Ortográfico verifica a ortografia no texto selecionado. Você pode configurar o pluma para verificar a ortografia automaticamente ou você pode verificar manualmente no idioma especificado. A configuração do idioma e as propriedades da auto-verificação são aplicadas por documento. Para usar o plug-in de Verificador ortográfico, siga os seguintes passos:

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   Ortografias desconhecidas são exibidas em uma cor diferente e sublinhadas. Aperte o botão direito em uma ortografia desconhecida, então selecione Sugestões de Ortografia a partir do menu que aparece:

   - Para substituir a palavra desconhecida por outra na lista, selecione a palavra a substituir no menu Sugestões de Ortografia.

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   Se não houver erros de ortografia, uma janela de Informação exibe uma mensagem que o documento não contém palavras com grafia errada. Clique no botão OK para fechar a janela de Informação.

   Se houver erros de ortografia, a janela Verificação de Ortografia é exibida:

   - A Palavra com erro de ortografia é exibida no topo da janela.

   - Uma ortografia conhecida sugerida é exibida na caixa de texto Modificar para. Você pode substituir essa opção por outra selecionando uma palavra a partir da lista de Sugestões, ou você pode digitar o texto diretamente dentro da caixa de texto Modificar para.

   - Para verificar a ortografia do texto na caixa de texto Modificar para, clique em Verificar Palavra. Se é uma palavra conhecida, a lista de Sugestões é substituída pelo texto `(ortografia correta)`. Se a palavra não é conhecida, novas entradas aparecem na lista de Sugestões.

   - Para ignorar a ocorrência atual da palavra desconhecida, clique em Ignorar. Para ignorar todas as ocorrências da palavra, clique em Ignorar Todos. A palavra desconhecida é ignorada somente na seção atual do pluma.

   - Para alterar a ocorrência atual da palavra desconhecida no texto da caixa de texto Modificar para, clique no botão Modificar. Para modificar todas as ocorrências da palavra desconhecida no texto da caixa de texto Modificar para, clique em Modificar Todos.

   - Para adicionar a palavra desconhecida para o seu dicionário pessoal, clique no botão Adicionar palavra.

   - Para fechar a janela Verificar Ortografia, clique em Fechar.

### Plug-in de Lista de Tags

O plug-in Lista de Tags permite que você insira tags comuns de uma lista no painel lateral.

Para usar o plug-in de Lista de Tags, efetue as seguintes etapas:

1. Choose View Side Pane .

2. Por padrão, o painel lateral mostra uma aba contendo uma lista de documentos abertos. Clique na aba mostrando um ícone de + na parte inferior do painel lateral para mostrar a aba de lista de tags.

3. Selecione a categoria de tag apropriada a partir da lista. Por exemplo, HTML - Tags.

4. Role pela lista de tags para pesquisar pela tag requerida.

5. Para inserir uma tag na posição do cursor no arquivo atual, dê um clique duplo na tag na lista. Você pode também inserir uma tag da seguinte maneira:

   - Para inserir uma tag no arquivo atual e mudar o foco do painel lateral para a área de visualização, pressione Enter.

   - Para inserir uma tag no arquivo atual e manter o foco na janela do Plug-in de lista de tags, pressione Shift Enter.