<chapter id="kate-part">
<chapterinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Trabalhar com o editor &kate;</title>

<sect1 id="kate-part-overview">

<title
>Introdução</title>

<para
>O editor do &kate; é a área de edição da janela do &kate;. Este editor é também usado pelo &kwrite; e pode ser usado no &konqueror; para mostrar os ficheiros de texto do teu computador local ou da rede.</para>

<para
>O editor é composto pelas seguintes partes:</para>

<variablelist>

<varlistentry>
<term
>A área de edição</term>
<listitem
><para
>Aqui é onde se localiza o texto do teu documento.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>As barras de posicionamento</term>
<listitem>
<para
>As barras de posicionamento indicam a posição da parte visível do texto do documento, e podem ser usadas para o percorrer. Se arrastares as barras de posicionamento não mudarás de posição o cursor de inserção.</para>
<para
>As barras de posicionamento podem estar visíveis ou não, dependendo da vontade.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>O Contorno do Ícone</term>
<listitem>
<para
>O contorno do ícone é uma pequena área à esquerda do editor, a qual mostra um pequeno ícone junto às linhas marcadas.</para>
<para
>Podes colocar ou retirar um <link linkend="kate-part-bookmarks"
>favorito</link
> numa linha visível carregando com o botão esquerdo rato ao lado dessa linha.</para>
<para
>Esta área pode ser ligada ou desligada usando a opção do menu <menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Mostrar o Contorno do Ícone</guimenuitem
></menuchoice
>.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
>A Área de Números de Linha</term>
<listitem>
<para
>Esta área mostra os números de linha de todas as linhas visíveis do documento.</para
> 
<para
>A área pode ser ligada ou desligada através da opção do menu <menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Mostrar Números de Linha</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>

</variablelist>

<itemizedlist>
<title
>Também neste Capítulo:</title>
<listitem
><para
><link linkend="kate-part-navigation"
>Navegar no Texto</link
> </para
></listitem>
<listitem
><para
><link linkend="kate-part-selection"
>Trabalhar com a Selecção</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-copy-and-paste"
>Copiar e Colar Texto</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-find-replace"
>Procurar e Substituir Texto</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-bookmarks"
>Usar os Favoritos</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-auto-wrap"
>Mudar o Texto de Linha Automaticamente</link
></para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="kate-part-navigation">
<title
>Navegar no Texto</title>

<para
>Esta secção ainda não está documentada.</para>

</sect1>

<sect1 id="kate-part-selection">
<title
>Trabalhar com a Selecção</title>

<para
>Existem duas formas básicas de seleccionar texto no &kate;: com o rato e com o teclado.</para>

<para
>Para seleccionares com o rato, mantém pressionado o botão esquerdo do rato enquanto arrastas o cursor do rato de onde a selecção deve começar até ao sítio final desejado. O texto vai ficando seleccionado à medida que arrastas.</para>

<para
>Um duplo-click numa palavra seleccioná-la-á.</para>

<para
>Um triplo-click numa linha seleccioná-la-á por completo.</para>

<para
>Se o &Shift; é mantido pressionado ao carregar, o texto ficará seleccionado:</para>

<itemizedlist>
<listitem
><para
>Se não estiver nada seleccionado previamente, da posição do cursor de texto até à posição do cursor do rato.</para
></listitem>
<listitem
><para
>Se estiver algo seleccionado, desde essa selecção até à posição do cursor do rato</para
></listitem>
</itemizedlist>

<note>
<para
>Ao seleccionares texto arrastando para tal o rato, o texto seleccionado é copiado para a área de transferência, e pode ser colado carregando para isso no botão do meio do rato no editor ou em qualquer outra aplicação onde queiras colar o texto. </para>
</note>

<para
>Para seleccionares com o teclado, mantém a tecla &Shift; carregada enquanto utilizas as teclas de navegação (as teclas dos cursores, <keycap
>Page Up</keycap
>, <keycap
>Page Down</keycap
>, <keycap
>Home</keycap
> e <keycap
>End</keycap
>, possivelmente em combinação com o &Ctrl; para extender o movimento do cursor de texto).</para>

<para
>Vê também a secção <link linkend="kate-part-navigation"
>Navegar no Texto</link
> deste capítulo.</para>

<para
>Para <action
>copiares</action
> a selecção actual, utiliza a opção do menu <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Copiar</guimenuitem
></menuchoice
> ou a combinação de teclas respectiva (por omissão é <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>).</para>

