# Configurar o &kate;

## Introdução

O &kate; ofecere várias formas de equipar a aplicação para que se comporte como desejado. As mais importantes são:

A Janela de Configuração

- A ferramenta de configuração principal, que te permite configurar a aplicação &kate;, o componente do editor e a utilização de 'plugins'.

O Menu Configuração

- Permite-te alterar as opções mais usadas e lançar as janelas de configuração.

O Menu Ver

- Permite-te repartir a janela actual, assim como mostrar a barra de ícones e de números de linha para o documento actual.

O Konsole embutido usa a configuração definida no Centro de Controlo, e pode ser configurado carregando no botão direito do rato e seleccionando no sub-menu Configuração.

## A Janela Principal de Configuração

A janela de configuração do &kate; mostra uma árvore com os tópicos à esquerda, bem como uma página de configuração correspondente ao tópico seleccionado à direita. A árvore agrupa as páginas da janela em grupos lógicos.

### O grupo do &kate;

Este grupo contém páginas para configurar a aplicação principal do &kate;

#### A Página Geral

Opções globais do &kate;

Modo da Aplicação

- Este grupo permite-te escolher entre o modo MDI do &kate; e o modo SDI, seleccionando o botão apropriado.

  O modo do &kate; MDI (Multiple Document Interface), o qual é o modo por omissão, permite ao &kate; usar uma janela para todos os ficheiros abertos. Podes escolher o documento a editar na Lista de Ficheiros (acoplada na janela do &kate; à esquerda por omissão) ou seleccionando o documento no menu Documento.

  O modo SDI (Single Document Interface) fará com que o &kate; abra cada documento numa janela própria e, nesse caso, a Lista de Ficheiros/Selector de Ficheiros terá uma janela separada.

  Se alterares esta opção, terás de reiniciar o &kate; para que faça efeito.

No Arranque

- Estas opções determinam como e se o &kate; irá recuperar a tua sessão de edição ao ser lançado após uma saída normal do sistema (se for recuperada pelo gestor de sessões, o &kate; irá tentar sempre recuperar a tua sessão, tanto quanto possível, como tinhas quando usaste o &kate; pela última vez).

  Reabrir os Ficheiros

- Se esta opção estiver activa, os ficheiros abertos desde que fechaste o &kate; serão reabertos. Os Favoritos serão recuperados e a posição do cursor, o contorno do ícone e a configuração dos números de linha do último editor usados com o documento serão restabelecidos

Restaurar a Configuração da Janela

- Se esta opção estiver activa, o &kate; irá tentar recuperar as tuas janelas tal como as deixaste.

Restringir a uma só instância

- Se activares isto, significa que só podes ter uma instância do &kate; em execução a qualquer altura. Se tentares iniciar outra, a instância actual sobrepor-se-á e irá abrir os ficheiros pedidos. Por exemplo, se usares o &kate; para abrires código-fonte em páginas Web no &konqueror;, elas serão todas abertas numa instância existente do &kate; se esta opção estiver disponível.

Mostrar conteúdo ao redimensionar janelas

- Se esta opção estiver activa, as janelas serão redesenhadas por completo enquanto arrastas os separadores de janelas. Uma maneira bonita de usar alguns ciclos de CPU extra :). Se estiver desligada, será mostrada apenas uma banda (que indica o novo tamanho da janela) em alternativa.

Sincronizar o Konsole com o Documento Actual

- Isto fará com que o &konsole; embutido faça `cd` para a directoria do documento activo quando for lançado e de cada vez que um novo documento passa para primeiro plano. Se não estiver activo, tens de efectuar a tua navegação no &konsole; por ti próprio

Número de Ficheiros Recentes

- Sem surpresas, isto permite-te decidir quanto deve crescer o menu Abrir Recente.

### O Grupo Editor

Este grupo contém todas as páginas relacionadas com o componente de editor do &kate;

#### A Página Cores

Esta página permite-te alterar as cores do texto e do fundo do editor. Inicialmente, o &kate; irá usar as cores definidas no &kcontrolcenter;, na sua página Aparência e Comportamento Cores .

Para mudares uma cor, carrega no botão associado e selecciona a cor desejada no seu selector respectivo.

Ao escolheres a cor de fundo podes tornar o texto com a sintaxe realçada ilegível. Deves escolher uma cor clara para o fundo e uma cor escura para o fundo.

Caso contrário, poderás necessitar de alterar os Estilos por Omissão.

#### A Página Tipos de Letra

Esta página permite escolher os tipos de letra por omissão do &kate;. A configuração será também usada para o &kwrite; e para ver os ficheiros de texto no &konqueror;.

A página apresenta duas secções, uma para o tipo de letra do editor e outra para o tipo de letra da impressão. Selecciona uma página e escolhe o tipo de letra desejado. Por omissão, é utilizado o tipo de letra monoespaçado global do &kde;.

Dado que não é possível de momento usar tipos de letra individuais para os documentos, nem é permitido alterar o tipo de letra da impressão na janela de impressão, tem cuidado. Recomenda-se um tipo de letra monoespaçado.

