<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&klipper;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE" 
> <!-- change language only here -->
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do &klipper; </title>

<authorgroup>
<author
> <firstname
>Philip</firstname
> <surname
>Rodrigues</surname
> <affiliation
> <address
><email
>phil.rod@ntlworld.com</email
></address
> </affiliation
> </author>

<othercredit role="developer">
<firstname
>Carsten</firstname>
<surname
>Pfeiffer</surname>
<affiliation>
<address
><email
>pfeiffer@kde.org</email
></address>
</affiliation>
<contrib
>Programador</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<affiliation>
<address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Revisor</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@rnl.ist.utl.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit>

</authorgroup>

<copyright>
<year
>2000</year
><year
>2001</year
><year
>2002</year>
<holder
>Philip Rodrigues</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-01-11</date>
<releaseinfo
>2.92.00</releaseinfo>

<abstract>
<para
>O &klipper; é o utilitário de cópia e colagem da área de transferência do &kde;.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Klipper</keyword>
<keyword
>kdebase</keyword>
<keyword
>área de transferência</keyword>
</keywordset>
</bookinfo>
 
<chapter id="introduction">
<title
>Introdução</title>
<para
>O &klipper; é o utilitário da área de transferência do &kde;. Guarda o histórico desta área e permite-lhe ligar o conteúdo da área de transferência às acções das aplicações. Comunique por favor todos os problemas ou pedidos de funcionalidades para Carsten Pfeiffer <email
>pfeiffer@kde.org</email
>.</para>

</chapter>

<chapter id="using-klipper">
<title
>Usar o &klipper;</title>

<sect1 id="basic-usage">
<title
>Utilização Básica</title>

<para
>Para mostrar o histórico da área de transferência, carregue no ícone do &klipper; ou carregue em <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>V</keycap
> </keycombo
>. Os itens anteriores da área de transferência são mostrados no topo do menu que aparece. Se seleccionar um desses itens copiá-lo-á para a área de transferência, a partir do qual poderá ser colado em qualquer aplicação do &kde; ou do X, como de costume.</para>

</sect1>

<sect1 id="actions">
<title
>Acções</title>

<para
>O &klipper; pode efectuar acções no conteúdo da área de transferência, baseando-se na possível correspondência com uma dada expressão regular. Por exemplo, todos os itens da área de transferência que comecem por <quote
>http://</quote
> podem ser passados ao &Netscape; ou ao &konqueror; como &URL;s a abrir.</para>

<para
>Para usar esta funcionalidade, basta copiar um &URL; ou um nome de ficheiro para a área de transferência. Se existir uma expressão regular correspondente na lista do &klipper;, irá aparecer um menu a mostrar-lhe as opções que tem (por exemplo, o Abrir o &URL; no &konqueror;, o Abrir o &URL; no &Netscape;). Use o rato ou o teclado para seleccionar a opção que deseja, para que o &klipper; execute o programa que seleccionou e abrindo o endereço apontado pelo conteúdo da área de transferência.</para>

<para
>Se não quiser efectuar nenhuma acção no conteúdo da área de transferência seleccione <guimenuitem
>Não Fazer Nada</guimenuitem
> no menu para voltar ao que estava a fazer. Se deixar o menu, este irá desaparecer, deixando-o continuar o seu trabalho. Pode alterar o período em que o menu permanece aberto na janela de <guilabel
>Preferências</guilabel
> na acção <guilabel
>Tempo-limite para o menu de acções</guilabel
> da secção <guilabel
>Geral</guilabel
>.</para>
	  
<para
>As acções podem ser desactivadas por completo ao carregar no &klipper; e ao seleccionar as <guimenuitem
>Acções Activadas</guimenuitem
>, ou carregando em <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>V</keycap
></keycombo
> seguido de <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>X</keycap
></keycombo
>.</para>

<para
>O conteúdo da área de transferência que corresponder a uma dada expressão regular poderá também ser editado antes de efectuar uma acção sobre ele. Seleccione <guimenuitem
>Editar e processar de novo</guimenuitem
> no menu do &klipper;, alterando o conteúdo da área de transferência na janela que aparece, antes de carregar no botão <guibutton
>OK</guibutton
> para executar a acção apropriada.</para>

<para
>Ao carregar em <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>R</keycap
></keycombo
> fará aparecer o menu para repetir a última acção efectuada pelo &klipper;.</para>

</sect1>

<sect1 id="clipboard-modes">
<title
>Modos da Área de Transferência</title>