<para
>Para <action
>deseleccionares</action
> a selecção actual, utiliza a opção do menu <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Deseleccionar</guimenuitem
></menuchoice
> ou o atalho de teclado correspondente (por omissão é o <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>A</keycap
></keycombo
>), ou carrega com o botão esquerdo do rato no editor.</para>

<sect2 id="kate-part-selection-block">
<title
>Usar a Selecção do Bloco</title>

<para
>When Block Selection is enabled, you can make <quote
>vertical selections</quote
> in the text, meaning selecting limited columns from multiple lines. This is handy for working with tab separated lines for example.</para>

<para
>A Selecção do Bloco pode ser ligada ou desligada através da opção <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Comutar a Selecção do Bloco</guimenuitem
></menuchoice
>. O atalho de teclado por omissão é o <keycap
>F4</keycap
></para>

</sect2>

<sect2 id="kate-part-seleciton-overwrite">

<title
>Usar a Substituição da Selecção</title>

<para
>Se a opção Substituir a Selecção estiver activa, se escreveres ou colares texto  na selecção farás com que o texto seleccionado seja substituído. Se não estiver activo o novo texto será adicionado à posição do cursor de texto.</para>

<para
>A Substituição da Selecção está activa por omissão.</para>

<para
>Para alterares a configuração desta opção, vê a <link linkend="config-dialog-editor-select"
>Página Seleccionar</link
> da <link linkend="config-dialog"
>Janela de Configuração</link
>.</para>

</sect2>

<sect2 id="kate-part-selection-persistent">

<title
>Usar a Selecção Persistente</title>

<para
>Quando a selecção persistente está activa, à medida que vais escrevendo caracteres ou moves o cursor, não desfazes a selecção existente. Isto significa que podes mover o cursor para longe da selecção e continuar a escrever texto.</para>

<para
>A selecção persistente está desligada por omissão.</para>

<para
>A Selecção Persistente pode ser activada na <link linkend="config-dialog-editor-select"
>Página Seleccionar</link
> da <link linkend="config-dialog"
>Janela de Configuração</link
>.</para>

<warning>
<para
>Se ambas as opções estiverem activas, a introdução ou colagem de texto quando o cursor do texto está dentro da selecção fará com que este seja substituída e deseleccionada.</para>
</warning>

</sect2>

</sect1>

<sect1 id="kate-part-copy-and-paste">

<title
>Copiar e Colar Texto</title>

<para
>Para copiares texto, selecciona-o e usa a opção do menu <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Copiar</guimenuitem
></menuchoice
>. Adicionalmente, a selecção de texto com o rato fará com que o texto seleccionado seja copiado para a área de transferência.</para>

<para
>Para colares o texto actualmente na área de transferência, usa a opção do menu <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Colar</guimenuitem
></menuchoice
>.</para>

<para
>Adicionalmente, o texto seleccionado com o rato pode ser colado carregando no botão <mousebutton
>do meio</mousebutton
> do rato na posição desejada.</para>

<tip>
<para
>Se estás a usar o ambiente do &kde;, podes obter o texto copiado anteriormente de qualquer aplicação com o ícone &klipper; na bandeja do &kicker;.</para>
</tip>

</sect1>

<sect1 id="kate-part-find-replace">
<title
>Procurar e Substituir Texto</title>

<sect2 id="find-replace-dialog">
<title
>As Janelas <guilabel
>Procurar Texto</guilabel
> e <guilabel
>Substituir Texto</guilabel
></title>


<para
>As janelas de Procurar e Substituir Texto no &kate; são muito parecidas, excepto que a de Substituir Texto possibilita a introdução de um texto de substituição, em conjunto com algumas opções adicionais.</para>

