&Anders.Lund; &Anders.Lund.mail;
&Dominik.Haumann; &Dominik.Haumann.mail;
José
Pires

    zepires@gmail.com

Tradução

# 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 &i18n-powermode;

  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 &i18n-powermode;

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.

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

Apenas a 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 e com uma mensagem Não encontrado do lado direito da barra.

Use o botão Seguinte ou Anterior para saltar para a ocorrência anterior ou seguinte no documento.

Poderá escolher aqui se a pesquisa faz a distinção entre minúsculas e maiúsculas ou não. Se seleccionar a opção Corresponder à Capitalizaçã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 ícone da seta verde, à 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.

Use o botão Seguinte ou Anterior 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 se seleccionar as diferentes opções no fundo da barra. Se seleccionar a opção Distinguir a Capitalização irá limitar as pesquisas aos itens que correspondam, a nível de maiúsculas/minúsculas, a cada um dos caracteres no padrão de pesquisa. A opção Apenas a Selecção irá procurar e substituir apenas dentro da selecção actual. O botão Procurar Tudo irá realçar todas as ocorrências no documento e mostrar o número de ocorrências encontradas numa pequena janela.

Carregue no ícone da seta verde, à 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 &i18n-powermode;

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 &i18n-powermode;

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.