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

    lisiane@conectiva.com.br

Tradução

# Configurando o &kate;

## Visão geral

O &kate; oferece vários meios de configurar a aplicação para comportar-se como desejado. Os mais importantes são:

O Diálogo de Configuração

  A principal ferramenta de configuração, permitindo a você configurar a aplicação &kate;, o componente de edição e o uso de plugins.

O Menu Preferências

  Permite a você modificar preferências usadas com freqüência, e lançar os diálogos de configuração.

O Menu Visão

  Permite a você dividir o quadro atual, bem como exibir ícones e números de linha para o documento atualmente editado.

O &konsole; integrado está usando a configuração definida no &kcontrolcenter;, e pode ser configurado com o clique direito do mouse , e a escolha do sub-menu Preferências.

## O Diálogo de Configuração Principal

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 selecionado à direita.

A configuração está dividida em dois grupos, denominados

- Configuração da aplicação

- Configuração do componente de edição

## A Configuração da Aplicação &kate;

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

### A Página Geral

Esta seção contém algumas opções globais para o &kate;

Mostrar o Caminho Completo no Título

  Quando estiver ativa, o Kate irá mostrar a URL completa do seu documento atual na janela do título, em vez de exibir apenas o nome do arquivo.

Comportamento
  Sincronizar Konsole com o Documento Ativo

    Isto causará a integração do &konsole; ao comando `cd` dentro da pasta do documento ativo quando lançado, e quando um novo documento obter o foco. Se não estiver habilitado, você terá que fazer toda a sua navegação pelo &konsole; sozinho.

  Avisar sobre arquivos modificados por processos de fora

    Quando esta opção estiver ativa, o &kate; irá notificá-lo dos arquivos modificados fora da aplicação, sempre que a janela principal for colocada em primeiro plano. Você será então capaz de lidar com vários arquivos modificados de uma vez, os quais poderá recarregar, salvar ou descartar os arquivos alterados nos grupos.

    Se não estiver ativada, o &kate; irá perguntar-lhe a ação a tomar, quando um arquivo modificado externamente ficar em primeiro plano, dentro da aplicação.

Meta-Informação
  Manter meta-informação das sessões passadas

    Quando estiver ativa, o &kate; irá guardar alguns meta-dados, como a configuração dos favoritos e da sessão, mesmo quando fechar os seus documentos. Os dados serão usados, se o documento não estiver alterado, quando for aberto de novo.

  Remover meta-informações que não forem utilizadas após

    Indica o número máximo de dias durante os quais serão mantidas as meta-informações dos arquivos por abrir. Isto mantém a base de dados de meta-informação com um tamanho razoável.

### A Página de Sessões

Esta seção contém opções relacionadas com a utilização das sessões.

Elementos das Sessões
  Incluir configurações da janela

    Se estiver ativada esta opção, o &kate; irá salvar as configurações da janela com cada sessão.

Comportamento ao Iniciar o Aplicativo

  Selecione a forma como deseja que o &kate; se comporte na inicialização. Esta opção poderá ser substituída se especificar o que fazer na linha de comando.

  Iniciar uma nova sessão

    Com esta opção, o &kate; irá iniciar uma nova sessão sem nome, quando iniciar.

  Carregar a última sessão usada

    O &kate; irá usar a sessão mais recente na inicialização. Isto é bom se quiser usar a mesma sessão sempre ou raramente deseje mudar.

  Escolher manualmente uma sessão

    O &kate; irá mostrar uma pequena janela que lhe permite escolher a sua sessão preferida. Este é o comportamento padrão. Isso é bom se usar diversas sessões diferentes com frequência.

Comportamento ao Sair do Aplicativo ou Trocar de Sessão
  Não salvar a sessão

    As modificações dos dados da sessão (arquivos abertos e, se assinalado, a configuração da janela) não serão salvas. Você será avisado, claro, se tiver arquivos a serem salvos. Com esta opção, você poderá configurar as suas sessões uma vez; não se preocupe em fechar os arquivos extras que tiver aberto e não quiser ver da próxima vez que usar a sessão.

  Salvar Sessão

    O &kate; irá salvar os dados da sessão, exceto se a sessão não tiver nome. Com esta opção, as suas sessões são sempre restauradas, tal como as deixou. Este é o comportamento padrão.

  Perguntar ao usuário

    Será perguntado se deseja salvar a sessão sempre que uma sessão com nome for fechada.