<para
>As janelas oferecem as seguintes opções comuns:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Texto a Procurar</guilabel
></term>
<listitem
><para
>Aqui é onde se indica o texto a procurar. A interpretação do texto depende de algumas das opções descritas em baixo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Expressão Regular</guilabel
></term>
<listitem>
<para
>Se estiver assinalada, o texto a procurar é interpretado como uma expressão regular. Estará activo um botão para criar ou editar a expressão.</para
> 
<para
>Veja as <link linkend="regular-expressions"
>Expressões Regulares</link
> para mais informações sobre elas.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Não Distinguir Capitalização</guilabel
></term>
<listitem>
<para
>Se estiver activo, a pesquisa não fará distinção entre maiúsculas e minúsculas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Apenas Palavras Inteiras</guilabel
></term>
<listitem>
<para
>Se estiver seleccionado, a pesquisa só fará a correspondência se existir um limite de palavra em ambos os extremos da ocorrência, ou seja, um carácter não alfanumérico, outro carácter visível qualquer ou um fim de linha.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Do Início</guilabel
></term>
<listitem>
<para
>Se estiver seleccionada, a pesquisa irá começar a partir da primeira linha do documento, caso contrário tomará início na posição do cursor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Procurar para Trás</guilabel
></term>
<listitem>
<para
>Se estiver seleccionada, a pesquisa irá procurar a primeira correspondência para cima do ponto inicial, seja este a posição actual do cursor ou do início do documento, se a opção <guilabel
>Do Início</guilabel
> estiver activa.</para>
</listitem>
</varlistentry>

</variablelist>

<para
>A janela <guilabel
>Substituir Texto</guilabel
> oferece algumas opções adicionais:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Substituir Por</guilabel
></term>
<listitem
><para
>Aqui é onde introduzes o texto de substituição.</para
></listitem
> 
</varlistentry>

<varlistentry>
<term
><guilabel
>Texto Seleccionado</guilabel
></term>
<listitem>
<para
>Esta opção estás desactivada se não estiver nenhum texto seleccionado ou se a opção <guilabel
>Perguntar ao Substituir</guilabel
> estiver activa. Se estiver, todas as correspondências do texto de pesquisa dentro do texto seleccionado serão substituídas pelo texto de substituição.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Perguntar ao Substituir</guilabel
></term>
<listitem
><para
>Se estiver seleccionada, aparecerá uma pequena janela a perguntar-te o que fazer de cada vez que é encontrada uma ocorrência. Oferece as seguintes opções: <variablelist>

<varlistentry>
<term
><guibutton
>Sim</guibutton
></term>
<listitem
><para
>Activa isto para substituíres a ocorrência actual (a que está seleccionada no editor).</para
></listitem
> 
</varlistentry>

<varlistentry>
<term
><guibutton
>Não</guibutton
></term>
<listitem
><para
>Active para ignorar a ocorrência actual e tentar encontrar outra.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Tudo</guibutton
></term>
<listitem
><para
>Activa para cancelares a pergunta e substituíres todas as ocorrências.</para
></listitem
> 
</varlistentry>

<varlistentry>
<term
><guibutton
>Fechar</guibutton
></term>
<listitem
><para
>Activa isto para ignorares a ocorrência actual e terminares a pesquisa.</para
></listitem
> 
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

</variablelist>

<note>
<para
>Não existe de momento nenhuma forma de fazer a correspondência mínima ao procurar por uma expressão regular. Isto será adicionado numa próxima versão do &kate;</para
> 
</note>

</sect2>

<sect2 id="finding-text">
<title
>Procurar Texto</title>

<para
>Para procurares texto, lança a janela <guilabel
>Procurar Texto</guilabel
> com o  <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
> ou na opção do menu <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Procurar...</guimenuitem
></menuchoice
>, indica o texto a procurar, selecciona as <link linkend="find-replace-dialog"
>opções</link
> desejadas e carrega em <guibutton
>Ok</guibutton
>. Se não forem encontradas ocorrências entre o ponto inicial da pesquisa (a posição actual do cursor ou o início do documento), ser-te-á pedida permissão para continuar do início (ou do fim, se estás a procurar para trás) do documento.</para>

<para
>Se for encontrada uma ocorrência esta é seleccionada e a janela <guilabel
>Procurar Texto</guilabel
> é escondida, mas é muito fácil continuar à mesma a procurar mais ocorrências:</para>

<para
>Para procurares a próxima ocorrência na direcção da procura, usa a opção <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Procurar Seguinte</guimenuitem
></menuchoice
> ou carrega em <keycap
>F3</keycap
>.</para>

<para
>Para procurares a próxima ocorrência na direcção oposta, usa a opção <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Procurar Anterior</guimenuitem
></menuchoice
> ou carrega em <keycombo action="simul"
>&Shift;<keycap
>F3</keycap
></keycombo
>.</para>

