<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 seu computador local ou da rede.</para>
<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 você arrastar as barras de posicionamento, não mudará 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>
<para>O contorno dos ícones é uma pequena área à esquerda do editor, a qual mostra um pequeno ícone junto às linhas marcadas.</para>
<para>O utilizador poderá colocar ou retirar um <link linkend="kate-part-bookmarks">favorito</link> numa linha visível, se carregar com o botão esquerdo rato ao lado dessa linha.</para>
<para>Esta área pode ser ligada ou desligada se usar a opção do menu <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Mostrar o Contorno do Ícone</guimenuitem></menuchoice>.</para>
<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>
<para>A área de dobragem/desdobramento permite-lhe expandir ou recolher blocos de linhas de código. O cálculo das regiões dobráveis é feito de acordo com regras na definição de realce de sintaxe do documento.</para>
<para>A movimentação pelo texto no &kate; é como na maioria dos editores de texto gráficos. O utilizador poderá mover o cursor com as teclas dos cursores e com as teclas <keycap>Page Up</keycap>, <keycap>Page Down</keycap>, <keycap>Home</keycap> e <keycap>End</keycap>, em conjunto com as teclas modificadoras <keycap>Ctrl</keycap> e <keycap>Shift</keycap>. A tecla <keycap>Shift</keycap> é sempre usada para gerar uma selecção, enquanto a tecla <keycap>Ctrl</keycap> pode ter efeitos diferentes nas diferentes teclas: <itemizedlist>
<listitem><para>Para as teclas <keycap>Cima</keycap> e <keycap>Baixo</keycap>, significa deslocar o cursor, em vez de o mover.</para></listitem>
<listitem><para>Para as teclas <keycap>Esquerda</keycap> e <keycap>Direita</keycap>, significa saltar as palavras em vez de simples caracteres.</para></listitem>
<listitem><para>Para as teclas <keycap>Page Up</keycap> e <keycap>Page Down</keycap>, significa ir para o limite visível da janela, em vez de navegar.</para>
<listitem><para>Para as teclas <keycap>Home</keycap> e <keycap>End</keycap>, significa ir para o início ou fim do documento, em vez de ir para o início ou fim da linha.</para></listitem>
<para>O &kate; também lhe oferece uma forma de saltar rapidamente para um parêntesis correspondente: Coloque o cursor no interior de um parêntesis e carregue em <keycombo><keycap>Ctrl</keycap><keycap>6</keycap></keycombo> para saltar para o parêntesis correspondente.</para>
<para>Para além disso, poderá colocar ou retirar um <link linkend="kate-part-bookmarks">favorito</link>, para saltar para posições definidas por si.</para>
<para>Para seleccionar com o rato, mantenha pressionado o botão esquerdo do rato enquanto arrasta 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 arrasta.</para>
<para>Ao seleccionar texto, arrastando para tal o rato, o texto seleccionado é copiado para a área de transferência, e poderá ser colado se carregar para isso no botão do meio do rato no editor ou em qualquer outra aplicação onde deseje colar o texto. </para>
<para>Para seleccionar com o teclado, mantenha a tecla &Shift; carregada enquanto utiliza as teclas de navegação (as teclas dos cursores, o <keycap>Page Up</keycap>, o <keycap>Page Down</keycap>, o <keycap>Home</keycap> e o <keycap>End</keycap>, possivelmente em combinação com o &Ctrl; para extender o movimento do cursor de texto).</para>
<para>Veja também a secção <link linkend="kate-part-navigation">Navegar no Texto</link> deste capítulo.</para>
<para>Para <action>copiar</action> a selecção actual, utilize a opção do menu <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Copiar</guimenuitem></menuchoice> ou a combinação de teclas respectiva (por omissão é o <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>).</para>
<para>Para <action>deseleccionar</action> a selecção actual, utilize 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 carregue com o botão esquerdo do rato no editor.</para>
<para>Quando a Selecção de Blocos estiver activa, pode fazer <quote>selecções verticais</quote> de texto, seleccionando colunas específicas em várias linhas. Isto é útil, por exemplo, para trabalhar com linhas separadas por tabulações.</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>
<para>Se a opção Substituir a Selecção estiver activa, ao escrever ou colar texto na selecção, fará 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>Para alterar a configuração desta opção, veja a <link linkend="config-dialog-editor-cursor-selection">Página Seleccionar</link> da <link linkend="config-dialog">Janela de Configuração</link>.</para>
<para>Quando a selecção persistente estiver activa, à medida que o utilizador vai escrevendo caracteres ou movendo o cursor, não irá desfazer a selecção existente. Isto significa que poderá mover o cursor para longe da selecção e continuar a escrever texto.</para>
<para>A Selecção Persistente pode ser activada na <link linkend="config-dialog-editor-cursor-selection">Página Seleccionar</link> da <link linkend="config-dialog">Janela de Configuração</link>.</para>
<para>Se ambas as opções estiverem activas, a introdução ou colagem de texto quando o cursor do texto estiver dentro da selecção fará com que este seja substituído e deseleccionado.</para>
<para>Para copiar texto, seleccione-o e use 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 você colar o texto actualmente na área de transferência, use 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 se carregar no botão <mousebutton>do meio</mousebutton> do rato, na posição desejada.</para>
<para>Se estiver a usar o ambiente do &kde;, poderá obter o texto copiado anteriormente de qualquer aplicação com o ícone do &klipper; na bandeja do &kicker;.</para>
<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>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>
<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>
<para>Se estiver seleccionada, a pesquisa irá começar a partir da posição do cursor, caso contrário irá ter início na primeira linha do documento.</para>
<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>
<para>Esta opção está 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>
<term><guilabel>Perguntar ao Substituir</guilabel></term>
<listitem><para>Se estiver seleccionada, aparecerá uma pequena janela a perguntar-lhe o que fazer de cada vez que é encontrada uma ocorrência. Oferece as seguintes opções: <variablelist>
<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>
<para>Para procurar texto, lance 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>, indique o texto a procurar, seleccione as <link linkend="find-replace-dialog">opções</link> desejadas e carregue em <guibutton>OK</guibutton>. Se a pesquisa for iniciada na posição do cursor e não forem encontradas ocorrências, antes de atingir o fim (ou o início, se estiver a procurar para trás) do documento, ser-lhe-á perguntado se deseja dar a volta à procura. </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 procurar a próxima ocorrência na direcção da procura, use a opção <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Procurar Seguinte</guimenuitem></menuchoice> ou carregue em <keycap>F3</keycap>.</para>
<para>Para procurar a próxima ocorrência na direcção oposta, use a opção <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Procurar Anterior</guimenuitem></menuchoice> ou carregue 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-lhe-á perguntado se deseja dar a volta. </para>
<para>Para substituir texto, lance 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>, indique o texto a procurar e, opcionalmente, o texto de substituição (se este estiver em branco, cada ocorrência será removida), defina as <link linkend="find-replace-dialog">opções</link> desejadas e carregue no botão <guibutton>OK</guibutton>.</para>
<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><para>Poderá <command>procurar</command>, <command>substituir</command> e <command>procurar de forma incremental</command> na <link linkend="advanced-editing-tools-commandline">linha de comandos</link>.</para>
<para>Movendo o cursor de inserção para essa linha e activando o comando <menuchoice><guimenu>Favoritos</guimenu><guimenuitem>Comutar o Favorito</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>).</para>
<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 mover o cursor de inserção para o início de uma linha com uma marcação dessas, abra o menu e seleccione o Favorito.</para>
<para>Para saltar rapidamente entre favoritos ou para o favorito anterior/seguinte, use as opções <menuchoice><guimenu>Favoritos</guimenu><guimenuitem>Seguinte</guimenuitem> </menuchoice> (<keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Page Down</keycap></keycombo>) ou <menuchoice> <guimenu>Favoritos</guimenu><guimenuitem>Anterior</guimenuitem></menuchoice> (<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Page Up</keycap> </keycombo>).</para>
<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-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>
<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>
<para>O componente de edição do &kate; suporta uma variedade de modos de auto-indentação, desenhado para os diferentes formatos de texto. Você poderá escolhê-los, entre os modos disponíveis, com a opção <menuchoice><guimenu>Ferramentas</guimenu><guisubmenu>Indentação</guisubmenu></menuchoice>. Os módulos de indentação automática também oferecem uma função <menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Alinhamento</guimenuitem></menuchoice>, que irá calcular de novo a indentação da linha actual ou a seleccionada. Como tal, poderá mudar a indentação do seu documento inteiro, seleccionando o texto e activando essa opção.</para>
<para>Todos os modos de indentação usam a configuração de indentação no documento activo.</para>
<tip><para>Poderá definir todos os tipos de variáveis de configuração, incluindo aqueles relacionados com a indentação com as <link linkend="config-variables">Variáveis do Documento</link> e os <link linkend="config-dialog-editor-filetypes">Tipos de ficheiros</link>.</para></tip>
<listitem><para>Este sistema de indentação simplesmente mantém a indentação semelhante à da linha anterior, com o conteúdo que não corresponda a espaços em branco. Poderá combinar isto com a utilização das acções de indentação e remoção de indentação, para poder indentar de acordo com a sua vontade. </para></listitem>
<listitem><para>Um sistema de indentação para o C e para as linguagens semelhantes, como o C++, C#, Java, JavaScript, entre outros. Este sistema não irá funcionar para as linguagens de 'scripting', como o Perl ou o PHP.</para></listitem>
<listitem><para>Um sistema de indentação automática de XML muito bom. Embora seja tentador, não o tente usar com as variantes de HTML que não sejam o XHTML, dado que não funciona com as marcas antigas do HTML (as marcas em aberto, como por exemplo o <br>)</para></listitem>
<para>O sistema de indentação variável é especial, na medida em que poderá ser configurado através de variáveis no documento (ou com uma configuração por tipo de ficheiro). São lidas as seguintes variáveis: <variablelist>
<para>Uma expressão regular que fará com que uma linha seja indentada de uma unidade, se a primeira linha, não sendo composta apenas por espaços em branco, fizer correspondência. var-indent-indent: Uma expressão regular que fará com que uma linha correspondente a ela seja indentada de uma unidade.</para>
<para>Uma lista de conjuntos de parêntesis para tratar. Pode ser qualquer combinação de parêntesis normais, rectos e chavetas. Cada tipo de conjunto é lidado da seguinte forma: se existirem instâncias abertas na linha acima, será adicionada uma unidade de indentação, enquanto se existirem instâncias de fecho não correspondidas, é removida uma unidade de indentação.</para>
<para>Ao procurar pelos pares de parêntesis, só são considerados os caracteres com este atributo. O valor deverá ser o nome do atributo no ficheiro XML da sintaxe, como por exemplo "Symbol". Se não for indicado, é usado o atributo 0 (normalmente o 'Normal Text').</para>