### A Página do Navegador do Sistema de Arquivos

Barra de Ferramentas

  Configure os botões no navegador do sistema de arquivos, movendo os que deseja ativar para a lista de Ações Selecionadas e ordenando-os com as setas ao lado da lista.

Sincronização Automática

  Você poderá fazer com que o navegador do sistema de arquivos navegue automaticamente para a pasta que contém o documento atual no caso de certos eventos:

  - Quando um documento tornar-se ativo.

  - Quando o navegador do sistema de arquivos tornar-se visível.

  Mesmo que opte por não usar esta funcionalidade, você poderá sincronizar manualmente o navegador com o documento atual, clicando no botão da barra de ferramentas Sincronizar.
Lembrar das Localizações

  Selecione o tamanho que deseja manter para o histórico de navegação. O navegador só se recorda das localizações individuais, sendo que as duplicadas são removidas.

Lembrar dos Filtros

  Selecione quantos filtros deseja recordar. Só os filtros distintos individualmente serão recordados, sendo que os duplicados serão removidos.

Sessão

  Configure se o navegador do sistema de arquivos deverá recordar a sua localização e filtros para as outras sessões.

### A Página da Lista de Documentos

Habilitar Sombra

  Esta página permite-lhe ativar ou desativar a visualização sombreada do fundo da sua atividade recente e escolher as cores a usar, se estiver ativada. Veja a seção sobre a Lista de Documentos para mais dados sobre esta funcionalidade.

Ordenar Por

  Indique como deseja ordenar a lista de documentos. Isto também poderá ser feito, com o menu do &RMB;, na lista de documentos.

### A Página de Plugins

Esta página oferece uma lista de plugins instalados para a aplicação &kate;. Cada plugin é representado pelo seu nome e uma breve descrição. Você poderá assinalar a opção com um item para ativar o plugin que representa.

Se um plugin tiver opções de configuração, irá aparecer uma seção para acessá-las, como filha desta página.

### Ferramentas Externas

No menu Ferramentas, você poderá ver um submenu chamado Ferramentas Externas. Estas ferramentas invocam aplicações externas com dados relacionados com o documento atual, como por exemplo o seu URL, pasta, texto ou seleção. Esta página permite-lhe gerenciar o menu e editar, remover ou adicionar ferramentas.

Cada ferramenta externa é um comando de console que contém macros representando dos dados do documento. Quando estiver ativada, as macros são substituídas por dados do documento ativo.

#### Propriedades das Ferramentas Externas

Legenda

  Uma legenda amigável para o menu de Ferramentas Externas.

Programa

  O programa a executar quando a ferramenta estiver ativada. Antes de passar o programa à linha de comando, são substituídas as seguintes macros:

  %URL

    O URL completo do documento atual ou um texto vazio, se o documento não estiver salvo.

  %URLS

    Uma lista, separada por espaços, dos URLs de todos os documentos abertos (exceto os não-salvos).

  %directory

    A parte do diretório do URL do documento atual ou um texto vazio se o documento atual não estiver salvo.

  %filename

    O nome do arquivo do documento atual, sem o caminho completo, ou um texto vazio se o documento atual não estiver salvo.

  %line

    O número de linha onde o cursor de inserção se encontra no documento atual.

  %column

    O número da coluna onde o cursor de inserção se encontra no documento atual.

  %selection

    O texto selecionado no documento atual ou um texto vazio se não existir qualquer texto selecionado

  %text

    O texto completo do documento atual. Note que este texto poderá exceder potencialmente o comprimento máximo do comando no seu sistema. Use-o com cuidado.

Executável

  O executável principal no programa. Isto é obrigatório e é usado para testar se o comando poderá ser executado corretamente. É permitida uma localização absoluta, no caso do executável não se encontrar acessível através da sua variável `PATH`.

Tipos MIME

  Uma lista, separada por pontos-e-vírgulas, dos tipos MIME que estão ativos para este comando. Isto normalmente não é usado.

Salvar

  O usuário poderá, opcionalmente, optar por salvar o documento atual ou todos os documentos, antes de executar o programa. Isto é útil se o seu programa ler o arquivo do disco.

