# Trabalhando com o Editor &kate;

## Visão geral

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.

O editor é composto pelos seguintes componentes:

A Área do Editor

- Esta é a área onde o texto de seu documento está localizado.

As barras de Rolagem

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

  As barras de rolagem podem ser exibidas e ocultas, caso necessário.

A Borda do Ícone

- A borda do ícone é um pequeno painel do lado esquerdo do editor, exibindo um pequeno ícone próximo às linhas marcadas.

  Você pode ajustar ou remover um favorito em uma linha visível clicando com o &LMB; na borda do ícone, próximo àquela linha.

  A exibição da borda do ícone pode ser alternada usando o item de menu Ver Mostrar Borda do Ícone.

O Painel dos Números de Linha

- O painel de números de linha exibem os números de linha de todas as linhas visíveis no documento.

  A exibição do Painel de Números de linha pode ser alternado usando o item de menu Ver Mostrar Números da Linha.

A Área de Dobragem

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

## Também Neste Capítulo:

- Navegando no Texto

- Trabalhando com Seleção

- Copiando e Colando e Texto

- Procurando e Substituindo Texto

- Using Favoritos

- Quebra de Texto Automática

- Usando a indentação automática

## Navegando no Texto

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 Page Up, Page Down, Home e End, em conjunto com as teclas modificadoras Ctrl e Shift. A tecla Shift é sempre usada para gerar uma seleção, enquanto a tecla Ctrl pode ter efeitos diferentes nas diferentes teclas:

- Para as teclas Cima e Baixo, isto significa deslocar o cursor, em vez de movê-lo.

- Para as teclas Esquerda e Direita, isto significa saltar as palavras em vez de simples caracteres.

- Para as teclas Page Up e Page Down, isto significa ir para o limite visível da janela, em vez de navegar.

- Para as teclas Home e End, isto significa ir para o início ou fim do documento, em vez de ir para o início ou fim da linha.

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 Ctrl 6 para saltar para o parênteses correspondente.

Além disso, você poderá colocar ou retirar um favorito, para saltar para posições definidas por você.

## Trabalhando com Seleção

Existem duas maneiras básicas de selecionar texto no &kate;: usando o mouse e usando o teclado.

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.

O clique duplo em uma palavra seleciona a mesma.

O clique triplo em uma linha seleciona a linha inteira.

Se o &Shift; estiver pressionado enquanto se clica, o texto será selecionado:

- Se nenhum texto já estiver selecionado, da posição do cursor do texto até a posição do cursor do mouse.

- Se existe uma seleção, da seleção do mouse, inclusive, até a posição do cursor do mouse

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 selecionar usando o teclado, pressione mantenha pressionada a tecla &Shift; usando as telcas de navegação (as setas, Page Up, Page Down, Home e End , possivelmente em combinação com o &Ctrl; para aumentar o movimento do cursor de texto).

Veja também a seção Navegando no Texto , neste capítulo.

Para Copiar a seleção atual, use o item de menu Editar Copiar ou o atalho de teclado (o padrão é &Ctrl;C).

Para Deselecionar a seleção atual, use o item de menu Editar Deselecionar ou o atalho de teclado (o padrão é &Ctrl;&Shift;A), ou clique com o &LMB; no editor.

### Usando a Seleção de Bloco

Quando a Seleção de Bloco estiver habilitada, você pode fazer seleções verticais no texto, o que significa selecionar colunas limitadas de múltiplas linhas. Isto é útil em trabalhos com linhas separadas com tabs, por exemplo.

A Seleção de Bloco pode ser alternada usando-se o item de menu Editar Alternar Seleção de Bloco. O atalho padrão no teclado é F4.

### Usando Seleção de Sobrescrita

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.

A Seleção de Sobrescrita está habilitada, por padrão.

Para alterar a configuração desta opção, veja a Página Selecionar da Janela de Configuração.

### Usando Seleção Persistente

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.

A Seleção Persistente está desabilitada, por padrão.

A Seleção Persistente pode ser ativada na Página Selecionar da Janela de Configuração.

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.

## Copiando e Colando Texto

Para copiar texto, selecione-o e use a opção do menu Editar Copiar. Adicionalmente, a seleção de texto com o mouse fará com que o texto selecionado seja copiado para a área de transferência.

Para colar o texto contido atualmente na área de transferência, use o item de menu Editar Colar .

Adicionalmente, o texto selecionado com o mouse pode ser colando clicando-se com o botão do meio do mouse na posição desejada.

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

## Procurando e Substituindo Texto

### Os Diálogos Procurar Texto e Substituir Texto

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.