#### A Página Indentar

Esta página permite-te alterar o comportamento da indentação.

#### Opções de Indentação

Auto-indentar

- se estiver activa, o &kate; irá indentar as linhas novas como a anterior. Se a linha anterior estiver em branco, é usada a linha anterior que tiver texto.

Indentar com Espaços

- Se estiver seleccionada, o &kate; irá indentar com espaços em vez de tabulações.

Indentação com Backspace

- Se isto estiver seleccionado, o &kate; irá desfazer a indentação de uma forma igual à linha não-vazia anterior quando carregares na tecla Backspace se a parte da linha que precede o cursor só contiver espaços.

Indentação com Tab

- Se isto estiver seleccionado, o &kate; irá tentar indentar a linha actual da mesma forma que a linha não-vazia anterior quando carregares na tecla Tab, se a componente da linha que precede o cursor só conter espaços.

Manter espaços extra

- Com este comportamento seleccionado, o &kate; irá deixar os espaços em branco por trás do cursor após a indentação.

#### A Página Seleccionar

Esta página oferece opções para afinar o comportamento da selecção do &kate;

#### Opções da Selecção

Selecções Persistentes

- Quando as Selecções Persistentes estão activas, a introdução de caracteres não provoca a diminuição/remoção da selecção.

  Esta opção entra parcialmente em conflito com a opção Substituir Selecções. Se ambas estiverem seleccionadas, a colagem de texto ou o pressionar de outras teclas sem serem os cursores fará com que a selecção seja substituída.

Substituir Selecções

- Se isto estiver seleccionado, toda a introdução de texto, quer escrito quer colado, fará com que o texto seleccionado seja apagado e substituído pelo texto inserido.

#### A Página Editar

Esta página contém opções diversas para ajustar o comportamento da componente do editor &kate;.

#### Opções do Editor

Mudança de Linha

- A opção Mudança de Linha significa que o texto é formatado dinamicamente através da quebra de linhas a partir de um local apropriado, em vez da mudança normal de linha, para uma leitura mais fácil.

  Se estiver activo, o &kate; irá inserir uma quebra de linha tal como está definido na opção Fim de Linha para o documento quando a linha ultrapassa o tamanho definido em Mudar Palavras em descrita em baixo.

Mudar Palavras Em

- Esta opção decide o tamanho máximo das linhas se a opção Mudar de Linha estiver activa.

Substituir Tabs por Espaços

- Se estiver activa, o &kate; irá substituir os caracteres Tab introduzidos por um número conveniente de espaços, tal como definido na Tabulação.

Remover espaços finais

- Se estiver activo, o &kate; irá remover os espaços em branco no fim de cada linha, de cada vez que o cursor passa para lá do seu fim.

Tabulação

- Define o tamanho da tabulação, o qual também é usado para definir o tamanho da indentação quando a opção Auto-Indentar está activa ou a indentação é chamada explicitamente.

  Dependendo da configuração da página Indentar, a indentação pode ser efectuada através do carregar das teclas Tab e Backspace. Activando a opção do menu Editar Indentar causa o mesmo efeito.

Parêntesis Automáticos