Nome da Linha de Comando

  Se você preencher isto, a ferramenta estará disponível na linha de comando dos editores como `exttool-Nome da Linha de Comando` (o texto que indicar aqui é antecedido por exttool-).

## A Configuração do Componente de Edição

Este grupo contém todas as páginas relacionadas com o componente de edição do &kate;. A maioria das configurações aqui são os valores pré-definidos, que podem ser substituídos ao definir um tipo de arquivo, nas Variáveis do Documento ou através da sua alteração, durante uma sessão de edição do documento.

### Aparência

Quebra de linhas
  Quebra de linha dinâmica

    Se esta opção estiver assinalada, as linhas de texto serão quebradas ao chegarem na borda da janela.

  Indicadores de quebra de linha dinâmica

    Escolha se deseja mostrar os indicadores de quebra de linha dinâmica.

  Alinhar verticalmente as mudanças de linhas dinâmicas à profundidade de indentação:

    Ativa o início das linhas repartidas com quebras de linha dinâmicas, de modo a ficarem alinhadas na vertical com o nível de indentação da primeira linha. Isto poderá ajudar a tornar o código e a formatação mais legíveis.

    Além disso, isto permite-lhe definir uma largura máxima da tela, como percentagem, após a qual as linhas repartidas de forma dinâmica não serão mais alinhadas na vertical. Por exemplo, a 50%, as linhas cujos níveis de indentação sejam mais profundas que 50% da largura da janela não terão qualquer alinhamento vertical aplicado às linhas repartidas subsequentes.

Dobragem do Código
  Mostrar as marcações de dobragem (se disponíveis)

    Se esta opção estiver assinalada, a janela atual irá mostrar marcações para dobrar ou desdobrar o código, se este estiver disponível.

Bordas
  Mostrar Borda do Ícone

    Se esta opção estiver assinalada, você verá uma borda para os ícones do lado esquerdo. A borda dos ícones mostra os sinais de favoritos, por exemplo.

  Mostrar o Número das Linhas

    Se esta opção estiver assinalada, você verá os números das linhas do lado esquerdo.

  Mostrar marcas na barra de posicionamento

    Se esta opção estiver assinalada, a janela atual mostrará algumas marcas na barra de posicionamento vertical. Estas marcas, por exemplo, poderão mostrar os favoritos.

Ordenar Menu de Favoritos

  Por Posição

    Os favoritos serão ordenados pelos números de linhas onde estão colocados.

  Por Criação

    Cada novo favorito será adicionado no fim, independentemente de onde se encontra colocado no documento.

Mostrar linhas de indentação

  Se esta opção estiver assinalada, o editor irá mostrar linhas verticais para ajudar a identificar as linhas de indentação.

### Fontes & Cores

Esta seção da janela permite-lhe configurar todas as fontes e cores de qualquer esquema de cores que tiver, assim como criar esquemas novos ou remover os existentes. Cada esquema tem a configuração das cores, fontes e estilos do texto normal e selecionado.

O &kate; irá selecionar previamente o esquema atualmente ativo para você; se quiser trabalhar sobre um esquema diferente, comece por selecioná-lo na lista Esquema.

#### Cores

Fundo da Área de Texto
  Texto normal

    Este é o fundo padrão para a área de edição, sendo a cor dominante da área do editor.

  Texto Selecionado

    Este é o fundo do texto selecionado. O valor padrão é a cor global de seleção, como está definida nas preferências de cores do &kde;.

  Linha Atual

    Define a cor da linha atual. Configurar esta cor um pouco diferente do fundo do Texto Normal irá ajudá-lo a concentrar-se na linha atual.

  Favoritos

    Esta lista permite-lhe sobrepor as cores dos vários tipos de marcações. A cor é misturada com a cor de fundo de uma linha marcada, para que uma linha com mais marcas ou a linha atual tenham um fundo que seja uma mistura de mais cores. As cores das marcações são também usadas se ativar a visualização das marcas na barra de posicionamento.

