# Trabalhar com o editor &kappname;

## Introdução

O editor &kappname; é a área de edição da janela do &kappname;. Este editor é partilhado entre o &kate; e o &kwrite;, podendo também ser usado no &konqueror; para mostrar os ficheiros de texto no seu computador local ou na 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 &LMB; 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

- Usar a indentação automática

## Navegar no Texto

A deslocação pelo texto no &kappname; é feita como na maioria dos editores gráficos. Poderá deslocar o cursor com as teclas de cursores e 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; tem diferentes efeitos, dependendo das 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 &kappname; também lhe oferece uma forma de saltar rapidamente para um parêntesis ou chaveta correspondente: coloque o cursor no interior de um bloco de parêntesis ou chavetas e carregue em &Ctrl;6 para saltar para o carácter 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 o texto no &kappname;: usando o rato ou o teclado.

Para seleccionar com o rato, mantenha pressionado o &LMB; 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 em 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 Modo de Selecção em Bloco. O atalho de teclado por omissão é o &Ctrl;&Shift;B .

### 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 página Cursor & Selecção 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 Cursor & Selecção 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 sistema.

## Procurar e Substituir Texto

### As Barras para Procurar e Substituir

O &kappname; tem uma barra de pesquisa incremental e uma barra de pesquisa e substituição poderosa, que lhe oferece a possibilidade de indicar um texto de substituição com algumas opções extra.

As barras oferecem as seguintes opções comuns:

Procurar

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

Distinguir capitalização

- Se estiver activo, a pesquisa será limitada aos itens que correspondam a nível de capitalização (maiúsculas ou minúsculas) de cada um dos caracteres no padrão de pesquisa.

A barra de pesquisa e substituição avançadas oferece algumas opções adicionais:

Texto Simples

- Corresponde literalmente a qualquer ocorrência do texto de pesquisa.

Palavras Completas

- 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 - seja outro carácter visível qualquer ou um fim de linha.

Sequências de Escape

- Se estiver seleccionada, o botão Adicionar ficará activo e permitir-lhe-á adicionar sequências de escape para o padrão de pesquisa, usando uma lista predefinida.

Expressão Regular

- Se estiver assinalada, o texto a procurar é interpretado como uma expressão regular. O botão Adicionar ficará activo, para que possa criar itens de expressão regular do padrão de pesquisa, usando como base uma lista predefinida.

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

Pesquisar apenas na selecção

- Se estiver seleccionada, a pesquisa e substituição será feita apenas sobre o texto seleccionado.

Procurar tudo

- Se carregar neste botão, irá realçar todas as ocorrências no documento e mostrar o número de ocorrências encontradas numa pequena área.

### Procurar Texto

Para procurar texto, invoque a barra de pesquisa incremental com a combinação de teclas &Ctrl;F ou com a opção do menu Editar Procurar....

Isto abre a barra de pesquisa incremental no fundo da janela do editor. Do lado esquerdo da barra, existe um ícone para fechar a barra, seguido de um pequeno campo de texto para introduzir o padrão a pesquisar.

Quando começar a introduzir caracteres no seu padrão de pesquisa, esta começa imediatamente. Se existir uma ocorrência no texto, esta fica realçada e a cor de fundo do campo muda para verde-claro. Se o padrão de pesquisa não corresponder a nenhum texto, isto é indicado por uma cor de fundo vermelha-clara no campo.

Use os botões ou para saltar para a ocorrência anterior ou seguinte no documento.

As correspondências são realçadas até quando fechar a barra de pesquisa. Para limpar este realce, carregue na tecla &Esc;.

Poderá escolher aqui se a pesquisa faz a distinção entre minúsculas e maiúsculas ou não. Se seleccionar a opção , irá limitar as pesquisas para os itens que correspondam à capitalização (maiúsculas ou minúsculas) de cada um dos caracteres do padrão de pesquisa.

Carregue no botão , à direita da barra de pesquisa incremental, para mudar para a barra mais poderosa de pesquisa e substituição.

