# Manual do &klipper;

## Introdução

O &klipper; é um utilitário de área de transferência do &kde;. Ele armazena um histórico da área de transferência, e permite ligar tipos de conteúdo da área de transferência à ações de aplicativos. Por favor, reporte qualquer problema ou pedido de recurso para o Bugzilla do KDE ou use o item Relatar erro do menu Ajuda.

## Usando o &klipper;

### Uso Básico

O ícone do &klipper;. O ícone do &klipper;

Para mostrar o histórico da área de transferência, clique no ícone do &klipper; ou pressione &Ctrl;&Alt;V . Os itens anteriores da área de transferência são mostrados no topo do menu de contexto. Selecionar um desses itens irá copiá-lo para a área de transferência, a partir do qual poderá ser colado em qualquer aplicativo do &kde; ou do X, como de costume.

O atalho para esta ação precisa ser configurado na Configuração da área de notificação do sistema, na página Itens.

Você pode procurar pelo histórico da área de transferência abrindo-o (clique no &klipper;) e digitando a sua pesquisa. Os resultados são atualizados à medida que você digita. No caso de desejar saber como usar as teclas aceleradoras no menu do &klipper;, basta pressionar &Alt; e na tecla que deseja. Por exemplo, para limpar o histórico da área de transferência quando for aberto o menu do &klipper;, pressione &Alt; e a letra sublinhada da opção Limpar histórico da área de transferência .

Selecione Mostrar o código de barras do menu de contexto do &klipper; para abrir uma caixa de diálogo com um código de barras QRCode e DataMatrix. Use o &ksnapshot; para capturar os códigos de barras e salvá-los.

Para desabilitar o &klipper;, clique no seu ícone e selecione no menu que aparece a opção Sair.

### Ações

O &klipper; pode executar ações sobre os conteúdos da área de transferência baseado na correspondência do mesmo com uma determinada expressão regular. Por exemplo, qualquer conteúdo da área de transferência iniciando com http:// pode ser passado para o Firefox ou o &konqueror; como uma &URL; a ser aberta. Adicionalmente, se o conteúdo corresponder a um caminho, ações similares podem ser realizadas de acordo com o tipo de arquivo. Por exemplo, se o caminho para um arquivo PDF for copiado para a área de transferência, o arquivo pode ser visualizado no &okular;.

Para usar este recurso, basta selecionar um &URL; ou caminho. Se existir uma correspondência com alguma expressão regular da lista do &klipper;, um menu aparecerá mostrando os programas disponíveis para sua seleção. Use o mouse ou teclado para selecionar um programa, e o &klipper; executará este programa, abrindo o endereço apontado pelo conteúdo da área de transferência.

Se você não deseja executar nenhuma das ações sobre o conteúdo da área de transferência, selecione Desativar este menu no menu para retornar ao que estava fazendo antes. Se você deixar o menu, ele desaparecerá, permitindo que você continue seu trabalho. Você pode mudar o tempo em que este menu fica aberto na janela Configurar Klipper..., com a opção Tempo máximo para ações de contexto na página Geral. Você pode desativar separadamente a parte do caminho do arquivo usando a opção Ativar ações baseadas no MIME na página de Ações.

Ações podem ser desabilitadas completamente clicando no &klipper; e desmarcando Ativar ações da área de transferência, ou pressionando &Ctrl;&Alt;X.

O conteúdo da área de transferência que corresponde a uma expressão regular pode também ser editado antes de executar uma ação sobre ele. Selecione Editar conteúdo... no menu do &klipper;, e você pode mudar o conteúdo da área de transferência que aparece, antes de clicar o botão OK para executar a ação correspondente.

Pressionar &Ctrl;&Alt;R mostra o menu para repetir a última ação que o &klipper; executou.

### Comportamento da Área de Transferência/Seleção

#### Geral

O &klipper; pode ser usado para configurar o comportamento da área de transferência e seleção no &kde;.