- Se isto estiver seleccionado, o &kate; irá tentar inserir um parêntesis direito imediatamente à direita do cursor quando é introduzido um parêntesis esquerdo pelo utilizador. Os tipos de parêntesis suportados são o (, o {, o [ e o <

Agrupar as anulações

- Se estiver activo, o &kate; irá agrupar as acções de edição semelhantes (como por exemplo a escrita, o apagar de caracteres ou a colagem) como um registo só no histórico do 'desfazer', de modo a que possam ser efectuadas as anulações de uma vez.

Mostrar Tabs

- Se a opção estiver activa, o &kate; irá desenhar um pequeno ponto no início de um carácter Tab no editor para indicar a sua presença.

Início Inteligente

- Isto fará com que o &kate; mova o cursor para o primeiro carácter válido da linha actual em vez de ir para a primeira coluna da linha, quando se carrega na tecla Home (ou em qualquer outra tecla atribuída a essa função).

Mudar o Cursor

- Se estiver activo, ao moveres o cursor para lá do fim de uma linha fará com que ele continue na linha anterior/seguinte, se existir.

  Se não estiver activo, o cursor não pode ser movido para o início da linha, mas pode ser movido para lá do fim da mesma e, quando o texto é introduzido, o &kate; irá inserir automaticamente espaços em branco até essa posição, o que pode ser útil para os programadores, por exemplo, em algumas situações.

#### A Página Teclado

Aqui podes configurar os atalhos de teclado para os comandos internos da componente de editor do &kate;. Isto inclui os comandos para percorrer o documento e seleccionar texto. Para as teclas usadas para copiar e colar texto, vê a janela Configurar Teclas

Podes alterar as teclas para um comando ou adicionar uma tecla alternativa.

#### Para alterar a(s) tecla(s) para um comando, segue este procedimento:

1. Selecciona o comando para o qual queres configurar as teclas.

2. Escolhe a opção Nenhuma na área por baixo da lista se não quiseres uma tecla para este comando.

   Escolhe a opção Predefinida para usares a(s) tecla(s) por omissão para o comando

   Seleccione a opção Personalizada para escolher uma tecla personalizada para o comando ou definir uma alternativa.

3. Se escolheu a opção Personalizada, o botão da tecla à direita ficará activo. Para alterar uma tecla, carregue nela. A Janela de Definição do Atalho irá aparecer. Nesta janela:

4. 1. Escolhe se queres alterar a tecla por omissão ou a alternativa. A Primária não significa que alteras a tecla por omissão, simplesmente ela altera a tecla personalizada respectiva.

   2. Carrega na sequência de teclas desejada; esta será visualizada por ti na janela para tu confirmares.

      Se tiver uma natureza aventureira, tente brincar com a opção Multi-tecla. Ao usá-la poderá usar sequências semelhantes às do &Emacs; (uma indica o grupo, a outra executa a acção), à parte do facto que, em vez de desempenhar apenas a tarefa, o &kde; irá mostrar um menu para escolher num local indefinido e às vezes inapropriado. Agora não terá dúvidas que, enquanto carregar a próxima tecla da sequência, irá funcionar, ou então terá de indicar o acelerador do menu (ambos funcionarão).

#### A Página Correcção Ortográfica

Esta página permite-te configurar como o &kspell; se comporta com o &kate;

#### A Página de Realce

Esta página permite-te ajustar a cor e a selecção do tipo de sintaxe do &kate;

Para uma informação mais detalhada acerca do sistema de realce de sintaxe, vê ??

A página consiste em duas secções, uma para definir os Estilos por omissão e outra para gerir os Modos de Realce. Ambas as secções mostram uma lista de contextos nos quais as cores e tipos de letra por omissão são usados para visualizar a aparência de cada estilo. O nome do contexto é desenhado com as propriedades actuais do contexto.

A lista tem quatro ou cinco colunas, cada uma com o seguinte fim:

Contexto

- Mostra o nome do contexto, desenhado com as propriedades do estilo para o contexto.

Negrito

- O estado desta opção decide se o contexto deve ser desenhado com um tipo de letra negrito (mais carregado).

Itálico

- O estado desta opção decide se o contexto deve ser desenhado com um tipo de letra itálico.

Normal

- Este botão mostra a cor para desenhar o estilo no modo normal, isto é, quando não está seleccionado. Para alterares a cor, carrega no botão.

Seleccionado

- Este botão mostra a cor para desenhar o estilo quando o texto está seleccionado. Para alterares a cor, carrega no botão.

Usar Estilo Predefinido

- Esta opção, só disponível na página Highlight Modes, mostra se o estilo está a usar os seus valores por omissão. Ficará automaticamente deseleccionada se mudares alguma propriedade do estilo. Selecciona-a para repor um estilo para os seus valores predefinidos.

##### A Página Estilos Predefinidos

Para alterares algum dos estilos por omissão, define as suas propriedades para o valor desejado.

##### A Página Modos de Realce

Aqui podes alterar as propriedades mais importantes de cada modo de realce disponível. Primeiro, usa a lista Realce para escolheres um modo no qual trabalhar.

Os modos de realce são seleccionados inicialmente com base no tipo &MIME; e na extensão do ficheiro. Para mudares a lista para a selecção actual, edita os campo Extensões do Ficheiro e Tipos MIME. Em alternativa, carrega no botão de assistência à direita do campo Tipos MIME. Isto irá mostrar uma janela que apresenta todos os tipos &MIME; a partir dos quais poderás escolher. Se usares essa janela irás editar os tipos &MIME; assim como as extensões dos ficheiros.

A janela de selecção de tipos &MIME; mostra uma árvore com todos os tipos &MIME;, com uma descrição e os padrões para o tipo &MIME;. Para incluires um tipo &MIME;, assinala a opção por baixo dele.

Podes alterar as propriedades do estilo de qualquer contexto tal como descrito em cima.

À direita da secção, por baixo das propriedades do realce, podes ver um botão chamado Obter. Se carregares nele, será efectuada uma ligação ao 'site' do &kate; para obteres uma lista com os modos de sintaxe disponíveis para poderes efectuar a sua actualização.

### O Grupo 'Plugins'

Este grupo contém as páginas referentes aos 'plugins'. Para além da página de configuração do Gestor, alguns dos 'plugins' disponibilizam opções de configuração individuais. Para mais informação sobre estas, vê a documentação para os 'plugins' individuais.

#### A Página do Gestor de 'Plugins'

Esta página disponibiliza os meios para activar/desactivar 'plugins', bem como informações mínimas sobre os 'plugins' individualmente.

Para carregares um 'plugin' inactivo, selecciona-o na lista 'Plugins' Disponíveis e usa as teclas das setas para o moveres para os 'Plugins' Carregados.

Para desactivar um 'plugin' activo, seleccione-o na lista 'Plugins' Carregados e utilize as setas para os mover para a lista de 'Plugins' Disponíveis.

Para veres uma descrição mínima e as informações sobre um 'plugin', selecciona-o para que a informação fique disponível por baixo das listas.