<para>O editor &kate; é a área de edição da janela do &kate;. Este editor também é usado pelo &kwrite; e pode ser usado pelo &konqueror; para exibir arquivos texto de seu computador local ou da rede.</para>
<para>Indicam a posição da parte visível do texto do documento, e pode ser usada para mover-se pelo documento. Arrastar as barras não fará com que o cursor de inserção seja movido.</para>
<para>As barras de rolagem podem ser exibidas e ocultas, caso necessário.</para>
<para>A borda do ícone é um pequeno painel do lado esquerdo do editor, exibindo um pequeno ícone próximo às linhas marcadas.</para>
<para>Você pode ajustar ou remover um <link linkend="kate-part-bookmarks">favorito </link> em uma linha visível clicando com o &LMB; na borda do ícone, próximo àquela linha.</para>
<para>A exibição da borda do ícone pode ser alternada usando o item de menu <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Mostrar Borda do Ícone</guimenuitem></menuchoice>.</para>
<para>O painel de números de linha exibem os números de linha de todas as linhas visíveis no documento.</para>
<para>A exibição do Painel de Números de linha pode ser alternado usando o item de menu <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Mostrar Números da 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 usuário 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 seleçã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>, isto significa deslocar o cursor, em vez de movê-lo.</para></listitem>
<listitem><para>Para as teclas <keycap>Esquerda</keycap> e <keycap>Direita</keycap>, isto 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>, isto 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>, isto 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ênteses correspondente: Coloque o cursor no interior de um parênteses e pressione <keycombo><keycap>Ctrl</keycap><keycap>6</keycap></keycombo> para saltar para o parênteses correspondente.</para>
<para>Além disso, você poderá colocar ou retirar um <link linkend="kate-part-bookmarks">favorito</link>, para saltar para posições definidas por você.</para>
<para>Para selecionar usando o mouse, pressione e mantenha pressionado o &LMB; enquanto arrasta o cursor do mouse de onde a seleção deve iniciar, até o ponto final desejado. O texto fica selecionado quando você arrasta.</para>
<para>Ao selecionar o texto arrastando o mouse, o texto selecionado é copiado para a área de transferência, e pode ser coloca clicando-se com o botão do meio do mouse no editor, ou em qualquer outra aplicação para a qual você deseja colar o texto. </para>
<para>Para selecionar usando o teclado, pressione mantenha pressionada a tecla &Shift; usando as telcas de navegação (as setas, <keycap>Page Up</keycap>, <keycap>Page Down</keycap>, <keycap>Home</keycap> e <keycap>End </keycap>, possivelmente em combinação com o &Ctrl; para aumentar o movimento do cursor de texto).</para>
<para>Veja também a seção <link linkend="kate-part-navigation">Navegando no Texto </link>, neste capítulo.</para>
<para>Para <action>Copiar</action> a seleção atual, use o item de menu <menuchoice><guimenu>Editar</guimenu><guimenuitem>Copiar </guimenuitem></menuchoice> ou o atalho de teclado (o padrão é <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>).</para>
<para>Para <action>Deselecionar</action> a seleção atual, use o item de menu <menuchoice><guimenu>Editar</guimenu><guimenuitem>Deselecionar </guimenuitem></menuchoice> ou o atalho de teclado (o padrão é <keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>), ou clique com o &LMB; no editor.</para>
<para>Quando a Seleção de Bloco estiver habilitada, você pode fazer <quote>seleções verticais</quote> no texto, o que significa selecionar colunas limitadas de múltiplas linhas. Isto é útil em trabalhos com linhas separadas com tabs, por exemplo.</para>
<para>A Seleção de Bloco pode ser alternada usando-se o item de menu <menuchoice><guimenu>Editar </guimenu><guimenuitem>Alternar Seleção de Bloco</guimenuitem></menuchoice>. O atalho padrão no teclado é <keycap>F4</keycap>.</para>
<para>Se a Seleção de Sobrescrita estiver habilitada, a digitação ou colagem de texto dentro da seleção causará a substituição do texto selecionado. Se não estiver habilitada, o novo texto será adicionado na posição do cursor do texto.</para>
<para>Para alterar a configuração desta opção, veja a <link linkend="config-dialog-editor-cursor-selection">Página Selecionar</link> da <link linkend="config-dialog">Janela de Configuração</link>.</para>
<para>Quando a Seleção Persistente estiver habilitada, a digitação de caracteres ou a movimentação do cursor não fará com que a seleção desapareça. Isto signifca que você pode mover o cursor para fora da seleção e digitar o texto.</para>
<para>A Seleção Persistente pode ser ativada na <link linkend="config-dialog-editor-cursor-selection">Página Selecionar</link> da <link linkend="config-dialog">Janela de Configuração</link>.</para>
<para>Se a Seleção Persistente e a Seleção de Sobrescrita estiverem ambas habilitadas, a digitação e a colagem de texto, quando o cursor estiver dentro da seleção, farão com que ela seja substituída ou deselecionada.</para>
<para>Para copiar texto, selecione-o e use a opção do menu <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Copiar</guimenuitem></menuchoice>. Adicionalmente, a seleção de texto com o mouse fará com que o texto selecionado seja copiado para a área de transferência.</para>
<para>Para colar o texto contido atualmente na área de transferência, use o item de menu <menuchoice><guimenu>Editar</guimenu><guimenuitem>Colar</guimenuitem> </menuchoice>.</para>
<para>Adicionalmente, o texto selecionado com o mouse pode ser colando clicando-se com o botão do <mousebutton>meio</mousebutton> do mouse na posição desejada.</para>
<para>Se você está usando o ambiente de trabalho &kde;, você pode recuperar textos copiados recentemente de qualquer aplicação, usando o ícone do &klipper; no sistemas de ícones do &kicker;.</para>
<para>Os Diálogos Procurar e Substituir Texto no &kate; são muito parecidos, exceto que o diálogo Substituir Texto oferece a facilidade de digitar uma string de substituição juntamente com algumas opções extras.</para>
<para>Se marcada, a string de busca é interpretada como uma expressão regular. Um botão para o uso da ferramenta gráfica, para a criação ou edição da expressão, será habilitado.</para>
<para>Veja em <link linkend="regular-expressions">Expressões Regulares</link> para mais informações.</para>
<para>Se marcado, a busca somente combinará se existir uma palavra com os mesmos finais da string encontrada, o que significa que nem caracteres alfanuméricos, nem algum outro caractere visível ou um final de linha.</para>
<para>Se estiver selecionada, 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 marcado, o busca procurará pela primeira combinação acima do ponto de início, da posição do cursor ou do início do documento, se a opção <guilabel> Do Início</guilabel> estive habilitada.</para>
<para>Esta opção é desabilitada se nenhum texto for selecionado, ou se a opção <guilabel>Avisar ao Substituir</guilabel> estiver habilitada. Se marcada, todas as combinações da string de busca, dentro do texto selecionado, serão substituídas pela string de substituição.</para>
<term><guilabel>Avisar ao Substituir</guilabel></term>
<listitem><para>Se marcada, um pequeno diálogo lhe avisará sobre o que fazer cada vez que uma combinação for encontrada. Ela oferece as seguintes opções: <variablelist>
<para>Não existe atualmente uma maneira de usar uma combinaçào mínima ao se procurar com uma expressão regular. Isto será adicionado em versões futuras 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, selecione as <link linkend="find-replace-dialog">opções</link> desejadas e clique <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 procurando para trás) do documento, ser-lhe-á perguntado se deseja continuar a partir do início/fim do mesmo. </para>
<para>Se uma combinação for encontrada, ela é selecionada e o Diálogo <guilabel> Procurar Texto</guilabel> será ocultado, mas fique atento, pois procurar por mais combinações é mais fácil:</para>
<para>Para encontrar a próxima combinação na direção da busca, use o comando <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Procurar Próximo</guimenuitem></menuchoice> ou pressione <keycap>F3</keycap>.</para>
<para>Para encontrar a próxima combinação na direção contrária da busca, use o comando <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Procurar Anterior</guimenuitem></menuchoice> ou pressione <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 procurar a partir do início/fim do mesmo. </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 clique no botão <guibutton>OK</guibutton>.</para>
<para>Se você estiver usando uma expressão regular para encontrar um texto a ser substituído, você pode empregar referências regressivas, para reutilizar o texto capturado em sub-padrões da expressão, com parênteses.</para>
<para>Veja em <xref linkend="regular-expressions"/> para mais detalhes.</para>
<tip><para>Você poderá <command>procurar</command>, <command>substituir</command> e <command>procurar de forma incremental</command> na <link linkend="advanced-editing-tools-commandline">linha de comando</link>.</para>
<para>Movendo o cursor de inserção para essa linha e ativando o comando <menuchoice><guimenu>Favoritos</guimenu><guimenuitem>Comutar 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 individuais estão disponíveis como itens de menu, rotulados com o número da linha que contém o favorito, e os primeiros caracteres da linha. Para mover o cursor para o início da linha marcada, abra o menu e selecione 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>
<para>Esta característica permite a você ter o texto formatado de uma maneira muito simples: o texto será quebrado, e assim nenhuma linha excederá o número máximo de caracteres por linha, a menos que exista uma string mais longa sem espaços em branco.</para>
<para>Para desabilitar/habilitar isto, desmarque/marque a caixa de verificação <guibutton>Quebra de Linha</guibutton> na página de <link linkend= "config-dialog-editor-edit">Edição</link> do <link linkend="config-dialog"> diálogo 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>Quebrar Linha Em</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 habilitada, ele terá os seguintes efeitos: <itemizedlist>
<listitem><para>Ao digitar, o editor inserirá automaticamente uma quebra de linha após o último espaço em branco na posição antes que o comprimento máximo de linha seja alcançado.</para></listitem>
<listitem><para>Ao carregar um documento, o editor quebrará o texto de modo similar, e assim nenhuma linha será maior que o comprimento máximo por linha, se elas contiverem quaisquer espaços em branco pertencentes a ela.</para></listitem>
<note><para>Não existe atualmente um modo de ajustar a quebra de linha por tipo de documento, ou até mesmo habilitar ou desabilitar a característica em um nível de documento. Isto será consertado em versões futuras 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 novamente a indentação da linha atual ou a selecionada. Assim, você poderá mudar a indentação do seu documento inteiro, selecionando o texto e ativando essa opção.</para>
<para>Todos os modos de indentação usam a configuração de indentação no documento ativo.</para>
<tip><para>Você 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 arquivos</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. Você poderá combinar isto com a utilização das açõ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, uma vez 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 arquivo). 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ênteses para tratar. Pode ser qualquer combinação de parênteses normais, retos e chaves. 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ênteses, só são considerados os caracteres com este atributo. O valor deverá ser o nome do atributo no arquivo XML da sintaxe, como por exemplo "Symbol". Se não for indicado, é usado o atributo 0 (normalmente o 'Normal Text').</para>
