# Configurar o &kappname;

A seleção do Configurações Configurar Editor..., a partir do menu, provoca o aparecimento da janela para Configurar Editor. Esta janela pode ser usada para alterar algumas das várias opções existentes. As opções disponíveis para alteração podem variar de acordo com a categoria que o usuário seleciona, numa lista vertical do lado esquerdo da janela. Recorrendo aos três botões na parte inferior da janela, o usuário poderá controlar o processo.

Você pode invocar o sistema de Ajuda, aceitar as configurações atuais e fechar o diálogo através do botão OK ou Cancelar. As categorias Aparência, Fontes & Cores, Edição, Abrir/Salvar e Extensões são detalhadas abaixo.

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

Este grupo contém todas as páginas relacionadas com o componente de edição do &kappname; 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

#### Geral

Quebra de linhas 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 linhas dinâmica (se aplicável)

- Escolhe quando deverão ser mostrados os indicadores de quebra de linha, sendo as opções Desligado, Seguir número de linhas ou Sempre ligado.

Alinhar a quebra de linhas dinâmica à 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.

Realce de espaço em branco

- Realçar as tabulações

- O editor mostrará um símbolo » para indicar a presença de uma tabulação no texto.

Realçar espaços finais

- O editor mostrará pontos para indicar a presença de espaços em branco extra no fim das linhas.

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.

#### Bordas

Bordas

- Mostrar marcadores de dobra

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

Mostrar borda de ícones

- 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 número das linhas

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

Mostrar marcadores de modificação de linha

- Se estiver assinalada, os marcadores de modificação das linhas ficarão visíveis. Para mais informações, veja em kate-part-line-modification.

Mostrar marcas na barra de rolagem

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

Mostrar minimapa na barra de rolagem

- Se esta opção estiver assinalada, cada nova visão exibirá um minimapa de todo o documento na barra de rolagem vertical.

  Para obter mais informações sobre o minimapa na barra de rolagem, veja kate-part-scrollbar-minimap

Largura do minimapa

- Ajusta a largura em pixels do minimapa na barra de rolagem.

Ordenar menu de favoritos

- Por criação

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

Por posição

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

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

Por padrão, o &kappname; irá basear o seu esquema de cores no esquema atual do &kde;. Você poderá restaurar uma cor individual ao seu valor predefinido clicando no botão de reposição à direita do item no editor de cores, ou poderá ainda restaurar todas as cores predefinidas se usar o botão Usar o esquema de cores do &kde; no fundo do painel.

Você poderá ajustar o esquema de cores do &kde; no módulo de Cores das &systemsettings;.

#### Cores

Cores de fundo do Editor

- Área de texto

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

Realce da pesquisa

- Define a cor do texto correspondente à sua última pesquisa.

Realce da substituição

- Define a cor do texto correspondente à sua última substituição.

Borda do ícone

- Área de fundo

- 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úmero de linhas

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

Marcadores de quebra de linhas

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

Dobradura de código

- Esta cor é usada para realçar a seção de código que seria dobrada quando você clica na seta de dobradura de código à esquerda de um documento Para mais informações, veja a documentação sobre a dobradura de código.

Linhas modificadas

- Esta cor é usada para realçar, à esquerda de um documento, as linhas que foram modificadas mas ainda não foram salvas. Para mais informações, veja a kate-part-line-modification.

Linhas salvas

- Esta cor é usada para realçar, à esquerda de um documento, as linhas que foram modificadas e salvas nesta sessão. Para mais informações, veja a kate-part-line-modification.

Decorações de texto

- Linha com erros ortográficos

- Esta cor é usada para indicar os erros ortográficos.

Marcadores de tabulação e espaços

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

Linha de recuo

- Esta cor é usada para desenham uma linha à esquerda dos blocos recuados, se este recurso estiver ativo.

Realçar parênteses

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

Cores dos marcadores

- Favoritos

- Esta cor é usada para indicar os favoritos. Para mais informações, veja os kate-part-bookmarks.