Os diálogos oferecem as seguintes opções comuns:

Texto a Procurar

- Aqui é onde se digita a string de busca. A interpretação da string depende de algumas das opções escritas a seguir.

Expressão regular

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

  Veja em Expressões Regulares para mais informações.

Não diferenciar maiúsculas de minúsculas

- Se habilitado, a busca não fará diferenciação entre maiúsculas e minúsculas.

Apenas palavras inteiras

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

A partir do cursor

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

Procurar Para trás

- 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 Do Início estive habilitada.

O Diálogo Substituir Texto oferece algumas opções adicionais:

Substituir por

- É aqui onde se deve digitar a string a ser substituída.

Texto selecionado

- Esta opção é desabilitada se nenhum texto for selecionado, ou se a opção Avisar ao Substituir 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.

Avisar ao Substituir

- 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:

  Sim

- Ative isto para substituir a combinação atual (que está selecionada no editor).

Não

- Ative isto para sair da combinação atual e tentar encontrar outra.

Tudo

- Ative para cancelar o aviso, e apenas substitua todas as entradas encontradas.

Fechar

- Ative isto para ignorar a ocorrência atual e terminar a pesquisa.

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

### Procurando Texto

Para procurar texto, lance a janela Procurar Texto com o &Ctrl;F ou na opção do menu Editar Procurar..., indique o texto a procurar, selecione as opções desejadas e clique OK. 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.

Se uma combinação for encontrada, ela é selecionada e o Diálogo Procurar Texto será ocultado, mas fique atento, pois procurar por mais combinações é mais fácil:

Para encontrar a próxima combinação na direção da busca, use o comando Editar Procurar Próximo ou pressione F3.

Para encontrar a próxima combinação na direção contrária da busca, use o comando Editar Procurar Anterior ou pressione &Shift;F3.

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.

### Substituindo Texto

Para substituir texto, lance a janela Substituir Texto com a opção do menu Editar Substituir ou com o atalho &Ctrl;R, indique o texto a procurar e, opcionalmente, o texto de substituição (se este estiver em branco, cada ocorrência será removida), defina as opções desejadas e clique no botão OK.

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.

Veja em regular-expressions para mais detalhes.

Você poderá `procurar`, `substituir` e `procurar de forma incremental` na linha de comando.

## Usando Favoritos

A característica de favoritos permite a você marcar certas linhas, para ser capaz de encontrá-las facilmente de novo.

Você pode ajustar ou remover um favorito de uma linha de duas maneiras:

- Movendo o cursor de inserção para essa linha e ativando o comando Favoritos Comutar Favorito (&Ctrl;B).

- Carregando na Borda do Ícone junto a essa linha.

Os Favoritos estão disponíveis no menu Favoritos. 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 saltar rapidamente entre favoritos ou para o favorito anterior/seguinte, use as opções Favoritos Seguinte (Ctrl Page Down) ou Favoritos Anterior (Ctrl Page Up ).

## Quebra de Texto Automática

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 desabilitar/habilitar isto, desmarque/marque a caixa de verificação Quebra de Linha na página de Edição do diálogo de configuração.

Para definir o tamanho máximo da linha (número máximo de caracteres por linha), use a opção Quebrar Linha Em na página de edição da janela de configuração.

Se habilitada, ele terá os seguintes efeitos:

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

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

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

## Usando a indentação automática

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 Ferramentas Indentação. Os módulos de indentação automática também oferecem uma função Ferramentas Alinhamento, 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.

Todos os modos de indentação usam a configuração de indentação no documento ativo.

Você poderá definir todos os tipos de variáveis de configuração, incluindo aqueles relacionados com a indentação com as Variáveis do Documento e os Tipos de arquivos.

## Modos de Indentação Automática Disponíveis

Nenhum

- Se selecionar este modo, irá desativar a indentação automática.

Normal

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

Estilo C

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

Estilo C SS

- Um sistema de indentação alternativo para o C e as linguagens do género, com as mesmas restrições.

Estilo Python

- Um sistema de indentação específico para a linguagem de programação Python.

XML

- 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>)

Sistema de Indentação Variável

- Este sistema é experimental e poderá mudar de comportamento ou desaparecer nas versões futuras.

  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:

  var-indent-indent-after

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

var-indent-unindent

- Uma expressão regular que fará com que a linha reduza a indentação de uma unidade, se fizer correspondência.

var-indent-triggerchars

- Uma lista de caracteres que deverá fazer com que a indentação seja recalculada imediatamente, quando forem digitados.

var-indent-handle-couples

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

`var-indent-couple-attribute`

- 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').