Elementos Adicionais
  Fundo da Borda Esquerda

    Esta cor é usada para as marcas, números de linhas e bordas das marcações de desdobramento do lado esquerdo da janela de edição, quando forem apresentados.

  Números de Linha

    Esta cor é usada para desenhar os números de linha do lado esquerdo da janela, quando estiverem visíveis.

  Realce de Parênteses

    Esta cor é usada para desenhar o fundo dos parênteses correspondentes.

  Marcadores de Quebra de Linha

    Esta cor é usada para desenhar um padrão à esquerda das linhas repartidas com quebra de linha, quando estiverem alinhadas na vertical, assim como para as marcações de quebras de linha estáticas.

  Marcadores de Tabulações

    Esta cor é usada para desenhar os indicadores de espaços em branco, quando estiverem ativos.

#### Fontes

Aqui, o usuário poderá escolher a fonte padrão para o esquema. Você pode escolher qualquer fonte disponível no seu sistema, assim como definir um tamanho padrão e uma codificação. Um texto de exemplo aparecerá na parte inferior da janela, para que você possa ver o resultado das suas opções.

#### Estilos de Texto Normal

Os estilos de texto normal são herdados pelos estilos de texto realçados, permitindo ao editor apresentar o texto de forma bastante consistente; por exemplo, o texto do comentário usa o mesmo estilo em quase todos os formatos de texto que o Kate consegue realçar.

O nome na lista de estilos está usando o estilo configurado para o item, oferecendo-lhe uma antevisão imediata ao configurar um estilo.

Cada estilo permite-lhe selecionar atributos comuns, assim como as cores do texto e do fundo. Para retirar uma cor de fundo, clique com o botão direito para usar o menu de contexto.

#### Estilos de Texto Realçado

Aqui você poderá editar os estilos de texto usados por uma definição de realce específica. O editor seleciona previamente o realce usado pelo seu documento atual. Para funcionar com um realce diferente, selecione um na lista Realce, acima da lista de estilos.

O nome na lista de estilos está usando o estilo configurado para o item, oferecendo-lhe uma antevisão imediata ao configurar um estilo.

Cada estilo permite-lhe selecionar os atributos comuns, assim como as cores de fundo e do texto. Para retirar uma cor de fundo, clique com o botão direito para usar o menu de contexto. Além disso, você poderá verificar se um estilo é igual ao pré-definido que for usado para o item, e configurá-lo como tal, se não estiver.

Você notará que vários realces contém outros realces, representados por grupos na lista de estilos. Por exemplo, a maioria dos realces implementam o realce Alert (Alerta) e muitos formatos de código importam o realce do Doxygen. A edição das cores destes grupos só afetará os estilos se forem usados no formato de realce editado.

### Cursor & Seleção

Movimento do Cursor de Texto
  Início inteligente

    Quando estiver selecionado, pressionar na tecla Home, fará com que o cursor salte os espaços em branco e vá para o início do texto de uma linha.

  Tecla de cursor muda de linha

    Quando estiver ativada esta opção, mover o cursor de inserção com as teclas Esquerda e Direita, irá para a linha anterior/seguinte no início/fim da linha, como acontece nos outros editores.

    Quando esta opção for selecionada, a movimentação do cursor com as teclas dos cursores além do fim da linha (à direita) faz com que o cursor mude para o início da próxima linha. Do mesmo modo, quando o cursor passar para trás do início de uma linha (à esquerda) salta para o fim da linha anterior. Quando esta linha não estiver selecionada, a movimentação do cursor para além do fim da linha simplesmente faz com que ele continue horizontalmente na mesma linha, assim como a movimentação para além do início da linha não fará nada.

  PageUp/PageDown move o Cursor

    Esta opção altera o comportamento do cursor quando o usuário pressionar as teclas Page Up ou Page Down. Se não estiver selecionada, o cursor do texto irá manter a sua posição relativa, dentro do texto visível no &kate;, à medida que vai ficando texto novo visível em resultado da operação. Como tal, se o cursor estiver no meio do texto visível, quando ocorrer a operação, irá permanecer nesse estado (exceto se atingir o início ou o fim.) Com esta opção selecionada, a primeira tecla fará com que o cursor se mova para o topo ou o fundo do texto visível, à medida que for apresentada uma página nova de texto.

  Centralizar o cursor automaticamente (linhas):

    Indica o número de linhas a manter visível acima e abaixo do cursor, sempre que possível.

Modo de Seleção
  Normal

    As seleções serão sobrepostas pelo texto escrito e serão perdidas com o movimento do cursor.

  Persistente

    As seleções manter-se-ão mesmo com a inserção de texto e a movimentação do cursor.

### Edição

