&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 o aplicativo 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 o aplicativo &kate;, o componente de edição e o uso de plug-ins.

O Menu Preferências

  Permite a você modificar preferências usadas com frequê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 terminal integrado está usando a configuração definida nas configurações do sistema, e pode ser configurado usando o clique direito do mouse para acessar o menu de contexto.

## 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 do aplicativo

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

## A configuração do aplicativo &kate;

Este grupo contém páginas para se configurar o aplicativo principal do &kate;

### A Página Geral

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

Comportamento
  Avisar sobre arquivos modificados por processos de fora

    Quando esta opção estiver ativa, o &kate; irá notificá-lo dos arquivos modificados fora do aplicativo, 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 do aplicativo.

Meta informações
  Manter meta informações de sessões passadas

    Quando estiver ativa, o &kate; irá guardar alguns metadados, 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.

As alterações nos dados da sessão (arquivos abertos e, se estiver ativa, a configuração das janelas) serão sempre guardadas.

### A Página da Lista de Documentos

Sombra do Fundo

  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 Plug-ins

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

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

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

### A Página de Terminal

Sincronizar automaticamente o terminal com o documento atual se possível

  Isto causará a integração do terminal 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 terminal sozinho.

### Ferramentas Externas

Está página será exibida se as Ferramentas Externas estiverem selecionadas na página Plug-ins. Neste caso, no menu Ferramentas você poderá ver um submenu chamado Ferramentas Externas. Estas ferramentas invocam aplicativos externos 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

Quebrar linha
  Quebra de linha dinâmica

    Se esta opção estiver marcada, as linhas de texto serão quebradas na borda da visão da tela.

  Indicadores de quebra de linha dinâmica (se aplicável)

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

  Alinhar dinamicamente as linhas quebradas para a profundidade de recuo:

    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 recuo 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 porcentagem, 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 recuo sejam mais profundas que 50% da largura da tela não terão qualquer alinhamento vertical aplicado às linhas repartidas subsequentes.