<sect2 id="clipboard-modes-general">
<title
>Geral</title>
<para
> O &klipper; pode ser usado para alterar o modo da área de transferência para todo o  &kde;. O primeiro modo será familiar aos utilizadores do &Microsoft; &Windows; e do &Mac;: O texto é introduzido na área de transferência usando a função des cortar/copiar (ou <keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> e <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
>, respectivamente), bem como a opção de colagem da aplicação (através, geralmente, da combinação <keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
>) para colocar o conteúdo desta área de transferência. </para>
<para
> O segundo modo será mais familiar para os utilizadores mais antigos do &UNIX;. O texto seleccionado é copiado para a área de transferência e ao carregar no botão <mousebutton
>do meio</mousebutton
> cola o conteúdo da área de transferência. </para>
</sect2>

<sect2 id="changing-clipboard-modes">
<title
>Mudar os Modos da Área de Transferência</title>
<para
> Para poder alterar os modos da área de transferência seleccione as <guimenuitem
>Preferências</guimenuitem
> no menu do &klipper;, e na janela que aparece seleccione a secção <guilabel
>Geral</guilabel
>. A opção <guilabel
>Sincronizar o conteúdo da área de transferência e da selecção</guilabel
> determina o modo da área de transferência. Se a opção estiver seleccionada, a área de transferência funciona no modo de &UNIX;, caso contrário funciona no modo de &Windows;/&Mac;. </para>
</sect2>

</sect1>

</chapter>

<chapter id="preferences">
<title
>Preferências do &klipper;</title>

<sect1 id="viewing-options">

<title
>Ver a Janela de Preferências</title>

<para
>Para ver ou alterar a configuração do &klipper;, abra o menu do &klipper; e seleccione as <guimenuitem
>Preferências</guimenuitem
>. A Janela de Preferências do &klipper; irá aparecer. O seu conteúdo é descrito em baixo.</para>

</sect1>

<sect1 id="general-tab">
<title
>Opções Gerais</title>

<variablelist
> <varlistentry
> <term
><guilabel
>O menu aparece na posição do cursor do rato</guilabel
></term
> <listitem
><para
>Faz com que o menu do &klipper; apareça na posição do cursor do rato, em vez de aparecer na sua localização por omissão no Painel do &kde;. Isto é útil se usa mais o rato que o teclado.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Gravar o conteúdo da área de transferência ao sair</guilabel
></term
> <listitem
><para
>Se esta opção estiver activada, a selecção de um item no histórico faz com que o &klipper; verifique se existem acções aplicáveis nesse item, mostrando as opções possíveis. Se esta opção estiver desligada, as acções não poderão ser executadas nos itens do histórico.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Repetir as acções num item seleccionado no histórico</guilabel
></term
> <listitem
><para
>Se isto estiver assinalado, a selecção de um item do histórico faz com que o &klipper; mostre o menu das acções desse item, se for apropriado.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Sincronizar o conteúdo da área de transferência e o da selecção</guilabel
></term
> <listitem
><para
>Altera o modo da área de transferência. Veja em <xref linkend="clipboard-modes"/>. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Evitar o esvaziamento da área de transferência</guilabel
></term
> <listitem
><para
>Se estiver seleccionado, a área de transferência nunca ficará vazia. O &klipper; irá inserir o item mais recente da área de transferência no histórico desta, em vez de permitir que este esteja vazio. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tempo-limite para o menu das acções</guilabel
></term
> <listitem
><para
>Altera o tempo que o menu das acções irá permanecer abero se não fizer nada com ele.</para
></listitem
> </varlistentry
> <varlistentry
><term
><guilabel
>Tamanho do histórico da área de transferência</guilabel
></term
> <listitem
><para
>Altera o número de itens que são armazenados no histórico da área de transferência.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="actions-tab">
<title
>Opções das Acções</title>

