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

O Menu Preferências

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

Menu Exibir

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

### Geral

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

Comportamento

- Avisar sobre arquivos modificados por outros processos

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

Componente de edição de texto padrão

- Selecione o componente de editor de texto usado pelo &kate;. Por padrão, isto é configurado para usar o componente de edição de texto padrão do sistema como configurado nas &systemsettings;.

### 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, ou carregar a sessão padrão se nenhum tiver sido salva. 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.

### Visão em árvore

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.

Mostrar localização completa

- Quando ativado, no modo em árvore, as pastas de nível de topo serão mostradas com sua localização completa ao invés de apenas o último nome de pasta.

### Plugins

Esta página oferece uma lista de plugins instalados para o aplicativo &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.

### Terminal

Esta página somente é exibida pelo plugin da ferramenta de exibição do terminal, que está ativa por padrão.

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.

Definir a variável de ambiente EDITOR como sendo 'kate -b'

- Isto define a variável de ambiente `EDITOR` de modo que programas executados no terminal embutido que abrem automaticamente um arquivo em um editor abrirão estes arquivos no &kate; ao invés do editor configurado em seu shell. Você não será capaz de continuar usando o terminal até que você feche o arquivo no &kate;, de modo que o programa que realizou a requisição saiba que você terminou a edição do arquivo.

&configuring-part-sections;

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

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

- Ativa ou desativa 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 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: 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 .

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

    wrap-cursorBOOL

- itens ou desativa a envolvência do cursor.