Bordas
  Exibir os marcadores de dobradura (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.

  Exibir 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 irá 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.

Avançado

  Mostrar linhas de recuo

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

  Realçar o intervalo entre os parênteses selecionados

    Se esta opção estiver ativa, o intervalo entre os parênteses selecionados será realçado.

### 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 &kappname; selecionará previamente o esquema atualmente ativo para você; se quiser trabalhar sobre um esquema diferente, comece por selecioná-lo na lista Esquema. Com os botões Novo e Excluir você pode criar um novo esquema ou remover um existente.

No fundo da página, você poderá selecionar o Esquema padrão para o &kappname;.

#### 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. Se configurar esta cor um pouco diferente do fundo do Texto Normal, isto o ajudará 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.

  Marcações de tabulações e espaços

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

  Linha com erros ortográficos

    define a cor da linha usada para indicar os erros ortográficos.

#### 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 &kappname; consegue realçar.

O nome na lista de estilos está usando o estilo configurado para o item, oferecendo-lhe uma visualizaçã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 visualizaçã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.

### Edição

#### Geral

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

  Realçar as tabulações

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

    Isto faz também com que pontos sejam desenhados para indicar os espaços em branco finais. Isto será corrigido numa futura versão do &kappname;

  Largura da tabulação

    Se a opção Inserir espaços ao invés de tabulações 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 é um recurso que faz com que o editor inicie automaticamente uma nova linha de texto e mova (quebre) o cursor para o início da nova linha. O &kappname; automaticamente iniciará uma nova linha de texto quando a linha atual atingir o comprimento especificado pela opção Quebrar linhas 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 Ativar quebra de linha estática estiver selecionada esta entrada determina o comprimento (em caracteres) no qual o editor automaticamente iniciará uma nova linha.

Diversos
  Remover espaços finais

    O &kappname; irá eliminar automaticamente os espaços extras no final das linhas de texto.

  Realçar espaços finais

    O &kappname; irá realçar os espaços adicionais no fim das linhas de texto.

  Parênteses automáticos

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

  Copiar/recortar a linha atual se não existir seleção

    Se esta opção estiver ativa e se a seleção de texto estiver vazia, as ações de cópia e corte são efetuadas para a linha de texto na posição atual do cursor.

  Permitir o deslocamento após o fim do documento

    Esta opção permite-lhe deslocar além do fim do documento. Isto poderá ser usado para centrar na vertical o fundo do documento, ou para colocá-lo no topo da janela atual.

#### Cursor & Seleção

Movimento do Cursor de Texto
  Início e fim inteligentes

    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 &kappname;, à 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 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 do Texto
  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.

#### Recuo

Modo de recuo padrão:

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

Propriedades do recuo
  Largura do recuo:

    A largura do recuo é o número de espaços usado para recuar uma linha. Se a opção Inserir espaços em vez de tabulações, na página Geral em Edição, estiver desativada, será inserido um caractere &Tab; se o recuo for divisível pela largura da tabulação.

  Manter Espaços Extras

    Se esta opção estiver desativada, a alteração do nível de recuo alinha uma linha a um múltiplo da largura definida em Largura do recuo.

  Ajustar o recuo do código colado da área de transferência

    Se esta opção for selecionada, o código colado da área de transferência será recuado. A execução da ação Desfazer irá remover o recuo.

Ações de recuo
  A tecla Backspace nos espaços iniciais retira o recuo

    Se esta opção for selecionada, a tecla &Backspace; diminui o nível de recuo se o cursor estiver localizado no espaço em branco inicial de uma linha.

  Ação da tecla Tab (se não existir seleção)

    Se você quiser que o &Tab; alinhe a linha atual no bloco de código atual, como acontece no Emacs, torne o &Tab; um atalho para a ação Alinhar.

    Sempre avançar para a tabulação seguinte

      Se esta opção for selecionada, a tecla &Tab; insere sempre espaços em branco até atingir a posição da tabulação seguinte. Se a opção Inserir espaços em vez de tabulações, na página Geral em Edição estiver ativa, são inseridos espaços; caso contrário, é inserida uma única tabulação.

    Sempre aumentar o nível de recuo

      Se esta opção for selecionada, a tecla &Tab; recua sempre a linha atual de acordo com o número de posições de caracteres indicada na Largura do recuo.

    Aumentar o nível de recuo se estiver num espaço em branco inicial

      Se esta opção estiver assinalada, a tecla &Tab; recua a linha atual ou avança para a próxima posição de tabulação. Se o ponto de inserção estiver sobre ou antes do primeiro caractere que não seja espaço na linha, ou se existir algo selecionado, a linha atual é recuada pelo número de posições de caracteres indicada em Largura do recuo. Se o ponto de inserção estiver após o primeiro caractere não-espaço e nada estiver selecionado, são inseridos espaços em branco até atingir a próxima posição de tabulação: se a opção Inserir espaços em vez de tabulações da página Geral em Edição estiver ativa, são inseridos espaços; caso contrário, é inserida uma única tabulação.

#### Complementação automática

Geral
  Complementação automática habilitada

    Se habilitado, aparece um campo de completação automática, mostrando uma lista com os itens de texto para completar o texto atual sob o cursor.

Tamanho mínimo da palavra a completar

  Ao digitar o texto, a complementação de palavras procura por palavras no documento que se iniciam com o texto já digitado. Esta opção configura a quantidade mínima de caracteres que são necessários para fazer com que a complementação de palavras habilite a caixa de complementação.

#### Modo de Entrada VI

Geral
  Usar o modo de inserção de dados como no VI

    Quando a opção estiver selecionada, o modo de inserção de dados à 'vi' será ativado, quando ativar uma janela nova. Você ainda poderá ativar/desativar o modo de entrada VI, para uma determinada janela, no menu Editar.

  Permitir aos comandos do VI substituir os atalhos do Kate

    Quando selecionado, os comandos do 'vi' irão substituir os comandos incorporados do &kate;. Por exemplo: o &Ctrl;R irá refazer, substituindo a ação padrão (mostrar a janela de pesquisa e substituição).

  Ocultar a barra de estado do modo VI

    Por padrão, será usada uma barra de status extra quando o modo de entrada do VI estiver ativo. Esta barra de status mostra os comandos, enquanto vão sendo escritos, e as mensagens/erros produzidos pelos comandos do VI.

    Assinalar esta opção irá ocultar esta linha de status extra.

Associação de Teclas

  A associação de teclas é usada para alterar o significado das teclas pressionadas. Isto permite-lhe mover os comandos para outras teclas ou criar sequências de teclas especiais para fazer uma determinada série de comandos.

  Exemplo:

  F2 -> I-- &Esc;

  Isto irá anteceder o I-- com uma linha, ao pressionar F2.

#### Verificação ortográfica

Estas opções de configuração estão descritas na documentação do módulo do &systemsettings; sobre Verificação Ortográfica.

### Abrir/salvar

#### Geral

Formato do Arquivo
  Codificação:

    Isto define o padrão de codificação a ser usado ao abrir/salvar arquivos, se não for mudado na janela de abertura/salvamento de arquivos ou por meio de uma opção de linha de comando.

  Detecção da codificação

    Selecione um item na lista, quer para desativar a detecção automática como para usar a Universal, de modo a ativar a detecção automática para todas as codificações. Contudo, como isto provavelmente só irá detectar o UTF-8/UTF-16, selecionar uma região irá usar heurísticas personalizadas para melhores resultados. Se a codificação selecionada como padrão acima, a codificação especificada na janela de abertura/salvamento de arquivos ou a codificação especificada na linha de comando corresponder ao conteúdo do arquivo, esta detecção será realizada.

  Codificação secundária

    Isto define a codificação secundária a ser tentada quando abrir os arquivos, caso não funcione a codificação padrão, a indicada através da janela para abrir/salvar ou pela linha de comando, de modo a corresponder ao conteúdo do arquivo. Antes desta ser usada, a componente do Kate irá tentar deduzir a codificação, lendo um possível marcador de ordem dos 'bytes' no início do arquivo; caso se detecte algum conhecido, será escolhida a codificação correta, caso contrário será testada esta como último recurso.

  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.

  Ativar o marcador da ordem de 'bytes'

    O marcador da ordem dos 'bytes' é uma sequência especial no início dos documentos codificados em Unicode. Ajuda os editores a abrir os documentos de texto com a codificação Unicode correta. Para mais informações, veja o Marcador da Ordem de 'Bytes'.

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.

#### Avançado

Arquivo de configuração da pasta
  Profundidade da pesquisa pelo arquivo de configuração:

    O editor irá procurar pelo número de níveis de pastas indicado para cima, no arquivo de configuração do &kappname; e carregar a linha de configuração respectiva. Poderá obter mais informações sobre estes arquivos de configuração ocultos da pasta no artigo O Arquivo .kateconfig.

Fazer cópia de segurança ao salvar

  Criar cópia de segurança ao salvar, fará com que o &kappname; 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 a ser adicionado aos nomes das cópias de segurança.

  Desativar a sincronização dos arquivos temporários

    O Kate é capaz de recuperar (a maior parte) o que foi escrito após o último salvamento no caso de uma falta de energia. Um arquivo temporário (.swp<nomedoarquivo>) é criado após a primeira ação de edição de um documento. Se o usuário não salvar as mudanças e o Kate travar, o arquivo temporário permanecerá no disco. Ao abrir um arquivo, o Kate verifica se existe um arquivo temporário para o documento e, caso exista, ele pergunta se o usuário deseja recuperar os dados perdidos ou não. O usuário também pode ver as diferenças entre o arquivo original e o recuperado. O arquivo temporário é excluído após cada salvamento ou saída normal do programa.

    O Kate sincroniza os arquivos temporários a cada 15 segundos, mas somente se eles tiverem mudado desde a última sincronização. O usuário poderá desativar a sincronização dos arquivos temporários se desejar, selecionando a opção Desativar a sincronização de arquivos temporários, mas isto pode levar a mais perda de dados.

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

  Excluir

    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 &kappname; para os arquivos selecionados por este tipo MIME, usando as variáveis do &kappname;. 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.

  Realce:

    Se você criar um novo tipo de arquivo, esta lista permite-lhe selecionar um tipo de arquivo para o realce.

  Modo de recuo:

    A lista indica o modo de recuo para os documentos novos.

  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.

Obter Arquivos de Realce...

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

### Extensões

A aba Plug-ins lista todos os plug-ins disponíveis e você poderá assinalar os que deseja usar. Clique no botão de Informações para abrir a janela Sobre deste plug-in.

Uma vez que um plug-in configurável esteja marcado, o botão Configurar fica habilitado para que se possa clicar nele, de modo a configurar o plug-in realçado.

#### Plugins do Componente de Edição

Parênteses automático

  O plug-in de parênteses automático sobrepõe-se ao recurso interno do &kate; de Parênteses automático. Ele automaticamente insere um parênteses de fechamento } no início da próxima linha após terminar uma linha com um parênteses de abertura { e pressionar o &Enter;.

Ferramentas de dados

  Ativa as ferramentas de dados, como a verificação gramatical e ortográfica (se estiverem instalados). As ferramentas de dados só ficam disponíveis quando tem texto selecionado, ou quando o botão direito do mouse é clicado sobre uma palavra. Se não existirem ferramentas de dados disponíveis, mesmo quando seleciona algum texto, terá que instalá-las. Algumas ferramentas de dados fazem parte do pacote &koffice;. Se este plugin estiver ativo e se as ferramentas de dados estiverem instalados, irão aparecer alguns itens adicionais no fim do menu do contexto.

Exportação

  Este comando permite que você exporte o documento atual com todas as informações realçadas em um documento HTML usando oArquivo Exportar como HTML. Adicionalmente você pode usar o Editar Copiar como HTML para copiar o texto atualmente selecionado como HTML para a área de transferência do sistema.

Inserir arquivo

  Este plugin permite-lhe inserir o conteúdo de qualquer arquivo legível na posição do cursor. Se estiver ativo, o menu Ferramentas tem uma opção adicional para Inserir um arquivo.

Verificação da codificação em Python

  Este plugin está sempre ativo. Se estiver tentando salvar um arquivo de Python como não-ASCII, sem indicar uma linha correta de codificação do código, como &eg; # -*- coding: utf-8 -*-, irá aparecer uma janela de aviso que lhe permitirá adicionar uma linha adequada com a codificação atual do arquivo.

## 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 do recuo 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 plug-ins adicionais podem usar as variáveis; nesse caso, isto deverá estar indicado na documentação do plug-in.

### Como o &kate; usa 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 itens 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 plug-ins, usando-as para os seus próprios fins. Por exemplo, o modo de recuo 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 recuo 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-indentsBOOLEANO

  Ativa ou desativa o recuo com o Backspace.

    block-selectionBOOL

  Ativa ou desativa a seleção em bloco.

    bom | byte-order-markerBOOLEANO

  Ativar/desativar o marcador da ordem dos 'bytes' ao salvar os arquivos no formato Unicode (utf8, utf16, utf32).

  Desde: Kate 3.4 (KDE 4.4)

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

    default-dictionaryTEXTO

  Configurar o dicionário padrão usado na verificação ortográfica.

  Desde: Kate 3.4 (KDE 4.4)

    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.

    folding-markersBOOL

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

    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.

    hl | syntaxTEXTO

  Define o realce de sintaxe. Os textos usados são todos os nomes disponíveis nos menus. Por exemplo, para o C++, basta digitar `C++`.

    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.

    indent-modeTEXTO

  Define o modo de recuo automático. As opções none, normal, cstyle, haskell, lilypond, lisp, python, ruby e xml são as reconhecidas. Veja a seção para mais detalhes.

    indent-widthINTEIRO

  Define a largura do recuo.

    keep-extra-spacesBOOL

  Define se deseja manter os espaços extras ao calcular a largura do recuo.

    keep-indent-profileBOOLEANO

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

  Nota: Removido no Kate 3 (KDE 4)

    line-numbersBOOL

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

    mixed-indentBOOLEANO

  Ativa ou desativa o recuo misto no estilo Emacs.

  Nota: Desatualizado desde o Kate 3 no KDE4. Esta variável é ignorada. Use o `replace-tabs on;` como alternativa no futuro.

    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-indentBOOLEANO

  Ativa ou desativa o recuo com espaços.

  Nota: Desatualizado desde o Kate 3 no KDE4. O recuo misto é o comportamento padrão. Use o `replace-tabs on;` para obter um recuo apenas com espaços.

    tab-indentsBOOLEANO

  Ativa ou desativa o recuo com tabulações.

    tab-widthINT

  Define a largura das tabulações.

    undo-stepsINT

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

  Nota: Desatualizado desde o Kate 3 no KDE4. Esta variável é ignorada. O número máximo de passos de anulação é ilimitado.

    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

  itens ou desativa a envolvência do cursor.