Tabulações
  Inserir espaços ao invés de tabulações

    Quando isto estiver ativo, o editor irá inserir um número calculado de espaços, de acordo com a posição no texto e a configuração `tab-width`, quando pressionar a tecla TAB.

  Mostrar tabulações

    Quando esta opção estiver ativa, o &kate; irá mostrar um pequeno ponto como representação visual dos caracteres de tabulação.

    Isto fará também com que sejam desenhados pontos representando os espaços em branco. Isto será corrigido numa versão futura do &kate;

  Tabulação

    Se a opção Substituir Tabulações por Espaços estiver selecionada, este item define o número de espaços com os quais o editor irá substituir automaticamente as tabulações.

Quebra de Linha Estática

  A quebra de linha é uma funcionalidade que faz com que o editor inicie automaticamente uma nova linha de texto e mova (reparta) o cursor para o início dessa linha nova. O &kate; irá iniciar automaticamente uma linha de texto nova, quando a linha atual atingir o tamanho indicado na opção Quebrar Linha Em:.

  Habilitar quebra de linha estática

    Ativa ou desativa a quebra de linha estática.

  Mostrar marcadores de quebra de linha estática (se aplicável)

    Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna da quebra de linha, como está definido na opção Configurações Configurar Editor... na página de Edição. Lembre-se que o marcador de quebra de linha só é desenhado se você usar uma fonte monoespaçada.

  Quebrar linhas em:

    Se a opção de Mudança de Linha estiver selecionada, este item define o tamanho (em caracteres) com que o editor irá iniciar uma nova linha automaticamente.

Remover Espaços Finais

  O &kate; irá eliminar de forma automática os espaços adicionais no fim das linhas de texto.

Colchetes Automáticos

  Quando o usuário escrever um parênteses esquerdo ([, ( ou {), o &kate; irá introduzir automaticamente o parênteses direito (}, ) ou ]) à direita do cursor.

Máximo de passos do desfazer:

  Aqui o usuário poderá definir o número de passos que o &kate; irá reter em memória, com o objetivo de anular os ítens e ações. Isto significa que, quanto maior o número de passos, maior a quantidade de memória que o &kate; irá usar para tal. Se configurar este valor como 10, significa que o usuário será capaz de anular as últimas dez operações, i.e., pressionar o botão desfazer 10 vezes, obtendo os resultados correspondentes.

Procura inteligente de texto de:

  Isto determina de onde o &kate; irá obter o texto da procura (que será inserido automaticamente na janela para Procurar Texto):

  - Nenhum Local: Não irá adivinhar o texto de procura.

  - Somente Seleção: Usar a seleção do texto atual, se disponível.

  - Seleção, então Palavra Atual: Usar a seleção atual, se disponível, caso contrário usa a palavra atual.

  - Somente Palavra Atual: Usa a palavra sob o cursor, se disponível.

  - Palavra Atual, então Seleção: Usa a palavra atual, se disponível, caso contrário usa a seleção atual.

  Lembre-se que, nos modos acima, se não se conseguir determinar um texto de procura, então a janela para Procurar Texto irá usar o último texto de procura.

### Indentação

Indentação automática
  Modo de indentação:

    Selecione o modo de indentação automático que desejar usar por padrão. Recomenda-se que use o `Nenhum` ou o `Normal` aqui e usar as configurações do tipo de arquivo para definir outros modos de indentação para os formatos de texto, como o código em C/C++ ou o &XML;.

  Inserir um "*" inicial do Doxygen ao digitar

    Insere automaticamente um "*" inicial, enquanto digitar dentro de um comentário do tipo do Doxygen. Esta configuração só está ativa quando for aplicável.

Indentação com Espaços
  Usar espaços em vez de tabulações para indentar

    Isto substitui as tabulações pelo número de espaços definido no campo Número de espaços: abaixo.

  Modo misto, estilo Emacs

    Usa uma mistura de tabulações e espaços na indentação.

  Número de espaços:

    Defina o número de espaços que deseja usar na indentação, quando assinalar a opção Usar espaços em vez de tabulações para indentar.

Manter Perfil de Indentação

  Quando esta opção estiver ativa, o editor não irá remover mais a indentação das linhas de uma seleção, quando a linha com menor indentação ficar completamente sem indentação. Se algumas vezes retirar blocos de indentação no código, isto poderá ser útil.