<variablelist
> <varlistentry
> <term
>Editar as Expressões/Acções</term
> <listitem
><para
>Na secção <guilabel
>Acções</guilabel
>, carregue na expressão regular ou na acção que deseja editar. Irá aparecer um campo de edição no qual poderá alterar o texto como desejar. Certifique-se que carrega em <keysym
>Enter</keysym
> quando terminar.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Adicionar Expressões/Acções</term
> <listitem
><para
>Carregue no botão <guibutton
>Adicionar uma Acção</guibutton
> para adicionar uma expressão regular com a qual o &klipper; deverá fazer a correspondência. O  &klipper; usa a <classname
>QRegExp</classname
> do &Qt;, a qual compreende a maioria das expressões regular que usaria no <application
>grep</application
> ou no <application
>egrep</application
>, por exemplo.</para
> <para
>Pode adicionar uma descrição para o tipo da expressão regular (&eg; <quote
>URL de HTTP</quote
>) carregando com o botão <mousebutton
>esquerdo</mousebutton
> na coluna <guilabel
>Descrição</guilabel
>.</para
> <note
><para
>Poderá encontrar informações mais detalhadas sobre a utilização das expressões regulares do <classname
>QRegExp</classname
> em <ulink url="http://doc.trolltech.com/qregexp.html#details"
>http://doc.trolltech.com/qregexp.html#details</ulink
>. Lembre-se que o &klipper; não suporta o modo de caracteres especiais indicados nesta página.</para
></note
> <para
>Edite a expressão regular tal como é descrito acima. Para adicionar um comando a executar, carregue com o botão <mousebutton
>direito</mousebutton
>, seleccione o <guimenuitem
>Adicionar um Comando</guimenuitem
> e edite o comando que aparece na árvore por baixo da expressão regular.</para
> <para
>Repare que o <token
>%s</token
> na linha de comandos é substituído pelo conteúdo da área de transferência, &eg; se a sua definição do comando for <userinput
><command
>kedit</command
> <token
>%s</token
></userinput
> e o conteúdo da sua área de transferência for <filename
>/home/ze/ficheirotexto</filename
>, o comando <userinput
><command
>kedit</command
> <filename
>/home/ze/ficheirotexto</filename
></userinput
> será executado. Para incluir o <token
>%s</token
> na linha de comandos, assinale-o com uma barra invertida, como no exemplo: <userinput
>\%s</userinput
>.</para
></listitem
> </varlistentry
> <varlistentry
><term
><guibutton
>Avançado...</guibutton
></term
> <listitem
><para
>Abre a janela do <guilabel
>Desactivar as Acções para as Janelas do tipo WM_CLASS</guilabel
></para
> <para
>Alguns programas, como o &konqueror;, usam a área de transferência internamente. Se não quiser que o &klipper; notifique a toda a hora ao usar uma dada aplicação, faça o seguinte:</para
> <orderedlist
> <listitem
><para
>Abra a aplicação</para
></listitem
> <listitem
><para
>A partir de um terminal, execute <userinput
><command
>xprop</command
> | <command
>grep</command
> <parameter
>WM_CLASS</parameter
></userinput
> e carregue depois na janela da aplicação que está a correr</para
></listitem
> <listitem
><para
>O primeiro texto a seguir ao '=' é o valor a indicar</para
></listitem
> </orderedlist
> <para
>Logo que seja adicionada a WM_CLASS, já não serão geradas mais acções para as janelas dessa aplicação.</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="shortcuts-tab">
<title
>Opções dos Atalhos</title>

<para
>A secção de atalhos permite-lhe alterar os atalhos de teclado que são usados para aceder às funções do &klipper;. Pode alterar o atalho para uma de três coisas:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Sem Tecla</guilabel
></term
> <listitem
><para
>A acção seleccionada não poderá ser acedida directamente a partir do teclado</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tecla por Omissão</guilabel
></term
> <listitem
><para
>A acção seleccionada usa a tecla por omissão do &klipper;. Estes são os atalhos referidos neste manual.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tecla Personalizada</guilabel
></term
> <listitem
><para
>A acção seleccionada é atribuída às teclas que escolher.</para
> <para
>Para escolher uma tecla personalizada para a acção que seleccionou, carregue na representação de uma tecla na parte inferior direita do ecrã para a activar, e indique a combinação de teclas desejada no seu teclado, como em qualquer aplicação do &kde;. </para
> </listitem
> </varlistentry
> </variablelist>

</sect1>
</chapter>

<chapter id="credits">
<title
>Créditos e Licença</title>

<para
> &klipper; </para>
<para
> Programa copyright 1998 Andrew Stanley-Jones <email
>asj@cban.com</email
> </para>
<para
> Programa copyright 1998-2000 Carsten Pfeiffer <email
>pfeiffer@kde.org</email
></para>
<para
> Mantido actualmente por Carsten Pfeiffer </para>

<para
> Documentação copyright 2000-2002 Philip Rodrigues <email
>phil.rod@ntlworld.com</email
> </para>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-klipper">
<title
>Como obter o &klipper;</title>

&install.intro.documentation;

</sect1>


<sect1 id="compilation">
<title
>Compilação e Instalação</title>
<para
>O &klipper; deverá compilar e instalar-se em conjunto com o pacote 'kdebase', e deverá aparecer no seu painel do &kde; (o &kicker;) quando correr o KDE 3.</para
> 

<screenshot
> <screeninfo
>ícone do &klipper;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Imagem</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Para desactivar isto, basta remover o ficheiro <filename
>$KDEDIR/share/autostart/klipper.desktop</filename
> ou criar um ficheiro <filename
>$HOME/share/autostart/klipper.desktop</filename
> com o seguinte conteúdo: <programlisting>
[Desktop Entry]
Hidden=true
</programlisting
> A última irá manter a instalação do sistema intacta e só irá evitar que o &klipper; seja iniciado para si, sem afectar os outros utilizadores. </para>

</sect1>
</appendix>

&documentation.index; 

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step: 0
End:
-->










