# 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 teu computador local ou da rede.

O editor é composto pelas seguintes partes:

A área de edição

  Aqui é onde se localiza o texto do teu 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 arrastares as barras de posicionamento não mudarás de posição o cursor de inserção.

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

O Contorno do Ícone

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

  Podes colocar ou retirar um favorito numa linha visível carregando com o botão esquerdo rato ao lado dessa linha.

  Esta área pode ser ligada ou desligada usando 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.

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

## Navegar no Texto

Esta secção ainda não está documentada.

## Trabalhar com a Selecção

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

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.

Um duplo-click numa palavra seleccioná-la-á.

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

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

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

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

### Usar a Selecção do Bloco

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

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

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

Para alterares a configuração desta opção, vê a Página Seleccionar da Janela de Configuração.

### Usar a Selecção Persistente

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.

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 está dentro da selecção fará com que este seja substituída e deseleccionada.

## Copiar e Colar Texto

Para copiares texto, selecciona-o e usa 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 colares o texto actualmente na área de transferência, usa a opção do menu Editar Colar.

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

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

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

Do Início

  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.

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 introduzes o texto de substituição.

Texto Seleccionado

  Esta opção estás 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-te o que fazer de cada vez que é encontrada uma ocorrência. Oferece as seguintes opções:

  Sim

    Activa isto para substituíres a ocorrência actual (a que está seleccionada no editor).

  Não

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

  Tudo

    Activa para cancelares a pergunta e substituíres todas as ocorrências.

  Fechar

    Activa isto para ignorares a ocorrência actual e terminares 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 procurares texto, lança a janela Procurar Texto com o &Ctrl;F ou na opção do menu Editar Procurar..., indica o texto a procurar, selecciona as opções desejadas e carrega em Ok. 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.

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 procurares a próxima ocorrência na direcção da procura, usa a opção Editar Procurar Seguinte ou carrega em F3.

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

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

### Substituir Texto

Para substituíres texto, lança a janela Substituir Texto com a opção do menu Editar Substituir ou com o atalho &Ctrl;R, indica o texto a procurar e, opcionalmente, o texto de substituição (se este estiver em branco, cada ocorrência será substituída por ""), define as opções desejadas e carrega 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.

## Usar os Favoritos

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

Podes 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 os Favoritos (&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 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.

Se a opção Reabrir os Ficheiros na Janela de Configuração estiver seleccionada (ou se o &kate; foi reiniciado pelo gestor de sessões), os teus favoritos serão recuperados quando o documento for reaberto.

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