Para repetir a última operação de pesquisa, se tiver ocorrido e sem ter de invocar a barra de pesquisa incremental, use a opção F3 Editar Procurar o Próximo ou &Shift;F3 Editar Procurar o Anterior.

### Substituir Texto

Para substituir o texto, invoque a barra avançada de pesquisa e substituição com a opção do menu Editar Substituir ou com a combinação de teclas &Ctrl;R.

No canto superior esquerdo da barra existe um ícone para fechar a barra, seguido de um pequeno campo de texto para introduzir o padrão de pesquisa.

Poderá controlar o modo de pesquisa se seleccionar as opções Texto Simples, Palavras Completas, Sequências de Escape ou Expressão Regular, que estão descritas acima.

Se as Sequências de escape ou a Expressão regular estiverem seleccionadas, o item Adicionar..., no fundo do menu de contexto das áreas de texto, irá ficar activo, permitindo assim que adicione sequências de escape ou itens de expressões regulares ao padrão de pesquisa e substituição, a partir de listas predefinidas.

Use os botões ou para saltar para a ocorrência anterior ou seguinte no documento.

Indique o texto de substituição no campo de texto Substituir e carregue no botão Substituir, para substituir apenas o texto realçado, ou o botão Substituir Tudo para substituir o texto de pesquisa no documento inteiro.

Poderá modificar o comportamento da pesquisa e da substituição ao seleccionar as diferentes opções no lado direito da barra. Se seleccionar a opção irá limitar as pesquisas apenas aos itens com capitalização correspondente (maiúsculas ou minúsculas) para cada um dos caracteres no padrão de pesquisa. A opção Procurar Tudo realça todas as ocorrências no documento. A opção irá procurar e substituir apenas dentro do texto seleccionado de momento.

Carregue no botão , à direita da barra avançada de pesquisa e substituição, para mudar para a barra de pesquisa incremental.

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

Poderá fazer um `find`, `replace` e um `ifind` (pesquisa 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 Marcar um 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 Estática 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 configurar a mudança de linha para os tipos de documento ou de activar ou desactivar a funcionalidade ao nível do documento. Isto será resolvido numa versão futura do &kappname;

## Usar a indentação automática

O componente de edição do &kappname; suporta uma variedade de modos de indentação automática, desenhadas para os diferentes formatos de texto. Poderá escolher qualquer um dos modos disponíveis com a opção do menu Ferramentas Indentação. Os módulos de indentação automática também oferecem uma função Ferramentas Alinhar que irá calcular de novo a indentação da linha seleccionada ou da actual. Como tal, poderá voltar a indentar todo o seu documento, seleccionando todo o texto e activando essa acçã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.

Haskell

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

Lilypond

- Um sistema de indentação específico para a linguagem de notação musical Lilypond.

Lisp

- Um sistema de indentação específico para a linguagem de programação Lisp e respectivos dialectos.

Python

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

Estilo XML

- Um sistema de indentação específico para linguagens semelhantes a XML.

## Indicadores de Modificação da Linha

Os indicadores de modificação de linhas do &kappname; permitem-lhe ver facilmente o que alterou recentemente num ficheiro. As alterações gravadas são indicadas com uma barra verde à esquerda de um documento, enquanto as alterações não gravadas são indicadas com uma barra laranja.

Os indicadores de modificação da linha em acção.

Poderá alterar as cores usadas no painel de configuração das Cores & Tipos de Letra ou poderá desactivar esta funcionalidade por completo na página Contornos do painel de configuração da Aparência.

## O Mini-Mapa de Posicionamento

O Mini-Mapa de Posicionamento do &kappname; mostra uma antevisão dos documentos no local da barra de posicionamento. A parte visível de momento do documento fica realçada.

O Mini-Mapa de Posicionamento mostra uma antevisão do código-fonte do &kate;.

Poderá activar ou desactivar temporariamente o mini-mapa, seleccionando a opção Ver Ver o Mini-Mapa de Posicionamento ou, de forma permanente, na secção de Aparência da configuração do &kappname;.