&Anders.Lund; &Anders.Lund.mail;
&Dominik.Haumann; &Dominik.Haumann.mail;
Lisiane
Sztoltz

    lisiane@conectiva.com.br

Tradução

# 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 o recuo automático

## 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 outro aplicativo para o 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 Modo de Seleção de Bloco. O atalho padrão no teclado é &Ctrl;&Shift;B.

### 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 Cursor & Seleção 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 CUrsor & Seleção 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 aplicativo, usando o ícone do &klipper; na área de notificação.

## Procurando e Substituindo Texto

### As Barras para Procurar e Substituir

O &kate; possui uma barra de pesquisa incremental e uma barra avançada de pesquisa e substituição, que possibilita a inserção de um texto de substituição, juntamente com algumas opções adicionais.

As barras oferecem as seguintes opções comuns:

Procurar

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

Realçar tudo

  Se estiver ativo, todas as ocorrências em todo o documento ficam realçadas.

Corresponder capitalização

  Se estiver ativo, 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 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.

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 selecionado, 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 caracter visível ou um final de linha.

Sequências de Escape

  Se estiver selecionada, o botão Adicionar no topo de menu de contexto das caixas de texto ficará ativo permitindo que você adicione sequências de escape para o padrão de pesquisa, usando uma lista pré-definida.

Expressão regular

  Se estiver assinalada, o texto a procurar é interpretado como uma expressão regular. O botão Adicionar no topo do menu de contexto das caixas de texto ficará ativo permitindo que você crie itens de expressão regular para o padrão de pesquisa, usando como base uma lista pré-definida.

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

Apenas a seleção

  Se estiver selecionada, a pesquisa e substituição será feita apenas sobre o texto selecionado.

### Procurando 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 inserir o padrão a pesquisar.

Quando você começar a inserir caracteres no seu padrão de pesquisa, a busca inicia imediatamente. Se existir uma ocorrência no texto, ela 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 Próximo ou Anterior para saltar para a próxima ocorrência ou a anterior no documento.

Você poderá modificar o comportamento da pesquisa selecionando as diferentes Opções que estão descritas acima.

Clique 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 existir alguma e sem ter que invocar a barra de pesquisa incremental, use a opção F3 Editar Procurar Próximo ou &Shift;F3 Editar Procurar Anterior.

### Substituindo 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 inserir o padrão de pesquisa.

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

Use o botão Próximo ou Anterior para saltar para a próxima ocorrência ou a anterior no documento.

Insira o texto de substituição no campo de texto Substituir e clique no botão Substituir, para substituir apenas o texto realçado, ou o botão Substituir Tudo para substituir o texto de pesquisa em todo o documento.

Você poderá modificar o comportamento da pesquisa e substituição selecionando as diferentes opções do lado direito da barra.

Clique no ícone da seta verde, à direita da barra avançada de pesquisa e substituição, para mudar para a barra de pesquisa incremental.

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 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 Definir 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; PgDown) ou Favoritos Anterior (&Ctrl;PgUp ).

## 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 Estática 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 o recuo automático

O componente de edição do &kate; suporta uma variedade de modos de recuo automático, desenhado para os diferentes formatos de texto. Você poderá escolhê-los, entre os modos disponíveis, com a opção Ferramentas Recuar. Os módulos de recuo automático também oferecem uma função Ferramentas Alinhamento, que irá calcular novamente o recuo da linha atual ou a selecionada. Assim, você poderá mudar o recuo do seu documento inteiro, selecionando o texto e ativando essa opção.

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

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

### Modos de recuo automático disponíveis

Nenhum

  Se selecionar este modo, irá desativar o recuo automático.

Normal

  Este sistema de recuo simplesmente mantém o recuo semelhante ao 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 recuo e remoção de recuo, para poder recuar de acordo com a sua vontade.

Estilo C

  Um sistema de recuo 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 recuo específico para a linguagem de programação Haskell.

Lilypond

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

Lisp

  Um sistema de recuo específico para a linguagem de programação Lisp e respectivos dialetos.

Python

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