O &X-Window; usa dois buffers separados de área de transferência: o seleção e o área de transferência. O texto é colocado no buffer de seleção simplesmente selecionando-o, e pode ser colado com o botão do meio do mouse. O texto deve ser explicitamente colocado no buffer da área de transferência selecionando-o e pressionado &Ctrl;X ou &Ctrl;C . O texto do buffer da área de transferência é colado usando o &Ctrl;V ou selecionando Editar Colar .

#### Mudando o Comportamento da Área de Transferência/Seleção

Para mudar o comportamento da área de transferência/seleção, selecione Configurar &klipper;... no menu do &klipper;, e na caixa de diálogo que aparecer, selecione a página Geral. Desmarcar Sincronizar o conteúdo da área de transferência com a seleção faz com que as funções de área de transferência e seleção ocupem buffers distintos conforme descrito anteriormente. Com esta opção configurada, a opção Ignorar seleção evitará que o &klipper; inclua conteúdo da seleção no seu histórico da área de transferência e que ele execute ações sobre o conteúdo da seleção. Selecionar Sincronizar conteúdo da área de transferência com a seleção fará com que os buffers da área de transferência e seleção sejam sempre o mesmo, fazendo com que o texto na seleção possa ser colado tanto com o botão do meio do mouse ou a combinação de teclas &Ctrl;V , e da mesma maneira que o texto no buffer da área de transferência.

## Configurando o &klipper;

### Vendo o Diálogo de Configuração

Para ver ou mudar as configurações do &klipper;, abra o menu do &klipper; e selecione Configurar Klipper.... O diálogo de configuração do &klipper; aparecerá. Seu conteúdo será descrito abaixo.

### Opções gerais

Salvar o conteúdo da área de transferência ao sair

- Se esta opção estiver habilitada, o histórico da área de transferência será salva quando o &klipper; terminar, permitindo que você o use na próxima vez que iniciar o &klipper;.

Impedir que a área de transferência fique vazia

- Se selecionado, a área de transferência nunca ficará vazia: o &klipper; inserirá o item mais recente do histórico da área de transferência na área ao invés de permitir que ela fica vazia.

Ignorar imagens

- Quando uma área da tela é selecionada com o mouse ou o teclado, ela é chamada de seleção. Se esta opção estiver selecionada, somente será armazenada no histórico as seleções de texto, enquanto as imagens e as outras seleções não são.

Ignorar seleção

- Define o modo da área de transferência. Esta opção evitará que o &klipper; inclua o conteúdo da seleção em seu histórico e realize ações no conteúdo da seleção. Veja clipboard-modes.

Somente a seleção de texto

- Quando uma área da tela é selecionada com o mouse ou teclado, ela é chamada de seleção. Se esta opção estiver ativa, somente seleções de texto são armazenadas no histórico, enquanto imagens e outras seleções não. Veja clipboard-modes.

Sincronizar o conteúdo da área de transferência com a seleção

- Define o modo da área de transferência. Quando uma área da tela é selecionada com o mouse ou teclado, ela é chamada de seleção. Se esta opção estiver selecionada, a seleção e a área de transferência se manterão a mesma, assim qualquer coisa na seleção fica imediatamente disponível para colagem em qualquer local usando qualquer método, incluindo o tradicional botão do meio do mouse. Caso contrário, a seleção é guardada no histórico da área de transferência, mas a seleção somente pode ser colada usando o método do botão do meio do mouse. Veja também a opção Ignorar seleção. Veja clipboard-modes.

Tempo máximo para ações de contexto

- Configura o tempo que o menu das ações irá permanecer aberto, se você não selecionar nenhuma ação dele.

Tamanho do histórico da área de transferência

- Configura o número de itens que serão armazenados no histórico da área de transferência.

### Opções de Ações

Repetir ações sobre um item selecionado do histórico

- Se esta opção estiver habilitada, selecionar um item do histórico fará com que o &klipper; exiba o menu de ações sobre este item, se necessário.

Remover espaços em branco ao executar as ações

