# Trabalhar com o editor &kate;

## Introdução

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.

O editor é composto pelas seguintes partes:

A área de edição

- Aqui é onde se localiza o texto do seu documento.

As barras de posicionamento

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

  As barras de posicionamento podem estar visíveis ou não, dependendo da vontade.

O Contorno dos Ícones

- O contorno dos ícones é uma pequena área à esquerda do editor, a qual mostra um pequeno ícone junto às linhas marcadas.

  O utilizador poderá colocar ou retirar um favorito numa linha visível, se carregar com o botão esquerdo rato ao lado dessa linha.

  Esta área pode ser ligada ou desligada se usar a opção do menu Ver Mostrar o Contorno do Ícone.

A Área de Números de Linha

- Esta área mostra os números de linha de todas as linhas visíveis do documento.

  A área pode ser ligada ou desligada, através da opção do menu Ver Mostrar Números de 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:

- Navegar no Texto

- Trabalhar com a Selecção

- Copiar e Colar Texto

- Procurar e Substituir Texto

- Usar os Favoritos

- Mudar o Texto de Linha Automaticamente

- Utilizar a indentação automática

## Navegar no Texto

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

- Para as teclas Cima e Baixo, significa deslocar o cursor, em vez de o mover.

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

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

- Para as teclas Home e End, 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êntesis correspondente: Coloque o cursor no interior de um parêntesis e carregue em Ctrl 6 para saltar para o parêntesis correspondente.

Para além disso, poderá colocar ou retirar um favorito, para saltar para posições definidas por si.

## Trabalhar com a Selecção

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

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.

Se carregar duas vezes numa palavra seleccioná-la-á.

Se carregar três vezes numa linha seleccioná-la-á por completo.

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

- Se não estiver nada seleccionado previamente, da posição do cursor de texto até à posição do cursor do rato.

- Se estiver algo seleccionado, desde essa selecção até à posição do cursor do rato

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 seleccionar com o teclado, mantenha a tecla &Shift; carregada enquanto utiliza as teclas de navegação (as teclas dos cursores, o Page Up, o Page Down, o Home e o End, possivelmente em combinação com o &Ctrl; para extender o movimento do cursor de texto).

Veja também a secção Navegar no Texto deste capítulo.

Para copiar a selecção actual, utilize a opção do menu Editar Copiar ou a combinação de teclas respectiva (por omissão é o &Ctrl;C).

Para deseleccionar a selecção actual, utilize a opção do menu Editar Deseleccionar ou o atalho de teclado correspondente (por omissão é o &Ctrl;&Shift;A) ou carregue com o botão esquerdo do rato no editor.

### Usar a Selecção do Bloco

Quando a Selecção de Blocos estiver activa, pode fazer selecções verticais de texto, seleccionando colunas específicas em várias linhas. Isto é útil, por exemplo, para trabalhar com linhas separadas por tabulações.

A Selecção do Bloco pode ser ligada ou desligada através da opção Editar Comutar a Selecção do Bloco. O atalho de teclado por omissão é o F4

### Usar a Substituição da Selecção

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.

A Substituição da Selecção está activa por omissão.

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

### Usar a Selecção Persistente

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.

A selecção persistente está desligada por omissão.

A Selecção Persistente pode ser activada na Página Seleccionar da Janela de Configuração.

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.

## Copiar e Colar Texto

Para copiar texto, seleccione-o e use a opção do menu Editar Copiar. Adicionalmente, a selecção de texto com o rato fará com que o texto seleccionado seja copiado para a área de transferência.

Para você colar o texto actualmente na área de transferência, use a opção do menu Editar Colar.

Adicionalmente, o texto seleccionado com o rato pode ser colado se carregar no botão do meio do rato, na posição desejada.

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

## Procurar e Substituir Texto

### As Janelas Procurar Texto e Substituir Texto

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.

As janelas oferecem as seguintes opções comuns:

Texto a Procurar

- Aqui é onde se indica o texto a procurar. A interpretação do texto depende de algumas das opções descritas em baixo.

Expressão Regular

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

  Veja as Expressões Regulares para mais informações sobre elas.

Não Distinguir Capitalização

- Se estiver activo, a pesquisa não fará distinção entre maiúsculas e minúsculas.

Apenas Palavras Inteiras

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

A partir do cursor

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

Procurar para Trás

- 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 Do Início estiver activa.

A janela Substituir Texto oferece algumas opções adicionais:

Substituir Por

- Aqui é onde irá introduzir o texto de substituição.

Texto Seleccionado

- Esta opção está desactivada se não estiver nenhum texto seleccionado ou se a opção Perguntar ao Substituir 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.

Perguntar ao Substituir

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

  Sim

- Active isto para substituir a ocorrência actual (a que está seleccionada no editor).

Não

- Active para ignorar a ocorrência actual e tentar encontrar outra.

Tudo

- Active para cancelar a pergunta e substituir todas as ocorrências.

Fechar

- Active isto para ignorar a ocorrência actual e terminar a pesquisa.

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;

### Procurar 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, seleccione as opções desejadas e carregue em 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 a procurar para trás) do documento, ser-lhe-á perguntado se deseja dar a volta à procura.

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

Para procurar a próxima ocorrência na direcção da procura, use a opção Editar Procurar Seguinte ou carregue em F3.

Para procurar a próxima ocorrência na direcção oposta, use a opção Editar Procurar Anterior ou carregue em &Shift;F3.

Se não for encontrada nenhuma ocorrência antes de atingir o extremo do documento, ser-lhe-á perguntado se deseja dar a volta.

### Substituir 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 carregue no botão OK.

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.

Veja as Expressões Regulares para mais informações sobre elas.

Poderá `procurar`, `substituir` e `procurar de forma incremental` na linha de comandos.

## Usar os Favoritos

A possibilidade de o utilizador ter favoritos permite-lhe marcar certas linhas, para as encontrar de novo facilmente.

Poderá colocar ou remover um favorito numa linha de duas formas:

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

- Carregando no Contorno do Ícone junto a essa linha.

Os favoritos estão disponíveis no menu Favoritos. 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 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 ).

## Mudar o Texto de Linha Automaticamente

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 a activar ou desactivar, assinale a opção Mudança de Linha na página de edição da janela de configuração.

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

Se estiver activa, tem os seguintes efeitos:

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

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

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;

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

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

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

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

Nenhum

- Se seleccionar este modo, irá desactivar 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. 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.

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 alternativa 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, dado 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 o 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 ficheiro). 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 calculada de novo imediatamente, quando estes forem escritos.

var-indent-handle-couples

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

`var-indent-couple-attribute`

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