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

    lisiane@conectiva.com.br

Tradução

# Trabalhando com o Editor &kappname;

## Visão geral

O editor &kappname; é a área de edição da janela do &kappname;. Este editor também é usado pelo &kate; e pelo &kwrite;, e ele pode também 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.

Painel 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 o texto

- Procurando e substituindo texto

- Usando os favoritos

- Quebra de Texto Automática

- Usando o recuo automático

## Navegando no Texto

A movimentação pelo texto no &kappname; é 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 &PgUp;, &PgDn;, 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 &Up;e &Down;, isto significa deslocar o cursor, em vez de movê-lo.

- Para as teclas &Left; e &Right;, isto significa saltar as palavras em vez de simples caracteres.

- Para as teclas &PgUp; e &PgDn;, 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 &kappname; 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 &kappname;: 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, deste essa seleção até a posição do ponteiro 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 teclas de navegação (as setas, &PgUp;, &PgDn;, 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 Desmarcar a seleção atual, use o item de menu Editar Desmarcar ou o atalho de teclado (o padrão é &Ctrl;&Shift;A), ou clique com o &LMB; no editor.

### Usando a Seleção de Blocos

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 tabulações, 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 significa 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 desmarcada.

## 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 &MMB; 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 Pesquisar e Substituir

O &kappname; 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 pesquisa. A interpretação da string depende de algumas das opções escritas a seguir.

Diferenciar maiúsculas de minúsculas

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

Procura apenas na área selecionada

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

Procurar todos

  Ao clicar neste botão, serão realçadas todas as ocorrências no documento e será mostrado o número de ocorrências encontradas numa pequena área.

### 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 botão com í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 os 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.

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

As correspondências no documento são realçadas mesmo quando você fecha a barra de pesquisa. Para limpar este realce, pressione a tecla &Esc;.

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

Clique 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 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 botão com um ícone para fechar a barra, seguido de um pequeno menu suspenso para inserir o padrão de pesquisa. O menu se lembra dos padrões recentemente usados.

Você poderá controlar o modo de pesquisa selecionando as opções Texto simples, Palavras completas, Sequências de escape ou Expressão regular da caixa suspensa.

Se Sequências de escape ou Expressão regular estiver selecionado, o item de menu Adicionar... na base do menu de contexto de caixas de texto será habilitado e lhe permitirá adicionar sequências de escape ou expressões regulares para pesquisa ou substituição de padrões a partir de listas pré-definidas.

Use os botões or para ir para a ocorrência anterior ou seguinte 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 da substituição ao selecionar as diferentes opções no lado direito da barra. Se selecionar 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 irá procurar e substituir apenas dentro do texto selecionado no momento. A opção Procurar tudo realça todas as ocorrências no documento e mostra o número de correspondências encontradas em uma pequena janela de contexto.

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

Se 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 subpadrões da expressão, com parênteses.

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

Você poderá `procurar`, `substituir` e `procurar de forma incremental` na linha de comando.

## Usando os 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 (&Alt;&PgDn;) ou Favoritos Anterior (&Alt;&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á corrigido em versões futuras do &kappname;.

## Usando o recuo automático

O componente de edição do &kappname; 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 Formatar recuo, 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 arquivo.

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

Estilo XML

  Um sistema de recuo específico para linguagens semelhantes ao XML.

## Indicadores de modificação de linhas

Os indicadores de modificação de linhas do &kappname; permitem-lhe ver facilmente o que você alterou recentemente em um arquivo. Por padrão, 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 de linhas em ação.

Você poderá alterar as cores usadas no painel de configuração das Cores & Fontes ou poderá desativar esta funcionalidade por completo na página Bordas do painel de configuração da Aparência.

## O minimapa na barra de rolagem

O minimapa na barra de rolagem exibe uma miniatura dos documentos no local da barra de rolagem. A parte visível do documento será realçada.

O minimapa na barra de rolagem mostra uma miniatura do código-fonte do &kate;.

Você pode ativar ou desativar o minimapa temporariamente selecionando Exibir Mostrar minimapa na barra de rolagem ou de forma permanente na seção Aparência, da configuração do &kappname;.

## Cursores múltiplos

O suporte a múltiplos cursores foi introduzido na versão 5.93 do katepart.

### Criando cursores múltiplos

- Para criá-los com o mouse, use &Alt; + &LMB;. O modificador é configurável. Consulte Configurar modificador multicursor

- Para criar usando o teclado, pressione &Ctrl;&Alt;&Up; para criar o cursor acima do cursor principal e &Ctrl;&Alt;&Down; para criar o cursor abaixo. Esses atalhos também são configuráveis

- Para criar cursores a partir de uma seleção, primeiro selecione algum texto e pressione &Shift;&Alt;I. Isso criará um cursor no final de cada linha da seleção.

- Use &Alt;J para encontrar a próxima ocorrência da palavra sob o cursor e selecioná-la + criar um cursor. Se quiser pular a palavra atual sob o cursor, pressione &Alt;K e a palavra selecionada será marcada como pulada. Ao pressionar &Alt;J novamente, a palavra atual será desmarcada e o cursor passará para a próxima palavra.

- Use &Ctrl;&Alt;&Shift;J para encontrar todas as ocorrências da palavra sob o cursor e selecioná-las com o cursor no final de cada seleção. Você pode usar &Alt;J para percorrer as palavras selecionadas e usar &Alt;K para desmarcar qualquer palavra, como mencionado no parágrafo anterior.

### Trabalhando com cursores múltiplos

Depois de criar alguns cursores, você pode realizar a maioria das operações de edição neles como faria em um único cursor. Por exemplo, digitar uma letra a digitará para cada cursor. Da mesma forma, você pode realizar transformações de texto &eg;, capitalização para todas as posições ou seleções.

Às vezes, você desejará remover os cursores. Para isso, você pode usar &Alt; + &LMB; no cursor que deseja remover. Se você quiser remover os cursores apenas em linhas vazias, existe uma ação pronta para isso para você. Para invocar a ação, abra a barra de comandos usando &Ctrl;&Alt;I e procure por Remover cursores de linhas vazias e pressione &Enter;. Você também pode configurar um atalho para esta ação.