Manual do Klipper

Manual do Klipper

Philip Rodrigues

developer: Carsten Pfeiffer
Tradução: Marcus Gama
Tradução: André Marcelo Alvarenga
revisão Plasma 5.25 (05/05/2022)

Klipper é um utilitário de recortar e colar para área de transferência do Plasma.


Capítulo 1. Introdução

Capítulo 1. Introdução

O Klipper é um utilitário de área de transferência do Plasma. Ele armazena um histórico da área de transferência, e permite ligar tipos de conteúdo da área de transferência a ações de aplicativos. Por favor, comunique qualquer problema ou pedido de recurso no Bugzilla do KDE.

Capítulo 2. Usando o Klipper

Capítulo 2. Usando o Klipper

Uso Básico

Você pode usar o Klipper na área de notificação como um widget do Plasma ou como um aplicativo normal. Ambos compartilham a mesma funcionalidade, mas possuem uma interface diferente e mostram o último item do histórico ao passar o ponteiro do mouse sobre o ícone do Klipper na área de notificação:

O ícone do Klipper

O widget do Klipper ficará oculto se a área de transferência estiver vazia.

Para mostrar o histórico da área de transferência, clique no ícone do Klipper na área de notificação.

Widget do Klipper

O widget do Klipper

Passe o ponteiro do mouse sobre um item para aparecerem quatro ícones, os quais lhe permitem efetuar uma ação, mostrar o código de barras, editar o conteúdo ou remover o item do histórico. Use o Spectacle para capturar os códigos de barras e depois salvá-los.

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. Para limpar o histórico da área de transferência, clique no ícone à direita do campo de pesquisa.

A ação Configurar área de transferência... no menu de contexto abre a caixa de diálogo de configuração.

Ações

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.

Você pode alterar o tempo de exibição do menu nas configurações, com a opção Mostrar menu popup de ações na página Geral. Você pode desativar separadamente a parte do caminho do arquivo usando a opção Incluir ações MIME na página Menu de ações.

Ações podem ser desabilitadas completamente pressionando Ctrl+Alt+X.

O conteúdo da área de transferência que corresponde a uma expressão regular também pode ser editado antes de executar uma ação sobre ele. Selecione Editar conteúdo... à direita do item da área de transferência, para que possa mudar o seu conteúdo na caixa de diálogo que aparece, antes de clicar no 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

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

Nota

O X Window System® usa dois buffers separados de área de transferência: o de seleção e o da á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 Colar no menu de contexto.

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

Para mudar o comportamento da área de transferência/seleção, selecione Configurar área de transferência... no menu de contexto, e na caixa de diálogo que aparecer, selecione a página Geral. Desmarcar Seleção e área de transferência 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 Seleção e área de transferência 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.

Capítulo 3. Configurando o Klipper

Capítulo 3. Configurando o Klipper

Opções gerais

Seleção e área de transferência

Quando um texto ou uma área da tela é selecionada com o mouse ou o teclado, essa é a seleção. Ela pode ser colada usando o botão do meio do mouse.

Se a seleção for copiada explicitamente usando uma ação Copiar ou Recortar, ela será salva na área de transferência. Ela poderá ser colada usando uma ação Colar.

Quando ativada, esta opção mantém a seleção e a área de transferência iguais, de modo que qualquer seleção esteja imediatamente disponível para colar por qualquer meio. Se estiver desativada, a seleção ainda poderá ser salva no histórico da área de transferência (sujeito às opções abaixo), mas só poderá ser colada usando o botão do meio do mouse.

Histórico da área de transferência

Alterna o histórico da área de transferência.

Número de entradas

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

Seleção de texto

Quando uma área da tela é selecionada com o mouse ou teclado, isso é chamado de seleção. Esta opção determina se as seleções de texto são salvas no histórico da área de transferência. É possível escolher entre Sempre salvar no histórico e Somente quando copiado explicitamente. A opção Sempre salvar no histórico não está disponível se a sincronização de seleção/área de transferência estiver desativada ‐ nesse caso, a seleção nunca é salva automaticamente no histórico da área de transferência. Consulte “Comportamento da Área de Transferência/Seleção”.

Seleção não textual

Esta opção determina se seleções que não sejam texto (como imagens) são salvas no histórico da área de transferência. É possível escolher entre Sempre salvar no histórico, Somente quando explicitamente copiado e Nunca salvar no histórico. A opção Sempre salvar no histórico não está disponível se a sincronização de seleção/área de transferência estiver desativada ‐ nesse caso, a seleção nunca é salva automaticamente no histórico da área de transferência. Consulte “Comportamento da Área de Transferência/Seleção”.

Menu de ações

Menu de ações

Mostra menu de contexto de ações

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

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.

Incluir ações MIME

Se selecionado, inclui aplicativos que possam aceitar o tipo MIME de um nome de arquivo ou URL selecionado no menu popup.

Configuração das ações

Configuração das ações

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 QRegularExpression do Qt™, que usa PCRE (Expressões Regulares Compatíveis com o Perl).

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

Nota

Você pode encontrar informações detalhadas sobre o uso de expressões regulares do QRegularExpression na documentação do Qt.

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, por exemplo 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.

As entradas %0 até %9 serão substituídas pelos textos correspondentes capturados do padrão de correspondência.

Opções de Atalhos

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 Plasma). É útil se você usar mais o mouse do que o teclado.

Capítulo 4. Créditos e licença

Capítulo 4. Créditos e licença

Klipper

Programa copyright 1998 Andrew Stanley-Jones

Direito de cópia do programa de 1998-2000 Carsten Pfeiffer

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

Tradução de Marcus Gama e André Marcelo Alvarenga

Esta documentação é licenciada sob os termos da Licença de Documentação Livre GNU.

Este programa é licenciado sob os termos da Licença Pública Geral GNU.