Manter Espaços Extras

  As indentações com mais espaços que os selecionados não serão encolhidas.

Teclas a usar
  Tecla Tab identa

    Isto permite usar a tecla Tab para indentar.

  Tecla Backspace indenta

    Isto permite usar a tecla Backspace para indentar.

Modo da Tecla Tab Se Nada Estiver Selecionado
  Inserir caracteres de indentação

    Isto permite usar a tecla Tab para indentar.

  Inserir caracter de tabulação

    Isto permite usar a tecla Tab para indentar.

  Indentar a linha atual

    Isto permite usar a tecla Tab para indentar.

### Abrir & Salvar

Formato do Arquivo
  Codificação:

    Isto altera a codificação de caracteres do seu arquivo.

  Fim da linha:

    Escolha o seu fim de linha preferido para o seu documento ativo. Você poderá optar pelo padrão &UNIX;, DOS/&Windows; ou o Macintosh.

  Detecção automática de fim da linha

    Assinale isto se quiser que o editor detecte automaticamente o tipo de fim da linha. O primeiro tipo encontrado será o usado para todo o arquivo.

Uso da Memória
  Número máximo de blocos máximos carregados por arquivo:

    O editor irá carregar o número de blocos indicado (com cerca de 2048 linhas) com texto para a memória; se o tamanho do arquivo for maior que isto, os outros blocos são transferidos para o disco e carregados de forma transparente, conforme necessário.

    Isto poderá provocar alguns pequenos atrasos ao navegar no documento; um número de blocos maior aumenta a velocidade de edição com uma sobrecarga na memória.

    Para uma utilização normal, basta escolher o número de blocos maior que for possível: limite-o apenas se tiver problemas com o uso de memória.

Limpezas Automáticas ao Carregar/Salvar
  Remover espaços finais

    O editor irá eliminar automaticamente os espaços extras, no fim das linhas de texto, enquanto carrega/salva o arquivo.

Arquivo de Configuração de Pasta
  Profundidade da procura do arquivo de configuração:

    O editor irá procurar para cima, pelo número indicado de níveis da pasta, no arquivo de configuração do &kate;, e irá carregar a linha de configuração do mesmo.

Fazer Cópia de Segurança ao Salvar

  Criar cópia de segurança ao salvar, fará com que o &kate; copie o arquivo do disco para <prefixo><arquivo><sufixo>' antes de salvar as alterações. O sufixo é, por padrão, ~ e o prefixo está em branco, por padrão.

  Arquivos locais

    Assinale isto se quiser cópias de segurança dos arquivos locais ao salvar.

  Arquivos remotos

    Assinale isto se quiser cópias de segurança dos arquivos remotos ao salvar.

  Prefixo

    Indique o prefixo com que antecede os nomes das cópias de segurança.

  Sufixo

    Indique o sufixo com que termina os nomes das cópias de segurança.

### Realce

Este grupo de opções é usado para personalizar os estilos de realce para cada tipo de linguagem de programação. Todas as alterações que fizer nas outras áreas desta janela só irão se aplicar a este tipo.

Realce:

  Isto é usado para mudar o tipo de linguagem a configurar.

Informações

  Veja as propriedades das regras de realce da linguagem escolhida: nome do autor e licença.

Propriedades
  Extensões dos arquivos:

    Esta é a lista de extensões de arquivos, usadas para determinar os arquivos a realçar, com o modo de realce de sintaxe atual.

  Tipos MIME:

    Clicar no botão do assistente, irá mostrar uma janela com todos os tipos MIME disponíveis para seleção.

    O item das Extensões de Arquivos será também automaticamente editado.

  Prioridade:

    Indica a prioridade da regra de realce.

Obter...

  Clique neste botão para transferir descrições de realce de sintaxe novas ou atualizadas na página Web do &kate;.

### Tipos de Arquivos

Esta página permite-lhe substituir a configuração padrão dos documentos dos tipos MIME indicados. Quando o editor carregar um documento, ele verificará se o arquivo corresponde às máscaras de arquivos ou tipos MIME para cada um dos tipos definidos e, se corresponder, aplica as variáveis definidas. Se de um tipo de arquivo corresponder, será usado o que tiver maior prioridade.