Ponto de parada ativo

- Esta cor é usada pelo plugin do GDB para indicar um ponto de parada ativo. Para mais informações, veja a documentação do plugin do GDB.

Ponto de parada alcançado

- Esta cor é usada pelo plugin do GDB para indicar um ponto de parada que tenha sido atingido durante a depuração. Para mais informações, veja a documentação do plugin do GDB.

Ponto de parada desativado

- Esta cor é usada pelo plugin do GDB para indicar um ponto de parada inativo. Para mais informações, veja a documentação do plugin do GDB.

Execução

- Esta cor é usada pelo plugin do GDB para indicar a linha que está sendo executada de momento. Para mais informações, veja a documentação do plugin do GDB.

Aviso

- Esta cor é usada pelo plugin de compilação para indicar uma linha que contém um aviso do compilador. Para mais informações, veja a documentação do plugin de compilação.

Erro

- Esta cor é usada pelo plugin de compilação para indicar uma linha que contém um erro do compilador. Para mais informações, veja a documentação do plugin de compilação.

Modelos de texto & trechos

- Plano de fundo

- Esta cor é usada pelo plugin Trechos do &kate; para marcar o fundo de um trecho.

Campo editável

- Esta cor é usada pelo plugin Trechos do &kate; para marcar um item de substituição que você poderá clicar para editar manualmente.

Campo editável focável

- Esta cor é usada pelo plugin Trechos do &kate; para marcar o item de substituição que você está editando no momento.

Modelo de campo não editável

- Esta cor é usada pelo plugin de trechos do &kate; para marcar um item de substituição que não pode ser editado manualmente. Para mais informações, veja a documentação sobre os Trechos no &kate;.

Usar esquema de cores do &kde;

- Se clicar neste botão irá ativar todas as cores definidas acima para corresponderem ao esquema de cores definido nas &systemsettings; do &kde;. Para mais informações, veja a documentação do Módulo de Controle de Cores do &kde;.

  Se não usar o Espaço de Trabalho &plasma; do &kde;, este botão não fará efeito e pode não estar presente.

#### Fonte

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.

Para mais informações sobre como selecionar uma fonte, leia a seção Escolhendo as fontes na documentação dos Fundamentos do &kde;.

#### Estilos de texto padrão

Os estilos de texto predefinidos 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 de fundo. Para retirar uma cor de fundo, clique com o botão direito para usar o menu de contexto.

#### Estilos de texto de realce

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 o estilo usado pelo item é igual ao estilo padrão e configurá-lo desta forma, caso 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

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

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

#### Navegação de texto

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.

PageUp/PageDown move o cursor

- Esta opção muda o comportamento do cursor quando o usuário pressiona as teclas Page Up e Page Down. Se não estiver selecionada, o cursor de texto manterá sua posição relativa dentro do texto visível no &kappname; conforme o novo texto se torna visível como resultada da operação. Assim, se o cursor estiver no meio do texto visível quando a operação ocorre, ele permanecerá lá (exceto quando o início ou fim são atingidos). Com esta opção selecionada, o primeiro pressionamento de tecla fará com que o cursor se mova para cima ou para baixo do texto visível conforme uma nova página de texto é exibida.

Centralizar cursor automaticamente:

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

Modo de seleção de texto

- Normal

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

Persistente

- As seleções serão mantidas mesmo após o movimento do cursor ou a digitação.

Permitir rolagem 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.

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

Recuar usando

- Tabulações

- Quando estiver ativo, o editor irá inserir caracteres de tabulação quando você clicar na tecla ou usar o recuo automático.

Espaços

- 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 ou usar o recuo automático.

Tabulações e espaços

- Quando a opção estiver ativa, o editor irá inserir espaços, como descrito acima, quando recuar ou pressionar a tecla no início de uma linha, mas irá inserir tabulações quando pressionar na tecla no meio ou no fim de uma linha.

Largura da tabulação:

- Isto configura o número de espaços que são apresentados no lugar de um caractere de tabulação.

Largura do recuo:

- A largura do recuo é o número de espaços usado para recuar uma linha. Se estiver configurado para recuar com tabulações, será inserido um caractere de tabulação se o recuo for divisível pela largura da tabulação.

Propriedades do recuo

- 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 texto colado da área de transferência

- Se esta opção for selecionada, o texto 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 alinhe a linha atual no bloco de código atual, como acontece no Emacs, torne o um atalho para a ação Alinhar.

  Sempre avançar para a tabulação seguinte

- Se esta opção for selecionada, a tecla 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 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 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

- Ativar completamento automático

- 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, o completamento de palavras procura por palavras no documento iniciando com o texto já digitado. Esta opção configura a quantidade mínima de caracteres que são necessários para tornar o completamento de palavras ativo e exibir uma caixa de completamento.

Remover o fim com a completação

- Remover o fim de uma palavra anterior quando o item de completação for escolhido a partir de uma lista.

#### Modo de entrada Vi

Geral

- Usar o modo de entrada do 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 que os comandos do Vi substituam os atalhos do Kate

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

Mapeamento 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 a codificação padrão a ser usada para abrir/salvar os arquivos, se não for alterado no diálogo de abertura/gravação ou na opção da linha de comandos.

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

Limite do tamanho da linha

- Infelizmente, devido a deficiências no &Qt;, o &kappname; tem um desempenho ruim ao lidar com linhas extremamente longas. Por este motivo, o &kappname; tentará quebrar as linhas automaticamente, quando o tamanho for maior que o número de caracteres aqui indicado. Para desativar isto, defina como `0`.

Limpezas automáticas ao salvar

- Remover espaços finais

- O editor irá eliminar automaticamente os espaços extras no fim das linhas de texto enquanto salva o arquivo. Você pode selecionar Nunca para desativar essa funcionalidade, Nas linhas modificadas para fazer apenas nas linhas que você modificou desde a última gravação do documento ou Em todo o documento para removê-las de forma incondicional do documento inteiro.

Adicionar nova linha no fim do arquivo ao salvar

- O editor irá adicionar automaticamente uma nova linha ao fim do arquivo, caso não exista, ao salvar 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 Mais informações sobre estes arquivos de configuração ocultos da pasta podem ser encontradas na seção de variáveis do documento.

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.

Desabilitar a sincronização de arquivos temporários

- O &kappname; é 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 &kappname; travar, o arquivo temporário permanecerá no disco. Ao abrir um arquivo, o &kappname; 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 &kappname; 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 arquivo, 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 Excluir.

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 arquivo, 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 arquivo

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

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', etc.

  Pressione Editar para ver uma lista de todas as variáveis disponíveis e suas descrições. Selecione a caixa à esquerda para ativar uma determinada variável e então defina o valor da variável à direita. Algumas variáveis fornecem uma caixa combinada para selecionar os valores possíveis enquanto outras necessitam que você insira um valor válido manualmente.

  Para informações completas sobre estas variáveis, veja Configurando com variáveis de documento.

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 de máscaras separada por ponto e vírgula.

Tipos MIME:

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

Baixar arquivos de realce...

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

### Extensões

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

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

Para mais informações sobre os plugins disponíveis, veja editor-component-plugins.

## Configurando com as Variáveis do Documento

As variáveis do &kappname; 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 seguinte 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: replace-tabs on; indent-width 4; indent-mode cstyle;

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

Além disso, as variáveis do documento podem ser colocadas em um arquivo chamado `.kateconfig` em qualquer diretório, e as opções configuradas serão aplicadas se as modelines forem inseridas em qualquer arquivo no diretório e subdiretórios, com a profundidade definida na profundidade de pesquisa. As variáveis de documento no `.kateconfig` usam a mesma sintaxe das modelines.

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 &kappname; 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 documento no `.kateconfig`.

- As variáveis do próprio documento.

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