- Se estiver selecionada, todos os caracteres em branco (espaços, tabulações, &etc;) no início e no fim do conteúdo da área de transferência serão removidos antes de passar o conteúdo da área de transferência para o aplicativo. Isto é útil, por exemplo, se a área de transferência contiver um &URL; com espaços que, ao ser aberto por um navegador Web, poderia causar um erro.

Habilitar ações baseadas no MIME

- Se selecionado, além das ações que você definiu, irá aparecer no menu de contexto uma lista de aplicativos para o tipo MIME detectado.

Editando Expressões/Ações

- Na página de Ações, dê um duplo-clique numa expressão regular ou ação que deseja editar ou selecione-a e pressione o botão Editar ação. Um diálogo aparecerá no qual o texto da expressão pode ser editado conforme você desejar.

Adicionando Expressões/Ações

- Clique no botão Adicionar Ação para adicionar uma expressão regular para o &klipper; pesquisar. O &klipper; usa o `QRegExp` do &Qt;, que aceita a maioria das expressões que você poderia usar no grep ou egrep por exemplo.

  Você pode adicionar uma descrição para o tipo da expressão regular (⪚ HTTP URL) através de um clique esquerdo na coluna Descrição.

  Você pode encontrar informações detalhadas sobre o uso de expressões regulares do `QRegExp` em http://qt-project.org/doc/qt-4.8/qregexp.html#details. Observe que o &klipper; não tem suporte a caracteres curingas diferentes dos mencionados nesta página.

  Edita a expressão regular como descrito acima. Para adicionar o comando a ser executado, clique em Adicionar Comando e edite o comando na caixa de texto. Um duplo-clique no comando permitirá que você o edite.

  Observe que o %s na linha de comando é substituído pelo conteúdo da área de transferência, ⪚ se sua definição de comando é ``kwrite` %s` e o conteúdo da área de transferência é `/home/marcus/arquivotexto`, o comando ``kwrite` `/home/marcus/arquivotexto`` será executado. Para incluir o %s na linha de comando, escape-o com uma barra invertida, como a seguir: `\%s`.

Avançado

- Levanta o diálogo Desabilitar Ações para Janelas do Tipo WM_CLASS.

  Alguns programas, como o &konqueror;, usam a área de transferência internamente. Se você obter um menu do &klipper; indesejado sempre que você usa um determinado aplicativo, faça o seguinte:

  1. Abra o aplicativo.

  2. A partir de um terminal, execute ``xprop` | `grep` `WM_CLASS`` e então clique na janela do aplicativo que você esta executando.

  3. O primeiro string após o sinal de igual é o que deve ser inserido.

  Uma vez que a WM_CLASS é adicionado, nenhuma ação mais será gerada para janelas deste aplicativo.

### Opções de Atalhos

A página de atalhos permite mudar os atalhos de teclado que serão usado para acessar as funções do &klipper;. Você pode mudar o atalho para uma de três coisas:

Nenhum

- A ação selecionada não será acessada diretamente do teclado

Padrão

- A ação selecionada usa a tecla padrão do &klipper;. Estas teclas estão relacionadas neste manual.

Personalizado

- A ação selecionada será associada às teclas que você escolher.

  Para escolher uma tecla personalizada para ação que você selecionou, clique em Personalizado e então Nenhum. Agora digite a combinação desejada de teclas em seu teclado, como em qualquer aplicativo do &kde;.

Se definir um atalho para Abrir o Klipper na posição do mouse, ao pressionar este atalho irá abrir o menu de contexto do &klipper; na posição do ponteiro do mouse, em vez da sua posição padrão (no Painel do &kde;). É útil se você usar mais o mouse do que o teclado.

## Créditos e licença

&klipper;

Programa copyright 1998 &Andrew.Stanley-Jones; asj@cban.com

Direito de cópia do programa de 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;

Mantido atualmente por Esben Mose Hansen. Veja em http://mosehansen.dk/about os detalhes de contato.

Direito de cópia de documentação de 2000-2003, 2005 &Philip.Rodrigues; &Philip.Rodrigues.mail;

Tradução de Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &klipper;

&install.intro.documentation;

### Compilação e instalação

&install.compile.documentation;
&documentation.index;