Tipo de arquivo:

  O tipo de arquivo com a maior prioridade é o que será apresentado na primeira lista. Se forem encontrados mais tipos de arquivos, eles serão também listados.

  Novo

    Isto é usado para criar um novo tipo de arquivo. Após clicar este botão, os campos abaixo ficam em branco, para que você possa preencher as propriedades que deseja para o novo tipo de arquivo.

  Remover

    Para remover um tipo de arquivo existente, selecione-o na lista e clique no botão Remover.

Propriedades do tipo de arquivo atual

  O tipo de arquivo com a maior prioridade é o que será apresentado na primeira lista. Se forem encontrados mais tipos de arquivos, eles serão também listados.

  Nome:

    O nome do tipo de arquivo será o texto do item de menu correspondente. Este nome é mostrado no item Ferramentas Tipos de Arquivos

  Seção:

    O nome da seção é usado para organizar os tipos de arquivos em menus. Ele também é usado no menu Ferramentas Tipos de Arquivos .

  Variáveis:

    Este texto permite-lhe configurar as opções do &kate; para os arquivos selecionados por este tipo MIME, usando as variáveis do &kate;. Você poderá definir quase todas as opções de configuração, como o 'highlight', 'indent-mode', 'encoding', etc.

    Para uma lista completa das variáveis conhecidas, veja o manual.

  Extensões dos arquivos:

    As máscaras com caracteres especiais permitem-lhe selecionar arquivos pelo nome. Uma máscara típica usa um asterisco e a extensão do arquivo, como por exemplo `*.txt; *.text`. O texto é uma lista, separada por pontos-e-vírgulas, de máscaras.

  Tipos MIME:

    Inicia um assistente que o ajuda a escolher facilmente tipos MIME.

  Prioridade:

    Escolhe a prioridade deste tipo de arquivo. Se mais de um tipo de arquivo corresponder a um arquivo, será utilizado o com a prioridade mais elevada.

### Atalhos

Você poderá alterar aqui a configuração dos atalhos. Selecione uma ação e clique em Personalizado se quiser um atalho diferente para esta ação.

A linha de procura permite-lhe procurar por uma determinada ação e ver o seu atalho associado.

### Plugins

Esta página lista todos os plugins disponíveis e você poderá assinalar os que deseja usar. Assim que um plugin seja assinalado, o botão Configurar fica ativo e você poderá clicar nele para configurar o plugin selecionado.

## Configurando com as Variáveis do Documento

As variáveis do Kate são a implementação do 'katepart' para as variáveis do documento, de forma semelhante à que acontece no Emacs e no VI. Na 'katepart', as linhas têm o formato `kate: NOMEVARIÁVEL VALOR; [ NOMEVARIÁVEL VALOR; ... ]`; as linhas poderão estar, claro, num comentário, se o arquivo estiver num formato que suporte comentários. Os nomes das variáveis são palavras únicas (sem espaços) e tudo o que estiver até o próximo ponto-e-vírgula é o valor. Esse ponto-e-vírgula é obrigatório.

Aqui está uma linha de variável de exemplo, obrigando a configuração da indentação para um arquivo em C++, Java ou JavaScript:

    // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;

Só as primeiras e últimas 10 linhas serão pesquisadas pelas linhas de variáveis.

Existem variáveis para suportar quase todas as configurações no 'katepart', e os plugins adicionais podem usar as variáveis; nesse caso, isto deverá estar indicado na documentação do plugin.

### Como o kate utiliza as variáveis

Ao ler a configuração, o 'katepart' procura nos seguintes locais (nesta ordem):

- A configuração global.

- Os dados opcionais da sessão.

- A configuração do "Tipo de arquivo".

- As variáveis do próprio documento.

- As configurações feitas durante a edição do menu ou da linha de comando.

Como poderá compreender, as variáveis do documento têm a próxima precedência mais elevada. Sempre que um documento for salvo, as variáveis do documento são lidas novamente e irão sobrepor as alterações feitas, usando os ítens do menu ou nas linhas de comando.

Todas as variáveis que não estejam indicadas abaixo são guardadas no documento e poderão ser pesquisadas por outros objetos, como os plugins, usando-as para os seus próprios fins. Por exemplo, o modo de indentação variável usa as variáveis do documento para a sua própria configuração.