Como pode ver, as variáveis do documento somente podem ser sobrepostas por alterações feitas no momento da execução. 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 plugins, 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 &kappname; versão 3.7. 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-center-linesINT

- Define o número de linhas de centralização automática.

    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 no estilo 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 a remoção do recuo quando o &Backspace; é pressionado.

    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)

    encodingTEXTO

- Define a codificação usada para carregar ou salvar o arquivo. Como as variáveis do documento serão lidas após o carregamento, isto só terá impacto na gravação. Se o colocar em um arquivo `.kateconfig`, também afetará o carregamento.

  Desde: &kate; 3.10 (&kde; 4.10)

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

    folding-markersBOOL

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

    font-sizeINT

- Define o tamanho em pontos 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 reconhecidas. Veja a seção kate-part-autoindent para mais detalhes.

    indent-pasted-textBOOLEANO

- Ativa/desativa o ajuste de recuo do texto colado da área de transferência.

  Desde: &kate; 3.11 (&kde; 4.11)

    indent-widthINTEIRO

- Define a largura do recuo.

    keep-extra-spacesBOOL

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

    line-numbersBOOL

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

    mixed-indentBOOLEANO

- Ativa ou desativa o recuo misto no estilo &Emacs;.

  Nota: Obsoleto desde o &kate; 3 no &kde;4. Esta variável é ignorada. Use o `replace-tabs on;` como alternativa no futuro.

    newline-at-eofBOOLEANO

- Adiciona uma linha vazia no fim do arquivo (EOF) ao salvar o documento.

  Desde: &kate; 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Ativa ou desativa o modo de sobreposição.

    persistent-selectionBOOL

- Ativa ou desativa as seleções persistentes.

    remove-trailing-spaceBOOL

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

  Nota: Obsoleto desde a versão &kde; 4.10. Em vez disso, use a opção remove-trailing-spaces com a escolha desejada.

    remove-trailing-spacesTEXTO

- Remove os espaços finais ao salvar o documento. As opções válidas são:

  - `none`, `-` ou `0`: nunca remove os espaços finais.

  - `modified`, `mod`, `+` ou `1`: remove os espaços finais apenas nas linhas modificadas. Estas linhas são marcadas pelo sistema de modificação de linhas.

  - `all`, `*` ou `2`: remove os espaços finais no documento inteiro.

  Desde: &kde; 4.10. Esta opção substitui as opções `remove-trailing-space` e `replace-trailing-space-save`.

    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.

  Nota: Obsoleto desde a versão &kde; 4.10. Em vez disso, use a opção remove-trailing-spaces com a escolha desejada.

    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 caractere de tabulação visível.

    smart-homeBOOL

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

    space-indentBOOLEANO

- Ativa ou desativa o recuo com espaços.

  Nota: Obsoleto desde o &kate; 3 no &kde;4. 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 .

    tab-widthINT

- Define a largura de exibição do caractere de tabulação.

    undo-stepsINT

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

  Nota: Obsoleto desde o &kate; 3 no &kde;4. 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 estática.

    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 estática.

## Extensões do componente de edição

Estes plugins estão disponíveis para qualquer programa que use o componente de edição do &kate;. Para aprender como ativar, desativar ou configurá-los, consulte as informações disponíveis em pref-plugins.

Parênteses automático

- O plugin de parênteses automático sobrepõe-se ao recurso interno do &kappname; 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;.

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.

Destacar a seleção

- Destaca todas as palavras que correspondem ao texto selecionado.

Inserção de ícones

- O plugin de inserção de ícones só é usada para os programadores do &kde;: Ele adiciona um item Inserir código de KIcon no menu de contexto do editor. Se estiver ativado, o seletor de ícones do &kde; irá abrir (mostrando os ícones das aplicações, das ações, &etc;..). Se clicar em um, será inserido como texto o nome do arquivo sem a extensão. Só é útil para atribuir ícones, através da plataforma do &kde;, com a classe KIcon().

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