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

    jncp@netcabo.pt

Tradução

# 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 seu computador local ou da 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 botão esquerdo rato 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

- Utilizar a indentação automática

## Navegar no Texto

A movimentação pelo texto no &kate; é como na maioria dos editores de texto gráficos. O utilizador 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 selecção, enquanto a tecla Ctrl pode ter efeitos diferentes nas diferentes 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 &kate; também lhe oferece uma forma de saltar rapidamente para um parêntesis correspondente: Coloque o cursor no interior de um parêntesis e carregue em Ctrl 6 para saltar para o parêntesis 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 texto no &kate;: com o rato e com o teclado.

Para seleccionar com o rato, mantenha pressionado o botão esquerdo do rato 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 do 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 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, 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 a Página Seleccionar 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 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 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 &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.

A partir do cursor

  Se estiver seleccionada, a pesquisa irá começar a partir da posição do cursor, caso contrário irá ter início na primeira linha do documento.

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 irá introduzir o texto de substituição.

Texto Seleccionado

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

  Sim

    Active isto para substituir a ocorrência actual (a que está seleccionada no editor).

  Não

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

  Tudo

    Active para cancelar a pergunta e substituir todas as ocorrências.

  Fechar

    Active isto para ignorar a ocorrência actual e terminar 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 procurar texto, lance a janela Procurar Texto com o &Ctrl;F ou na opção do menu Editar Procurar..., indique o texto a procurar, seleccione as opções desejadas e carregue em OK. Se a pesquisa for iniciada na posição do cursor e não forem encontradas ocorrências, antes de atingir o fim (ou o início, se estiver a procurar para trás) do documento, ser-lhe-á perguntado se deseja dar a volta à procura.

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

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

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

### Substituir Texto

Para substituir texto, lance a janela Substituir Texto com a opção do menu Editar Substituir ou com o atalho &Ctrl;R, indique o texto a procurar e, opcionalmente, o texto de substituição (se este estiver em branco, cada ocorrência será removida), defina as opções desejadas e carregue 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.

Poderá `procurar`, `substituir` e `procurar de forma 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 Comutar o 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 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;

## Utilizar a indentação automática

O componente de edição do &kate; suporta uma variedade de modos de auto-indentação, desenhado para os diferentes formatos de texto. Você poderá escolhê-los, entre os modos disponíveis, com a opção Ferramentas Indentação. Os módulos de indentação automática também oferecem uma função Ferramentas Alinhamento, que irá calcular de novo a indentação da linha actual ou a seleccionada. Como tal, poderá mudar a indentação do seu documento inteiro, seleccionando o texto e activando essa opçã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.

Estilo C SS

  Um sistema de indentação alternativa para o C e as linguagens do género, com as mesmas restrições.

Estilo Python

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

XML

  Um sistema de indentação automática de XML muito bom. Embora seja tentador, não o tente usar com as variantes de HTML que não sejam o XHTML, dado que não funciona com as marcas antigas do HTML (as marcas em aberto, como por exemplo o <br>)

Sistema de Indentação Variável

  Este sistema é experimental e poderá mudar o comportamento ou desaparecer nas versões futuras.

  O sistema de indentação variável é especial, na medida em que poderá ser configurado através de variáveis no documento (ou com uma configuração por tipo de ficheiro). São lidas as seguintes variáveis:

  var-indent-indent-after

    Uma expressão regular que fará com que uma linha seja indentada de uma unidade, se a primeira linha, não sendo composta apenas por espaços em branco, fizer correspondência. var-indent-indent: Uma expressão regular que fará com que uma linha correspondente a ela seja indentada de uma unidade.

  var-indent-unindent

    Uma expressão regular que fará com que a linha reduza a indentação de uma unidade, se fizer correspondência.

  var-indent-triggerchars

    Uma lista de caracteres que deverá fazer com que a indentação seja calculada de novo imediatamente, quando estes forem escritos.

  var-indent-handle-couples

    Uma lista de conjuntos de parêntesis para tratar. Pode ser qualquer combinação de parêntesis normais, rectos e chavetas. Cada tipo de conjunto é lidado da seguinte forma: se existirem instâncias abertas na linha acima, será adicionada uma unidade de indentação, enquanto se existirem instâncias de fecho não correspondidas, é removida uma unidade de indentação.

  `var-indent-couple-attribute`

    Ao procurar pelos pares de parêntesis, só são considerados os caracteres com este atributo. O valor deverá ser o nome do atributo no ficheiro XML da sintaxe, como por exemplo "Symbol". Se não for indicado, é usado o atributo 0 (normalmente o 'Normal Text').