As variáveis aqui listadas dizem respeito ao &kate; versão 2.4. Poderão ser adicionadas mais variáveis no futuro. Existem 3 tipos de valores definidos para as variáveis, com as seguintes expressões válidas:

- BOOL - on|off|true|false|1|0

- INTEIRO - qualquer número inteiro

- TEXTO - todo o resto

#### Variáveis Disponíveis

    auto-bracketsBOOL

  Ativa ou desativa a inserção automática de parênteses.

    auto-center-linesINT

  Define o número de linhas centradas automaticamente.

    auto-insert-doxygenBOOL

  Ativa ou desativa a inserção do asterisco inicial nos comentários do 'doxygen'. Isto não tem efeito, a menos que você use o sistema de indentação do tipo do C.

    background-colorTEXTO

  Define a cor de fundo do documento. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo, "#ff0000".

    backspace-indentsBOOL

  Ativa ou desativa a indentação com o Backspace.

    block-selectionBOOL

  Ativa ou desativa a seleção em bloco.

    bracket-highlight-colorTEXTO

  Define a cor de realce dos parênteses. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000"

    current-line-colorTEXTO

  Define a cor da linha atual. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000".

    dynamic-word-wrapBOOL

  Ativa ou desativa a quebra de linha dinâmica.

    eol | end-of-lineTEXTO

  Define o modo de fim-de-linha. Os valores válidos são o unix, o mac e o dos

    encodingTEXTO

  Define a codificação do documento. O valor deverá ser um nome de codificação válido, como por exemplo utf-8.

    font-sizeINT

  Define o tamanho da fonte do documento.

    fontTEXTO

  Define o tipo de fonte do documento. O valor deverá ser um nome de fonte válido, como por exemplo courier.

    icon-bar-colorTEXTO

  Define a cor da barra de ícones. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    icon-borderBOOL

  Ativa ou desativa a visibilidade da borda dos ícones.

    folding-markersBOOL

  Ativa ou desativa a visualização dos marcadores de expansão/contração do código.

    indent-modeTEXTO

  Define o modo de indentação automática. As opções none, normal, cstyle, csands, python, xml são as reconhecidas, atualmente. Veja a seção para mais detalhes.

    indent-widthINT

  Define a largura de indentação.

    keep-extra-spacesBOOL

  Define se deseja manter os espaços extras ao calcular a largura de indentação.

    keep-indent-profileBOOL

  Se estiver ativada, evita a remoção da indentação de um bloco se, pelo menos, uma linha não tiver indentação.

    line-numbersBOOL

  Ativa ou desativa a visibilidade dos números de linha.

    mixed-indentBOOL

  Ativa ou desativa a indentação mista no estilo Emacs.

    overwrite-modeBOOL

  Ativa ou desativa o modo de sobreposição.

    persistent-selectionBOOL

  Liga/desliga as seleções persistentes.

    remove-trailing-spaceBOOL

  Ativa ou desativa a limpeza dinâmica dos fins-de-linha.

    replace-tabs-saveBOOL

  Ativa ou desativa a conversão de tabulações para espaços no salvamento.

    replace-tabsBOOL

  Ativa ou desativa a conversão dinâmica de tabulações para espaços no salvamento.

    replace-trailing-space-saveBOOL

  Ativa ou desativa a limpeza dos fins-de-linha no salvamento.

    schemeTEXTO

  Define o esquema de cores. O texto deverá ser o nome de um esquema de cores que exista na sua configuração, para que faça qualquer efeito.

    selection-colorTEXTO

  Define a cor da seleção. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000".

    show-tabsBOOL

  Ativa ou desativa o caracter TAB visível.

    smart-homeBOOL

  Ativa ou desativa a navegação inteligente do Home.

    space-indentBOOL

  Ativa ou desativa a indentação com espaços.

    tab-indentsBOOL

  Ativa ou desativa a indentação com tabulações.

    tab-widthINT

  Define a largura das tabulações.

    undo-stepsINT

  Define o número de passos a recordar no Desfazer/Refazer.

    word-wrap-columnINT

  Define a largura da quebra de linha para as palavras.

    word-wrap-marker-colorTEXTO

  Define a cor do marcador de quebra de linha. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000".

    word-wrapBOOL

  Ativa ou desativa a quebra de linha das palavras.

    wrap-cursorBOOL

  Ativa ou desativa a envolvência do cursor.