<para
>Se não for encontrada nenhuma ocorrência antes de atingir o extremo do documento, ser-te-á perguntado se queres dar a volta.</para>

</sect2>

<sect2>
<title
>Substituir Texto</title>

<para
>Para substituíres texto, lança a janela <guilabel
>Substituir Texto</guilabel
> com a opção do menu <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Substituir</guimenuitem
></menuchoice
> ou com o atalho <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
>, indica o texto a procurar e, opcionalmente, o texto de substituição (se este estiver em branco, cada ocorrência será substituída por &quot;&quot;), define as <link linkend="find-replace-dialog"
>opções</link
> desejadas e carrega no botão <guibutton
>Ok</guibutton
>.</para>

<tip>
<para
>Se estiver a usar uma expressão regular para procurar o texto a substituir, pode usar referências anteriores para reutilizar o texto capturado nos sub-padrões entre parêntesis da expressão.</para>
<para
>Veja as <link linkend="regular-expressions"
>Expressões Regulares</link
> para mais informações sobre elas.</para>
</tip>

</sect2>

</sect1>

<sect1 id="kate-part-bookmarks">
<title
>Usar os Favoritos</title>

<para
>A possibilidade de teres favoritos permite-te marcar certas linhas, para as encontrares de novo facilmente.</para>

<para
>Podes colocar ou remover um favorito numa linha de duas formas:</para>

<itemizedlist>
<listitem>
<para
>Movendo o cursor de inserção para essa linha e activando o comando <menuchoice
><guimenu
>Favoritos</guimenu
><guimenuitem
>Comutar os Favoritos</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
>).</para
> 
</listitem>
<listitem>
<para
>Carregando no Contorno do Ícone junto a essa linha.</para>
</listitem>
</itemizedlist>


<para
>Os favoritos estão disponíveis no menu <guimenu
>Favoritos</guimenu
>. Os favoritos estão disponíveis individualmente como itens do menu, nomeados com o número de linha com o favorito e os primeiros caracteres de texto da linha. Para moveres o cursor de inserção para o início de uma linha com uma marcação dessas, abre o menu e selecciona o Favorito.</para>

<tip>
<para
>Se a opção <link linkend="config-dialog-general-reopen-files"
>Reabrir os Ficheiros</link
> na <link linkend="config-dialog"
>Janela de Configuração</link
> estiver seleccionada (ou se o &kate; foi reiniciado pelo gestor de sessões), os teus favoritos serão recuperados quando o documento for reaberto.</para>
</tip>

</sect1>

<sect1 id="kate-part-auto-wrap">

<title
>Mudar o Texto de Linha Automaticamente</title>

<para
>Esta funcionalidade permite-lhe ter o texto formatado de uma forma muito simples: o texto será repartido, de modo a que não hajam linhas que excedam o número máximo de caracteres por linha, a menos que exista uma sequência de caracteres sem espaços maior do que o comprimento da linha.</para>

<para
>Para a activar ou desactivar, assinale a opção <guibutton
>Mudança de Linha</guibutton
> na <link linkend="config-dialog-editor-edit"
>página de edição</link
> da <link linkend="config-dialog"
>janela de configuração</link
>.</para>

<para
>Para definir o tamanho máximo da linha (número máximo de caracteres por linha), use a opção <link linkend="config-dialog-editor-edit-wrap-words-at"
><guibutton
>Mudar de Linha A</guibutton
></link
> na <link linkend="config-dialog-editor-edit"
>página de edição</link
> da <link linkend="config-dialog"
>janela de configuração</link
>.</para>

<para
>Se estiver activa, tem os seguintes efeitos: <itemizedlist>
<listitem
><para
>À medida que se vai escrevendo, o editor irá inserir automaticamente uma quebra de linha depois do último carácter de separação de palavras numa posição antes do tamanho máximo da linha ser atingido.</para
></listitem>
<listitem
><para
>Enquanto se vai lendo o documento, o editor irá repartir o texto de uma forma semelhante, de modo a que não hajam linhas que sejam maiores que o tamanho máximo definido, se conterem alguns espaços que o permitam.</para
></listitem>
</itemizedlist>

</para>

<note
><para
>Não existe de momento nenhuma forma de definir a mudança de linha por cada tipo de documento, ou ainda desligar a funcionalidade ao nível do documento. Isto será resolvido numa próxima versão do &kate;</para
></note>

</sect1>

</chapter>
